[TaylorMutch]

Summary

Add reusable Grafana dashboards for operational health, operational logs, and OCSF events in Kubernetes-based OpenShell deployments. Package them as a configurable monitoring mixin that operators render and provision into their existing Grafana environment.

Related Issue

Closes #5351.

The issue has no state:accepted label; the author has verified ADMIN access to NVIDIA/OpenShell.

Changes

• Add standard mixin exports, configurable selectors and label mappings, datasource variables, and a consumer override example. Alert and recording-rule exports are empty initially.
• Cover gateway health and request behavior, supervisor sessions, routing and relay pressure, operational logs, and gateway/supervisor OCSF events.
• Add mise tasks for generation, formatting, and structural tests, with task-specific Jsonnet tooling pinned in the lockfile.
• Run mise run monitoring:check in Branch Checks when deploy/openshell-mixin/ changes; skip unrelated changes and always run on manual dispatch.
• Document rendering, collection requirements, Kubernetes provisioning options, query semantics, and consumer validation. Telemetry backend deployment and live dashboard validation remain with the consumer.

Screenshots

Operational dashboard

OCSF Logs

Operational (non-OCSF) Logs

Release Notes

Testing

• mise run monitoring:check: five structural tests, formatting checks, and default dashboard rendering pass.
• Custom configuration rendering, including an output path containing spaces, passes.
• Actionlint and Markdown lint pass; git diff --check passes.
• Change-detection script passes nine temporary Git fixture cases covering unrelated changes, mixin edits/deletions, diverged targets, merge queues, manual dispatch, and missing/invalid baselines.
• Live query and visual validation against the consumer's telemetry pipeline and Grafana version. Automated checks validate structure and configuration; they do not execute backend queries.

Checklist

• Follows Conventional Commits
• Commits are signed off (DCO)
• Contributor and CI documentation updated; related workflow guidance reviewed.

[copy-pr-bot]

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.