Documentation

Terraform Provider

Manage your Oack monitoring infrastructure as code with the official Terraform provider. Create teams, monitors, alert channels, status pages, and PagerDuty integrations — all in version-controlled HCL.

Installation

main.tf

terraform {
  required_providers {
    oack = {
      source  = "oack-io/oack"
      version = "~> 0.3"
    }
  }
}

provider "oack" {
  api_key    = var.oack_api_key    # or OACK_API_KEY env var
  account_id = var.oack_account_id # or OACK_ACCOUNT_ID env var
}

Available resources

Resource	Description
`oack_team`	Teams that own monitors, channels, and API keys
`oack_monitor`	HTTP/HTTPS monitors with SSL/domain expiry, latency thresholds, checker preferences
`oack_alert_channel`	Slack, Email, Webhook, Telegram, Discord, PagerDuty channels
`oack_monitor_alert_channel_link`	Route alerts from monitors to channels
`oack_status_page`	Public or password-protected status pages with custom branding
`oack_status_page_component`	Components and groups on status pages
`oack_status_page_watchdog`	Auto-create/resolve incidents when monitors change health
`oack_pagerduty_integration`	Two-way PagerDuty incident sync
`oack_external_link`	Quick links to Grafana, Datadog, or other dashboards
`oack_team_api_key`	Team-scoped API keys for CI/CD and deploy events

Example: full-stack setup

main.tf

resource "oack_team" "production" {
  name = "Production"
}

resource "oack_monitor" "api" {
  team_id           = oack_team.production.id
  name              = "API Health"
  url               = "https://api.example.com/health"
  check_interval_ms = 30000
  ssl_expiry_enabled    = true
  domain_expiry_enabled = true
}

resource "oack_alert_channel" "slack" {
  team_id = oack_team.production.id
  name    = "Engineering Slack"
  type    = "slack"
  config  = jsonencode({ webhook_url = var.slack_webhook })
}

resource "oack_monitor_alert_channel_link" "api_slack" {
  team_id    = oack_team.production.id
  monitor_id = oack_monitor.api.id
  channel_id = oack_alert_channel.slack.id
}

See the full GitHub repository for progressive examples and resource documentation.