Skip to content

Options d'un check

Cette page liste l’ensemble des paramètres disponibles lors de la création ou modification d’un check Gward. Le formulaire est organisé en onglets : Général, Schedule, Check, Alerte, Remédiation, Contexte, Agents et Intégrations.

Paramètre Type Description
name string Nom du check (minimum 2 caractères), affiché dans la plateforme
description string Description du check
enabled boolean Active ou désactive le check
platforms checkbox Plateformes cibles : linux, windows, macos (au moins une requise)
Paramètre Type Description
interval_seconds integer Intervalle d’exécution en secondes (minimum : 1)
jitter_seconds integer Délai aléatoire ajouté à chaque exécution pour éviter les pics de charge (≥ 0)
cron string Expression cron optionnelle (ex: 0 * * * *). Alternative ou complément à interval_seconds
Paramètre Type Description
type string Type de check — actuellement command uniquement
timeout_seconds integer Durée maximale d’exécution du script avant échec forcé (≥ 1)
script string Script exécuté localement sur l’agent

Le champ success_if définit la condition qui détermine si le check est en succès.

Opérateur Exemple Description
== stdout == "0" Égalité stricte
!= stdout != "error" Différence
contains stdout contains "OK" La sortie contient la valeur
not_contains stdout not_contains "FAIL" La sortie ne contient pas la valeur
> stdout > "0" Supérieur à (numérique)
< stdout < "100" Inférieur à (numérique)

L’alerting s’active via le toggle Alerte. Une fois activé, les champs suivants sont disponibles :

Paramètre Type Description
alert.enabled boolean Active ou désactive l’alerting pour ce check
alert.condition.operator string Opérateur de déclenchement de l’alerte (mêmes opérateurs que success_if)
alert.condition.value string Valeur seuil de déclenchement
alert.severity enum Criticité de l’alerte : info, low, medium, high, critical
alert.message string Message descriptif de l’alerte (requis si alerting activé)
alert.failure_threshold integer Nombre d’échecs consécutifs avant ouverture de l’alerte (≥ 1, par défaut : 1)

L’auto-remédiation s’active via le toggle Remédiation. Une fois activée :

Paramètre Type Description
remediation.condition.operator string Condition de déclenchement de la remédiation
remediation.condition.value string Valeur seuil de déclenchement
remediation.max_attempts integer Nombre maximum de tentatives de remédiation
steps[].name string Nom de l’étape
steps[].script string Script exécuté lors de l’étape
steps[].timeout_seconds integer Timeout de l’étape (≥ 1)
steps[].on_failure enum Comportement en cas d’échec : continue ou stop

L’onglet Contexte permet d’ajouter des scripts complémentaires exécutés au moment d’un impact. Leur résultat est capturé et conservé pour faciliter le diagnostic.

Chaque entrée de contexte contient :

Champ Description
label Nom de l’entrée (ex: État du service, Logs nginx)
script Script exécuté pour capturer les informations (ex: systemctl is-active nginx)

La sélection des agents cibles se fait via une grille de cartes. Chaque agent peut être sélectionné/désélectionné individuellement. Des fonctions de recherche par nom et de filtre par catégorie sont disponibles. Il est également possible de tout sélectionner ou de désélectionner tous les agents en une action.

Paramètre Type Description
webhookTeamsLink URL Webhook Microsoft Teams (optionnel). Envoie une notification lors de la création d’une alerte, de l’ajout d’un agent impacté ou de la résolution d’un impact