Zabbix de surveillance (version préliminaire publique)

Zabbix est un outil logiciel open source qui surveille l'infrastructure informatique, notamment les hôtes et les machines virtuelles. Pour afficher les hôtes surveillés par l' Zabbix, ainsi que leurs métriques et problèmes associés, dans l'interface utilisateur d' Instana, vous pouvez utiliser le capteur Zabbix pour Instana.

Une fois l'agent hôte d' Instana s installé, le capteur d' Zabbix s est automatiquement installé. Une fois le capteur configuré, vous pouvez consulter les métriques des hôtes surveillés par l' Zabbix -monitored dans l'interface utilisateur d' Instana. Pour plus d'informations sur la configuration, consultez la section « Configuration du capteur d' Zabbix ».

Informations complémentaires

Systèmes d'exploitation pris en charge

Les systèmes d'exploitation pris en charge par le capteur « Zabbix » correspondent aux exigences des agents hôtes, qui peuvent être consultées dans la section « Systèmes d'exploitation pris en charge » de chaque agent hôte, comme par exemple les systèmes d'exploitation pris en charge pour « Unix ».

Versions prises en charge

Instana prend en charge les métriques et les problèmes (importés dans Instana en tant qu'événements) pour Zabbix 6.4 et les versions ultérieures.

Configuration du capteur « Zabbix »

Pour vous connecter à l'instance d' Zabbix, vous devez configurer le capteur Instana Zabbix en utilisant le point de terminaison et la clé API. Vous devez configurer les zones suivantes dans le fichier de configuration d'agent <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.zabbix:
  enabled: true
  endpoint: 'http://zabbixhostname/zabbix/api_jsonrpc.php'
  token: 'redacted'
  poll_rate: 30

Le tableau suivant contient les options de configuration prises en charge:

Nom Type Obligatoire Par défaut Description
enabled booléen Non False Ce paramètre vérifie si le détecteur est activé.
endpoint chaîne Oui ND Le point de terminaison de votre serveur Zabbix : API.
token chaîne Oui ND Le jeton « API » utilisé pour accéder au point de terminaison.
poll_rate entier Non 30 Nombre de secondes entre les requêtes de métrique. Vous devrez peut-être ajuster le temps de prise en compte de toute limite de débit d'interrogation imposée par votre noeud final.
target_zone chaîne Non Non disponible Nom de la zone générique dans laquelle les hôtes surveillés par Zabbix s'affichent sur la carte de l'infrastructure d' Instana. Si la zone n'est pas spécifiée, les hôtes sont affichés dans Undefined Zone.
read_timeout entier Non 30 Le nombre de secondes pendant lesquelles le capteur attend qu'un serveur Zabbix réponde avant que le capteur ne termine la demande. Augmentez le temps pour éviter java.net.SocketTimeoutException fréquents dans le journal de votre agent lorsque vous êtes connecté à un serveur Zabbix .
connect_timeout entier Non 30 Le nombre de secondes pendant lesquelles le capteur attend pour établir une connexion avec un serveur Zabbix avant que le capteur ne mette fin à la connexion.

Zabbix point de terminaison

Le capteur Instana Zabbix utilise l' Zabbix API pour collecter des informations sur les hôtes surveillés par Zabbix. Le point de terminaison Zabbix API est nécessaire pour communiquer avec Zabbix. L'exemple suivant illustre le format du point de terminaison Zabbix API : https://<zabbix-hostname>/zabbix/api_jsonrpc.php

Vous devez inclure l'intégralité du point de terminaison, y compris le api_jsonrpc.php suffixe, dans le fichier configuration.yamlInstana.

Pour plus d'informations sur l' Zabbix API, consultez la documentation de l' Zabbix.

Affichage des mesures

Pour afficher les métriques, procédez comme suit:

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
  2. Cliquez sur un hôte surveillé spécifique.

Vous pouvez voir un tableau de bord d'hôte distant avec toutes les métriques collectées.

Données de configuration

  • Système d'exploitation (nom, version et architecture)
  • Nombre d'UC
  • Mémoire totale
  • Nom d'hôte et nom de domaine complet
  • Capacité de disque

Métriques de performance

  • % UC utilisée
  • Charge UC
  • Mémoire utilisée
  • Permutation utilisée (Linux uniquement)
  • Disque utilisé
  • Octets RX et TX du réseau

Problèmes d'affichage

Zabbix Les problèmes sont importés sur Instana sous forme de tickets. Pour afficher les problèmes, procédez comme suit:

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez Événements.
  2. Pour filtrer les événements qui ne sont pas des problèmes, cliquez sur l'onglet Problèmes .
  3. Pour filtrer les problèmes importés à partir de Zabbix, entrez la requête suivante dans la zone de recherche: entity.remote.host.source:Zabbix

Vous pouvez voir la liste des problèmes qui sont importés à partir de Zabbix. Un problème d' Zabbix, lorsqu'il est ouvert, génère un ticket d' Instana, qui reste ouvert jusqu'à ce que le problème d' Zabbix soit résolu. Lorsque le ticket Zabbix est clôturé, le ticket Instana est clôturé en quelques minutes.

Traitement des incidents

Problèmes liés à la surveillance des agents

Si le détecteur Zabbix ne peut pas communiquer avec le serveur Zabbix , un problème de surveillance de l'agent est créé. Le problème décrit le paramètre de configuration incorrect. Par exemple, le capteur reçoit une erreur 401 ou 403 « HTTP » de la part du serveur Zabbix lorsque le jeton API est incorrect ou a expiré. Les paramètres de configuration suivants entraînent des problèmes de surveillance de l'agent:

  • endpoint
  • token ( HTTP 401 ou 403)
  • poll_rate ( HTTP 429)

Agent OutOfMemoryError

Si vous êtes connecté à un serveur Zabbix qui surveille de nombreux hôtes, vous devrez peut-être augmenter la taille du tas JVM de l'agent Instana. Si vous constatez la présence d'un OutOfMemoryError dans le journal de l'agent, vous devez augmenter la taille maximale du tas de l'agent Instana. Pour plus d'informations sur la variable JAVA_OPTS d'environnement, consultez la section « Référence des variables d'environnement ».