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.
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").
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").
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.
- --minDate=valeur
- 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.
--isoDateFormat
Spécifie d'utiliser le format de date et d'heure ISO-8601 pour la sortie.
- --format={basic | advanced | CBE-1.0.1}
- 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").
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").
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.
- --minDate=valeur
- 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 {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.
Option de sortie :
- --isoDateFormat
Spécifie d'utiliser le format de date et d'heure ISO-8601 pour la sortie.
- --isoDateFormat
- 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
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: The application hello-world has stopped successfully.
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
- Affichez tous les événements dans le référentiel defaultServer entre le 19 juillet 2013 et le 2 août 2013.