Su Professional e Business, il provider di Uptimecheck per Terraform, uptimecheck-com/uptimecheck nel Terraform Registry, gestisce monitor, progetti, canali di avviso e pagine di stato come codice. Funziona tramite la REST API con una chiave API.
Crea una chiave API
- Apri Impostazioni nella barra laterale e scegli la scheda API.
- Scegli Nuova chiave API, dalle un nome in base a dove la usi, per esempio “Terraform”, e scegli Lettura e scrittura. Il provider crea e modifica risorse, quindi una chiave in sola lettura non basta.
- Scegli Crea chiave e copiala. È l’unica volta in cui la chiave viene mostrata.
Aggiungi il provider
Aggiungi il provider alla tua configurazione:
terraform {
required_providers {
uptimecheck = {
source = "uptimecheck-com/uptimecheck"
}
}
}
provider "uptimecheck" {}
Esegui terraform init, che scarica il provider dal Terraform Registry. Poi metti la chiave nella variabile d’ambiente UPTIMECHECK_API_KEY, per esempio con export UPTIMECHECK_API_KEY=uc_your_api_key, oppure come secret nel tuo sistema di CI. Il provider accetta anche un argomento api_key, ma la variabile d’ambiente tiene la chiave fuori dai tuoi file.
Aggiungi un 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è uno trahttp,tcp,ping,dns,domain,heartbeat,server,vendor,crawleflow. Se lo cambi, il monitor viene sostituito.configcontiene le impostazioni del tipo in JSON, con le stesse chiavi della documentazione API. Vengono gestite solo le chiavi che scrivi, quindi i valori predefiniti dell’app per il resto non compaiono come modifiche.interval_secondsindica ogni quanto controllare, da 60 a 3600 secondi (30 su un piano che lo consente); se lo ometti, 300.channel_idssceglie i canali di avviso,project_idil progetto, epaused = truemette in pausa il monitor.
Esegui terraform plan per vedere cosa cambierà, poi terraform apply. Il monitor compare subito nell’app.
Un cron job e il suo URL di ping
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
}
L’URL di ping è in heartbeat_url, contrassegnato come sensibile. Leggilo con terraform output -raw backup_ping_url e aggiungilo al job.
Progetti, canali di avviso e pagine di stato
uptimecheck_project: un progetto, per esempio un cliente, con unnamee uncolor. Se lo elimini, i suoi monitor e le sue pagine di stato restano senza progetto; i report cliente e l’accesso dei clienti vengono eliminati con lui.uptimecheck_alert_channel: email, Slack tramite incoming webhook, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover e webhook. L’indirizzo o la chiave vanno inconfig, che l’API non restituisce mai, quindi una modifica fatta nell’app non viene vista come drift.delay_minutes(5, 10, 15, 30 o 60) lo trasforma in un passo di escalation. Il secret di firma di un webhook è inwebhook_secrete viene restituito solo quando il canale viene creato.uptimecheck_status_page: una pagina di stato con titolo, aspetto ecomponents, i monitor che vedono i visitatori, in ordine ed eventualmente raggruppati. La password, la lista di accesso via email e il CSS personalizzato si impostano nell’app e non vengono toccati. Se la elimini, vengono eliminati anche i suoi iscritti, gli aggiornamenti scritti e le statistiche delle visite.- I data source
uptimecheck_alert_channels,uptimecheck_projectseuptimecheck_status_pageselencano ciò che esiste. Usa il primo per i canali SMS, Telegram, push e Add to Slack, che si configurano nell’app.
Porta dentro ciò che hai già
Monitor, progetti, canali di avviso e pagine di stato creati nell’app si possono importare tramite il loro 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_...
L’indirizzo di un canale di avviso importato e il secret di firma di un webhook non vengono riletti. Ogni risorsa e attributo è documentato nel Terraform Registry. Scopri di più sull’integrazione con Terraform, sulle chiavi API e sulla REST API.