View a markdown version of this page

pattern - Amazon CloudWatch Logs

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

pattern

Verwenden Sie pattern, um Ihre Protokolldaten automatisch nach Mustern zu clustern.

Ein Muster ist eine gemeinsame Textstruktur, die sich in Ihren Protokollfeldern wiederholt. Sie können verwenden pattern um neue Trends zu erkennen, bekannte Fehler zu überwachen und häufig auftretende oder kostspielige Protokollzeilen zu identifizieren. CloudWatch Logs Insights bietet auch eine Konsolenerfahrung, mit der Sie Muster in Ihren Protokollereignissen finden und weiter analysieren können. Weitere Informationen finden Sie unter Musteranalyse.

Weil der pattern Der Befehl identifiziert automatisch gängige Muster. Sie können ihn als Ausgangspunkt für die Suche und Analyse Ihrer Protokolle verwenden. Sie können auch pattern mit den Befehlen  filter, parse oder sort kombinieren, um Muster in detaillierteren Abfragen zu identifizieren.

Eingabe des Muster-Befehls

Der pattern-Befehl erwartet eine der folgenden Eingaben: das @message-Feld, ein mit dem parse-Befehl erstelltes extrahiertes Feld oder eine Zeichenfolge, die mit einer oder mehreren Zeichenfolgenfunktionen manipuliert wurde.

Wenn CloudWatch Logs können den Datentyp, den ein dynamisches Token repräsentiert, nicht ableiten, wird er als <Token- angezeigtnumberLogs können den Datentyp, den ein dynamisches Token repräsentiert, nicht ableiten, es wird angezeigt als , und number gibt an, wo im Muster dieses Token im Vergleich zu den anderen dynamischen Token erscheint.

Zu den gängigen Beispielen für dynamische Token gehören Fehlercodes, IP-Adressen, Zeitstempel und Anforderungs-IDs.

Ausgabe des Muster-Befehls

Die Ausgabe des Befehls pattern sieht wie folgt aus:

  • @pattern: Eine gemeinsam genutzte Textstruktur, die sich in Ihren Protokollfeldern wiederholt. Felder, die innerhalb eines Musters variieren, wie z. B. eine Anforderungs-ID oder ein Zeitstempel, werden dargestellt durch Spielmarken. Wenn CloudWatch Protokolle können den Datentyp ermitteln, den ein dynamisches Token darstellt, es zeigt das Token als <string-number>. Das string ist eine Beschreibung des Datentyps, den das Token darstellt. Das number zeigt, wo im Muster dieses Token im Vergleich zu den anderen dynamischen Token erscheint.

    CloudWatch Logs weist der Zeichenfolge einen Teil des Namens zu, basierend auf der Analyse des Inhalts der Protokollereignisse, in denen der Name enthalten ist.

    Wenn CloudWatch Logs können den Datentyp, den ein dynamisches Token repräsentiert, nicht ableiten, wird er als <Token- angezeigtnumberLogs können den Datentyp, den ein dynamisches Token repräsentiert, nicht ableiten, es wird angezeigt als , und number gibt an, wo im Muster dieses Token im Vergleich zu den anderen dynamischen Token erscheint.

    Zum Beispiel ist [INFO] Request time: <Time-1> ms eine mögliche Ausgabe für die Protokollmeldung [INFO] Request time: 327 ms.

  • @ratio: Das Verhältnis von Protokollereignissen aus einem ausgewählten Zeitraum und angegebenen Protokollgruppen, die einem identifizierten Muster entsprechen. Wenn beispielsweise die Hälfte der Protokollereignisse in den ausgewählten Protokollgruppen und im ausgewählten Zeitraum mit dem Muster übereinstimmt, gibt @ratio 0.50 aus

  • @sampleCount: Eine Zählung der Anzahl der Protokollereignisse aus einem ausgewählten Zeitraum und bestimmten Protokollgruppen, die einem bestimmten Muster entsprechen.

  • @severityLabel: Der Schweregrad oder die Stufe des Protokolls, der die Art der in einem Protokoll enthaltenen Informationen angibt. Beispiele: Error, Warning, Info oder Debug.

Beispiele

Der folgende Befehl identifiziert Protokolle mit ähnlichen Strukturen in der/den angegebenen Protokollgruppe(n) über den ausgewählten Zeitraum und gruppiert sie nach Muster und Anzahl

pattern @message

Der pattern-Befehl kann in Kombination mit dem filter-Befehl verwendet werden

filter @message like /ERROR/ | pattern @message

Der pattern-Befehl kann mit den Befehlen parse und  sort verwendet werden

filter @message like /ERROR/ | parse @message 'Failed to do: *' as cause | pattern cause | sort @sampleCount asc