Come gestire Uptimecheck con Terraform

Aggiornato il 15 novembre 2026 3 min di lettura

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

  1. Apri Impostazioni nella barra laterale e scegli la scheda API.
  2. 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.
  3. 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 tra http, tcp, ping, dns, domain, heartbeat, server, vendor, crawl e flow. Se lo cambi, il monitor viene sostituito.
  • config contiene 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_seconds indica ogni quanto controllare, da 60 a 3600 secondi (30 su un piano che lo consente); se lo ometti, 300.
  • channel_ids sceglie i canali di avviso, project_id il progetto, e paused = true mette 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 un name e un color. 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 in config, 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 è in webhook_secret e viene restituito solo quando il canale viene creato.
  • uptimecheck_status_page: una pagina di stato con titolo, aspetto e components, 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_projects e uptimecheck_status_pages elencano 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.

Questo articolo ti è stato utile?

Provalo nel tuo workspace

Prova gratuita di 14 giorni · Poi gratis con 20 monitor · Nessuna carta di credito

Ancora bloccato?

Scrivi a support@uptimecheck.com e ti risponderemo entro 24 ore.

Vuoi automatizzare? La Riferimento API copre API REST, webhook, ping dei cron job e MCP.