docs(changelog): OTLP metrics to Grafana — Jun 23 entry

[indykish]

Changelog entry for the M94 milestone (paired with agentsfleet feat/m94-otlp-metrics): agentsfleetd now pushes metrics to Grafana Cloud Mimir, completing the OpenTelemetry triad next to traces and logs.

What this entry covers

• Three series — credit drained (posture/model), token throughput (by direction), run-latency histogram, plus a samples_dropped exporter-health counter.
• One credential triple — GRAFANA_OTLP_* now enables traces, logs, and metrics together.
• Collector requirement — DELTA temporality; a Fly-deployed OTel Collector with deltatocumulative converts before Mimir (the dashboard's deployment note documents it). Panels read empty without it.
• Bug fix — traces/logs were emitting invalid double-quoted JSON for span names/attributes/log bodies; now valid.

Review

• CTO docs review (second-agent pass): SHIP, no must-fix — verified the Collector prerequisite, money-safety framing (metrics emit only after the charge commits; wallet/ledger stay in Postgres), Mintlify voice (no marketing words, no milestone IDs leaked), and technical accuracy against the code.

🤖 Generated with Claude Code

Greptile Summary

This PR adds a changelog entry for the Jun 23, 2026 release documenting OTLP metrics support in agentsfleetd — covering credit drain, token throughput, and run-latency series pushed to Grafana Cloud Mimir — alongside a bug fix for double-quoted JSON in trace/log payloads.

• New <Update> block documents the three metric series, the GRAFANA_OTLP_* credential triple that now enables all three OpenTelemetry signals, the required OTel Collector deltatocumulative processor, and the ready-made Grafana dashboard at deploy/grafana/agent-observability.json.
• Bug fix bullet calls out the stray extra quote in span names, attributes, and log bodies that caused Grafana to reject payloads; the fix is described concisely without overstating impact.

Confidence Score: 5/5

Documentation-only change adding a changelog entry; no logic, no secrets, no breaking surface changes.

The change is a single, self-contained changelog block. Formatting is consistent with adjacent entries (blank lines between subheadings and bullet lists are present), the technical claims match the PR description, and the Collector prerequisite is called out explicitly so readers won't be surprised by empty panels.

No files require special attention.

Important Files Changed

Filename	Overview
changelog.mdx	Adds a new Jun 23, 2026 Update block documenting OTLP metrics and a JSON quoting bug fix; formatting is consistent with surrounding entries (blank lines present between headings and bullet lists).

Sequence Diagram

%%{init: {'theme': 'neutral'}}%%
sequenceDiagram
    participant afd as agentsfleetd
    participant col as OTel Collector(deltatocumulative)
    participant gc as Grafana Cloud
    participant pg as Postgres

    afd->>pg: Commit charge (wallet/ledger)
    afd->>afd: Emit metric (after commit)
    afd->>col: OTLP push (delta temporality) credit_drained, token_throughput, run_latency
    col->>col: Convert delta to cumulative
    col->>gc: OTLP push (cumulative) to Mimir
    afd->>gc: OTLP traces to Tempo
    afd->>gc: OTLP logs to Loki
    note over afd,gc: All three signals share GRAFANA_OTLP_* credentials

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"}}}%%
sequenceDiagram
    participant afd as agentsfleetd
    participant col as OTel Collector(deltatocumulative)
    participant gc as Grafana Cloud
    participant pg as Postgres

    afd->>pg: Commit charge (wallet/ledger)
    afd->>afd: Emit metric (after commit)
    afd->>col: OTLP push (delta temporality) credit_drained, token_throughput, run_latency
    col->>col: Convert delta to cumulative
    col->>gc: OTLP push (cumulative) to Mimir
    afd->>gc: OTLP traces to Tempo
    afd->>gc: OTLP logs to Loki
    note over afd,gc: All three signals share GRAFANA_OTLP_* credentials

Loading

_{Reviews (2): Last reviewed commit: "Fix changelog heading spacing" | Re-trigger Greptile}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
agentsfleet	🟢 Ready	View Preview	Jun 23, 2026, 4:59 AM

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