Skip to content

docs(rfc): commit the RFC0041.6 FinOps dashboard artifact - #661

Merged
jensholdgaard merged 2 commits into
mainfrom
rfc0041-6-finops-dashboard
Jul 27, 2026
Merged

docs(rfc): commit the RFC0041.6 FinOps dashboard artifact#661
jensholdgaard merged 2 commits into
mainfrom
rfc0041-6-finops-dashboard

Conversation

@jensholdgaard

@jensholdgaard jensholdgaard commented Jul 27, 2026

Copy link
Copy Markdown
Owner

Summary

The RFC0041.6 capstone artifact: the committed Perses FinOps dashboard, verified rendering against the live dogfood capture with no manual edits to the definition.

  • examples/perses/agent-finops.json — four panels: spend by model (sum(attr.cost_usd) by attr.model, bucket(1h), the RFC 0042 typed Float64 column), output-token throughput (Int64), tool-decision mix, and a LogsTable of recent agent events (RFC0002.21 floor admits unspecified-severity GenAI events).
  • examples/perses/datasource.example.json — the proxy datasource shape: tenant header injected server-side, POST /v1/query + POST /mcp (schema suggestions, RFC 0032) allowed.
  • examples/perses/README.md — prerequisites and percli apply import steps.
  • RFC 0041 §9 verification record for .1–.6 (.5 remains deliberately partial until the next server release carries typed columns).

Verification

Imported the committed file unmodified (API upsert, HTTP 200) into Perses 0.53.1 with the built ourios-perses-plugin archive, against the live agent-dogfood capture served by the dogfood querier. Every panel rendered from the capture: two model series (claude-fable-5, claude-haiku-4-5, ~$391 across the day's buckets), ~40K/h token peaks, decision counts, and the event log. Idle hours render as gaps, never zeros — the RFC 0042 null-propagation contract on screen.

Checks run: mdbook build (clean). No Rust code touched — fmt/clippy/test not applicable to this change.

Invariants / hazards

Docs + committed example only; no data-path code. Hazard #6 (DSL vs DataFusion surface): the dashboard consumes only the public DSL over POST /v1/query — the time range arrives as a DSL range(...) stage per the plugin's withRange, nothing host-specific leaks into the query surface.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Qtny6z6cA74xPZa4qRhk4F

Summary by CodeRabbit

  • New Features

    • Added a ready-to-import Perses FinOps dashboard with panels for model spend, output tokens, tool decisions, and recent agent activity.
    • Added an example datasource configuration for connecting Perses to an Ourios querier.
  • Documentation

    • Added setup and usage instructions for importing the datasource and dashboard.
    • Documented expected behavior for time ranges, idle periods, missing data, and null values.
    • Added verification details confirming dashboard panels render correctly without manual edits.

The Perses dashboard definition the RFC0041.6 capstone clause requires,
under examples/perses/: spend by model over the RFC 0042 typed Float64
column, output-token throughput (Int64), tool-decision mix, and the
event-log panel — plus the proxy datasource example (tenant header
injected server-side, /v1/query + /mcp allowed) and an import README.

Verified by importing the committed file unmodified into Perses 0.53.1
with the built ourios-perses-plugin archive against the live dogfood
capture: every panel renders, idle hours draw as gaps (never zeros).
RFC 0041 gains the §9 verification record for .1-.6.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qtny6z6cA74xPZa4qRhk4F
Signed-off-by: Jens Holdgaard Pedersen <Jens@holdgaard.org>
@jensholdgaard
jensholdgaard requested a review from Copilot July 27, 2026 19:07
@coderabbitai

coderabbitai Bot commented Jul 27, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@jensholdgaard, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 51 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 220d6547-4546-495f-a019-4f591fe0dc4c

📥 Commits

Reviewing files that changed from the base of the PR and between 51793b4 and 7438ef7.

📒 Files selected for processing (3)
  • docs/rfcs/0041-dashboard-datasource-plugins.md
  • examples/perses/README.md
  • examples/perses/agent-finops.json
📝 Walkthrough

Walkthrough

Adds Perses datasource and FinOps dashboard examples, usage instructions, rendering expectations, and RFC 0041 verification details covering plugin delivery and dashboard import testing.

Changes

Perses dashboard examples

Layer / File(s) Summary
Datasource and dashboard artifacts
examples/perses/*
Defines the ourios-ds proxy datasource, a four-panel FinOps dashboard, import commands, credential handling, and expected null and idle-period rendering behavior.
RFC 0041 verification record
docs/rfcs/0041-dashboard-datasource-plugins.md
Documents verification coverage for RFC0041.1–.5 plugin deliverables and RFC0041.6 dashboard import and rendering tests.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title is concise and accurately names the RFC0041.6 dashboard artifact being committed.
Description check ✅ Passed The description is detailed and covers summary, verification, and risks; the Related and checklist sections are not explicitly filled out.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch rfc0041-6-finops-dashboard

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Commits the RFC0041.6 capstone artifact by adding a Perses FinOps dashboard definition plus supporting datasource/README examples, and records the verification run in RFC 0041.

Changes:

  • Add agent-finops.json Perses dashboard (spend, tokens, tool decisions, recent events) using the public Ourios logs DSL.
  • Add a Perses Datasource example (HTTPProxy allowed endpoints + tenant header) and import instructions.
  • Extend RFC 0041 with a §9 verification record documenting the rendered dashboard against the dogfood capture.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
examples/perses/README.md Documents prerequisites and percli apply steps for importing the datasource + dashboard.
examples/perses/datasource.example.json Adds a Perses datasource example configured to proxy POST /v1/query and POST /mcp with a tenant header.
examples/perses/agent-finops.json Adds the RFC0041.6 Perses dashboard definition with four panels backed by Ourios DSL queries.
docs/rfcs/0041-dashboard-datasource-plugins.md Adds §9 verification record describing plugin/dash rendering and query-surface behavior.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/rfcs/0041-dashboard-datasource-plugins.md Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@examples/perses/agent-finops.json`:
- Around line 127-139: Update the LogQuery plugin configuration in the “Recent
agent events” panel to scope results to the Claude Code telemetry stream by
adding the com.anthropic.claude_code.events predicate alongside the existing
severity filter. Preserve the limit and other query behavior.

In `@examples/perses/README.md`:
- Around line 20-24: Update the command examples in the README snippet so both
percli apply commands reference the files under examples/perses/ when run from
the repository root, while preserving the existing filenames and command
structure.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 5e9e6969-1926-446b-b964-ace33802a6b9

📥 Commits

Reviewing files that changed from the base of the PR and between 25f476f and 51793b4.

📒 Files selected for processing (4)
  • docs/rfcs/0041-dashboard-datasource-plugins.md
  • examples/perses/README.md
  • examples/perses/agent-finops.json
  • examples/perses/datasource.example.json

Comment thread examples/perses/agent-finops.json
Comment thread examples/perses/README.md
… paths

The log panel now filters to the claude_code events scope like the
metric panels (predicates combine with 'and' before the first pipe —
the suggested '| severity >=' form is not a pipe stage and the querier
rejects it, caught by re-rendering). README import commands run from
the repository root; the §9.2 body-shape phrasing no longer reads as a
JSON literal.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qtny6z6cA74xPZa4qRhk4F
Signed-off-by: Jens Holdgaard Pedersen <Jens@holdgaard.org>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.

@jensholdgaard
jensholdgaard merged commit b223917 into main Jul 27, 2026
28 checks passed
@jensholdgaard
jensholdgaard deleted the rfc0041-6-finops-dashboard branch July 27, 2026 19:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants