Skip to content

Review backlog (docs-currency): operator-reference Dashboard metrics section does not point at the monitoring component or alert runbooks #15514

Closed

Description

@hivecommons-hive

Filed from an out-of-scope finding in the Hive review of PR #15487.

PR: #15487 (#15487)
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 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.

Fingerprint: ba7af8f20b879c64c02060b8289cc9aa7a14fbc4220e9a5203a61f394e778f62

filed by Hive review backlog

Activity

  1. added
    help wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.
    on Oct 29, 2026
  2. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 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.

  3. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    🔓 Claim by @mendezr released (lease revoked).

  4. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 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.

  5. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    Checked against v5 and the open PRs:

    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

  6. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    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.

    Fingerprint: 913bdcffe1ad3c948020db4d6f7771ebe0c45d4a6fa47677af05e43c2459256c

    filed by Hive review backlog

  7. 23 remaining items

  8. hivecommons-hive commented on Oct 30, 2026

    @hivecommons-hive
    ContributorAuthor

    🔓 Claim by @odttlnt released (released on disconnect).

  9. added
    stage/020-claimedClaimed by the scanner or a relay contributor
    and removed
    stage/010-actionableTriaged; eligible for the hive to pick up
    good first issueDenotes an issue ready for a new contributor, according to the "help wanted" guidelines.
    on Oct 30, 2026
  10. hivecommons-hive commented on Oct 30, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 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.

  11. added a commit that references this issue on Oct 30, 2026
    bf291e3
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/reviewerFiled by the reviewer agenthelp wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions