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