Collecteurs de journal Logstash et Bluemix
Liberty génère différents événements lors de la phase d'exécution, par exemple, des événements de journal, des événements de trace, des événements de capture de données à la première défaillance (ffdc), des événements de journal d'accès et des événements de récupération de place. Il est utile de consolider les événements provenant de tous les serveurs de manière à pouvoir les rechercher, les filtrer et les analyser, surtout lorsque vous gérez plusieurs serveurs ou lorsque vous exécutez des serveurs sur différentes plateformes (par exemple, sur un matériel dédié dans le cloud). Il peut également s'avérer utile de stocker des événements sur un serveur distinct lorsque vous utilisez Liberty dans des environnements qui ne possèdent pas suffisamment d'espace de stockage de fichiers persistants pour les données de détermination de problèmes.
- Evénements du journal des messages
- Evénements du journal de trace
- Evénements du journal d'accès HTTP (depuis le serveur Liberty)
- Evénements du journal FFDC
- Evénements de récupération de place (disponibles uniquement pour les JDK IBM)
Collecteur Logstash
La fonction de collecteur Logstash (logstashCollector-1.0 ou logstashCollector-1.1) envoie des événements à un serveur Logstash que vous indiquez.Logstash peut être utilisé avec le serveur de recherche Elasticsearch et le tableau de bord Kibana, que vous indiquez, configurez et gérez, pour offrir une vue consolidée des journaux ou d'autres événements de tous les secteurs de l'entreprise. Notez qu'il n'y a aucun processus ou agent distinct à configurer sur le serveur Liberty lorsque le collecteur Logstash est utilisé pour réacheminer des événements.

Structure des événements
Les collecteurs envoient chaque événement sous la forme d'un ensemble de paires nom-valeur de zone. Chaque type d'événement possède son propre ensemble de zones. Connaître les zones que comporte chaque événement peut s'avérer utile lorsque vous créez vos propres tableaux de bord Kibana.| Nom de zone logstashCollector-1.0 | Nom de zone logstashCollector-1.1 / bluemixLogCollector-1.1 | Description de la zone |
|---|---|---|
| type | type | Chaîne identifiant le type de l'événement |
| datetime | was_datetime | Date/heure à laquelle s'est produit l'événement |
| hostName | host | Nom d'hôte du serveur source de l'événement Pour plus d'informations sur les règles en vigueur pour définir le nom d'hôte, voir Utilisation de collecteurs de journaux Logstash et Bluemix avec Liberty s'exécutant dans Docker |
| wlpUserDir | was_userDir | Répertoire utilisateur du serveur source de l'événement. Par exemple, D:\wlp\usr |
| serverName | was_serverName | Nom du serveur source de l'événement Pour plus d'informations sur les règles en vigueur pour définir le nom du serveur, voir Utilisation de collecteurs de journaux Logstash et Bluemix avec Liberty s'exécutant dans Docker |
| sequence | was_sequence | Numéro de séquence de l'événement (utile pour trier les enregistrements avec le même horodatage) |
- Evénements de message
Tableau 2. Evénements de message (type : "liberty_message":) Nom de zone logstashCollector-1.0 Nom de zone logstashCollector-1.1 / bluemixLogCollector-1.1 Description de la zone severity Indicateur de gravité (F = Fatal, E = Erreur, W = Avertissement, A = Audit, I = Info, O = SystemOut, R = SystemErr) loglevel Indicateur de gravité (FATAL, ERROR, WARNING, AUDIT, INFO, CONFIG, DETAIL)
messageId was_messageId ID de message sur la ligne du journal, peut être utilisé pour rechercher des types d'erreur spécifiques. Par exemple, SRVE0250I methodName was_methodName Nom de méthode dans l'enregistrement de journal className was_className Nom de classe dans l'enregistrement de journal loggerName module Nom du consignateur dans l'enregistrement de journal threadId was_threadId ID d'unité d'exécution sur la ligne de journal (par exemple, 00000015). Notez que l'ID unité d'exécution est une chaîne et non un chiffre. message message Message dans l'enregistrement de journal, débutant par l'ID du message. - Evénements de trace
Tableau 3. Evénements de trace (type : "liberty_trace":) Nom de zone logstashCollector-1.0 Nom de zone logstashCollector-1.1 / bluemixLogCollector-1.1 Description de la zone severity Indicateur de gravité (1 = Fine, 2 = Finer, 3 = Finest, > = Entry, < = Exit) loglevel Indicateur de gravité (FINE, FINER, FINEST, ENTRY, EXIT) methodName was_methodName Nom de méthode dans l'enregistrement de journal className was_className Nom de classe dans l'enregistrement de journal loggerName module Nom du consignateur dans l'enregistrement de journal threadId was_threadId ID d'unité d'exécution sur la ligne de journal (par exemple, 00000015). Notez que l'ID unité d'exécution est une chaîne et non un chiffre. message message Message dans l'enregistrement de journal - Evénements du journal d'accès HTTP
Tableau 4. Evénements du journal d'accès HTTP (type :"liberty_accesslog") Nom de zone logstashCollector-1.0 Nom de zone logstashCollector-1.1 / bluemixLogCollector-1.1 Description de la zone uriPath was_uriPath Informations de chemin de l'URL demandée. Ne contiennent PAS les paramètres de requête (par exemple, /pushworksserver/ push/apps/tags) requestMethod was_requestMethod Instruction HTTP utilisée (par exemple, GET) hôte distant was_remoteHost Adresse IP de l'hôte distant (par exemple, 127.0.0.1) userAgent was_userAgent Valeur d'userAgent dans la requête requestProtocol was_requestProtocol Type de protocole (par exemple, HTTP/1.1) queryString was_queryString Chaîne représentant la chaîne de requête dans la demande HTTP (par exemple, color=blue&size=large)
bytesReceived was_bytesReceived Octets reçus dans l'URL (par exemple, 94) responseCode was_responseCode Code de réponse HTTP (par exemple, 200) elapsedTime was_elapsedTime Temps écoulé pour traiter la demande (en microsecondes) requestHost was_requestHost Adresse IP de l'hôte de la demande (par exemple, 127.0.0.1) requestPort was_requestPort Numéro de port de la demande - Evénements FFDC
Tableau 5. Evénements FFDC (type : "liberty_ffdc":) Nom de zone logstashCollector-1.0 Nom de zone logstashCollector-1.1 / bluemixLogCollector-1.1 Description de la zone className was_className Classe ayant émis l'entrée FFDC exceptionName was_exceptionName Exception signalée dans l'entrée FFDC probeID was_probeID Identificateur unique du point FFDC dans la classe stackTrace was_stackTrace Trace de pile de l'incident FFDC objectDetails was_objectDetails Détails de l'incident FFDC threadId was_threadId ID d'unité d'exécution de l'incident FFDC - Evénements de récupération de place
Tableau 6. Evénements de récupération de place (type : "liberty_gc":) Nom de zone logstashCollector-1.0 Nom de zone logstashCollector-1.1 / bluemixLogCollector-1.1 Description de la zone heap was_heap Segment mémoire total disponible usedHeap was_usedHeap Volume de segment mémoire utilisé duration was_duration Durée de récupération de la place (en microsecondes) gcType was_gcType Type d'événement de récupération de place (par exemple : Nursery, Global, etc.) reason was_reason Motif de récupération de la place
Utilisation de collecteurs de journaux Logstash et Bluemix avec Liberty s'exécutant dans Docker
Pour les serveurs Liberty s'exécutant dans des conteneurs Docker ou d'autres environnements virtualisés, les éléments host/hostName et serverName/was_serverName sont définis comme suit :
- valeur de la variable d'environnement CONTAINER_HOST
- valeur de la variable de configuration Liberty ${defaultHostName}
- nom d'hôte canonique indiqué par le JDK
- valeur de la variable d'environnement CONTAINER_NAME
- valeur de la variable de configuration Liberty ${wlp.server.name}
Si vous exécutez des serveurs Liberty dans le service Bluemix Container Service, CONTAINER_HOST et CONTAINER_NAME sont déjà définis pour vous.
Si vous exécutez des serveurs Liberty dans Liberty Docker Collectives, CONTAINER_HOST et CONTAINER_NAME sont déjà définis pour vous.
docker run -d -e LICENSE=accept -e CONTAINER_NAME=nom_votre_conteneur -e
CONTAINER_HOST=hôte_de_votre_conteneur
--name=nom_de_votre_conteneur nom_votre_image
Rubrique de concept