Beispiel: Zählen des Vorkommens eines Begriffs

Protokollereignisse enthalten häufig wichtige Nachrichten (z. B. über den Erfolg oder Misserfolg von Operationen), die Sie zählen möchten. Beispielsweise kann ein Fehler auftreten und in einer Protokolldatei aufgezeichnet werden, wenn eine bestimmte Operation fehlschlägt. Sie sollten diese Einträge überwachen, um sich einen Überblick über die Entwicklung Ihrer Fehler zu verschaffen.

In dem unten stehenden Beispiel wird ein Metrikfilter erstellt, mit dem der Begriff "Fehler" überwacht wird. Die Richtlinie wurde erstellt und der Protokollgruppe MyApp/message.log hinzugefügt. CloudWatch Logs veröffentlicht einen Datenpunkt für die CloudWatch benutzerdefinierte Metrik ErrorCount im Namespace MyApp/message.log mit dem Wert „1" für jedes Ereignis, das Fehler enthält. Wenn kein Ereignis das Wort "Error" enthält, werden der Wert 0 veröffentlicht. Achten Sie bei der grafischen Darstellung dieser Daten in der CloudWatch Konsole darauf, die Summenstatistik zu verwenden.

Nachdem Sie einen Metrikfilter erstellt haben, können Sie die Metrik in der CloudWatch Konsole anzeigen. Wenn Sie die anzuzeigende Metrik auswählen, wählen Sie den Metrik-Namespace aus, der mit dem Namen der Protokollgruppe übereinstimmt. Weitere Informationen finden Sie unter Anzeigen der verfügbaren Metriken.

Um einen Metrikfilter mit der CloudWatch Konsole zu erstellen

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

2. Wählen Sie im Navigationsbereich Protokollgruppen aus.

3. Wählen Sie den Namen der Protokollgruppe aus.

4. Wählen Sie Aktionen, Metrikfilter erstellen aus.

5. Geben Sie für Filtermuster Error ein.

   Anmerkung

   Alle Einträge in Filter Pattern berücksichtigen Groß- und Kleinschreibung.

6. (Optional) Um das Filtermuster zu testen, geben Sie unter Test Pattern (Muster testen) ein oder mehrere Protokollereignisse ein, die zum Testen des Musters verwendet werden sollen. Jedes Protokollereignis muss innerhalb einer einzelnen Zeile liegen, da Zeilenumbrüche verwendet werden, um Protokollereignisse im Anzeigebereich Log event messages (Ereignismeldungen protokollieren) zu trennen.

7. Wählen Sie Weiter und geben Sie dann auf der Seite Metrik zuweisen für Filtername MyAppErrorCount ein.

8. Geben MyNameSpaceSie unter Metric Details für Metric Namespace den Text ein.

9. Geben Sie für Metrikname den Wert ErrorCount ein.

10. Vergewissern Sie sich, dass Metrikwert „1“ lautet. Dadurch ist festgelegt, dass die Zählung für jedes Protokollereignis, das „Error“ enthält, um 1 erhöht wird.

11. Geben Sie für Standardwert „0“ ein und wählen Sie dann Weiter.

12. Wählen Sie Metrikfilter erstellen aus.

Um einen Metrikfilter mit dem zu erstellen AWS CLI

Führen Sie über die Eingabeaufforderung den folgenden Befehl aus:

aws logs put-metric-filter \
  --log-group-name MyApp/message.log \
  --filter-name MyAppErrorCount \
  --filter-pattern 'Error' \
  --metric-transformations \
      metricName=ErrorCount,metricNamespace=MyNamespace,metricValue=1,defaultValue=0

Sie können diese neue Richtlinie testen, indem Sie Ereignisse mit dem Begriff "Fehler" in der Nachricht veröffentlichen.

Um Ereignisse zu posten mit dem AWS CLI

Führen Sie an einer Eingabeaufforderung den folgenden -Befehl aus. Beachten Sie, dass in Mustern Groß- und Kleinschreibung berücksichtigt wird.

aws logs put-log-events \
  --log-group-name MyApp/access.log --log-stream-name TestStream1 \
  --log-events \
    timestamp=1394793518000,message="This message contains an Error" \
    timestamp=1394793528000,message="This message also contains an Error"