Options de la commande BinaryLog

Utilisez la commande binaryLog pour afficher ou copier le contenu d'un référentiel de journalisation binaire ou répertorier les instances de processus serveur disponibles dans le référentiel. La commande binaryLog équivaut à la commande logViewer dans le répertoire bin du profil sur le serveur d'applications du profil complet.

La fonctionnalité de trace et de journalisation binaires écrit les données dans un référentiel au format binaire. Vous pouvez afficher, interroger et filtrer le référentiel avec la commande binaryLog. Cette commande fournit des options permettant de convertir rapidement le contenu d'un référentiel en fichiers texte de divers formats, notamment les formats de base et avancés. Elle fournit également des options permettant d'obtenir plus facilement les données des journaux ; par exemple, en autorisant de filtrer les enregistrements du journal par niveau, nom de la personne ayant procédé à l'enregistrement ou date et heure.

Syntaxe

La syntaxe de la commande est la suivante :

binaryLog action {nomServeur | cheminRéférentiel} [options]

La valeur des options est différente selon la valeur de l'action.

Paramètres

Les actions suivantes sont disponibles pour la commande binaryLog :

view
Lisez un référentiel, filtrez-le (en option) et créez une version que les utilisateurs peuvent lire.

La syntaxe de la commande est la suivante :

binaryLog view {nomServeur | cheminRéférentiel} [options]

nomServeur

Spécifiez le nom d'un serveur Liberty comportant un référentiel à lire.

cheminRéférentiel

Spécifiez le chemin d'accès à un référentiel à lire. En général, il s'agit du répertoire qui contient les répertoires logdata et tracedata.

Remarque : Si ni nomServeur ni cheminRéférentiel n'est spécifié sur la ligne de commande, la tâche est effectuée à nouveau dans l'instance de serveur par défaut, defaultServer, si elle existe.

Options du filtre :

Tous les filtres sont facultatifs. Lorsque plusieurs filtres sont utilisés, ils sont liés de façon logique avec l'opérateur AND.

  • --minDate=valeur

    Le filtre repose sur une date de création d'enregistrement minimale. La valeur doit être spécifiée sous forme de date (par exemple --minDate="2/20/13") ou sous forme de date et d'heure (par exemple --minDate="2/20/13 16:47:21:445 EST").

  • --maxDate=valeur

    Le filtre repose sur une date de création d'enregistrement maximale. La valeur doit être spécifiée sous forme de date (par exemple --maxDate="2/20/13") ou sous forme de date et d'heure (par exemple --maxDate="2/20/13 16:47:21:445 EST").

  • --minLevel=valeur

    Le filtre repose sur un niveau minimal. La valeur doit être l'une des suivantes : LE PLUS FIN | PLUS FIN | FIN | DETAIL | CONFIG | INFO | AUDIT | AVERTISSEMENT | GRAVE | CRITIQUE.

  • --maxLevel=valeur

    Le filtre repose sur un niveau maximal. La valeur doit être l'une des suivantes : LE PLUS FIN | PLUS FIN | FIN | DETAIL | CONFIG | INFO | AUDIT | AVERTISSEMENT | GRAVE | CRITIQUE.

  • --includeLogger=valeur[,valeur]*

    Incluez des enregistrements avec le nom de consignateur spécifié. La valeur peut inclure un caractère * ou ? comme caractère générique.

  • --includeMessage=valeur

    Le filtre repose sur un nom de message. La valeur peut inclure un caractère * ou ? comme caractère générique.

  • --includeThread=valeur

    Incluez des enregistrements avec l'ID d'unité d'exécution spécifié. Les valeurs doivent être hexadécimales (par exemple --includeThread=2a).

  • --includeExtension=nom=valeur[,nom=valeur]*

    Incluez des enregistrements avec le nom et la valeur de l'extension spécifiée. La valeur peut inclure un caractère * ou ? comme caractère générique. Pour inclure une virgule dans la valeur, vous devez utiliser "\,"

  • --includeInstance=valeur

    Incluez des enregistrements de l'instance de serveur spécifiée. La valeur doit être "latest" ou un ID d'instance valide. Exécutez cette commande avec l'action listInstances afin d'afficher la liste des ID d'instance valides.

Option de surveillance :
--monitor

Surveillez le référentiel constamment et affichez le nouveau contenu au fur et à mesure qu'il est généré.

Options de sortie :
  • --format={basic | advanced | CBE-1.0.1}

    Spécifiez le format de sortie à utiliser. "basic" est le format par défaut.

  • --encoding=valeur

    Spécifiez le codage de caractères à utiliser pour la sortie.

copy
Lisez un référentiel, filtrez-le (en option) et écrivez les contenus dans un nouveau référentiel.
La syntaxe de la commande est la suivante :
binaryLog copy {nomServeur | cheminRéférentiel} cheminCible [options]
nomServeur

Spécifiez le nom d'un serveur Liberty comportant un référentiel à lire.

cheminRéférentiel

Spécifiez le chemin d'accès à un référentiel à lire. En général, il s'agit du répertoire qui contient les répertoires logdata et tracedata.

cheminCible

Spécifiez le chemin dans lequel créer un référentiel. cheminCible doit être spécifié.

Remarque : nomServeur ou cheminRéférentiel doit être spécifié, ainsi que cheminCible.

Options du filtre :

Tous les filtres sont facultatifs. Lorsque plusieurs filtres sont utilisés, ils sont liés de façon logique avec l'opérateur AND.
  • --minDate=valeur

    Le filtre repose sur une date de création d'enregistrement minimale. La valeur doit être spécifiée sous forme de date (par exemple --minDate="2/20/13") ou sous forme de date et d'heure (par exemple --minDate="2/20/13 16:52:32:808 EST").

  • --maxDate=valeur

    Le filtre repose sur une date de création d'enregistrement maximale. La valeur doit être spécifiée sous forme de date (par exemple --maxDate="2/20/13") ou sous forme de date et d'heure (par exemple --maxDate="2/20/13 16:52:32:808 EST").

  • --minLevel=valeur

    Le filtre repose sur un niveau minimal. La valeur doit être l'une des suivantes : LE PLUS FIN | PLUS FIN | FIN | DETAIL | CONFIG | INFO | AUDIT | AVERTISSEMENT | GRAVE | CRITIQUE.

  • --maxLevel=valeur

    Le filtre repose sur un niveau maximal. La valeur doit être l'une des suivantes : LE PLUS FIN | PLUS FIN | FIN | DETAIL | CONFIG | INFO | AUDIT | AVERTISSEMENT | GRAVE | CRITIQUE.

  • --includeLogger=valeur[,valeur]*

    Incluez des enregistrements avec le nom de consignateur spécifié. La valeur peut inclure un caractère * ou ? comme caractère générique.

  • --excludeLogger=valeur[,valeur]*

    Excluez des enregistrements avec le nom de consignateur spécifié. La valeur peut inclure un caractère * ou ? comme caractère générique.

  • --includeMessage=valeur

    Le filtre repose sur un nom de message. La valeur peut inclure un caractère * ou ? comme caractère générique.

  • --includeThread=valeur

    Incluez des enregistrements avec l'ID d'unité d'exécution spécifié. Les valeurs doivent être hexadécimales (par exemple --includeThread=2a).

  • --includeExtension=nom=valeur[,nom=valeur]*

    Incluez des enregistrements avec le nom et la valeur de l'extension spécifiée. La valeur peut inclure un caractère * ou ? comme caractère générique. Pour inclure une virgule dans la valeur, vous devez utiliser "\,"

  • --includeInstance=valeur

    Incluez des enregistrements de l'instance de serveur spécifiée. La valeur doit être "latest" ou un ID d'instance valide. Exécutez cette commande avec l'action listInstances afin d'afficher la liste des ID d'instance valides.

listInstances
Répertoriez les ID des instances de serveur dans le référentiel. Une instance de serveur est une collection de tous les enregistrements de journal/trace écrits depuis le démarrage d'un serveur jusqu'à son arrêt. Les ID d'instance de serveur peuvent être utilisés avec l'option --includeInstance de l'action view de la commande binaryLog.
La syntaxe de la commande est la suivante :
binaryLog listInstances {nomServeur | cheminRéférentiel}
nomServeur

Spécifiez le nom d'un serveur Liberty comportant un référentiel à lire.

cheminRéférentiel

Spécifiez le chemin d'accès à un référentiel à lire. En général, il s'agit du répertoire qui contient les répertoires logdata et tracedata.

Remarque : Si ni nomServeur ni cheminRéférentiel n'est spécifié sur la ligne de commande, la tâche est effectuée à nouveau dans l'instance de serveur par défaut, defaultServer, si elle existe.
Prenez connaissance des optimisations offertes par le filtrage binaryLog. L'outil binaryLog filtre plus efficacement les données de journal et de trace lorsqu'il est utilisé avec les options de filtrage suivantes :
  • --minDate
  • --maxDate
  • --includeThread
  • --minLevel
  • --maxLevel

Exemple de syntaxe

Reportez-vous aux exemples de commande binaryLog ci-après.

  • Affichez tous les événements figurant dans le référentiel defaultServer et qui sont survenus entre le 19 juillet 2013 et le 2 août 2013.
    binaryLog view --minDate=07/19/13
    --maxDate=08/02/13 
  • Affichez les nouveaux événements du serveur myServer qui sont associés au niveau AVERTISSEMENT ou à un niveau supérieur, en utilisant le format avancé, au fur et à mesure que le serveur les écrit dans le référentiel de journal.
    binaryLog view myServer --monitor --minLevel=AVERTISSEMENT
    --format=advanced 
  • Ecrivez les messages de journal d'un référentiel qui se trouve dans /apps/server1/logs ; n'incluez que ceux qui ont été écrits dans le flux d'erreurs d'un référentiel spécifique.
    binaryLog
    view /apps/server1/logs --includeLogger=SystemErr 
  • Affichez les événements du référentiel defaultServer qui sont survenus avant le 14 septembre 2012 à 16h28 (heure avancée de l'Est).
    binaryLog view
    --maxDate="09/14/12 16:28:00:000 EDT" 
  • Ecrivez les événements du référentiel defaultServer contenant une extension 'thread' de valeur 'Default Executor-thread-4'
    binaryLog view --includeExtension=thread="Default Executor-thread-4" --format=advanced 
  • Affichez la liste des instances de serveur figurant dans le référentiel defaultServer :
    binaryLog listInstances 
    
    Using D:\wlp\usr\servers\defaultServer\logs as repository directory.
    
    Instance ID 					      Start Date
    1358809441761                1/21/13 18:04:01:761 EST
    1358864476191                1/22/13 9:21:16:191 EST
    1358869523192                1/22/13 10:45:23:192 EST
    1358871281166                1/22/13 11:14:41:166 EST
    1358879829000                1/22/13 13:37:09:000 EST
    1358892222067                1/22/13 17:03:42:067 EST
  • Affichez les événements du référentiel defaultServer utilisant l'un des ID d'instance de l'exemple précédent :
    binaryLog view --includeInstance=1358871281166
  • Copiez les événements figurant dans le référentiel defaultServer qui sont associés au niveau AVERTISSEMENT ou ultérieur de l'instance de serveur la plus récente vers un nouveau référentiel dans le répertoire d:\toSupport.
    binaryLog copy defaultServer d:\toSupport --minLevel=warning --includeInstance=latest

Icône indiquant le type de rubrique Rubrique de référence

Dispositions pour les centres de documentation | Commentaires


Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_logviewer
Nom du fichier : rwlp_logviewer.html