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 traditionellen Anwendungsservers.

Die Binärprotokollierungs- und Tracefunktion schreibt Daten im Binärformat in ein Repository. Sie können das Repository mit dem Befehl "binaryLog" anzeigen, abfragen und filtern. Der Befehl "binaryLog" stellt Optionen zur Verfügung, mit denen Repository-Inhalte in verschiedene Formate, z. B. in Basisformate und in erweiterte Formate, in eine Textdatei konvertiert werden können. Außerdem stellt der Befehl Optionen bereit, die das Abrufen der Daten, die Sie aus den Protokollen benötigen, vereinfachen. Beispielsweise können Sie die gewünschten Protokolldatensätze nach Protokoll- bzw. Tracestufe, nach Name der Protokollfunktion (Logger) oder nach Datum und Uhrzeit filtern.

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 (*) als Platzhalterzeichen enthalten.

  • --includeMessage=Wert

    Filtert die Daten basierend auf dem Nachrichtennamen. Der Wert kann einen Stern (*) 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.

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.

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 (*) als Platzhalterzeichen enthalten.

  • --excludeLogger=Wert[,Wert]*

    Schließt Datensätze mit dem angegebenen Protokollfunktionsnamen aus. Der Wert kann einen Stern (*) als Platzhalterzeichen enthalten.

  • --includeMessage=Wert

    Filtert die Daten basierend auf dem Nachrichtennamen. Der Wert kann einen Stern (*) 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.

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

Symbol das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 01.12.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_logviewer
Dateiname: rwlp_logviewer.html