You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Review backlog (docs-currency): operator-reference Dashboard metrics section does not point at the monitoring component or alert runbooks #15514
| `HIVE_METRICS_TOKEN` | **Required whenever metrics are enabled** ([#3804](https://github.com/hivecommons/hive/pull/3804)): scrapers must send `Authorization: Bearer <token>` (configure Prometheus `bearer_token`). Enabled-but-tokenless serves 403 with an error naming both variables, and the hive logs a startup warning; the cost/agent series are never served unauthenticated. |
)
Finding: operator-reference Dashboard metrics section does not point at the monitoring component or alert runbooks
The HIVE_METRICS_TOKEN row still says 'configure Prometheus bearer_token' with no link to the Kubernetes monitoring component (ServiceMonitor authorization.credentials) or the new alert runbooks. Not required by #15438; a follow-up cross-link would help operators find the component.
🔒 Claimed by @mendezr (contributor on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 30m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.
🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 2h0m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.
📖 docs: monitoring a hive with Prometheus and Grafana #15497 (pending CI) already rewrites the HIVE_METRICS_TOKEN row in src/docs/operator-reference.md to end with See [monitoring.md](monitoring.md), and monitoring.md carries the Alerts and runbooks section whose anchors the PrometheusRule runbook_urls target. That covers the runbook half of this finding.
Leaving this open as a one-line follow-up for after #15487 lands: add the component path to the same row. No separate PR from me now to avoid colliding with #15497 and the operator-reference split in #15516.
Additional finding (folded in — same finding area and category). Raised in the Hive review of PR #15489 (#15489) and folded into this issue because it is a docs-currency finding at the same symbol or lines of src/docs/operator-reference.md as this issue. Address it together with this issue; if it turns out to be a different problem, file it separately before closing.
Review backlog (docs-currency): operator-reference 'Dashboard metrics' section does not link to the monitoring component
operator-reference 'Dashboard metrics' section does not link to the monitoring component (src/docs/operator-reference.md:2093)
Perspective: docs-currency
Severity: info (P3)
Evidence: src/docs/operator-reference.md:2093 (
| `HIVE_METRICS_TOKEN` | **Required whenever metrics are enabled** ([#3804](https://github.com/hivecommons/hive/pull/3804)): scrapers must send `Authorization: Bearer <token>` (configure Prometheus `bearer_token`). Enabled-but-tokenless serves 403 with an error naming both variables, and the hive logs a startup warning; the cost/agent series are never served unauthenticated. |
)
Finding: operator-reference 'Dashboard metrics' section does not link to the monitoring component
src/docs/operator-reference.md:2088-2093 documents HIVE_METRICS_ENABLED/HIVE_METRICS_TOKEN and tells operators to configure Prometheus bearer_token by hand, but does not point at src/deploy/kustomize/components/monitoring/README.md (ServiceMonitor, alerts, Grafana dashboard). A one-line cross-reference would make the component discoverable; belongs with the #15437 component PR rather than this dashboard PR.
🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 2h0m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.
Activity
hivecommons-hive commentedon Oct 29, 2026
🔒 Claimed by @mendezr (contributor on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 30m0s without activity and renews while the work continues. Reply
/unclaimto release, or/claimto take it over if you outrank the holder.hivecommons-hive commentedon Oct 29, 2026
🔓 Claim by @mendezr released (lease revoked).
hivecommons-hive commentedon Oct 29, 2026
🔒 Claimed by agent
scanner(agent on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 2h0m0s without activity and renews while the work continues. Reply/unclaimto release, or/claimto take it over if you outrank the holder.hivecommons-hive commentedon Oct 29, 2026
Checked against v5 and the open PRs:
HIVE_METRICS_TOKENrow insrc/docs/operator-reference.mdto end withSee [monitoring.md](monitoring.md), andmonitoring.mdcarries the Alerts and runbooks section whose anchors the PrometheusRulerunbook_urls target. That covers the runbook half of this finding.src/deploy/kustomize/components/monitoring, ServiceMonitorauthorization.credentials) does not exist onv5yet — it arrives with ✨ deploy: PrometheusRule alerts for the monitoring component #15487 (base v6). A link to it now would be a dead link, so that half is blocked on ✨ deploy: PrometheusRule alerts for the monitoring component #15487 merging.Leaving this open as a one-line follow-up for after #15487 lands: add the component path to the same row. No separate PR from me now to avoid colliding with #15497 and the operator-reference split in #15516.
/unclaim
🐝 Hive Agent:
scanner| Instance:hosted-available-oke-11-placeholder-r05x| SHA:660ad919— hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88
hivecommons-hive commentedon Oct 29, 2026
Additional finding (folded in — same finding area and category). Raised in the Hive review of PR #15489 (#15489) and folded into this issue because it is a docs-currency finding at the same symbol or lines of
src/docs/operator-reference.mdas this issue. Address it together with this issue; if it turns out to be a different problem, file it separately before closing.Review backlog (docs-currency): operator-reference 'Dashboard metrics' section does not link to the monitoring component
src/docs/operator-reference.md:2093)Perspective: docs-currency
Severity: info (P3)
Evidence:
src/docs/operator-reference.md:2093(hive/src/docs/operator-reference.md
Line 2093 in 126b994
Finding: operator-reference 'Dashboard metrics' section does not link to the monitoring component
src/docs/operator-reference.md:2088-2093 documents HIVE_METRICS_ENABLED/HIVE_METRICS_TOKEN and tells operators to configure Prometheus bearer_token by hand, but does not point at src/deploy/kustomize/components/monitoring/README.md (ServiceMonitor, alerts, Grafana dashboard). A one-line cross-reference would make the component discoverable; belongs with the #15437 component PR rather than this dashboard PR.
Fingerprint:
913bdcffe1ad3c948020db4d6f7771ebe0c45d4a6fa47677af05e43c2459256cfiled by Hive review backlog
23 remaining items
hivecommons-hive commentedon Oct 30, 2026
🔓 Claim by @odttlnt released (released on disconnect).
hivecommons-hive commentedon Oct 30, 2026
🔒 Claimed by agent
scanner(agent on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 2h0m0s without activity and renews while the work continues. Reply/unclaimto release, or/claimto take it over if you outrank the holder.📖 docs: link metrics token row to monitoring component and alert runb…