Skip to content

feat(dashboards): add operational panels#16229

Merged
Automaat merged 3 commits intomasterfrom
feat/grafana-dashboard-improvements
Apr 13, 2026
Merged

feat(dashboards): add operational panels#16229
Automaat merged 3 commits intomasterfrom
feat/grafana-dashboard-improvements

Conversation

@Automaat
Copy link
Copy Markdown
Contributor

Motivation

Add observability panels to Grafana dashboards covering operational blind spots: xDS snapshot sizing, KDS health, VIP exhaustion, cert expiry, injection outcomes, and DNS internals.

Implementation information

Control plane dashboard (kuma-control-plane.json):

  • xDS Snapshot Resources (p95 by type) — track cluster/endpoint fan-out growth
  • KDS Active Zone Connections — monitor zone CP connectivity
  • KDS NACK Rate — surface config rejection issues
  • VIP Allocation Exhaustion (1h) — alert before VIP pool runs out
  • xDS Cert Time Remaining (per mesh) — track cert renewal health
  • Sidecar Injection Outcomes — split success/skip/error injection counts

Service debug dashboard (kuma-service-debug.json):

  • DNS Queries by Type & Source — break down DNS traffic patterns
  • DNS Response Codes — surface NXDOMAIN/SERVFAIL spikes
  • DNS Map Entries (per pod) — track DNS table size per dataplane

All panels use existing metrics exposed by kuma-cp and kuma-dp; no code changes required.

Changelog: feat(dashboards): add operational Grafana panels for xDS, KDS, DNS, and cert monitoring

Control plane: xDS snapshot resources, KDS active
zones, KDS NACK rate, VIP allocation exhaustion,
cert time remaining, sidecar injection outcomes.
Service debug: DNS queries/responses/map entries.

Signed-off-by: Marcin Skalski <skalskimarcin33@gmail.com>
@Automaat Automaat added the ci/run-full-matrix PR: Runs all possible e2e test combination (expensive use carefully) label Apr 12, 2026
Copilot AI review requested due to automatic review settings April 12, 2026 09:24
@Automaat Automaat requested a review from a team as a code owner April 12, 2026 09:24
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR extends Kuma’s Grafana dashboards with additional operational observability panels to cover xDS, KDS, VIP/IPAM, certificate lifecycle, sidecar injection, and DNS behavior.

Changes:

  • Added xDS snapshot resource sizing, KDS connectivity/NACK, VIP exhaustion, cert expiry, and injection outcome panels to the control plane dashboard.
  • Added DNS query breakdown, DNS response codes, and DNS map sizing panels to the service debug dashboard.
  • Adjusted panel grid positions to accommodate the new rows.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
dashboards/grafana/kuma-service-debug.json Adds DNS-focused panels (queries, response codes, map size) and shifts layout to fit them.
dashboards/grafana/kuma-control-plane.json Adds operational control-plane panels (xDS snapshot sizing, KDS health, VIP exhaustion, cert expiry, injection outcomes) and shifts layout accordingly.

Comment thread dashboards/grafana/kuma-service-debug.json Outdated
Comment thread dashboards/grafana/kuma-service-debug.json Outdated
@github-actions
Copy link
Copy Markdown
Contributor

Reviewer Checklist

🔍 Each of these sections need to be checked by the reviewer of the PR 🔍:
If something doesn't apply please check the box and add a justification if the reason is non obvious.

  • Is the PR title satisfactory? Is this part of a larger feature and should be grouped using > Changelog?
  • PR description is clear and complete. It Links to relevant issue as well as docs and UI issues
  • This will not break child repos: it doesn't hardcode values (.e.g "kumahq" as an image registry)
  • IPv6 is taken into account (.e.g: no string concatenation of host port)
  • Tests (Unit test, E2E tests, manual test on universal and k8s)
    • Don't forget ci/ labels to run additional/fewer tests
  • Does this contain a change that needs to be notified to users? In this case, UPGRADE.md should be updated.
  • Does it need to be backported according to the backporting policy? (this GH action will add "backport" label based on these file globs, if you want to prevent it from adding the "backport" label use no-backport-autolabel label)

Signed-off-by: Marcin Skalski <skalskimarcin33@gmail.com>
@Automaat Automaat added ci/skip-test PR: Don't run unit and e2e tests (maybe this is just a doc change) and removed ci/run-full-matrix PR: Runs all possible e2e test combination (expensive use carefully) labels Apr 12, 2026
Signed-off-by: Marcin Skalski <skalskimarcin33@gmail.com>
@Automaat Automaat merged commit 9fab7eb into master Apr 13, 2026
13 checks passed
@Automaat Automaat deleted the feat/grafana-dashboard-improvements branch April 13, 2026 08:21
Automaat added a commit that referenced this pull request Apr 14, 2026
## Motivation

Add observability panels to Grafana dashboards covering operational
blind spots: xDS snapshot sizing, KDS health, VIP exhaustion, cert
expiry, injection outcomes, and DNS internals.

## Implementation information

**Control plane dashboard** (`kuma-control-plane.json`):
- xDS Snapshot Resources (p95 by type) — track cluster/endpoint fan-out
growth
- KDS Active Zone Connections — monitor zone CP connectivity
- KDS NACK Rate — surface config rejection issues
- VIP Allocation Exhaustion (1h) — alert before VIP pool runs out
- xDS Cert Time Remaining (per mesh) — track cert renewal health
- Sidecar Injection Outcomes — split success/skip/error injection counts

**Service debug dashboard** (`kuma-service-debug.json`):
- DNS Queries by Type & Source — break down DNS traffic patterns
- DNS Response Codes — surface NXDOMAIN/SERVFAIL spikes
- DNS Map Entries (per pod) — track DNS table size per dataplane

All panels use existing metrics exposed by kuma-cp and kuma-dp; no code
changes required.

> Changelog: feat(dashboards): add operational Grafana panels for xDS,
KDS, DNS, and cert monitoring

---------

Signed-off-by: Marcin Skalski <skalskimarcin33@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci/skip-test PR: Don't run unit and e2e tests (maybe this is just a doc change)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants