Mit einem Filtermuster wird die Zeichenfolge oder der Ausdruck definiert, dessen Entsprechung in der Schrittausgabe gesucht werden soll. Jedes von Ihnen erstellte Filtermuster wird einer einzigen Filteraktion zugeordnet. Sowohl Filtermuster als auch Aktionen werden in Filterprotokollgruppen definiert. Durch die Möglichkeit, mehrere Filtermuster in einen Protokollfilter einzuschließen und diesen auf die Ausgabe eines einzelnen Schritts anzuwenden, können Sie mehrere Suchkriterien verwenden, ohne komplexe Ausdrücke bilden zu müssen.
Zum Erstellen eines Protokollfilters wählen Sie Protokollfilter.
aus. Details zu diesem Thema finden Sie unterBeim Erstellen von Filtermustern sollten Sie sich an den folgenden Richtlinien orientieren:
In der folgenden Tabelle ist die Syntax für einige standardmäßige reguläre Ausdrücke aufgeführt.
Ausdruck |
Übereinstimmungen |
---|---|
Production |
Entspricht Production an einer beliebigen Stelle in der Zeichenfolge. |
^Production |
Entspricht Production am Anfang der Zeichenfolge. |
Error:.*[0-9]$ |
Entspricht einer Zeile, die Error, gefolgt von einer beliebigen Menge von Zeichen, die durch eine Zahl am Ende der Zeichenfolge beendet wird, enthält. |
[Ww]arning |
Entspricht Warning oder warning. |
.* |
Entspricht einem beliebigen Zeichen, das 0 Mal oder häufiger vorkommt. Der Punkt (.) entspricht einem beliebigen Zeichen, und der Stern (*) entspricht 0 Mal oder häufiger. |
Beim Erstellen eines Musterfilters müssen Sie sich vor Augen führen, wie im System nach Musterübereinstimmungen gesucht wird.
In jeder Zeile der Ausgabe wird nach Übereinstimmungen gesucht, wobei alle Filtermuster in der vorgegebenen Reihenfolge herangezogen werden. Wird eine Übereinstimmung gefunden, wird die Mustererkennung angehalten und mit dem nächsten Muster fortgesetzt. Kommt ein Muster ein zweites Mal in einer Zeile vor, wird es daher vom System möglicherweise nicht gefunden. Beispielsweise wird mit dem Befehl diese Zeile der Ausgabe:
exception retrying exception
Würden beispielsweise die Filtermuster in der folgenden Tabelle auf die oben angegebene Zeile aus einer Schrittausgabe angewendet, würde die Mustererkennung folgendermaßen durchgeführt: Für das erste Vorkommen von exception würde eine Übereinstimmung ermittelt, und der Status des Schrittergebnisses würde auf "Fehlgeschlagen" festgelegt. Dann würde für retrying eine Übereinstimmung ermittelt und der Status des Schrittergebnisses auf "Erfolgreich" festgelegt. Anschließend würde die Mustererkennung in der nächsten Zeile fortgesetzt, ohne dass das zweite Vorkommen von exception gefunden würde.
Filtermuster | Filteraktionen | Beispielbeschreibung |
---|---|---|
[Ee]xception [Rr]etrying | Als Fehlschlag festlegen - Fehlgeschlagen Fehlschlag löschen - Erfolgreich | Diese Muster eignen sich für Java-Projekte. Bei Ausnahmebedingungen schlägt der Schritt fehl, bei einer Wiederholung wird der Fehlschlag jedoch gelöscht. Wenn die Wiederholung fehlschlägt, wird eine Ausnahmebedingung generiert, sodass der Endstatus des Befehls gültig ist. |
Eine Möglichkeit, dieses Problem zu lösen, besteht darin, die Filtermuster in der Tabelle durch das folgende Filtermuster zu ersetzen:
retrying.*exception