Infrastructure as Code (IaC)

Manage Synthetic Checks via YAML specs and the official Dash0 Terraform provider to keep monitoring versioned and reviewed alongside your services.

YAML spec (authoritative shape)

Dash0 provides a sample synthetic_check.yaml that shows the expected structure (request, headers/params/auth/body, assertions, scheduling, locations, retries). Use it as the canonical reference for fields and nesting. GitHub

Tip: Keep one spec per check, per environment (synthetic_check.prod.yaml, synthetic_check.staging.yaml, …) and review changes via PRs.

Using the spec from Terraform

The provider example shows how Terraform references that YAML when defining a synthetic check resource. This keeps your check definition in a human-readable file while Terraform applies it. See the example resource.tf in the provider repo. GitHub

UI → IaC workflow (download the spec)

You can use the Dash0 UI as a builder for your check, then download the generated YAML and apply it via Terraform:

1. Create / edit the check in the Dash0 UI Fill out request details, headers/params, auth/body, assertions (status code, numeric timings, headers/JSON/text), scheduling (frequency, locations, strategy), and retries.
2. Download spec Click Download spec to export the YAML representation of the check (compatible with the Terraform example layout).
3. Commit & apply
   • Commit the YAML to your repo next to your service (or in an observability/ folder).
   • Reference the file from your Terraform configuration (following the resource.tf example).
   • Roll out via your standard CI/CD pipeline.