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 traditionnel.

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 à l'aide de 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'extraire plus facilement des journaux les données dont vous avez besoin. Vous pouvez, par exemple, filtrer les enregistrements de journal recherchés par niveau, nom du consignateur ou date et heure.

Syntaxe

La syntaxe de la commande est la suivante :

binaryLog action {serverName | repositoryPath} [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 {serverName | repositoryPath} [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. Ce chemin correspond généralement au répertoire qui contient à la fois les données des journaux et les répertoires des données de trace.

Remarque : Spécifiez sur la ligne de commande une valeur pour nom_serveur et pour chemin_référentiel. Sinon, la tâche est exécutée face à l'instance de serveur par défaut (defaultServer) si celle-ci 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="23/01/17") ou de date et heure (par exemple, --minDate="23/01/17 17:39:53:100 EST").

    [17.0.0.1 et ultérieur]Vous pouvez également entrer la date et l'heure au format ISO-8601. Entrez par exemple --minDate="2017-01-23" ou --minDate="2017-01-23T17:39:53.100-0500".

  • --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").

    [17.0.0.1 et ultérieur]Vous pouvez également entrer la date et l'heure au format ISO-8601. Entrez par exemple --maxDate="2017-01-23" ou --maxDate="2017-01-23T17:39:53.100-0500".

  • --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. Vous devez spécifier l'une des valeurs suivantes : FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.

  • --includeLogger=valeur[,valeur]*

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

  • --includeMessage=valeur

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

  • --includeThread=valeur

    Indique d'inclure les 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 le caractère générique * ou ?. 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.

  • [17.0.0.1 et ultérieur]--isoDateFormat

    Spécifie d'utiliser le format de date et d'heure ISO-8601 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 {serverName | repositoryPath} targetPath [options]
nom_serveur

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. Ce chemin correspond généralement au répertoire qui contient les données des journaux et les répertoires des données de trace.

cheminCible

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

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="23/01/17") ou de date et heure (par exemple, --minDate="23/01/17 17:39:53:100 EST").

    [17.0.0.1 et ultérieur]Vous pouvez également entrer la date et l'heure au format ISO-8601. Entrez par exemple --minDate="2017-01-23" ou --minDate="2017-01-23T17:39:53.100-0500".

  • --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="23/01/17") ou de date et heure (par exemple, --maxDate="23/01/17 17:39:53:100 EST").

    [17.0.0.1 et ultérieur]Vous pouvez également entrer la date et l'heure au format ISO-8601. Entrez par exemple --maxDate="2017-01-23" ou --maxDate="2017-01-23T17:39:53.100-0500".

  • --minLevel=valeur

    Le filtre repose sur un niveau minimal. Vous devez utiliser l'une des valeurs suivantes : FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.

  • --maxLevel=valeur

    Le filtre repose sur un niveau maximal. Vous devez utiliser l'une des valeurs suivantes : FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.

  • --includeLogger=valeur[,valeur]*

    Indique d'inclure les enregistrements avec le nom de consignateur spécifié. La valeur peut inclure le caractère générique *.

  • --excludeLogger=valeur[,valeur]*

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

  • --includeMessage=valeur

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

  • --includeThread=valeur

    Indique d'inclure les 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 le caractère générique * ou ?. 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.
[17.0.0.1 et ultérieur]
La syntaxe de la commande est la suivante :
binaryLog listInstances {serverName | repositoryPath} [options]
nom_serveur

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. Ce chemin correspond généralement au répertoire qui contient les données des journaux et les répertoires des données de trace.

Remarque : Spécifiez sur la ligne de commande une valeur pour nom_serveur et pour chemin_référentiel. Sinon, la tâche est exécutée face à l'instance de serveur par défaut (defaultServer) si celle-ci existe.
[17.0.0.1 et ultérieur]Option de sortie :
  • --isoDateFormat

    Spécifie d'utiliser le format de date et d'heure ISO-8601 pour la sortie.

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 dans le référentiel defaultServer 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=WARNING --format=advanced 
  • Ecrivez les messages de journal du référentiel dans /apps/server1/logs en n'incluant que ceux consignés 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 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 en utilisant l'un des ID d'instance de l'exemple précédent :
    binaryLog view --includeInstance=1358871281166
  • Copiez les événements du référentiel defaultServer dont le niveau spécifié est WARNING ou supérieur, depuis 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
  • [17.0.0.1 et ultérieur]Affichez la date et heure au format ISO-8601 pour le référentiel defaultServer en lançant la commande suivante :
    binaryLog view --isoDateFormat
    La sortie est la suivante :
    [2017-01-16T23:36:43.891-0500] 00000150 servlet I
    com.ibm.ws.webcontainer.servlet.ServletWrapper doDestroy SRVE0253I:
      [hello-world] [/hello-world] [/index.jsp]: Destroy successful.
    [2017-01-16T23:36:43.900-0500] 00000150 AppMessageHel A   CWWKZ0009I: L'arrêt de apl'plication hello-world a abouti .
  • [17.0.0.1 et ultérieur]Répertoriez les ID des instances de serveur dans le référentiel au format ISO-8601 en lançant la commande suivante :
    listInstances --isoDateFormat
    La sortie est la suivante :
    Instance ID 					      Start Date
    1484625121871               2017-01-16T22:52:01.871-0500
    1484626095175               2017-01-16T23:08:15.175-0500

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

Nom du fichier : rwlp_logviewer.html