Monitoring as Code (MaC) lets you define monitors, alert channels, notification policies, and more as version-controlled configuration. Choose the tool that fits your workflow:Documentation Index
Fetch the complete documentation index at: https://docs.devhelm.io/llms.txt
Use this file to discover all available pages before exploring further.
| Tool | Best for | Format |
|---|---|---|
| YAML + CLI | Fast iteration, standalone monitoring config | devhelm.yml |
| Terraform | Managing monitors alongside cloud infrastructure | HCL (.tf) |
YAML + CLI
The fastest path to monitoring as code. Define everything in a singledevhelm.yml and deploy with the CLI.
YAML file format
Full schema reference for devhelm.yml.
Deploy workflow
Validate, plan, and deploy lifecycle.
Terraform provider
Manage DevHelm resources as Terraform infrastructure alongside AWS, GCP, or any other provider.Terraform overview
Provider setup, resources, and data sources.
Terraform monitors
Full devhelm_monitor resource reference.
CI/CD patterns
Automate deploys on every push. Preview changes in pull requests.CI/CD overview
Common patterns across CI systems.
GitHub Actions
Official setup-devhelm action.
Generic CI
GitLab, Jenkins, CircleCI, and more.
Choosing between YAML and Terraform
| Consideration | YAML + CLI | Terraform |
|---|---|---|
| Setup time | Minutes | Requires Terraform knowledge |
| State management | API is source of truth | Terraform state file |
| Cloud resource co-management | No | Yes |
| PR preview | devhelm plan | terraform plan |
| Multi-environment | Per-env YAML files | Terraform workspaces or modules |