Verwenden von Live Tail zur Anzeige von Protokollen in nahezu Echtzeit

CloudWatch Logs Live Tail hilft Ihnen dabei, Vorfälle schnell zu beheben, indem es eine Streaming-Liste mit neuen Protokollereignissen anzeigt, sobald sie aufgenommen werden. Sie können erfasste Protokolle nahezu in Echtzeit anzeigen, filtern und hervorheben, sodass Sie Probleme schnell erkennen und lösen können. Sie können die Protokolle nach von Ihnen angegebenen Begriffen filtern und auch Protokolle hervorheben, die bestimmte Begriffe enthalten, damit Sie schnell finden, wonach Sie suchen.

Bei Live Tail-Sitzungen fallen Kosten pro Minute an. Weitere Informationen zur Preisgestaltung finden Sie auf der Registerkarte Logs unter Amazon CloudWatch Pricing.

Anmerkung

Live Tail wird nur für Protokollgruppen der Standard-Protokollklasse unterstützt. Weitere Informationen zu Protokollklassen finden Sie unterKlassen protokollieren.

In den folgenden Abschnitten wird erklärt, wie Sie Live Tail in der Konsole verwenden. Sie können eine Live Tail-Sitzung auch programmatisch starten. Weitere Informationen finden Sie unter StartLiveTail. SDK-Beispiele finden Sie unter Starten einer Live-Tail-Sitzung mit einem AWS SDK.

Starten einer Live-Tail-Sitzung

Sie verwenden die CloudWatch Konsole, um eine Live-Tail-Sitzung zu starten. Das folgende Verfahren erklärt, wie Sie eine Live-Tail-Sitzung über die Option Live Tail im linken Navigationsbereich starten. Sie können Live-Tail-Sitzungen auch von der Seite „Protokollgruppen“ oder der Seite „ CloudWatch Logs Insights“ aus starten.

Anmerkung

Wenn Sie Datenschutzrichtlinien verwenden, um sensible Daten in einer Protokollgruppe zu maskieren, die Sie mit Live Tail anzeigen, sind die sensiblen Daten in der Live-Tail-Sitzung immer maskiert. Weitere Informationen über die Maskierung sensibler Daten in Protokollgruppen finden Sie unter Den Schutz vertraulicher Protokolldaten mit Maskierung unterstützen.

Starten einer Live-Tail-Sitzung

1. Öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

2. Wählen Sie im Navigationsbereich Protokolle, Live Tail aus.

3. Wählen Sie unter Protokollgruppen auswählen die Protokollgruppen aus, deren Ereignisse Sie in der Live-Tail-Sitzung anzeigen möchten. Sie können bis zu 10 Protokollgruppen auswählen.

4. (Optional) Wenn Sie nur eine Protokollgruppe ausgewählt haben, können Sie Ihre Live-Tail-Sitzung weiter filtern, indem Sie einen oder mehrere Protokollstreams auswählen, aus denen Sie Protokollereignisse anzeigen möchten. Wählen Sie dazu unter Protokollstreams auswählen die Namen der Protokollstreams aus der Dropdownliste aus. Alternativ können Sie auch das zweite Feld unter Protokollstreams auswählen verwenden, um ein Präfix für den Namen des Protokollstreams einzugeben. Dann werden alle Protokollstreams ausgewählt, deren Namen mit dem Präfix übereinstimmen.

5. (Optional) Wenn Sie nur Protokollereignisse anzeigen möchten, die bestimmte Wörter oder andere Zeichenfolgen enthalten, geben Sie das Wort oder die Zeichenfolge in Add filter patterns ein.

   Um beispielsweise nur Protokollereignisse anzuzeigen, die das Wort Warning enthalten, geben Sie Warning ein. Im Feld „Filter“ wird zwischen Groß- und Kleinschreibung unterschieden. Sie können mehrere Begriffe und Musteroperatoren in dieses Feld eingeben:

   • error 404 zeigt nur Protokollereignisse an, die sowohl error als auch 404 enthalten

   • ?Error ?error zeigt Protokollereignisse an, die entweder Error oder error enthalten

   • -INFO zeigt alle Protokollereignisse an, die nicht INFO enthalten.

   • { $.eventType = "UpdateTrail" } zeigt alle JSON-Protokollereignisse an, bei denen der Wert des Ereignistypfelds UpdateTrail lautet

   Sie können auch einen regulären Ausdruck (regex) zum Filtern verwenden:

   • %ERROR% verwendet Regex, um alle Protokollereignisse anzuzeigen, die aus dem Schlüsselwort ERROR bestehen

   • { $.names = %Steve% } verwendet Regex, um JSON-Protokollereignisse anzuzeigen, bei denen sich Steve in der Eigenschaft "name" befindet

   • [ w1 = %abc%, w2 ] verwendet Regex, um durch Leerzeichen getrennte Protokollereignisse anzuzeigen, bei denen das erste Wort abc ist

   Weitere Informationen zur Mustersyntax finden Sie unter Filtermustersyntax.

6. (Optional) Um einige der angezeigten Protokollereignisse hervorzuheben, geben Sie einen Suchbegriff ein und markieren ihn unter Live Tail. Geben Sie die hervorzuhebenden Begriffe nacheinander ein. Wenn Sie mehrere Begriffe zur Hervorhebung hinzufügen, wird jedem Begriff eine andere Farbe zugewiesen. Ein Markierungsindikator wird links neben jedem Protokollereignis angezeigt, das den angegebenen Begriff enthält, und erscheint auch unter dem Begriff selbst, wenn Sie das Protokollereignis im Hauptfenster erweitern, um das gesamte Protokollereignis anzuzeigen.

   Sie können Filter zusammen mit Hervorhebungen verwenden, um Probleme schnell zu beheben. Sie können beispielsweise die Ereignisse so filtern, dass nur die Ereignisse angezeigt werden, die Error enthalten, und dann auch die Ereignisse hervorheben, die 404 enthalten.

7. Zum Starten der Sitzung wählen Sie Filter anwenden.

   Im Fenster werden nun übereinstimmende Protokollereignisse angezeigt. Die folgenden Informationen werden ebenfalls angezeigt:

   • Der Timer zeigt an, wie lange die Live-Tail-Sitzung bereits aktiv ist.

   • Ereignisse/Sek. zeigt an, wie viele erfasste Protokollereignisse pro Sekunde mit den von Ihnen festgelegten Filtern übereinstimmen.

   • Um zu verhindern, dass die Sitzung zu schnell scrollt, weil viele Ereignisse den Filtern entsprechen, werden in den CloudWatch Protokollen möglicherweise nur einige übereinstimmende Ereignisse angezeigt. Wenn dies der Fall ist, wird der Prozentsatz der übereinstimmenden Ereignisse, die auf dem Bildschirm angezeigt werden, in % angezeigt.

8. Um den Fluss der Ereignisse anzuhalten und zu untersuchen, was gerade angezeigt wird, klicken Sie auf eine beliebige Stelle im Ereignisfenster.

9. Während der Sitzung können Sie wie folgt vorgehen, um weitere Details zu den einzelnen Protokollereignissen anzuzeigen.

   • Um den gesamten Text für ein Protokollereignis im Hauptfenster anzuzeigen, wählen Sie den Pfeil neben dem betreffenden Ereignis.

   • Um den gesamten Text für ein Protokollereignis in einem Seitenfenster anzuzeigen, wählen Sie die Lupe + neben dem betreffenden Protokollereignis. Der Ereignisfluss wird angehalten und das Seitenfenster wird angezeigt.

     Die Anzeige des Textes eines Protokollereignisses im Seitenfenster kann nützlich sein, um seinen Text mit anderen Ereignissen im Hauptfenster zu vergleichen.

10. Zum Beenden der Live-Tail-Sitzung wählen Sie Stoppen.

11. Um die Sitzung neu zu starten, verwenden Sie optional den Filterbereich, um die Filterkriterien zu ändern, und wählen Sie Filter anwenden. Wählen Sie dann Anfang aus.