Quickstart

Create your first HTTP monitor in under 5 minutes. Pick the approach that fits your workflow.

Prerequisites

A DevHelm account — sign up at app.devhelm.io
An API key — create one from Settings → API Keys in the Dashboard

Set your token as an environment variable:

export DEVHELM_API_TOKEN=dh_live_xxxxxxxx

Create a monitor

CLI
YAML + Deploy
TypeScript
Python
REST API

Install the CLI globally:

npm install -g devhelm

Create a monitor:

devhelm monitors create \
  --name "My API" \
  --type HTTP \
  --url https://api.example.com/health \
  --frequency 60 \
  --regions us-east

Check your monitor status:

devhelm monitors list

Create a devhelm.yml file:

version: "1"

tags:
  - name: production
    color: "#10b981"

monitors:
  - name: API Health
    type: HTTP
    config:
      url: https://api.example.com/health
    frequencySeconds: 60
    regions:
      - us-east
      - eu-west
    tags:
      - production

  - name: Marketing Site
    type: HTTP
    config:
      url: https://example.com
    frequencySeconds: 300
    regions:
      - us-east

alert-channels:
  - name: Engineering Slack
    type: SLACK
    config:
      webhookUrl: ${SLACK_WEBHOOK_URL}

Preview and deploy:

devhelm validate devhelm.yml
devhelm plan -f devhelm.yml
devhelm deploy -f devhelm.yml

npm install @devhelm/sdk

import { DevHelm } from "@devhelm/sdk";

const client = new DevHelm({
  apiToken: process.env.DEVHELM_API_TOKEN,
});

const monitor = await client.monitors.create({
  name: "My API",
  type: "HTTP",
  config: { url: "https://api.example.com/health" },
  frequencySeconds: 60,
  regions: ["us-east"],
});

console.log(`Monitor created: ${monitor.id}`);

pip install devhelm

import os
from devhelm import DevHelm

client = DevHelm(api_token=os.environ["DEVHELM_API_TOKEN"])

monitor = client.monitors.create(
    name="My API",
    type="HTTP",
    config={"url": "https://api.example.com/health"},
    frequency_seconds=60,
    regions=["us-east"],
)

print(f"Monitor created: {monitor.id}")

curl -X POST https://api.devhelm.io/api/v1/monitors \
  -H "Authorization: Bearer $DEVHELM_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My API",
    "type": "HTTP",
    "config": { "url": "https://api.example.com/health" },
    "frequencySeconds": 60,
    "regions": ["us-east"],
    "managedBy": "DASHBOARD"
  }'

What happens next

Once your monitor is running, DevHelm will:

Check your endpoint from the selected probe regions at the configured frequency
Create an incident automatically if the endpoint fails or violates assertions
Alert your team through connected alert channels (Slack, PagerDuty, email, etc.)
Resolve the incident automatically when the endpoint recovers

Next steps

Monitoring overview

Learn about all six monitor types, assertions, and regions.

Alerting guide

Set up alert channels, notification policies, and escalation rules.

Monitoring as Code

Manage your monitoring stack in YAML or Terraform and deploy from CI/CD.

CLI overview

Full command reference for all CLI operations.

Getting Started

Monitoring as Code

Monitoring

Incidents

Alerting

Status Data

Platform

Common Patterns

Prerequisites

Create a monitor

What happens next

Next steps

Monitoring overview

Alerting guide

Monitoring as Code

CLI overview

Getting Started

Monitoring as Code

Monitoring

Incidents

Alerting

Status Data

Platform

Common Patterns

​Prerequisites

​Create a monitor

​What happens next

​Next steps

Monitoring overview

Alerting guide

Monitoring as Code

CLI overview

Prerequisites

Create a monitor

What happens next

Next steps