Docker überwachen

Der Sensor unterstützt die folgenden Versionen von „ Docker “:

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

Die folgende Tabelle zeigt die aktuell unterstützte Version und die Support-Richtlinien:

Weitere Informationen zur Support-Richtlinie finden Sie unter „Support-Strategie für Sensoren “.

Mithilfe der Docker Engine-API werden die Leistungsmessdaten vom Endpunkt /containers/{id}/stats zurückgegeben.

Für jeden Sensor gibt es eine kuratierte Wissensdatenbank für Signaturen für den Allgemeinzustand, die kontinuierlich anhand der eingehenden Messdaten ausgewertet werden und die je nach Auswirkung auf den Benutzer Probleme oder Vorfälle auslösen können.

Integrierte Ereignisse lösen Probleme oder Vorfälle aus, wenn bei Entitäten Fehler-Signaturen festgestellt werden, während benutzerdefinierte Ereignisse Probleme oder Vorfälle auslösen, wenn die Schwellenwerte einer einzelnen Metrik einer bestimmten Entität überschritten werden.

Informationen zu den integrierten Ereignissen für den Docker -Sensor finden Sie unter Integrierte Ereignisreferenz.

Führen Sie die folgenden Schritte aus, um die Protokollierung zu aktivieren:

1. Erwerben Sie eine Erweiterung zur „ Instana “-Lizenz. Bevor Sie fortfahren, lesen Sie bitte die Informationen zu den Lizenz- und Berechtigungsanforderungen, um Ihre Lizenz zu überprüfen.

2. Aktivieren Sie die Protokollerfassung, indem Sie den Protokollsensor „ Docker “ in der Agent-Konfigurationsdatei wie im folgenden Beispiel gezeigt konfigurieren:

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

   Das folgende Beispiel zeigt die möglichen Konfigurationsoptionen mit ihren Standardwerten:

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

   In der folgenden Tabelle sind die Konfigurationsoptionen und ihre Beschreibungen aufgeführt:

   Konfigurationsoption	Beschreibung	Standardwert
   unixSocket	Der Pfad zum Socket des Daemons „ Docker “.	"/var/run/docker.sock"
   maxBufferSize	Die maximale Größe des internen Puffers in Byte. Hiermit wird festgelegt, wie viele Protokollmeldungsdaten während des Auslesens im Speicher des Sensors gespeichert werden können.	16777216
   minBatchSize	Die Mindestgröße eines an den Server zu übertragenden Nachrichtenstapels in Zeichen. Eine Nachrichtengruppe wird erst übertragen, wenn sie mindestens diese Größe erreicht hat (bis zuminBatchWithholdCount den Wiederholungsversuchen).	1024
   minBatchWithholdCount	Die Anzahl der Male, die ein Stapel wegen zu geringer Größe zurückgehalten werden kann, bevor er dennoch versendet wird. Wenn ein Protokollstapel kleiner als minBatchSize, ist, wird er nicht sofort gesendet. Auch wenn die Datenmenge geringer bleibt als minBatchSize,, wird sie letztendlich doch gesendet, sobald die Anzahl der Versuche diesen Wert überschreitet.	2
   sendInterval	Die Wartezeit zwischen den Versuchen, einen Protokollstapel zu senden, in Sekunden.	1
   socketTimeout	Die Dauer in Sekunden, nach der eine Socket-Verbindung als abgelaufen gilt.	600
   maxLineLength	Die maximale Länge einer Zeile im Protokoll, in Zeichen. Da diese Länge in Zeichen gemessen wird, hängt die tatsächliche Anzahl der verwendeten Bytes von der Kodierung ab.	16384

Nachdem Sie die Protokollsammlung aktiviert haben, können Sie die Protokolle in der Benutzeroberfläche von „ Instana “ einsehen. Weitere Informationen finden Sie unter „ Docker -Protokolle anzeigen “.

Um die Protokollierung von „ Docker “ wieder zu deaktivieren, wählen Sie eine der folgenden Optionen:

• Setzen Sie das enabled Flag in der false Agentenkonfigurationsdatei auf:

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

• Entfernen Sie den logs Abschnitt aus der Konfigurationsdatei des Agenten.

Die „ AutoTracing “-Funktionen des Agenten erfassen automatisch Trace-Protokolle von Anwendungen innerhalb von Containern. Wenn daher sowohl Trace-Protokolle als auch „ Docker “-Protokolle aktiviert sind, führt dies zu doppelten Protokollen. Um dieses Problem zu vermeiden, aktivieren Sie nur eine der beiden Optionen.

Anwendungsprotokoll-Traces haben den Vorteil, dass sie mit den Anwendungsprotokollen korreliert werden können, während dies bei „ Docker “-Protokollen nicht der Fall ist. Anwendungs-Traces erfassen jedoch nur Protokolle der ERROR Stufen WARNING und, während der Protokollsensor „ Docker “ den gesamten Protokollausgabestrom erfasst, einschließlich der Protokolle aller Stufen.

Der Log-Sensor „ Docker “ erfasst die Streams stdout und stderr aus den Containern von „ Docker “.