Intégration · Développeurs

Vos moniteurs en code avec Terraform

Gérez moniteurs, projets, canaux d’alerte et pages de statut dans Terraform, à côté de l’infrastructure qu’ils surveillent, et voyez chaque changement dans un plan avant qu’il soit appliqué.

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

Ce que vous obtenez

  • Tous les types de moniteurs

    Sites web et API, ports, ping, DNS, expiration de domaine, tâches cron, serveurs, services tiers, analyses de santé du site et parcours, chacun avec ses réglages en JSON, comme dans la référence API.

  • Un client dans une seule configuration

    Le projet d’un client, ses canaux d’alerte, ses moniteurs et une page de statut qui les affiche, créés ensemble et reliés par leur ID.

  • Seulement ce que vous écrivez

    Terraform gère les réglages de moniteur que vous écrivez. Les valeurs par défaut de l’app pour le reste n’apparaissent jamais comme des changements dans un plan.

  • Importer l’existant

    Placez sous Terraform les moniteurs, projets, canaux d’alerte et pages de statut créés dans l’app, avec terraform import et leur ID.

Comment connecter Terraform

  1. Créez une clé API dans Paramètres › API avec l’accès Lecture et écriture.

  2. Ajoutez uptimecheck-com/uptimecheck à required_providers et lancez terraform init.

  3. Placez la clé dans la variable d’environnement UPTIMECHECK_API_KEY, pour qu’elle reste hors de votre configuration.

  4. Ajoutez une ressource uptimecheck_monitor, lancez terraform plan puis terraform apply.

Les canaux SMS, Telegram, push et Add to Slack se configurent dans l’app ; lisez-les avec la source de données uptimecheck_alert_channels. Chaque ressource est documentée dans le Terraform Registry.

Sur Professional et Business, avec une clé API en lecture et écriture créée dans Paramètres › API.

Ce qu’il permet

  • uptimecheck_monitor
  • uptimecheck_project
  • uptimecheck_alert_channel
  • uptimecheck_status_page
  • uptimecheck_alert_channels
  • uptimecheck_projects
  • uptimecheck_status_pages

Les ressources en bleu sont créées et modifiées par Terraform ; les autres sont des sources de données qu’il lit.

main.tf

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

# The API key comes from UPTIMECHECK_API_KEY.
provider "uptimecheck" {}

resource "uptimecheck_monitor" "checkout" {
  type             = "http"
  name             = "Checkout"
  target           = "https://northwind.shop/checkout"
  interval_seconds = 60
  config = jsonencode({
    expectedStatus = "200-299"
    keyword        = { value = "Add to cart", mode = "contains" }
  })
}
Un bloc provider et un moniteur de site web. config reçoit les réglages du type de moniteur en JSON, avec les mêmes clés que l’API.

Questions

Où le provider Terraform est-il publié ?

Dans le Terraform Registry, sous uptimecheck-com/uptimecheck, avec des versions signées. Ajoutez-le à required_providers et terraform init le télécharge.

Que puis-je gérer avec ?

Des moniteurs de tous types, des projets, des canaux d’alerte et des pages de statut avec leurs composants. Des sources de données listent vos canaux d’alerte, projets et pages de statut.

Quels canaux d’alerte Terraform peut-il créer ?

E-mail, Slack par webhook entrant, Microsoft Teams, Discord, Google Chat, Mattermost, PagerDuty, ntfy, Pushover et webhooks. SMS, Telegram, push et Add to Slack se configurent dans l’app et se lisent avec la source de données uptimecheck_alert_channels.

Puis-je placer des moniteurs existants sous Terraform ?

Oui. Importez un moniteur avec terraform import et son ID, par exemple terraform import uptimecheck_monitor.checkout mon_…. Les projets, canaux d’alerte et pages de statut s’importent de la même façon.

Reste-t-il des réglages réservés à l’app ?

Le mot de passe d’une page de statut, sa liste d’accès par e-mail et son CSS personnalisé se règlent dans l’app, et Terraform n’y touche pas. Le secret de signature d’un canal webhook n’est renvoyé qu’une fois, quand Terraform crée le canal.

Quels forfaits l’incluent ?

Professional et Business, comme l’API REST. Le provider exige une clé API en lecture et écriture, idéalement placée dans la variable d’environnement UPTIMECHECK_API_KEY.

Apprenez-le par nous, pas par vos clients.

Explorez la démo en direct sans compte, ou lancez votre essai et ajoutez votre premier moniteur.

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