In Professional und Business verwaltet der Uptimecheck-Provider für Terraform, uptimecheck-com/uptimecheck in der Terraform Registry, Monitore, Projekte, Alarmkanäle und Statusseiten als Code. Er arbeitet über die REST API mit einem API-Schlüssel.
API-Schlüssel erstellen
- Öffnen Sie Einstellungen in der Seitenleiste und wählen Sie den Tab API.
- Wählen Sie Neuer API-Schlüssel, benennen Sie ihn nach seinem Einsatzort, etwa „Terraform“, und wählen Sie Lesen & Schreiben. Der Provider legt Dinge an und ändert sie, ein Nur-Lese-Schlüssel reicht also nicht.
- Wählen Sie Schlüssel erstellen und kopieren Sie ihn. Er wird nur dieses eine Mal angezeigt.
Provider einbinden
Fügen Sie den Provider Ihrer Konfiguration hinzu:
terraform {
required_providers {
uptimecheck = {
source = "uptimecheck-com/uptimecheck"
}
}
}
provider "uptimecheck" {}
Führen Sie terraform init aus; der Befehl lädt den Provider aus der Terraform Registry. Hinterlegen Sie den Schlüssel dann in der Umgebungsvariable UPTIMECHECK_API_KEY, etwa mit export UPTIMECHECK_API_KEY=uc_your_api_key, oder als Secret in Ihrem CI-System. Der Provider kennt auch ein Argument api_key, mit der Umgebungsvariable bleibt der Schlüssel aber aus Ihren Dateien heraus.
Monitor hinzufügen
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
})
}
typeist einer vonhttp,tcp,ping,dns,domain,heartbeat,server,vendor,crawlundflow. Eine Änderung ersetzt den Monitor.configenthält die Einstellungen des Typs als JSON, mit denselben Schlüsseln wie in der API-Referenz. Verwaltet werden nur die Schlüssel, die Sie schreiben, die Standardwerte der App für den Rest erscheinen also nicht als Änderungen.interval_secondslegt fest, wie oft geprüft wird: 60 bis 3600 Sekunden (30 in Tarifen, die das erlauben), ohne Angabe 300.channel_idswählt die Alarmkanäle,project_iddas Projekt, undpaused = truepausiert den Monitor.
Führen Sie terraform plan aus, um zu sehen, was sich ändert, dann terraform apply. Der Monitor erscheint sofort in der App.
Ein Cron-Job und seine 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
}
Die Ping-URL steht in heartbeat_url und ist als sensibel markiert. Lesen Sie sie mit terraform output -raw backup_ping_url aus und tragen Sie sie in den Job ein.
Projekte, Alarmkanäle und Statusseiten
uptimecheck_project: ein Projekt, etwa ein Kunde, mitnameundcolor. Wird es gelöscht, sind seine Monitore und Statusseiten keinem Projekt mehr zugeordnet; seine Kundenberichte und Kundenzugänge werden mitgelöscht.uptimecheck_alert_channel: E-Mail, Slack per Incoming Webhook, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover und Webhooks. Adresse oder Schlüssel stehen inconfig, das die API nie zurückgibt; eine Änderung in der App gilt daher nicht als Drift. Mitdelay_minutes(5, 10, 15, 30 oder 60) wird der Kanal zur Eskalationsstufe. Das Signatur-Secret eines Webhooks steht inwebhook_secretund wird nur beim Anlegen des Kanals zurückgegeben.uptimecheck_status_page: eine Statusseite mit Titel, Gestaltung undcomponents, den Monitoren, die Besucher sehen, in Reihenfolge und optional gruppiert. Passwort, E-Mail-Zugriffsliste und eigenes CSS legen Sie in der App fest, Terraform lässt sie unberührt. Beim Löschen werden ihre Abonnenten, geschriebenen Updates und Besucherstatistiken mitgelöscht.- Die Datenquellen
uptimecheck_alert_channels,uptimecheck_projectsunduptimecheck_status_pageslisten auf, was vorhanden ist. Nutzen Sie die erste für SMS-, Telegram-, Push- und Add-to-Slack-Kanäle, die in der App eingerichtet werden.
Bestehendes übernehmen
In der App angelegte Monitore, Projekte, Alarmkanäle und Statusseiten lassen sich über ihre ID importieren:
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_...
Bei einem importierten Alarmkanal werden Adresse und Signatur-Secret eines Webhooks nicht zurückgelesen. Jede Ressource und jedes Attribut ist in der Terraform Registry dokumentiert. Mehr zur Terraform-Integration, zu API-Schlüsseln und zur REST API.