docs(changelog): add Prometheus metric-rename breaking change to M92 upgrade

[indykish]

What

The M92 rename changelog entry's Upgrading list covered the CLI, API hosts, ZOMBIE_* env vars, routes/wire fields, UZ-ZMB-* error codes, and token prefixes — but omitted the Prometheus metric rename, the most silent break in the cutover.

Operators running Grafana dashboards/alerts on zombie_* metrics get blank panels and silenced alerts with no error and no log. Added one Upgrading bullet naming the new families:

• agent-entity metrics → agent_* (e.g. agent_duration_seconds, agent_tokens_total)
• fleet/runner metrics → agentsfleet_runner_*
• daemon metrics → agentsfleetd_*

Why

Surfaced during a full docs-repo residue review. The rest of the docs site is clean — the only zombie references are this rename entry (legitimate old→new naming) and append-only history.

Notes

Append-only: only the one Upgrading bullet added; no historical entries rewritten. Follows changelog-voice (**Bold lead-noun** — consequence-first, no marketing words).

🤖 Generated with Claude Code

Greptile Summary

Adds one missing bullet to the M92 (usezombie → agentsfleet) Upgrading checklist covering the Prometheus metric rename. All other breaking changes in that entry were already documented; the new bullet closes the gap for operators relying on Grafana dashboards or alerting rules pointed at zombie_* metric names.

• Single-line append to changelog.mdx — no historical entries rewritten, consistent bold-lead-noun style, placed correctly after the token-prefix bullet.
• Content is accurate and specific — names the three new metric families (agent_*, agentsfleet_runner_*, agentsfleetd_*), gives concrete examples, and calls out the silent failure mode (blank panels, silenced alerts, no error).

Confidence Score: 5/5

Safe to merge — append-only documentation change with no code, config, or schema impact.

The change is a single line appended to an existing upgrading checklist. It names the correct metric families (agent_*, agentsfleet_runner_*, agentsfleetd_*), is consistent with the agentsfleet_runner_* reference already in the What's new section, follows the established bold-lead-noun voice, and does not touch any historical entries.

No files require special attention.

Important Files Changed

Filename	Overview
changelog.mdx	Adds one Upgrading bullet for the Prometheus metric rename in the M92 entry; change is append-only, correctly styled, and consistent with the agentsfleet_runner_* reference already present in the What's new section.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Operator upgrades to agentsfleet M92] --> B{Are Prometheus dashboards\nor alerts configured?}
    B -- No --> C[No action needed]
    B -- Yes --> D[Identify zombie_* metric queries]
    D --> E[Remap metric families]
    E --> F["agent-entity metrics\nzombie_* → agent_*\ne.g. agent_duration_seconds\nagent_tokens_total"]
    E --> G["fleet/runner metrics\n→ agentsfleet_runner_*"]
    E --> H["daemon metrics\n→ agentsfleetd_*"]
    F --> I[Update Grafana dashboards\nand alert rules]
    G --> I
    H --> I
    I --> J[Verify panels show data\nand alerts re-arm]
    J --> K{Old zombie_* queries\nstill present?}
    K -- Yes --> L["⚠️ Silent failure:\nblank panels, silenced alerts\nno error or log"]
    K -- No --> M[✅ Cutover complete]

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[Operator upgrades to agentsfleet M92] --> B{Are Prometheus dashboards\nor alerts configured?}
    B -- No --> C[No action needed]
    B -- Yes --> D[Identify zombie_* metric queries]
    D --> E[Remap metric families]
    E --> F["agent-entity metrics\nzombie_* → agent_*\ne.g. agent_duration_seconds\nagent_tokens_total"]
    E --> G["fleet/runner metrics\n→ agentsfleet_runner_*"]
    E --> H["daemon metrics\n→ agentsfleetd_*"]
    F --> I[Update Grafana dashboards\nand alert rules]
    G --> I
    H --> I
    I --> J[Verify panels show data\nand alerts re-arm]
    J --> K{Old zombie_* queries\nstill present?}
    K -- Yes --> L["⚠️ Silent failure:\nblank panels, silenced alerts\nno error or log"]
    K -- No --> M[✅ Cutover complete]

Loading

_{Reviews (1): Last reviewed commit: "docs(changelog): add Prometheus metric-r..." | Re-trigger Greptile}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
megam	🟢 Ready	View Preview	Jun 17, 2026, 1:07 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.