Utilisation du collecteur Logstash version 1.0

Utilisez la fonction Collecteur Logstash de Liberty pour collecter des journaux et d'autres événements à partir de vos serveurs Liberty et les envoyer vers un serveur Logstash distant. Les événements collectés peuvent être utilisés pour l'analyse des journaux et le traitement des incidents.

Procédure

  1. Configurez Logstash V2.x en suivant les instructions fournies par Elasticsearch.
  2. Créez ou procurez-vous des fichiers de certificat et de paire de clés SSL pour Logstash. L'exemple ci-après illustre la commande pour openSSL permettant de générer un certificat et une paire de clés. Indiquez, en nombre de jours et selon vos besoins, la durée de validité des clés.
    openssl req -x509 -newkey rsa:1024 -keyout logstash.key -out logstash.crt -days 365 -nodes
  3. Pour les utilisateurs Logstash V2.x et Elasticsearch, copiez l'exemple dans un fichier liberty_logstash_template.json. Voir l'exemple de modèle d'index logstash. Personnalisez les valeurs par défaut _ttl selon vos besoins afin d'indiquer, en millisecondes, la durée de conservation des enregistrements de chaque type d'événement.
  4. Pour les utilisateurs Logstash V2.x et Elasticsearch, copiez l'exemple dans un fichier liberty_logstash.conf. Voir l'exemple de filtre logstash. Personnalisez le chemin ssl_certificate, le chemin ssl_key et le numéro de port lumberjack selon vos besoins. Personnalisez les hôtes et le chemin de modèle Elasticsearch selon vos besoins.
  5. Procédez comme suit pour chacun des serveurs Liberty à partir desquels vous souhaitez collecter des événements :
    1. Procurez-vous ou créez un fichier de clés pour le serveur Liberty. Pour créer un certificat autosigné, utilisez la commande ci-après. Personnalisez le nom de serveur, le mot de passe et l'objet selon vos besoins.
      d:\wlp\bin\securityUtility createSSLCertificate --server=myServerName --password="Liberty" --subject=CN=myHostname,OU=defaultServer,O=ibm,C=us
    2. Importez le fichier logstash.crt de l'étape 2 dans le fichier trust.jks de votre serveur. Personnalisez le rép_install_wlp et le nom de serveur selon vos besoins. Lorsque vous êtes invité à entrer un mot de passe, utilisez le mot de passe de certificat de l'étape 5a.
      d:\java\bin\keytool -import -noprompt -alias logstash -file logstash.crt -keystore wlp_install_dir\usr\servers\myServerName\resources\security\trust.jks -storepass Liberty
    3. Configurez le collecteur Logstash dans le fichier server.xml de Liberty en ajoutant le contenu ci-après. Personnalisez la liste de sources, le nom d'hôte et le port logstashCollector selon vos besoins.
      <featureManager>
          <feature>logstashCollector-1.0</feature>
      </featureManager>
      
      <keyStore id="defaultKeyStore" password="Liberty" />
      <keyStore id="defaultTrustStore" location=”trust.jks” password="Liberty" />
      <ssl id="mySSLConfig" trustStoreRef="defaultTrustStore" keyStoreRef="defaultKeyStore" />
      
      <logstashCollector 
      	source="message,trace,garbageCollection,ffdc,accessLog" 
      	hostName="localhost" 
      	port="5043" 
      	sslRef="mySSLConfig"
      />
      Remarque : Les journaux de trace et d'accès sont généralement volumineux et nécessitent davantage de réseau, d'unité centrale et de ressources de stockage pour la collecte.
  6. Pour les utilisateurs Elasticsearch et Kibana V4.x, importez le tableau de bord Kibana comme suit :
    1. Sauvegardez l'objet JSON de tableau de bord Kibana dans un fichier sur votre système de fichiers local. Voir l'exemple de tableau de bord Kibana pour les utilisateurs Elasticsearch et Kibana V4.x.
    2. Dans Kibana, configurez le modèle d'index en cliquant sur Paramètres > Index. Sélectionnez le nom d'index comme logstash-* et le nom de la zone d'heure comme datetime.
    3. Cliquez sur Paramètres > Objets > Importer pour importer le tableau de bord dans Kibana. A l'invite, indiquez le chemin d'accès au fichier que vous avez sauvegardé à l'étape précédente.
  7. Sauvegardez le tableau de bord à l'aide de l'icône de sauvegarde (disque). Entrez "Liberty" dans la zone de texte fournie et cliquez sur l'icône de sauvegarde située en regard de la zone de texte. Lors de votre prochain accès à Kibana à partir d'un navigateur, vous pourrez recharger ce tableau de bord en utilisant l'icône de chargement et en cliquant sur Liberty.

Résultats

Vous avez configuré vos serveurs Liberty pour qu'ils envoient des événements à votre serveur Logstash et vous pouvez désormais afficher vos événements dans le tableau de bord Liberty à l'aide de Kibana.

Icône indiquant le type de rubrique Rubrique Tâche



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=twlp_analytics_logstash
Nom du fichier : twlp_analytics_logstash.html