Så hanterar du Uptimecheck med Terraform

Uppdaterad 15 november 2026 3 min läsning

På Professional och Business hanterar Uptimechecks provider för Terraform, uptimecheck-com/uptimecheck i Terraform Registry, monitorer, projekt, larmkanaler och statussidor som kod. Den arbetar via REST API:et med en API-nyckel.

Skapa en API-nyckel

  1. Öppna Inställningar i sidomenyn och välj fliken API.
  2. Välj Ny API-nyckel, döp den efter var den används, till exempel ”Terraform”, och välj Läsa och skriva. Providern skapar och ändrar saker, så en nyckel som bara får läsa räcker inte.
  3. Välj Skapa nyckel och kopiera den. Det är enda gången nyckeln visas.

Lägg till providern

Lägg till providern i din konfiguration:

terraform {
  required_providers {
    uptimecheck = {
      source = "uptimecheck-com/uptimecheck"
    }
  }
}

provider "uptimecheck" {}

Kör terraform init, som laddar ner providern från Terraform Registry. Lägg sedan nyckeln i miljövariabeln UPTIMECHECK_API_KEY, till exempel med export UPTIMECHECK_API_KEY=uc_your_api_key, eller som en hemlighet i ditt CI-system. Providern tar också argumentet api_key, men miljövariabeln håller nyckeln utanför dina filer.

Lägg till en monitor

resource "uptimecheck_monitor" "checkout" {
  type             = "http"
  name             = "Checkout"
  target           = "https://shop.example.com/checkout"
  interval_seconds = 60
  config = jsonencode({
    expectedStatus = "200-299"
    keyword        = { value = "Add to cart", mode = "contains" }
    slowMs         = 1500
  })
}
  • type är en av http, tcp, ping, dns, domain, heartbeat, server, vendor, crawl och flow. Ändrar du den ersätts monitorn.
  • config innehåller typens inställningar som JSON, med samma nycklar som i API-referensen. Bara de nycklar du skriver hanteras, så appens standardvärden för resten syns inte som ändringar.
  • interval_seconds anger hur ofta kontrollen körs, från 60 till 3600 sekunder (30 på en plan som tillåter det), och 300 om du utelämnar den.
  • channel_ids väljer larmkanaler, project_id projektet, och paused = true pausar monitorn.

Kör terraform plan för att se vad som ändras, och sedan terraform apply. Monitorn dyker upp i appen direkt.

Ett cron-jobb och dess ping-URL

resource "uptimecheck_monitor" "backup" {
  type = "heartbeat"
  name = "Nightly backup"
  config = jsonencode({
    schedule      = { cron = "0 3 * * *", timeZone = "Europe/Stockholm" }
    graceSeconds  = 900
    maxRunSeconds = 3600
  })
}

output "backup_ping_url" {
  value     = uptimecheck_monitor.backup.heartbeat_url
  sensitive = true
}

Ping-URL:en finns i heartbeat_url, markerad som känslig. Läs den med terraform output -raw backup_ping_url och lägg till den i jobbet.

Projekt, larmkanaler och statussidor

  • uptimecheck_project: ett projekt, till exempel en kund, med name och color. Tar du bort det blir dess monitorer och statussidor utan projekt; dess kundrapporter och kundåtkomst tas bort tillsammans med det.
  • uptimecheck_alert_channel: e-post, Slack via inkommande webhook, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover och webhooks. Adressen eller nyckeln läggs i config, som API:et aldrig returnerar, så en ändring i appen räknas inte som drift. delay_minutes (5, 10, 15, 30 eller 60) gör kanalen till ett eskaleringssteg. En webhooks signeringshemlighet finns i webhook_secret och returneras bara när kanalen skapas.
  • uptimecheck_status_page: en statussida med titel, utseende och components, de monitorer besökarna ser, i ordning och om du vill grupperade. Lösenordet, listan över e-postadresser med åtkomst och egen CSS ställs in i appen och lämnas orörda. Tar du bort sidan försvinner dess prenumeranter, skrivna uppdateringar och besöksstatistik.
  • Datakällorna uptimecheck_alert_channels, uptimecheck_projects och uptimecheck_status_pages listar det som finns. Använd den första för SMS-, Telegram-, push- och Add to Slack-kanaler, som ställs in i appen.

Ta in det du redan har

Monitorer, projekt, larmkanaler och statussidor som skapats i appen kan importeras med sitt ID:

terraform import uptimecheck_monitor.checkout mon_...
terraform import uptimecheck_project.acme prj_...
terraform import uptimecheck_alert_channel.slack ch_...
terraform import uptimecheck_status_page.public sp_...

En importerad larmkanals adress och en webhooks signeringshemlighet läses inte tillbaka. Varje resurs och attribut är dokumenterad i Terraform Registry. Läs mer om Terraform-integrationen, API-nycklar och REST API:et.

Var den här artikeln till hjälp?

Prova i din egen arbetsyta

14 dagar gratis · Sedan gratis för 20 monitorer · Inget kreditkort

Kommer du inte vidare?

Mejla support@uptimecheck.com så svarar vi inom 24 timmar.

Vill du automatisera? API-referens täcker REST-API:t, webhooks, pingar för cron-jobb och MCP.