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
- Åbn Indstillinger i sidemenuen, og vælg fanen API.
- 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.
- 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
})
}
typeer en afhttp,tcp,ping,dns,domain,heartbeat,server,vendor,crawlogflow. Ændrer du den, erstattes monitoren.configindeholder 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_secondser, hvor ofte der tjekkes, fra 60 til 3600 sekunder (30 på en plan, der tillader det), og 300, hvis du udelader den.channel_idsvælger alarmkanalerne,project_idprojektet, ogpaused = truesæ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, mednameogcolor. 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 iconfig, 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 iwebhook_secretog returneres kun, når kanalen oprettes.uptimecheck_status_page: en statusside med titel, udseende ogcomponents, 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_projectsoguptimecheck_status_pagesviser, 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.