Port bundled MINIO Grafana dashboards and alert rules to Metrics V3
Nobody has claimed this yet.
- Dominant language
- Shell
- Stars
- 5.7k
- Forks
- 384
- Avg merge
- 2h 36m
- Merged PRs (30d)
- 2
Description
Parent: #763
Problem
Switching ingestion to Metrics V3 is incomplete while Pigsty's bundled Grafana dashboards and VictoriaMetrics alert rules still query V2 metric names and assumptions. V3 changes names, labels, units, and in some cases the scrape/duplication model.
Scope
Audit and port every shipped MINIO consumer, including at least:
files/grafana/minio/minio-overview.jsonfiles/grafana/minio/minio-instance.json- MINIO panels embedded in
files/grafana/pigsty.jsonand related overview dashboards files/victoria/rules/minio.yml
Use native V3 names and semantics. Do not perform a blind text rename:
- map changed label keys, including API/operation labels;
- correct rate windows and byte/second units;
- handle cluster-wide gauges that are repeated by node scrapes with
min/maxor another semantically correct aggregation rather thansum; - scope cluster views by
clsand instance views byins; - include configured bucket identity where applicable;
- replace unavailable low-value V2 widgets with actionable V3 health or freshness signals.
The Console-side mapping and Info-page replacement discussions live in:
- pgsty/silo-console#7
- pgsty/silo-console#8
Suggested health coverage
At minimum, preserve or add actionable views/alerts for availability, erasure-set health, offline drives/nodes, capacity pressure, S3 error rate, request latency, replication/healing backlog where present, and usage-data freshness.
Acceptance criteria
- No active SILO dashboard panel or alert rule depends on a V2-only metric name.
- Dashboards work for single-node, distributed, and two-cluster test data.
- Repeated cluster-wide gauges do not inflate totals.
- Dashboard variables and links preserve
cls/inscontext. - Grafana provisioning succeeds and all PromQL expressions parse.
- VictoriaMetrics rule checks pass and representative synthetic failure states trigger/recover as expected.
- Any retained V2 compatibility path is isolated and documented rather than mixed into every V3 query.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the listed MINIO dashboards, embedded panels, and files/victoria/rules/minio.yml, then review parent #763 and the linked console mapping discussions. Audit every V2 metric, label, unit, aggregation, and cls/ins variable before updating the consumers. Done means provisioning and PromQL checks pass, representative failure states trigger and recover, and single-node, distributed, and two-cluster data remain correct.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- grafana
- Domain
- observability
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100