Envoi des métriques vers InfluxDB et Graphite

Avant de commencer la configuration dans Checkmk, vous devez obtenir les informations suivantes concernant le système cible InfluxDB que vous souhaitez connecter à Checkmk :

Pour plus de détails, consultez la documentation d'InfluxDB.

Une fois ces informations en main, la configuration dans Checkmk s'effectue en seulement deux opérations simples.

Ouvrez le menu Configuration et activez le mode Afficher plus — car ce n’est qu’alors que l’option de menu Setup > Exporter > InfluxDB connections sera affichée. Sélectionnez-la pour afficher la liste des connexions InfluxDB existantes. Comme vous n’avez probablement encore rien configuré ici, cette liste sera vide.

Une connexion est indispensable pour envoyer les données. Toutefois, sans règle permettant de sélectionner les informations de métriques, aucune donnée ne sera envoyée.

Commencez donc par créer une nouvelle connexion avec Add connection :

Dans l'General properties, vous spécifiez l'ID interne et le titre de la connexion, comme d'habitude.

Si d'autres sites sont connectés au site actuel, comme c'est le cas avec une surveillance distribuée, vous pouvez limiter la connexion à des sites spécifiques sous « Site restriction ». Pour ce faire, déplacez d'abord l'entrée « All sites » vers la colonne de gauche, puis déplacez les sites qui doivent recevoir des métriques de la colonne de gauche vers la colonne de droite « Selected ». Les sites qui ne recevront pas de métriques restent alors dans la colonne de gauche.

Nous poursuivons ensuite dans la case suivante avec l'InfluxDB Connection properties :

Saisissez ici le premier ensemble de valeurs de paramètres que vous avez compilées dans la section précédente.

Enregistrez la connexion en cliquant sur « Save » et vous reviendrez à la liste des connexions :

Dans la liste des connexions, la colonne « Enabled » affiche des informations importantes sur l'état de la connexion. Ne soyez pas surpris de voir trois entrées dans la liste de la capture d'écran ci-dessus : Afin de pouvoir voir tous les symboles en action, nous avons ajouté deux connexions supplémentaires à la liste. Dans la première colonne de « Enabled », vous pouvez voir si la connexion est activée () ou désactivée (). Dans la deuxième colonne, vous pouvez voir s'il existe déjà une règle pour la connexion () ou non ().

Aucune donnée ne sera transmise via une connexion tant qu’elle n’aura pas été associée à une règle sélectionnant les informations de métriques. Cette règle s’appelle « Send metrics to InfluxDB ». Les icônes de règle sont des boutons et constituent un raccourci vers la création de règles. Pour une connexion associée à une règle, cliquez sur « » afin d’ouvrir la page de présentation de l’ensemble des règles, qui met en évidence la règle qui s’applique ou s’appliquerait à la connexion. Pour une connexion sans règle, cliquer sur « » vous amène directement à la page de création de règles.

Dans le chapitre suivant, nous décrirons en détail ce qui peut être spécifié dans cette règle.

Une règle vous permet de déterminer dans Checkmk quelles données sont envoyées au serveur InfluxDB et où elles sont stockées.

L'ensemble de règles « Send metrics to InfluxDB » se trouve dans « Setup > Services > Service monitoring rules » ; vous pouvez y accéder plus rapidement via la recherche dans le menu « Setup », et encore plus rapidement en cliquant dans la liste des connexions :

Dans la boîte de dialogue « Send metrics to InfluxDB », sélectionnez d’abord la connexion créée dans la section précédente, puis spécifiez où les données seront stockées sur le serveur InfluxDB. Saisissez ici le deuxième ensemble d’informations collectées pour le serveur InfluxDB. Utilisez « Organization » pour déterminer quels utilisateurs reçoivent les données, et « Bucket » pour définir la durée de conservation des métriques. La sélection multiple n’est pas possible ; vous ne pouvez donc pas, par exemple, envoyer les métriques vers plusieurs buckets destinés à différentes organisations.

Ci-dessous, vous sélectionnez les données de métriques qui seront envoyées depuis Checkmk vers le serveur InfluxDB. L'option « Metrics of service» est déjà sélectionnée par défaut et permet l'envoi des métriques. Cochez la case « Service state » pour envoyer l'état du service en tant que métrique distincte.

Après avoir activé « Additional values per metric », vous pouvez ajouter un certain nombre de métadonnées aux métriques à des fins d’affichage, par exemple l’état du service (State of service) et l’adresse IP de l’hôte (Thresholds). Notez ici que l’option « Unit » ne fonctionne actuellement que pour les métriques issues de contrôles actifs, si ceux-ci la prennent en charge. La raison en est que seuls les contrôles actifs disposent d’une option permettant de fournir l’unité de mesure et que le CMC n’a pas accès aux autres.

Dans le dernier menu de sélection, « Tags to use », des métadonnées telles que des balises d’hôte ou des étiquettes sont ajoutées aux métriques ; celles-ci sont principalement utilisées pour le filtrage et ont été optimisées à cette fin. Les options « Host name » et « Service name » sélectionnées par défaut sont des entrées obligatoires qui ne peuvent pas être désélectionnées.

Dans InfluxDB, les Additional values per metric sont stockées sous forme de champs et les Tags to use sous forme de balises.

Enfin, validez les modifications pour créer la connexion et créer la ou les règles. En cas de problèmes avec la transmission des métriques, consultez les informations sur le diagnostic des erreurs ci-dessous.

Une fois que les métriques provenant de Checkmk sont arrivées sur le serveur InfluxDB, elles peuvent être affichées dans l'interface graphique d'InfluxDB. À titre d'exemple, l'image suivante montre le graphique de la métrique « total_used », qui indique la quantité de mémoire utilisée :

Remarque : cette métrique se trouve dans Checkmk, au niveau du service « Memory », sous la métrique intitulée « Total used memory ».

Dans Checkmk, sous « Setup > Services > Service monitoring rules », vous trouverez les deux ensembles de règles « Send host metrics to Graphite » et « Send service metrics to Graphite ». La configuration s’effectue de la même manière pour les métriques d’hôte et de service. Nous vous présentons ici la configuration pour les métriques de service. Vous configurez ensuite les métriques d’hôte de la même manière.

Vous pouvez utiliser la règle « Send service metrics to Graphite » pour sélectionner les valeurs à envoyer avec les métriques :

Deuxièmement, vous pouvez limiter l'envoi à certains hôtes et services dans la boîte de dialogue « Conditions ». Étant donné que sans règle restrictive, toutes les données seront envoyées, il est recommandé de créer d'abord une règle qui désactive l'envoi de manière globale en décochant toutes les cases indiquées dans la capture d'écran ci-dessus. Ensuite, créez une règle spécifique avec les informations de métrique souhaitées pour les hôtes et les services dont les métriques doivent être envoyées au serveur Graphite. Placez la règle spécifique avant la règle globale :

Vous configurez la connexion au serveur Graphite sous Setup > General > Global Settings > Monitoring Core > Send metrics to Graphite. Cliquez là-bas sur « Add new Graphite connection » :

Outre les informations évidentes relatives au serveur Graphite (le nom et le numéro de port pour le protocole Carbon en texte clair), vous pouvez également utiliser Optional variable prefix pour configurer un préfixe à ajouter à chaque nom d'hôte, par exemple pour imposer des noms uniques. Checkmk définit le chemin de métrique pour le protocole en texte clair sur <host>.<service>.<metric>.

Une activation des modifications apportées aux règles et à la connexion finalise la configuration de Graphite.

Dans l'interface graphique de Graphite, vous pouvez également consulter les métriques reçues de Checkmk. L'image suivante montre le graphique de la métrique total_used que nous avons déjà présentée ci-dessus à titre d'exemple dans l'interface graphique d'InfluxDB :