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.

Liberty fournit désormais les fonctions du collecteur de journal Logstash et Bluemix pour vous aider à consolider les événements à distance. Les collecteurs capturent des événements à la volée, les scindent en zones et les acheminent en toute sécurité au serveur de collecte de journaux Logstash ou Bluemix configuré. Les collecteurs peuvent être configurés pour envoyer un ou plusieurs des types de données suivants :
  • 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.

Figure 1. Collecteur Logstash
Ce diagramme illustre le flot d'événements vers le serveur Elasticsearch via le pipeline d'événements Logstash.

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.
Remarque : La fonction logstashCollector-1.0 utilise des noms de zones différents que les fonctions logstashCollector-1.1 et bluemixLogCollector-1.1.
Les zones suivantes sont communes et présentes dans tous les événements :
Tableau 1. Types d'événements communs
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)
Outre les zones communes, chacun des types d'événement comporte également des zones uniques :
  • 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 :

La zone host/hostName reçoit la première valeur suivante disponible :
  • 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
La zone serverName/was_serverName reçoit la première valeur suivante disponible :
  • 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.

Si vous exécutez des serveurs Liberty dans des conteneurs Docker ou d'autres environnements virtuels que vous gérez, définissez les variables d'environnement CONTAINER_HOST et CONTAINER_NAME lorsque vous exécutez votre image. De la sorte, le collecteur de journal Logstash ou Bluemix balisera avec le nom d'hôte et de conteneur appropriés les enregistrements qu'il envoie, ce qui peut aider dans l'identification de problèmes. Si vous ne définissez pas ces variables d'environnement, il peut vous être difficile de déterminer quel conteneur a envoyé quels événements lors de l'utilisation d'un tableau de bord affichant les événements de plusieurs conteneurs. Lorsque vous démarrez un conteneur Docker, utilisez une commande similaire à ceci :
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

Icône indiquant le type de rubrique Rubrique de concept



Icône d'horodatage Dernière mise à jour: 7 juin 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=cwlp_analytics_collectors
Nom du fichier : cwlp_analytics_collectors.html