Optionen für den Befehl "BinaryLog"
Verwenden Sie den Befehl binaryLog, um den Inhalt eines Repositorys für Binärprotokollierung anzuzeigen oder zu kopieren oder die verfügbaren Serverprozessinstanzen im Repository aufzulisten. Der Befehl "binaryLog" enspricht dem Befehl "logViewer" im Profilverzeichnis "bin" des vollständigen Profils von Application Server.
Syntax
Die Befehlssyntax ist wie folgt:
binaryLog action {Servername | Repository-Pfad} [Optionen]
Der Wert von Optionen richtet sich nach dem Wert von action.
Parameter
Die folgenden Aktionen sind für den Befehl "binaryLog" verfügbar:
- Sicht
- Liest ein Repository, filtert es (optional) und erstellt eine Version, die Benutzer lesen können.
Die Befehlssyntax ist wie folgt:
binaryLog view {Servername | Repository-Pfad} [Optionen]
Servername
Gibt den Namen eines Liberty-Servers mit einem Repository an, aus dem Daten gelesen werden sollen.
Repository-Pfad
Gibt den Pfad zu einem Repository an, aus dem Daten gelesen werden sollen. Dies ist normalerweise das Verzeichnis, das die Verzeichnisse "logdata" und "tracedata" enthält.
Anmerkung: Wenn in der Befehlszeile weder ein Servername noch ein Repository-Pfad angegeben ist, wird die Task für die Standardserverinstanz "defaultServer" ausgeführt, falls diese vorhanden ist. Filteroptionen:
Alle Filter sind optional. Wenn mehrere Filter verwendet werden, werden sie durch ein logisches UND miteinander verknüpft.
- --minDate=Wert
Filtert die Daten basierend auf dem Mindesterstellungsdatum der Datensätze. Als Wert muss entweder ein Datum (z. B. --minDate="2/20/13") oder ein Datum inklusive Uhrzeit (z. B. --minDate="2/20/13 16:47:21:445 EST") angegeben werden.
- --maxDate=Wert
Filtert die Daten basierend auf dem maximalen Erstellungsdatum der Datensätze. Als Wert muss entweder ein Datum (z. B. --maxDate="2/20/13") oder ein Datum inklusive Uhrzeit (z. B. --maxDate="2/20/13 16:47:21:445 EST") angegeben werden.
- --minLevel=Wert
Filtert die Daten basierend auf der Mindeststufe. Die gültigen Werte sind: FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.
- --maxLevel=Wert
Filtert die Daten basierend auf der maximalen Stufe. Die gültigen Werte sind: FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.
- --includeLogger=Wert[,Wert]*
Schließt Datensätze mit dem angegebenen Protokollfunktionsnamen ein. Der Wert kann einen Stern (*) oder ein Fragezeichen (?) als Platzhalterzeichen enthalten.
- --includeMessage=Wert
Filtert die Daten basierend auf dem Nachrichtennamen. Der Wert kann einen Stern (*) oder ein Fragezeichen (?) als Platzhalterzeichen enthalten.
- --includeThread=Wert
Schließt Datensätze mit der angegebenen Thread-ID ein. Der Wert muss ein Hexadezimalwert sein (z. B. --includeThread=2a).
- --includeExtension=Name=Wert[,Name=Wert]*
Schließt Datensätze mit dem angegebenen Erweiterungsnamen und dem angegebenen Wert ein. Der Wert kann einen Stern (*) oder ein Fragezeichen (?) als Platzhalterzeichen enthalten. Wenn Sie im Wert ein Komma einschließen möchten, müssen Sie "\," verwenden.
- --includeInstance=Wert
Schließt Datensätze aus der angegebenen Serverinstanz ein. Die gültigen Werte sind "latest" und gültige Instanz-IDs. Führen Sie diesen Befehl mit der Aktion "listInstances" aus, um eine Liste der gültigen Instanz-IDs anzuzeigen.
- --minDate=Wert
- Option für Überwachung:
- --monitor
Führt eine fortlaufende Überwachung des Repositorys durch und gibt neuen Inhalt aus, der generiert wird.
Ausgabeoptionen:- --format={basic | advanced | CBE-1.0.1}
Geben Sie das zu verwendende Ausgabeformat an. "basic" ist das Standardformat.
- --encoding=Wert
Geben Sie die Zeichencodierung an, die für die Ausgabe verwendet werden soll.
- --format={basic | advanced | CBE-1.0.1}
- copy
- Liest ein Repository, filtert es (optional) und schreibt den Inhalt in ein neues Repository.
- Die Befehlssyntax ist wie folgt:
binaryLog copy {Servername | Repository-Pfad} Zielpfad [Optionen]
- Servername
Gibt den Namen eines Liberty-Servers mit einem Repository an, aus dem Daten gelesen werden sollen.
- Repository-Pfad
Gibt den Pfad zu einem Repository an, aus dem Daten gelesen werden sollen. Dies ist gewöhnlich das Verzeichnis, das die Verzeichnisse "logdata" und "tracedata" enthält.
- Zielpfad
Gibt den Pfad an, in dem ein neues Repository erstellt werden soll. Der Zielpfad muss angegeben werden.
- Anmerkung: Servername bzw. Repository-Pfad sowie Zielpfad muss angegeben werden.
Filteroptionen:
- Alle Filter sind optional. Wenn mehrere Filter verwendet werden,
werden sie durch ein logisches UND miteinander verknüpft.
- --minDate=Wert
Filtert die Daten basierend auf dem Mindesterstellungsdatum der Datensätze. Als Wert muss entweder ein Datum (z. B. --minDate="2/20/13") oder ein Datum inklusive Uhrzeit (z. B. --minDate="2/20/13 16:52:32:808 EST") angegeben werden.
- --maxDate=Wert
Filtert die Daten basierend auf dem maximalen Erstellungsdatum der Datensätze. Als Wert muss entweder ein Datum (z. B. --maxDate="2/20/13") oder ein Datum inklusive Uhrzeit (z. B. --maxDate="2/20/13 16:52:32:808 EST") angegeben werden.
- --minLevel=Wert
Filtert die Daten basierend auf der Mindeststufe. Die gültigen Werte sind: FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.
- --maxLevel=Wert
Filtert die Daten basierend auf der maximalen Stufe. Die gültigen Werte sind: FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL.
- --includeLogger=Wert[,Wert]*
Schließt Datensätze mit dem angegebenen Protokollfunktionsnamen ein. Der Wert kann einen Stern (*) oder ein Fragezeichen (?) als Platzhalterzeichen enthalten.
- --excludeLogger=Wert[,Wert]*
Schließt Datensätze mit dem angegebenen Protokollfunktionsnamen aus. Der Wert kann einen Stern (*) oder ein Fragezeichen (?) als Platzhalterzeichen enthalten.
- --includeMessage=Wert
Filtert die Daten basierend auf dem Nachrichtennamen. Der Wert kann einen Stern (*) oder ein Fragezeichen (?) als Platzhalterzeichen enthalten.
- --includeThread=Wert
Schließt Datensätze mit der angegebenen Thread-ID ein. Der Wert muss ein Hexadezimalwert sein (z. B. --includeThread=2a).
- --includeExtension=Name=Wert[,Name=Wert]*
Schließt Datensätze mit dem angegebenen Erweiterungsnamen und dem angegebenen Wert ein. Der Wert kann einen Stern (*) oder ein Fragezeichen (?) als Platzhalterzeichen enthalten. Wenn Sie im Wert ein Komma einschließen möchten, müssen Sie "\," verwenden.
- --includeInstance=Wert
Schließt Datensätze aus der angegebenen Serverinstanz ein. Die gültigen Werte sind "latest" und gültige Instanz-IDs. Führen Sie diesen Befehl mit der Aktion "listInstances" aus, um eine Liste der gültigen Instanz-IDs anzuzeigen.
- --minDate=Wert
- listInstances
- Listet die IDs der Serverinstanzen im Repository auf. Eine Serverinstanz ist die Sammlung aller Protokoll-/Tracedatensätze, die zwischen dem Start eines Servers und dem Stoppen des Servers geschrieben werden. Die Serverinstanz-IDs können mit der Option "--includeInstance" der Aktion "binaryLog view" verwendet werden.
- Die Befehlssyntax ist wie folgt:
binaryLog listInstances {Servername | Repository-Pfad}
- Servername
Gibt den Namen eines Liberty-Servers mit einem Repository an, aus dem Daten gelesen werden sollen.
- Repository-Pfad
Gibt den Pfad zu einem Repository an, aus dem Daten gelesen werden sollen. Dies ist gewöhnlich das Verzeichnis, das die Verzeichnisse "logdata" und "tracedata" enthält.
- Anmerkung: Wenn in der Befehlszeile weder ein Servername noch ein Repository-Pfad angegeben ist, wird die Task für die Standardserverinstanz "defaultServer" ausgeführt, falls diese vorhanden ist.
- Beachten Sie, dass das Tool "binaryLog" Filteroptimierungen bereitstellt. Das Tool "binaryLog" kann Daten mit den Protokoll- und Traceoptionen sehr effizient filtern:
- --minDate
- --maxDate
- --includeThread
- --minLevel
- --maxLevel
- Verwendungsbeispiel
Sehen Sie sich die folgenden Beispiele für binaryLog-Befehle an.
- Alle Ereignisse im defaultServer-Repository zwischen dem 19.07.2013 und dem 02.08.2013 anzeigen.
binaryLog view --minDate=07/19/13 --maxDate=08/02/13
- Neue Ereignisse auf dem Server "myServer" anzeigen, dessen angegebene Stufe WARNING oder höher ist, und das erweiterte Format verwenden,
während der Server die Ereignisse in das Protokollrepository schreibt.
binaryLog view myServer --monitor --minLevel=WARNING --format=advanced
- Protokollnachrichten in ein Repository unter "/apps/server1/logs" schreiben und nur die Nachrichten einbeziehen, die in den Fehlerdatenstrom eines
bestimmten Repositorys geschrieben wurden.
binaryLog view /apps/server1/logs --includeLogger=SystemErr
- Ereignisse aus dem defaultServer-Repository anzeigen, die vor dem 14.09.2012, 16:28 EDT (Eastern Daylight Time) eingetreten sind.
binaryLog view --maxDate="09/14/12 16:28:00:000 EDT"
- Ereignisse aus dem defaultServer-Repository schreiben, die eine "thread"-Erweiterung mit dem Wert "Default Executor-thread-4" enthalten
binaryLog view --includeExtension=thread="Default Executor-thread-4" --format=advanced
- Liste von Serverinstanzen im defaultServer-Repository anzeigen:
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
- Ereignisse im defaultServer mit einer der Instanz-IDs aus dem vorherigen Beispiel anzeigen:
binaryLog view --includeInstance=1358871281166
- Ereignisse aus dem defaultServer, dessen angegebene Stufe WARNING oder höher ist,
aus der letzten Serverinstanz in ein neues Repository im Verzeichnis d:\toSupport kopieren.
binaryLog copy defaultServer d:\toSupport --minLevel=warning --includeInstance=latest
- Alle Ereignisse im defaultServer-Repository zwischen dem 19.07.2013 und dem 02.08.2013 anzeigen.