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
- Åpne Innstillinger i sidemenyen og velg fanen API.
- 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.
- 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
})
}
typeer en avhttp,tcp,ping,dns,domain,heartbeat,server,vendor,crawlogflow. Endrer du den, erstattes monitoren.configinneholder 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_secondser hvor ofte det sjekkes, fra 60 til 3600 sekunder (30 på en plan som tillater det), 300 hvis du utelater den.channel_idsvelger varslingskanalene,project_idprosjektet, ogpaused = truesetter 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, mednameogcolor. 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 iconfig, 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 iwebhook_secretog returneres bare når kanalen opprettes.uptimecheck_status_page: en statusside med tittel, utseende ogcomponents, 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_projectsoguptimecheck_status_pageslister 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.