Skip to content

docs: add Grafana dashboard import instructions to self-hosted monitoring page#312

Draft
seemeroland wants to merge 1 commit into
mainfrom
oz-agent/REMOTE-2110-grafana-dashboard
Draft

docs: add Grafana dashboard import instructions to self-hosted monitoring page#312
seemeroland wants to merge 1 commit into
mainfrom
oz-agent/REMOTE-2110-grafana-dashboard

Conversation

@seemeroland

Copy link
Copy Markdown
Contributor

Summary

Adds a "Grafana dashboard" section to the self-hosted worker monitoring documentation page, helping enterprise customers like IMC import and use the new dashboard template published in the oz-agent-worker repository.

Addresses REMOTE-2110: enterprise customer IMC requested Grafana dashboard templates for self-hosted Oz worker monitoring.

Changes

src/content/docs/platform/self-hosting/monitoring.mdx

New section "Grafana dashboard" added after the metric catalog, covering:

  • Dashboard sections overview: describes each of the 5 rows (Worker Health, Task Throughput, Task Duration, Failure Analysis, Connection Health) and the Instance filter variable
  • Step-by-step import instructions: Grafana UI (file upload), Grafana API (curl command), and direct raw URL from GitHub
  • Prometheus alerting rules reference: lists all 9 alert rules with severity and description
  • Links to grafana/README.md in oz-agent-worker for threshold tuning

Also adds the Steps component import from @astrojs/starlight/components.

Related PR

Conversation: https://staging.warp.dev/conversation/3861b9b2-ce49-46f7-baff-bfb3e2173b0b
Run: https://oz.staging.warp.dev/runs/019f4843-a02c-7ca4-aa34-0d867981dfbc

This PR was generated with Oz.

Add a new 'Grafana dashboard' section to the self-hosted worker monitoring
page, covering:
- Dashboard layout and sections overview
- Step-by-step import instructions (Grafana UI, API, and direct URL)
- Prometheus alerting rules reference with alert descriptions
- Links to the grafana/ directory in oz-agent-worker

Also adds the Steps component import needed for the step-by-step
import workflow.

Addresses REMOTE-2110 (enterprise customer IMC requesting Grafana
dashboard templates for self-hosted Oz worker monitoring).

Co-Authored-By: Oz <oz-agent@warp.dev>
@seemeroland seemeroland added the from-feedback-bot PR originated from Feedback Bot delegated Linear issue label Jul 9, 2026
@cla-bot cla-bot Bot added the cla-signed label Jul 9, 2026
@vercel

vercel Bot commented Jul 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 9, 2026 7:16pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed from-feedback-bot PR originated from Feedback Bot delegated Linear issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant