Surveillance de Docker

Le capteur prend en charge les versions suivantes d' Docker :

• Docker 23.0
• Docker 25.0
• Docker 26.x
• Docker 27.x

Le tableau suivant présente la dernière version prise en charge et la politique d'assistance :

Pour plus d'informations sur la politique d'assistance, consultez la section « Stratégie d'assistance pour les capteurs ».

Si vous utilisez l'API Docker Engine, les métriques de performance sont renvoyées à partir du noeud final /containers/{id}/stats.

Pour chaque capteur, il existe une base de connaissances des signatures d'intégrité qui sont évaluées en permanence par rapport aux métriques entrantes et qui sont utilisées pour traiter les problèmes ou les incidents en fonction de l'impact sur l'utilisateur.

Les événements intégrés déclenchent des problèmes ou des incidents en fonction de signatures de santé défaillantes sur des entités, tandis que les événements personnalisés déclenchent des problèmes ou des incidents en fonction des seuils d'un indicateur spécifique à une entité donnée.

Pour plus d'informations sur les événements intégrés pour le détecteur Docker , voir la référence des événements intégrés.

Pour activer la collecte des journaux, procédez comme suit :

1. Procurez-vous une extension de la licence d' Instana. Avant de continuer, consultez la section « Conditions relatives à la licence et aux droits » pour vérifier votre licence.

2. Activez la collecte des journaux en configurant le capteur de journaux « Docker » dans le fichier de configuration de l'agent, comme indiqué dans l'exemple suivant :

   com.instana.plugin.docker:
     logs:
       enabled: true
    

   L'exemple suivant présente les options de configuration possibles ainsi que leurs valeurs par défaut :

   com.instana.plugin.docker:
     logs:
       enabled: true
     unixSocket: "/var/run/docker.sock"
     maxBufferSize: 16777216
     minBatchSize: 1024
     minBatchWithholdCount: 2
     sendInterval: 1
     socketTimeout: 600
     maxLineLength: 16384
    

   Le tableau suivant répertorie les options de configuration et leur description :

   Option de configuration	Description	Valeur par défaut
   unixSocket	Le chemin d'accès au socket du démon « Docker ».	"/var/run/docker.sock"
   maxBufferSize	La taille maximale du tampon interne, en octets. Ce paramètre détermine la quantité de données de messages de journal pouvant être stockée en mémoire dans le capteur pendant la lecture.	16777216
   minBatchSize	La taille minimale, en caractères, d'un lot de messages à transmettre au serveur. Un lot de messages n'est transmis que lorsqu'il atteint au moins cette taille (jusqu'auminBatchWithholdCount nombre maximal de tentatives).	1024
   minBatchWithholdCount	Le nombre de fois qu'un lot peut être mis en attente parce qu'il est trop petit avant d'être tout de même envoyé. Si un lot de journaux est plus petit qu' minBatchSize,, il n'est pas envoyé immédiatement. Même si la quantité de données reste inférieure à minBatchSize,, celle-ci finit par être envoyée lorsque le nombre de tentatives dépasse ce seuil.	2
   sendInterval	Intervalle, en secondes, à respecter entre deux tentatives d'envoi d'un lot de journaux.	1
   socketTimeout	Durée, en secondes, pendant laquelle le système attend avant de considérer la connexion socket comme expirée.	600
   maxLineLength	La longueur maximale d'une ligne dans le journal, en caractères. Comme cette longueur est mesurée en caractères, le nombre réel d'octets utilisés varie en fonction du codage.	16384

Une fois la collecte des journaux activée, vous pouvez consulter ces derniers dans l'interface utilisateur d' Instana. Pour plus d'informations, consultez la section « Affichage des journaux d' Docker ».

Pour désactiver à nouveau la journalisation d' Docker, utilisez l'une des options suivantes :

• Définissez le enabled paramètre sur false dans le fichier de configuration de l'agent :

  com.instana.plugin.docker:
    logs:
      enabled: false
   

• Supprimez la logs section du fichier de configuration de l'agent.

Les fonctions d' AutoTracing s de l'agent collectent automatiquement les journaux de traçage des applications hébergées dans des conteneurs; par conséquent, l'activation simultanée des journaux de traçage et des journaux d' Docker entraîne la création de journaux en double. Pour éviter ce problème, n'activez qu'une seule de ces options.

Les journaux de trace d'application ont l'avantage d'être corrélés aux traces d'application, contrairement aux journaux d' Docker. Mais les traces d'application ne collectent que les journaux ERROR de niveau WARNING et, tandis que le capteur de journaux « Docker » collecte l'intégralité du flux de sortie des journaux, y compris les journaux de tous les niveaux.

Le capteur de journaux « Docker » collecte les flux stdout et stderr provenant des conteneurs « Docker ».