På Professional och Business hanterar Uptimechecks provider för Terraform, uptimecheck-com/uptimecheck i Terraform Registry, monitorer, projekt, larmkanaler och statussidor som kod. Den arbetar via REST API:et med en API-nyckel.
Skapa en API-nyckel
- Öppna Inställningar i sidomenyn och välj fliken API.
- Välj Ny API-nyckel, döp den efter var den används, till exempel ”Terraform”, och välj Läsa och skriva. Providern skapar och ändrar saker, så en nyckel som bara får läsa räcker inte.
- Välj Skapa nyckel och kopiera den. Det är enda gången nyckeln visas.
Lägg till providern
Lägg till providern i din konfiguration:
terraform {
required_providers {
uptimecheck = {
source = "uptimecheck-com/uptimecheck"
}
}
}
provider "uptimecheck" {}
Kör terraform init, som laddar ner providern från Terraform Registry. Lägg sedan nyckeln i miljövariabeln UPTIMECHECK_API_KEY, till exempel med export UPTIMECHECK_API_KEY=uc_your_api_key, eller som en hemlighet i ditt CI-system. Providern tar också argumentet api_key, men miljövariabeln håller nyckeln utanför dina filer.
Lägg till 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är en avhttp,tcp,ping,dns,domain,heartbeat,server,vendor,crawlochflow. Ändrar du den ersätts monitorn.configinnehåller typens inställningar som JSON, med samma nycklar som i API-referensen. Bara de nycklar du skriver hanteras, så appens standardvärden för resten syns inte som ändringar.interval_secondsanger hur ofta kontrollen körs, från 60 till 3600 sekunder (30 på en plan som tillåter det), och 300 om du utelämnar den.channel_idsväljer larmkanaler,project_idprojektet, ochpaused = truepausar monitorn.
Kör terraform plan för att se vad som ändras, och sedan terraform apply. Monitorn dyker upp i appen direkt.
Ett cron-jobb och dess 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 finns i heartbeat_url, markerad som känslig. Läs den med terraform output -raw backup_ping_url och lägg till den i jobbet.
Projekt, larmkanaler och statussidor
uptimecheck_project: ett projekt, till exempel en kund, mednameochcolor. Tar du bort det blir dess monitorer och statussidor utan projekt; dess kundrapporter och kundåtkomst tas bort tillsammans med det.uptimecheck_alert_channel: e-post, Slack via inkommande webhook, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover och webhooks. Adressen eller nyckeln läggs iconfig, som API:et aldrig returnerar, så en ändring i appen räknas inte som drift.delay_minutes(5, 10, 15, 30 eller 60) gör kanalen till ett eskaleringssteg. En webhooks signeringshemlighet finns iwebhook_secretoch returneras bara när kanalen skapas.uptimecheck_status_page: en statussida med titel, utseende ochcomponents, de monitorer besökarna ser, i ordning och om du vill grupperade. Lösenordet, listan över e-postadresser med åtkomst och egen CSS ställs in i appen och lämnas orörda. Tar du bort sidan försvinner dess prenumeranter, skrivna uppdateringar och besöksstatistik.- Datakällorna
uptimecheck_alert_channels,uptimecheck_projectsochuptimecheck_status_pageslistar det som finns. Använd den första för SMS-, Telegram-, push- och Add to Slack-kanaler, som ställs in i appen.
Ta in det du redan har
Monitorer, projekt, larmkanaler och statussidor som skapats i appen kan importeras med sitt 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 importerad larmkanals adress och en webhooks signeringshemlighet läses inte tillbaka. Varje resurs och attribut är dokumenterad i Terraform Registry. Läs mer om Terraform-integrationen, API-nycklar och REST API:et.