Grafana add-on
Metrics and dashboard visualization. Catalog version: 11.3.1.
Exact release scope. This page documents the reviewed v0.0.1 source at fcc5871. Check release status before enabling a gated capability.
Catalog contract
| Field | Value |
|---|---|
| Key | grafana |
| Version | 11.3.1 |
| Category | Observability |
| v0.0.1 posture | Install preview · gated |
| Upgrade / uninstall | Contract stubs; no OperationRun |
Metrics and dashboard visualization.
Before planning
- ✓Cluster state is ReadyForAddons and no conflicting lifecycle operation is active
- ✓The add-on artifact and every required image have immutable approved identities
- ✓Dependency: Prometheus or another approved data source
- ✓No catalog-level conflict
- ✓Required SecretRefs exist and values are never copied into plan input
Operator values
The catalog exposes a validated values schema. Unknown or secret-shaped plain values should fail before install.
| Value | Use |
|---|---|
adminPasswordSecretRef | Reference existing secret material; never provide a plaintext value |
autoDatasourceProvisioning | Review and set only when required by the selected profile |
dashboardTargetBaseUrl | Review and set only when required by the selected profile |
healthGatePolicy | Review and set only when required by the selected profile |
Plan, preflight and install
- 01
Select the catalog entry
Confirm key, version, source identity, dependencies, conflicts and dashboard capability.
- 02
Create an AddonPlan
Review ordered issues, namespace, values profile, artifacts and images.
- 03
Run preflight
Require cluster readiness, dependency, registry reachability, artifact lock and image lock evidence.
- 04
Install through the OperationRun
Use the compatible lifecycle agent and follow each Helm/apply and health step.
- 05
Accept semantic health
Do not stop at running pods; use the catalog health checks and retained evidence.
Dashboard and access
Direct public dashboard posture supported when healthy and explicitly approved.
Failure and recovery
| Failure | Safe response |
|---|---|
| Preflight blocked | Fix dependency, lock, registry, secret reference or cluster readiness; create no install run |
| Install step failed | Use the OperationRun error and evidence; retry only a classified retryable step |
| Health gate failed | Keep dependants and dashboard access blocked; inspect semantic checks |
| Reapply required | Use the saved plan and targeted install/reapply path with a new approved intent |
| Removal required | v0.0.1 uninstall is not implemented; use an environment-approved manual runbook outside the claimed product capability |