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.

# Beispiel: Zählen des Vorkommens eines Begriffs
<a name="CountOccurrencesExample"></a>

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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html).

**Um einen Metrikfilter mit der CloudWatch Konsole zu erstellen**

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

1. Wählen Sie im Navigationsbereich **Protokollgruppen** aus.

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

1. Wählen Sie **Aktionen**, **Metrikfilter erstellen** aus.

1. Geben Sie für **Filtermuster** **Error** ein.
**Anmerkung**  
Alle Einträge in **Filter Pattern** berücksichtigen Groß- und Kleinschreibung.

1. (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.

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

1. Geben Sie unter **Metric Details** (Metrikdetails) für **Metric Namespace** (Metrik-Namespace) **MyNameSpace** ein.

1. Geben Sie für **Metrikname** den Wert **ErrorCount** ein.

1. 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.

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

1. Wählen Sie **Metrikfilter erstellen** aus.

**Um einen metrischen Filter mit dem 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"
```