Slik styrer du Uptimecheck med Terraform

Oppdatert 15. november 2026 3 min lesing

På Professional og Business styrer Uptimecheck-provideren for Terraform, uptimecheck-com/uptimecheck i Terraform Registry, monitorer, prosjekter, varslingskanaler og statussider som kode. Den bruker REST API-et med en API-nøkkel.

Opprett en API-nøkkel

  1. Åpne Innstillinger i sidemenyen og velg fanen API.
  2. Velg Ny API-nøkkel, gi den navn etter hvor den brukes, for eksempel «Terraform», og velg Lese og skrive. Provideren oppretter og endrer ting, så en nøkkel med bare lesetilgang holder ikke.
  3. Velg Opprett nøkkel og kopier den. Dette er eneste gang nøkkelen vises.

Legg til provideren

Legg til provideren i konfigurasjonen din:

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

provider "uptimecheck" {}

Kjør terraform init, som laster ned provideren fra Terraform Registry. Legg deretter nøkkelen i miljøvariabelen UPTIMECHECK_API_KEY, for eksempel med export UPTIMECHECK_API_KEY=uc_your_api_key, eller som en hemmelighet i CI-systemet ditt. Provideren tar også argumentet api_key, men miljøvariabelen holder nøkkelen utenfor filene dine.

Legg til 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 av http, tcp, ping, dns, domain, heartbeat, server, vendor, crawl og flow. Endrer du den, erstattes monitoren.
  • config inneholder innstillingene for typen som JSON, med de samme nøklene som i API-referansen. Bare nøklene du skriver, styres, så appens standardverdier for resten dukker ikke opp som endringer.
  • interval_seconds er hvor ofte det sjekkes, fra 60 til 3600 sekunder (30 på en plan som tillater det), 300 hvis du utelater den.
  • channel_ids velger varslingskanalene, project_id prosjektet, og paused = true setter monitoren på pause.

Kjør terraform plan for å se hva som endres, og deretter terraform apply. Monitoren dukker opp i appen med en gang.

En cron-jobb og ping-URL-en dens

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, merket som sensitiv. Les den med terraform output -raw backup_ping_url og legg den inn i jobben.

Prosjekter, varslingskanaler og statussider

  • uptimecheck_project: et prosjekt, for eksempel en kunde, med name og color. Sletter du det, står monitorene og statussidene uten prosjekt; kunderapportene og kundetilgangen slettes sammen med det.
  • uptimecheck_alert_channel: e-post, Slack via innkommende webhook, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover og webhooks. Adressen eller nøkkelen legges i config, som API-et aldri returnerer, så en endring gjort i appen regnes ikke som avvik. delay_minutes (5, 10, 15, 30 eller 60) gjør kanalen til et eskaleringstrinn. Signeringshemmeligheten til en webhook ligger i webhook_secret og returneres bare når kanalen opprettes.
  • uptimecheck_status_page: en statusside med tittel, utseende og components, monitorene besøkende ser, i rekkefølge og eventuelt gruppert. Passordet, e-posttilgangslisten og egen CSS settes i appen og blir ikke rørt. Sletter du siden, slettes abonnentene, de skrevne oppdateringene og besøksstatistikken.
  • Datakildene uptimecheck_alert_channels, uptimecheck_projects og uptimecheck_status_pages lister opp det som finnes. Bruk den første for SMS-, Telegram-, push- og Add to Slack-kanaler, som settes opp i appen.

Ta med det du allerede har

Monitorer, prosjekter, varslingskanaler og statussider du har laget i appen, kan importeres med ID-en sin:

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_...

Adressen til en importert varslingskanal og signeringshemmeligheten til en webhook leses ikke tilbake. Alle ressurser og attributter er dokumentert i Terraform Registry. Mer om Terraform-integrasjonen, API-nøkler og REST API-et.

Var denne artikkelen nyttig?

Prøv det i ditt eget arbeidsområde

14 dagers gratis prøveperiode · Deretter gratis for 20 monitorer · Uten kredittkort

Står du fast?

Send e-post til support@uptimecheck.com, så svarer vi innen 24 timer.

Vil du automatisere? API-referanse dekker REST API-et, webhooks, cron-jobb-pinger og MCP.