Aller au contenu
Docs

Variables

Sur cette page
  1. Créer une variable
  2. Utiliser une variable dans une sonde
  3. Quand une variable est manquante
  4. Variables ou secrets ?

Une variable est une valeur en clair stockée dans un environnement et réutilisée dans les champs des sondes sous la forme ${NAME} : un hôte, un port, une URL de base. Modifiez la valeur une fois, et chaque sonde qui l'utilise prend la nouvelle valeur à son prochain contrôle. Donnez à la même variable une valeur différente par environnement, et la même configuration de sonde fonctionne partout.

Les variables exigent une offre payante et sont gérées par les rôles Manager et Admin.

Créer une variable#

  1. Ouvrez Configuration → Environments et sélectionnez l'environnement.
  2. Dans la carte Variables, cliquez sur New variable.
  3. Saisissez une Key — lettres majuscules, chiffres et tirets bas uniquement, par exemple API_HOST — et une Value — api.corvane.example.
  4. Enregistrez.

Une clé est unique au sein d'un environnement ; la même clé dans un autre environnement est une variable distincte.

Variables de l'environnement Production : API_HOST vaut api.corvane.example, PG_PRIMARY 10.20.1.21 et WEB_HOST www.corvane.example, avec un bouton New variable.
Les variables sont des valeurs en clair, utilisées dans les champs des sondes sous la forme ${KEY}.

Utiliser une variable dans une sonde#

Écrivez ${KEY} dans un champ pris en charge :

Sonde Champs
HTTP, Keyword, JSON, XML URL, nom d'utilisateur et mot de passe Basic, jeton Bearer, noms et valeurs d'en-têtes
Ping, Port, Domain, Certificate Hôte
Base de données SQL Requête
Stockage clé-valeur Nom de clé, champ
File de messages en erreur (dead-letter queue) Nom de la file
Somme de contrôle de fichier Chemin du fichier

Plusieurs variables peuvent être combinées : https://${API_HOST}:${API_PORT}/health. Le corps de requête des sondes HTTP n'accepte pas les variables.

Les variables sont remplacées lors de la préparation du contrôle, juste avant son envoi à l'agent ; l'agent reçoit la valeur finale. Enregistrer une sonde qui utilise une variable exige le rôle Manager.

Quand une variable est manquante#

Si une sonde utilise une variable qui n'existe pas dans son environnement, le contrôle est ignoré : aucun résultat, aucun incident. La sonde s'affiche alors comme Not checked. Vérifiez la clé et l'environnement de la sonde.

Variables ou secrets ?#

Variables Secrets
Pour Hôtes, ports, URL, noms Chaînes de connexion et identifiants
Stockage En clair Chiffré
Affichage Toujours Jamais, après enregistrement
Utilisation ${KEY} dans les champs texte Sélecteur Secret des sondes SQL, Key-value et Dead-letter queue

Ne stockez pas de mots de passe ni de jetons dans des variables : ils sont visibles par toute personne pouvant ouvrir l'environnement.