Skip to content
Gward

Conserver et grapher la valeur d'un check

Introduction

Section titled “Introduction”

Un check exécute un script et produit une valeur. Par défaut, cette valeur sert au verdict puis est oubliée. L’onglet Valeur conservée permet de la conserver, pour la consulter et la grapher dans le temps.

Le script reste le même, l’exécution reste la même : seule la conservation du résultat s’ajoute.

Deux natures de valeurs

Section titled “Deux natures de valeurs”

Le choix de la nature détermine comment la valeur est stockée et lue. Il ne se déduit pas du type de donnée.

Nature Ce qui compte Exemples
État La valeur actuelle, et depuis quand Version applicative, adresse IP, émetteur d’un certificat, nombre de cœurs
Métrique L’évolution Taux de remplissage, temps de réponse, nombre de connexions actives

Deux checks qui renvoient un nombre peuvent être de natures opposées : « nombre de cœurs CPU » est un état, « nombre de connexions actives » est une métrique.

Configurer la conservation

Section titled “Configurer la conservation”

Dans l’onglet Valeur conservée d’un check, activez Conservation de la valeur, puis renseignez :

Champ Rôle
Nature État ou Métrique
Type texte, nombre, pourcentage, booleen, ip, date, json. Une métrique exige un type numérisable.
Unité Libellé de l’axe des graphes : %, ms, GB, °C. Optionnel.
Historiser les changements Régime état uniquement : conserver ou non les valeurs passées.
Rétention (jours) Au-delà, les valeurs passées sont purgées.

Les pourcentages se lisent de 0 à 100. Un suffixe % renvoyé par le script est retiré automatiquement.

Relever une valeur sans seuil

Section titled “Relever une valeur sans seuil”

Tout check rend un verdict, y compris celui qui sert surtout à relever une valeur — une version applicative, une adresse IP. Pour ce cas, la condition de succès minimale est « la sortie n’est pas vide » :

Opérateur Valeur
matches \S

Le check est en succès tant que l’agent remonte quelque chose, et passe en échec si la sortie devient vide — ce qui signale en général que le script ne trouve plus ce qu’il cherche.

Lire les données

Section titled “Lire les données”

Les valeurs se consultent sur deux axes.

Depuis le check : la Visualisation

Section titled “Depuis le check : la Visualisation”

La page d’un check comporte deux parties : sa Configuration et sa Visualisation. La Visualisation montre, pour chaque agent ciblé, son verdict et — si le check conserve sa valeur — sa valeur actuelle.

En tête, une synthèse du parc :

  • le nombre d’agents par statut (ok, failing, error, jamais remonté). Cliquer sur un décompte filtre le tableau ;
  • les agents sans remontée récente, dont le dernier résultat date de plus de trois intervalles d’exécution ;
  • la distribution des valeurs : minimum, médiane, 95ᵉ centile et maximum pour une métrique ; pour une valeur texte (une version, une adresse IP), la répartition des valeurs les plus fréquentes.

Le tableau se trie par agent, statut, valeur ou fraîcheur, et se filtre par catégorie, par labels dynamiques ou par recherche. Cliquer sur une ligne ouvre la série de l’agent.

Depuis l’agent : l’onglet Valeurs

Section titled “Depuis l’agent : l’onglet Valeurs”

L’onglet Valeurs de la page d’un agent rassemble tous les checks conservés qui le ciblent : la valeur actuelle de chacun, depuis quand elle vaut ça, et son évolution sur la période choisie.

Séries et graphes

Section titled “Séries et graphes”

La série d’un check sur un agent s’ouvre depuis l’une ou l’autre de ces vues. La période est ajustable, de l’heure au mois.

Le rendu suit la nature :

  • une métrique se trace en courbe. Sur les longues périodes, les points sont regroupés et le graphe affiche le minimum, la moyenne et le maximum de chaque intervalle — la moyenne seule masquerait les pics, qui sont souvent ce que l’on cherche ;
  • un état se trace en paliers. Chaque palier couvre la durée pendant laquelle la valeur a été observée, et un blanc sépare deux paliers : l’intervalle entre les deux n’a pas été mesuré, il n’est donc pas tracé comme une continuité.

Un état non numérisable — une version, une adresse IP — ne se graphe pas : la liste de ses changements successifs est affichée à la place.

Maîtriser le volume

Section titled “Maîtriser le volume”

Un check tourne vite. À dix secondes d’intervalle, c’est plus de huit mille points par jour et par agent.

  • La conservation est désactivée par défaut sur tout nouveau check.
  • La rétention est obligatoire dès qu’un historique est conservé.
  • En régime état, la déduplication fait qu’une valeur stable n’occupe qu’une seule ligne, quelle que soit la durée.
  • La valeur actuelle d’un état n’est jamais purgée, même au-delà de la rétention.

Pour aller plus loin

Section titled “Pour aller plus loin”