Logstash- und Bluemix-Protokollcollectors
Liberty generiert verschiedene Ereignisse zur Laufzeit, wie z. B. Protokollereignisse, Traceereignisse, FFDC-Ereignisse (First-Failure Data Capture, Erfassung von Fehlerdaten beim ersten Auftreten), Zugriffsprotokollereignisse und Garbage-Collection-Ereignisse. Insbesondere wenn Sie viele Server verwalten oder Server auf verschiedenen Plattformen (z. B. auf dedizierter Hardware und in der Cloud) ausführen, ist es hilfreich, Ereignisse von allen Servern zu konsolidieren, sodass die Ereignisse gesucht, gefiltert und analysiert werden können. In Fällen, in denen Sie Liberty in Umgebungen ohne persistenten Dateispeicher für Problembestimmungsdaten verwenden, kann es außerdem hilfreich sein, Ereignisse in einem separaten Server zu speichern.
- Nachrichtenprotokollereignisse
- Traceprotokollereignisse
- HTTP-Zugriffsprotokollereignisse (vom Liberty-Server)
- FFDC-Protokollereignisse
- Garbage-Collection-Ereignisse (nur für IBM JDKs verfügbar)
Logstash-Collector
Das Feature "Logstash-Collector" ((logstashCollector-1.0 oder logstashCollector-1.1) sendet Ereignisse an einen Logstash-Server, den Sie bereitstellen.Logstash kann mit dem Elasticsearch-Suchserver und dem Kibana-Dashboard verwendet werden. Sie stellen alle diese Ressourcen bereit, konfigurieren sie und verwalten sie, um eine konsolidierte Ansicht der Protokolle oder anderer Ereignisse in Ihrem Unternehmen zu erhalten. Beachten Sie, dass bei der Verwendung des Logstash-Collectors zum Weiterleiten von Ereignissen keine separaten Prozesse oder Agenten auf der Liberty-Servermaschine konfiguriert werden müssen.

Ereignisstruktur
Die Collectors senden jedes Ereignis als Satz von Feldname/Feldwert-Paaren. Jeder Typ von Ereignis hat einen eigenen Satz von Feldern. Beim Erstellen eigener Kibana-Dashboards ist es hilfreich zu wissen, welche Felder die einzelnen Ereignisse haben.| Feldname in logstashCollector-1.0 | Feldname in logstashCollector-1.1/bluemixLogCollector-1.1 | Feldbeschreibung |
|---|---|---|
| type | type | Eine Zeichenfolge, die den Ereignistyp angibt. |
| datetime | was_datetime | Die Uhrzeit, zu der das Ereignis eingetreten ist. |
| hostName | host | Der Hostname des Servers, der die Quelle des Ereignisses ist. Weitere Informationen zu den Regeln zum Festlegen des Hostnamens finden Sie unter Logstash- und Bluemix-Protokollcollectors mit Liberty in Docker verwenden. |
| wlpUserDir | was_userDir | Das Benutzerverzeichnis des Servers, der die Quelle des Ereignisses ist, z. B. D:\wlp\usr. |
| serverName | was_serverName | Der Servername des Servers, der die Quelle des Ereignisses ist. Weitere Informationen zu den Regeln zum Festlegen des Servernamens finden Sie unter Logstash- und Bluemix-Protokollcollectors mit Liberty in Docker verwenden. |
| sequence | was_sequence | Die Folgenummer des Ereignisses (hilfreich beim Sortieren von Datensätzen mit derselben Zeitmarke). |
- Nachrichtenereignisse
Tabelle 2. Nachrichtenereignisse (type: "liberty_message") Feldname in logstashCollector-1.0 Feldname in logstashCollector-1.1/bluemixLogCollector-1.1 Feldbeschreibung severity Der Anzeiger für den Schweregrad (F = Fatal, E = Error, W = Warning, A = Audit, I = Info, O = SystemOut, R = SystemErr). loglevel Der Anzeiger für den Schweregrad (FATAL, ERROR, WARNING, AUDIT, INFO, CONFIG, DETAIL).
messageId was_messageId Die Nachrichten-ID in der Protokollzeile, die verwendet werden kann, um bestimmte Fehlertypen zu finden, z. B. s SRVE0250I. methodName was_methodName Der Methodenname aus dem Protokolldatensatz. className was_className Der Klassenname aus dem Protokolldatensatz. loggerName module Der Protokollname aus dem Protokolldatensatz. threadId was_threadId Die Thread-ID in der Protokollzeile, z. B. 00000015. Beachten Sie, dass die Thread-ID eine Zeichenfolge und keine Zahl ist. message message Die mit der Nachrichten-ID beginnende Nachricht aus dem Protokolldatensatz. - Traceereignisse
Tabelle 3. Traceereignisse (type: "liberty_trace") Feldname in logstashCollector-1.0 Feldname in logstashCollector-1.1/bluemixLogCollector-1.1 Feldbeschreibung severity Der Anzeiger für den Schweregrad (1 = Fine, 2 = Finer, 3 = Finest, > = Entry, < = Exit). loglevel Die Anzeige für den Schweregrad (FINE, FINER, FINEST, ENTRY, EXIT). methodName was_methodName Der Methodenname aus dem Protokolldatensatz. className was_className Der Klassenname aus dem Protokolldatensatz. loggerName module Der Protokollname aus dem Protokolldatensatz. threadId was_threadId Die Thread-ID in der Protokollzeile, z. B. 00000015. Beachten Sie, dass die Thread-ID eine Zeichenfolge und keine Zahl ist. message message Die Nachricht aus dem Protokolldatensatz. - HTTP-Zugriffsprotokollereignisse
Tabelle 4. HTTP-Zugriffsprotokollereignisse (type: "liberty_accesslog") Feldname in logstashCollector-1.0 Feldname in logstashCollector-1.1/bluemixLogCollector-1.1 Feldbeschreibung uriPath was_uriPath Die Pfadangabe für die angeforderte URL. Nicht enthalten sind die Abfrageparameter, z. B. /pushworksserver/ push/apps/tags. requestMethod was_requestMethod Das verwendete HTTP-Verb, z. B. GET. remoteHost was_remoteHost Die IP-Adresse des fernen Hosts, z. B. 127.0.0.1. userAgent was_userAgent Der userAgent-Wert in der Anforderung. requestProtocol was_requestProtocol Der Protokolltyp, z. B. HTTP/1.1. queryString was_queryString Die Zeichenfolge, die die Abfragezeichenfolge aus der HTTP-Anforderung darstellt, z. B. color=blue&size=large.
bytesReceived was_bytesReceived In der URL empfangene Byte, z. B. 94. responseCode was_responseCode Der HTTP-Antwortcode, z. B. 200. elapsedTime was_elapsedTime Die für die Bearbeitung der Anforderung benötigte Zeit in Mikrosekunden. requestHost was_requestHost Die IP-Adresse des Anforderungshosts, z. B. 127.0.0.1. requestPort was_requestPort Die Portnummer der Anforderung. - FFDC-Ereignisseevents
Tabelle 5. FFDC-Ereignisse (type: "liberty_ffdc":) Feldname in logstashCollector-1.0 Feldname in logstashCollector-1.1/bluemixLogCollector-1.1 Feldbeschreibung className was_className Die Klasse, die den FFDC-Eintrag ausgegeben hat. exceptionName was_exceptionName Die Ausnahme, die im FFD-Eintrag gemeldet wurde. probeID was_probeID Die eindeutige ID des FFDC-Punkts in der Klasse. stackTrace was_stackTrace Der Stack-Trace des FFDC-Vorfalls. objectDetails was_objectDetails Die Vorfalldetails für den FFDC-Vorfall. threadId was_threadId Die Thread-ID des FFDC-Vorfalls. - Garbage-Collection-Ereignisse
Tabelle 6. Garbage-Collection-Ereignisse (type: "liberty_gc":) Feldname in logstashCollector-1.0 Feldname in logstashCollector-1.1/bluemixLogCollector-1.1 Feldbeschreibung heap was_heap Der insgesamt verfügbare Heapspeicher. usedHeap was_usedHeap Der belegte Heapspeicher. duration was_duration Die Dauer der Garbage-Collection-Ausführung in Mikrosekunden. gcType was_gcType Der Typ des Garbage-Collection-Ereignisses (z. B. Nursery, Global etc.). reason was_reason Der Grund für die Garbage-Collection.
Logstash- und Bluemix-Protokollcollectors mit Liberty in Docker verwenden
Für die Ausführung von Liberty-Servern in Docker-Containern oder anderen virtualisierten Umgebungen werden host/hostName und serverName/was_serverName wie folgt definiert:
- Wert der Umgebungsvariablen CONTAINER_HOST
- Wert der Liberty-Konfigurationsvariablen ${defaultHostName}
- Vom JDK gemeldeter kanonischer Hostname
- Wert der Umgebungsvariablen CONTAINER_NAME
- Wert der Liberty-Konfigurationsvariablen ${wlp.server.name}
Bei der Ausführung von Liberty-Servern im Bluemix-Container-Service sind CONTAINER_HOST und CONTAINER_NAME bereits definiert.
Bei der Ausführung von Liberty-Servern in Liberty-Docker-Verbünden sind CONTAINER_HOST und CONTAINER_NAME bereits definiert.
docker run -d -e LICENSE=accept -e CONTAINER_NAME=Containername -e CONTAINER_HOST=Container-Host --name=Containername Imagename
Konzeptartikel