You can manage SigNoz dashboards as reviewable, version-controlled, and reproducible code with the Terraform signoz provider. As of provider v0.1.0, the canonical, always-current reference for doing this lives on the Terraform Registry. The previous inline example on this page was removed to avoid drift now that the provider docs are generated directly from the provider schema.
What changed in v0.1.0
Provider v0.1.0 is a breaking change for dashboards:
- The
signoz_dashboardresource moved from opaque JSON-string attributes (layout,widgets,variablespassed throughjsonencode(...)) to a fully typedspecschema modeled on the SigNoz dashboards v2 API and the Perses specification. Every panel, query, variable, and grid layout is now a first-class attribute Terraform validates at plan time. - The new
signoz_dashboardrequires SigNoz v0.135.0 or newer, which exposes the dashboards v2 API.
If you currently manage dashboards with the old JSON-string schema, follow the migration guide below before upgrading to v0.1.0.
Reference
- Dashboard resource reference: signoz_dashboard resource
- Provider configuration and getting started: SigNoz provider docs
- Upgrading the provider from 0.0.x to 0.1.0: v0.0.x → v0.1.0 migration guide
You can also import and edit dashboards from the SigNoz UI, and browse ready-made dashboard templates.
