Monitoring as Code

Tool	Best for	Format
YAML + CLI	Fast iteration, standalone monitoring config	`devhelm.yml`
Terraform	Managing monitors alongside cloud infrastructure	HCL (`.tf`)

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 single devhelm.yml and deploy with the CLI.

version: "1"

monitors:
  - name: API Health
    type: HTTP
    config:
      url: https://api.example.com/health
      method: GET
    frequencySeconds: 60
    regions: [us-east, eu-west]

alertChannels:
  - name: Slack Alerts
    config:
      channelType: slack
      webhookUrl: ${SLACK_WEBHOOK_URL}

devhelm deploy -f devhelm.yml --yes

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.

resource "devhelm_monitor" "api" {
  name              = "API Health"
  type              = "HTTP"
  frequency_seconds = 60
  regions           = ["us-east", "eu-west"]
  config            = jsonencode({ url = "https://api.example.com/health" })
}

Terraform overview

Provider setup, resources, and data sources.

Terraform monitors

Full devhelm_monitor resource reference.

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

Don’t manage the same resource with both YAML and Terraform. Pick one source of truth per resource to avoid drift and conflicts.

Overview

YAML Format

Deploy Workflow

Terraform Provider

CI/CD Patterns

Monitoring as Code

YAML + CLI

YAML file format

Deploy workflow

Terraform provider

Terraform overview

Terraform monitors

CI/CD patterns

CI/CD overview

GitHub Actions

Generic CI

Choosing between YAML and Terraform

​YAML + CLI

YAML file format

Deploy workflow

​Terraform provider

Terraform overview

Terraform monitors

​CI/CD patterns

CI/CD overview

GitHub Actions

Generic CI

​Choosing between YAML and Terraform

YAML + CLI

Terraform provider

CI/CD patterns

Choosing between YAML and Terraform