Sådan styrer du Uptimecheck med Terraform

Opdateret 15. november 2026 3 min. læsning

På Professional og Business styrer Uptimechecks provider til Terraform, uptimecheck-com/uptimecheck i Terraform Registry, monitorer, projekter, alarmkanaler og statussider som kode. Den arbejder via REST API’et med en API-nøgle.

Opret en API-nøgle

  1. Åbn Indstillinger i sidemenuen, og vælg fanen API.
  2. Vælg Ny API-nøgle, navngiv den efter, hvor den bruges, fx “Terraform”, og vælg Læse og skrive. Provideren opretter og ændrer ting, så en nøgle med kun læseadgang er ikke nok.
  3. Vælg Opret nøgle, og kopiér den. Det er den eneste gang, nøglen vises.

Tilføj provideren

Tilføj provideren til din konfiguration:

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

provider "uptimecheck" {}

Kør terraform init, som henter provideren fra Terraform Registry. Sæt derefter nøglen i miljøvariablen UPTIMECHECK_API_KEY, fx med export UPTIMECHECK_API_KEY=uc_your_api_key, eller som en hemmelighed i dit CI-system. Provideren tager også argumentet api_key, men miljøvariablen holder nøglen ude af dine filer.

Tilføj 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 er en af http, tcp, ping, dns, domain, heartbeat, server, vendor, crawl og flow. Ændrer du den, erstattes monitoren.
  • config indeholder typens indstillinger som JSON med de samme nøgler som i API-referencen. Kun de nøgler, du skriver, styres, så appens standardværdier for resten dukker ikke op som ændringer.
  • interval_seconds er, hvor ofte der tjekkes, fra 60 til 3600 sekunder (30 på en plan, der tillader det), og 300, hvis du udelader den.
  • channel_ids vælger alarmkanalerne, project_id projektet, og paused = true sætter monitoren på pause.

Kør terraform plan for at se, hvad der ændres, og derefter terraform apply. Monitoren dukker op i appen med det samme.

Et cronjob og dets 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 ligger i heartbeat_url, markeret som følsom. Læs den med terraform output -raw backup_ping_url, og tilføj den til jobbet.

Projekter, alarmkanaler og statussider

  • uptimecheck_project: et projekt, fx en kunde, med name og color. Sletter du det, står dets monitorer og statussider uden projekt; dets kunderapporter og kundeadgang slettes sammen med det.
  • uptimecheck_alert_channel: e-mail, Slack via indgående webhook, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover og webhooks. Adressen eller nøglen står i config, som API’et aldrig returnerer, så en ændring i appen ses ikke som drift. delay_minutes (5, 10, 15, 30 eller 60) gør kanalen til et eskaleringstrin. En webhooks signeringshemmelighed ligger i webhook_secret og returneres kun, når kanalen oprettes.
  • uptimecheck_status_page: en statusside med titel, udseende og components, de monitorer, besøgende ser, i rækkefølge og eventuelt grupperet. Adgangskoden, listen over e-mailadresser med adgang og egen CSS sættes op i appen og lades i fred. Sletter du siden, slettes dens abonnenter, skrevne opdateringer og besøgsstatistik.
  • Datakilderne uptimecheck_alert_channels, uptimecheck_projects og uptimecheck_status_pages viser, hvad der findes. Brug den første til SMS-, Telegram-, push- og Add to Slack-kanaler, som sættes op i appen.

Få det, du allerede har, med

Monitorer, projekter, alarmkanaler og statussider, der er oprettet i appen, kan importeres med deres 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 importeret alarmkanals adresse og en webhooks signeringshemmelighed læses ikke tilbage. Alle ressourcer og attributter er dokumenteret i Terraform Registry. Læs mere om Terraform-integrationen, API-nøgler og REST API’et.

Var denne artikel nyttig?

Prøv det i dit eget workspace

14 dages gratis prøveperiode · Derefter gratis med 20 monitorer · Intet kreditkort

Sidder du stadig fast?

Skriv til support@uptimecheck.com, så svarer vi inden for 24 timer.

Vil du automatisere? API-reference dækker REST API'et, webhooks, cron-job-pings og MCP.