Comment gérer Uptimecheck avec Terraform

Mis à jour le 15 novembre 2026 3 min de lecture

Sur Professional et Business, le provider Uptimecheck pour Terraform, uptimecheck-com/uptimecheck dans le Terraform Registry, gère moniteurs, projets, canaux d’alerte et pages de statut en code. Il passe par l’API REST avec une clé API.

Créer une clé API

  1. Ouvrez Paramètres dans la barre latérale et choisissez l’onglet API.
  2. Choisissez Nouvelle clé API, nommez-la d’après son usage, par exemple « Terraform », et choisissez Lecture et écriture. Le provider crée et modifie des éléments, une clé en lecture seule ne suffit donc pas.
  3. Choisissez Créer la clé et copiez-la. C’est la seule fois où la clé s’affiche.

Ajouter le provider

Ajoutez le provider à votre configuration :

terraform {
  required_providers {
    uptimecheck = {
      source = "uptimecheck-com/uptimecheck"
    }
  }
}

provider "uptimecheck" {}

Lancez terraform init, qui télécharge le provider depuis le Terraform Registry. Placez ensuite la clé dans la variable d’environnement UPTIMECHECK_API_KEY, par exemple avec export UPTIMECHECK_API_KEY=uc_your_api_key, ou en secret dans votre système de CI. Le provider accepte aussi un argument api_key, mais la variable d’environnement garde la clé hors de vos fichiers.

Ajouter un moniteur

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 vaut http, tcp, ping, dns, domain, heartbeat, server, vendor, crawl ou flow. Le changer remplace le moniteur.
  • config contient les réglages du type en JSON, avec les mêmes clés que la référence API. Seules les clés que vous écrivez sont gérées : les valeurs par défaut de l’app pour le reste n’apparaissent pas comme des changements.
  • interval_seconds fixe la fréquence des vérifications, de 60 à 3600 secondes (30 sur un forfait qui le permet), 300 si vous l’omettez.
  • channel_ids choisit les canaux d’alerte, project_id le projet, et paused = true met le moniteur en pause.

Lancez terraform plan pour voir ce qui va changer, puis terraform apply. Le moniteur apparaît aussitôt dans l’app.

Une tâche cron et son URL de 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 de ping se trouve dans heartbeat_url, marquée comme sensible. Lisez-la avec terraform output -raw backup_ping_url et ajoutez-la à la tâche.

Projets, canaux d’alerte et pages de statut

  • uptimecheck_project : un projet, par exemple un client, avec un name et une color. Le supprimer laisse ses moniteurs et pages de statut sans projet ; ses rapports client et accès client sont supprimés avec lui.
  • uptimecheck_alert_channel : e-mail, Slack par webhook entrant, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover et webhooks. L’adresse ou la clé va dans config, que l’API ne renvoie jamais : une modification faite dans l’app n’est donc pas vue comme une dérive. delay_minutes (5, 10, 15, 30 ou 60) en fait une étape d’escalade. Le secret de signature d’un webhook se trouve dans webhook_secret, renvoyé uniquement à la création du canal.
  • uptimecheck_status_page : une page de statut avec son titre, son apparence et ses components, les moniteurs que voient les visiteurs, dans l’ordre et éventuellement regroupés. Son mot de passe, sa liste d’accès par e-mail et son CSS personnalisé se règlent dans l’app et restent intacts. La supprimer supprime ses abonnés, ses mises à jour publiées et ses statistiques de visite.
  • Les sources de données uptimecheck_alert_channels, uptimecheck_projects et uptimecheck_status_pages listent ce qui existe. Utilisez la première pour les canaux SMS, Telegram, push et Add to Slack, configurés dans l’app.

Reprendre l’existant

Les moniteurs, projets, canaux d’alerte et pages de statut créés dans l’app s’importent par leur 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’adresse d’un canal d’alerte importé et le secret de signature d’un webhook ne sont pas relus. Chaque ressource et chaque attribut sont documentés dans le Terraform Registry. Pour aller plus loin : l’intégration Terraform, les clés API et l’API REST.

Cet article vous a-t-il été utile ?

Essayez-le dans votre propre espace de travail

Essai gratuit de 14 jours · Puis gratuit jusqu’à 20 moniteurs · Sans carte bancaire

Toujours bloqué ?

Écrivez à support@uptimecheck.com et nous vous répondrons sous 24 heures.

Vous automatisez ? La Référence de l’API couvre l’API REST, les webhooks, les pings de tâches cron et le MCP.