Uptimecheckin hallinta Terraformilla

Päivitetty 15. marraskuuta 2026 3 min lukuaika

Professional- ja Business-paketeissa Uptimecheckin Terraform-provider, uptimecheck-com/uptimecheck Terraform Registryssä, hallitsee valvontakohteita, projekteja, hälytyskanavia ja tilasivuja koodina. Se käyttää REST APIa API-avaimella.

Luo API-avain

  1. Avaa sivupalkista Asetukset ja valitse välilehti API.
  2. Valitse Uusi API-avain, nimeä se käyttöpaikan mukaan, esimerkiksi ”Terraform”, ja valitse Luku ja kirjoitus. Provider luo ja muuttaa asioita, joten vain luku -avain ei riitä.
  3. Valitse Luo avain ja kopioi se. Avain näytetään vain tämän kerran.

Lisää provider

Lisää provider konfiguraatioosi:

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

provider "uptimecheck" {}

Aja terraform init, joka lataa providerin Terraform Registrystä. Laita sitten avain ympäristömuuttujaan UPTIMECHECK_API_KEY, esimerkiksi komennolla export UPTIMECHECK_API_KEY=uc_your_api_key, tai salaisuudeksi CI-järjestelmääsi. Provider hyväksyy myös argumentin api_key, mutta ympäristömuuttuja pitää avaimen poissa tiedostoistasi.

Lisää valvontakohde

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 on jokin seuraavista: http, tcp, ping, dns, domain, heartbeat, server, vendor, crawl tai flow. Sen muuttaminen korvaa valvontakohteen.
  • config sisältää tyypin asetukset JSON-muodossa, samoilla avaimilla kuin API-viitteessä. Vain kirjoittamiasi avaimia hallitaan, joten sovelluksen oletusarvot muille eivät näy muutoksina.
  • interval_seconds on tarkistusväli, 60–3600 sekuntia (30 paketissa, joka sen sallii), tai 300, jos jätät sen pois.
  • channel_ids valitsee hälytyskanavat, project_id projektin, ja paused = true keskeyttää valvontakohteen.

Aja terraform plan nähdäksesi, mikä muuttuu, ja sitten terraform apply. Valvontakohde näkyy sovelluksessa heti.

Cron-työ ja sen ping-osoite

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-osoite on kentässä heartbeat_url, joka on merkitty arkaluonteiseksi. Lue se komennolla terraform output -raw backup_ping_url ja lisää se työhön.

Projektit, hälytyskanavat ja tilasivut

  • uptimecheck_project: projekti, esimerkiksi asiakas, jolla on name ja color. Kun se poistetaan, sen valvontakohteet ja tilasivut jäävät ilman projektia; sen asiakasraportit ja asiakaskäyttöoikeudet poistetaan sen mukana.
  • uptimecheck_alert_channel: sähköposti, Slack saapuvan webhookin kautta, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover ja webhookit. Osoite tai avain annetaan kentässä config, jota API ei koskaan palauta, joten sovelluksessa tehtyä muutosta ei tulkita poikkeamaksi. delay_minutes (5, 10, 15, 30 tai 60) tekee kanavasta eskalointivaiheen. Webhookin allekirjoitussalaisuus on kentässä webhook_secret, ja se palautetaan vain kanavaa luotaessa.
  • uptimecheck_status_page: tilasivu otsikkoineen, ulkoasuineen ja components-luetteloineen, eli vierailijoille näkyvät valvontakohteet järjestyksessä ja halutessasi ryhmiteltyinä. Sen salasana, sähköpostipääsylista ja oma CSS asetetaan sovelluksessa, eikä niihin kosketa. Sivun poistaminen poistaa sen tilaajat, kirjoitetut päivitykset ja kävijätilastot.
  • Tietolähteet uptimecheck_alert_channels, uptimecheck_projects ja uptimecheck_status_pages listaavat olemassa olevat. Käytä ensimmäistä SMS-, Telegram-, push- ja Add to Slack -kanaville, jotka otetaan käyttöön sovelluksessa.

Tuo olemassa olevat

Sovelluksessa luodut valvontakohteet, projektit, hälytyskanavat ja tilasivut voi tuoda niiden tunnisteella:

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

Tuodun hälytyskanavan osoitetta ja webhookin allekirjoitussalaisuutta ei lueta takaisin. Jokainen resurssi ja attribuutti on dokumentoitu: Terraform Registry. Lisää Terraform-integraatiosta, API-avaimista ja REST APIsta.

Oliko tästä artikkelista apua?

Kokeile omassa työtilassasi

14 päivän ilmainen kokeilu · Sen jälkeen ilmainen 20 valvontakohteelle · Ei luottokorttia

Yhä jumissa?

Lähetä sähköpostia osoitteeseen support@uptimecheck.com, niin vastaamme 24 tunnin kuluessa.

Automatisoitko? API-referenssi kattaa REST API:n, webhookit, cron-ajojen pingit ja MCP:n.