

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.

# Erstellen von Metriken aus Protokollereignissen mithilfe von Filtern
<a name="MonitoringLogData"></a>

Sie können die Protokolldaten, die in CloudWatch Logs eingehen, durchsuchen und filtern, indem Sie einen oder mehrere *Metrikfilter* erstellen. Metrikfilter definieren die Begriffe und Muster, nach denen in Protokolldaten gesucht werden muss, wenn diese an CloudWatch Logs gesendet werden. CloudWatch Logs verwendet diese Metrikfilter, um Protokolldaten in numerische CloudWatch Messwerte umzuwandeln, die Sie grafisch darstellen oder einen Alarm auslösen können.

Wenn Sie eine Metrik aus einem Protokollfilter erstellen, können Sie der Metrik auch Dimensionen und eine Einheit zuweisen. Wenn Sie eine Einheit angeben, stellen Sie sicher, dass Sie beim Erstellen des Filters die richtige Einheit angeben. Wenn Sie die Einheit für den Filter später ändern, hat das keine Wirkung.

Wenn Sie Mitgliedskonten konfiguriert haben AWS Organizations und mit diesen arbeiten, können Sie die Protokollzentralisierung verwenden, um Protokolldaten von Quellkonten in einem zentralen Überwachungskonto zu sammeln. 

Wenn Sie mit zentralisierten Protokollgruppen arbeiten, können Sie diese Systemfelddimensionen bei der Erstellung von Metrikfiltern verwenden.
+ `@aws.account`- Diese Dimension stellt die AWS Konto-ID dar, von der das Protokollereignis ausgegangen ist.
+ `@aws.region`- Diese Dimension stellt die AWS Region dar, in der das Protokollereignis generiert wurde. 

Diese Dimensionen helfen bei der Identifizierung der Quelle der Protokolldaten und ermöglichen so eine detailliertere Filterung und Analyse von Metriken, die aus zentralisierten Protokollen stammen. Weitere Informationen finden Sie unter [Konto- und regionenübergreifende Protokollzentralisierung](CloudWatchLogs_Centralization.md).

Wenn eine Protokollgruppe mit einem Abonnement die Protokolltransformation verwendet, wird das Filtermuster auf die transformierten Versionen der Protokollereignisse angewendet. Weitere Informationen finden Sie unter [Logs während der Aufnahme transformieren](CloudWatch-Logs-Transformation.md).

**Anmerkung**  
Metrikfilter werden nur für Protokollgruppen der Standard-Protokollklasse unterstützt. Weitere Hinweise zu Protokollklassen finden Sie unter[Klassen protokollieren](CloudWatch_Logs_Log_Classes.md).

Sie können jede Art von CloudWatch Statistik verwenden, einschließlich Perzentilstatistiken, wenn Sie sich diese Metriken ansehen oder Alarme einstellen.

**Anmerkung**  
Perzentil-Statistiken werden für eine Metrik nur dann unterstützt, wenn keiner der Metrikwerte negativ ist. Wenn Sie Ihren Metrikfilter so einrichten, dass er negative Zahlen melden kann, stehen für diese Metrik keine Perzentilstatistiken zur Verfügung, wenn negative Zahlen als Werte angezeigt werden. Weitere Informationen finden Sie unter [Perzentile](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Percentiles).

Filter können nicht rückwirkend auf Daten angewendet werden. Filter veröffentlichen nur die Metrikdatenpunkte für Ereignisse, die aufgetreten sind, nachdem der Filter erstellt wurde. Beim Testen eines Filtermusters zeigt die Vorschau der **Filterergebnisse** zu Überprüfungszwecken bis zu die ersten 50 übereinstimmenden Protokollzeilen an. Wenn der Zeitstempel der gefilterten Ergebnisse vor dem Zeitpunkt der Erstellung der Metrik liegt, werden keine Protokolle angezeigt.

**Topics**
+ [Konzepte](#search-filter-concepts)
+ [Filtermustersyntax für metrische Filter](FilterAndPatternSyntaxForMetricFilters.md)
+ [Erstellen von Metrikfiltern](MonitoringPolicyExamples.md)
+ [Auflisten von Metrikfiltern](ListingMetricFilters.md)
+ [Löschen eines Metrikfilters](DeletingMetricFilter.md)

## Konzepte
<a name="search-filter-concepts"></a>

Jeder Metrikfilter besteht aus den folgenden Schlüsselelementen:

**Standardwert**  
Der Wert, der dem Metrikfilter während eines Zeitraums gemeldet wird, in dem zwar Protokolle erfasst, aber keine passenden Protokolle gefunden werden. Wenn Sie diesen Wert auf 0 setzen, stellen Sie sicher, dass die Daten in jedem dieser Zeiträume gemeldet werden, und verhindern so „lückenhafte“ Metriken mit Zeiträumen ohne übereinstimmende Daten. Wenn während eines einminütigen Zeitraums keine Protokolle erfasst werden, wird kein Wert gemeldet.  
Wenn Sie einer Metrik, die von einem Metrikfilter erstellt wurde, Dimensionen zuweisen, können Sie dieser Metrik keinen Standardwert zuweisen.

**Dimensionen**  
Dimensionen sind die Schlüssel-Wert-Paare, die eine Metrik weiter definieren. Sie können der Metrik, die aus einem Metrikfilter erstellt wurde, Dimensionen zuweisen. Da Dimensionen Teil der eindeutigen Kennung für eine Metrik sind, erstellen Sie jedes Mal, wenn ein eindeutiges name/value Paar aus Ihren Logs extrahiert wird, eine neue Variante dieser Metrik.

**Filtermuster**  
Eine symbolische Beschreibung, wie CloudWatch Logs die Daten in den einzelnen Protokollereignissen interpretieren sollte. Ein Protokolleintrag enthält z. B. möglicherweise Zeitstempel, IP-Adressen, Zeichenfolgen und so weiter. Mit dem Muster können Sie angeben, wonach in der Protokolldatei gesucht werden soll.

**Metrikname**  
Der Name der CloudWatch Metrik, für die die überwachten Protokollinformationen veröffentlicht werden sollen. Sie können zum Beispiel mit einer Metrik namens veröffentlichen ErrorCount.

**Namespace der Metrik**  
Der Ziel-Namespace der neuen CloudWatch Metrik.

**Metrikwert**  
Der numerische Wert, der jedes Mal für die Metrik veröffentlicht werden soll, wenn ein übereinstimmendes Protokoll gefunden wird. Wenn Sie beispielsweise die Häufigkeit des Vorkommens eines bestimmten Begriffs wie "Fehler" zählen, lautet der Wert für jedes Vorkommen "1". Wenn Sie die übertragenen Bytes zählen, können Sie die Zahl um die tatsächliche Anzahl der Bytes, die im Protokollereignis gefunden wurden, erhöhen.

# Filtermustersyntax für metrische Filter
<a name="FilterAndPatternSyntaxForMetricFilters"></a>

**Anmerkung**  
**Wie sich Metrikfilter von CloudWatch Logs Insights-Abfragen unterscheiden**  
Metrikfilter unterscheiden sich von CloudWatch Logs Insights-Abfragen darin, dass einem Metrikfilter jedes Mal, wenn ein passendes Protokoll gefunden wird, ein bestimmter numerischer Wert hinzugefügt wird. Weitere Informationen finden Sie unter [Konfigurieren von Metrikwerten für einen Metrikfilter](#changing-default-increment-value).  
Informationen darüber, wie Sie Ihre Protokollgruppen mit der Abfragesprache von Amazon CloudWatch Logs Insights abfragen, finden Sie unter[CloudWatch Abfragesyntax in Logs Insights](CWL_QuerySyntax.md).  
**Beispiele für generische Filtermuster**  
Weitere Informationen zur generischen Filtermustersyntax für Metrikfilter sowie [Abonnementfilter](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SubscriptionFilters.html) und [Filterprotokollereignisse](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SearchDataFilterPattern.html) finden Sie unter [Filtermustersyntax für Metrikfilter, Abonnementfilter und Filterprotokollereignisse](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html), unter anderem die folgenden:  
Unterstützte Syntax für reguläre Ausdrücke (Regex)
Abgleichen von Begriffen in unstrukturierten Protokollereignissen
Auffinden von Begriffen in JSON-Protokollereignissen
Abgleichen von Begriffen in Leerzeichen-getrennten Protokollereignissen

Mit *Metrikfiltern* können Sie in CloudWatch Logs eingehende Protokolldaten suchen und filtern, metrische Beobachtungen aus den gefilterten Protokolldaten extrahieren und die Datenpunkte in eine CloudWatch Logs-Metrik umwandeln. Sie definieren die Begriffe und Muster, nach denen in den Protokolldaten gesucht werden soll, wenn diese an CloudWatch Logs gesendet werden. Metrikfilter sind Protokollgruppen zugewiesen, und alle einer Protokollgruppe zugewiesenen Filter werden auf ihre Protokollstreams angewendet.

Wenn ein Metrikfilter mit einem Begriff übereinstimmt, erhöht er die Anzahl der Metrik um einen bestimmten metrischen Wert. Sie können z. B. einen Metrikfilter erstellen, der zählt, wie oft das Wort ***ERROR*** (FEHLER) in Ihren Protokollereignissen vorkommt.

Sie können den Metriken Maßeinheiten und Dimensionen zuweisen. Wenn Sie beispielsweise einen Metrikfilter erstellen, der zählt, wie oft das Wort ***ERROR*** (FEHLER) in Ihren Protokollereignissen vorkommt, können Sie eine Dimension angeben, die `ErrorCode` genannt wird, um die Gesamtzahl der Protokollereignisse anzuzeigen, die das Wort ***ERROR*** (FEHLER) enthalten, und die Daten nach gemeldeten Fehlercodes filtern.

**Tipp**  
Wenn Sie einer Metrik eine Maßeinheit zuordnen, achten Sie darauf, dass Sie die richtige Einheit angeben. Wenn Sie die Einheit später ändern, wird Ihre Änderung möglicherweise nicht wirksam. Die vollständige Liste der CloudWatch unterstützten Einheiten finden Sie [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html)in der Amazon CloudWatch API-Referenz.

**Topics**
+ [Konfigurieren von Metrikwerten für einen Metrikfilter](#changing-default-increment-value)
+ [Veröffentlichung von Dimensionen mit Metriken aus Werten in JSON- oder Leerzeichen-getrennten Protokollereignissen](#logs-metric-filters-dimensions)
+ [Verwendung von Werten in Protokollereignissen zum Erhöhen des Metrikwerts](#publishing-values-found-in-logs)

## Konfigurieren von Metrikwerten für einen Metrikfilter
<a name="changing-default-increment-value"></a>

Wenn Sie einen Metrikfilter erstellen, definieren Sie Ihr Filtermuster und geben den Wert der Metrik und den Standardwert an. Sie können Metrikwerte für Zahlen, benannte Bezeichner oder numerische Bezeichner festlegen. Wenn Sie keinen Standardwert angeben, CloudWatch werden keine Daten gemeldet, wenn Ihr Metrikfilter keine Übereinstimmung findet. Es wird empfohlen, einen Standardwert anzugeben, auch wenn der Wert 0 ist. Wenn Sie einen Standardwert festlegen, können Daten genauer CloudWatch gemeldet werden, und es wird CloudWatch verhindert, dass lückenhafte Messwerte aggregiert werden. CloudWatch aggregiert und meldet Metrikwerte jede Minute.

 Wenn der Metrikfilter eine Übereinstimmung in Ihren Protokollereignissen findet, erhöht er die Metrikanzahl um den Wert der Metrik. Wenn Ihr Metrikfilter keine Übereinstimmung findet, wird der Standardwert der Metrik CloudWatch gemeldet. Beispiel: Ihre Protokollgruppe veröffentlicht jede Minute zwei Datensätze, der Metrikwert ist 1 und der Standardwert ist 0. Wenn der Metrikfilter in beiden Protokolleinträgen innerhalb der ersten Minute Übereinstimmungen findet, ist der Metrikwert für diese Minute 2. Wenn der Metrikfilter in beiden Datensätzen keine Übereinstimmungen während der zweiten Minute findet, ist der Standardwert für diese Minute 0. Wenn Sie den von den Metrikfiltern generierten Metriken Dimensionen zuweisen, können Sie keine Standardwerte für diese Metriken angeben.

Sie können auch einen Metrikfilter einrichten, um eine Metrik mit einem Wert zu erhöhen, der aus einem Protokollereignis extrahiert wurde, anstatt mit einem statischen Wert. Weitere Informationen finden Sie unter [Verwendung von Werten in Protokollereignissen zum Erhöhen des Metrikwerts](#publishing-values-found-in-logs).

## Veröffentlichung von Dimensionen mit Metriken aus Werten in JSON- oder Leerzeichen-getrennten Protokollereignissen
<a name="logs-metric-filters-dimensions"></a>

Sie können die CloudWatch Konsole oder AWS CLI verwenden, um Metrikfilter zu erstellen, die Dimensionen mit Metriken veröffentlichen, die JSON und durch Leerzeichen getrennte Protokollereignisse generieren. Dimensionen sind name/value Wertepaare und nur für JSON- und durch Leerzeichen getrennte Filtermuster verfügbar. Sie können JSON- und Leerzeichen-getrennte Metrikfilter mit bis zu drei Dimensionen erstellen. Weitere Informationen zu Dimensionen und der Zuordnung von Dimensionen zu Metriken finden Sie in den folgenden Abschnitten:
+ [Abmessungen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) im * CloudWatch Amazon-Benutzerhandbuch*
+ [Beispiel: Extrahieren von Feldern aus einem Apache-Protokoll und Zuweisen von Dimensionen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/ExtractBytesExample.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*

**Wichtig**  
Dimensionen enthalten Werte, die die gleichen Kosten wie benutzerdefinierte Metriken erzeugen. Um unerwartete Kosten zu vermeiden, sollten Sie keine Felder mit hoher Kardinalität, wie z. B. `IPAddress` oder `requestID`, als Dimensionen angeben.  
Wenn Sie Metriken aus Protokollereignissen extrahieren, werden Ihnen benutzerdefinierte Metriken in Rechnung gestellt. Um zu verhindern, dass Sie versehentlich hohe Gebühren erheben, deaktiviert Amazon möglicherweise Ihren Metrikfilter, wenn er über einen bestimmten Zeitraum 1000 verschiedene name/value Paare für bestimmte Dimensionen generiert.   
Sie können Rechnungsalarme erstellen, die Sie über Ihre geschätzten Gebühren informieren. Weitere Informationen finden Sie unter [Erstellen eines Rechnungsalarms zur Überwachung Ihrer geschätzten AWS -Gebühren](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html).

### Dimensionen mit Metriken aus JSON-Protokollereignissen veröffentlichen
<a name="logs-metric-filters-JSON"></a>

Die folgenden Beispiele enthalten Code-Snippets, die beschreiben, wie in einem JSON-Metrikfilter Dimensionen angegeben werden.

------
#### [ Example: JSON log event ]

```
{
  "eventType": "UpdateTrail",
  "sourceIPAddress": "111.111.111.111",
  "arrayKey": [
        "value",
        "another value"
  ],
  "objectList": [
       {"name": "a",
         "id": 1
       },
       {"name": "b",
         "id": 2
       }
  ]
  
}
```

**Anmerkung**  
Wenn Sie die Beispielmetrikfilter mit dem Beispiel-JSON-Protokollereignis testen, müssen Sie das Beispiel-JSON-Protokoll in einer einzigen Zeile eingeben.

------
#### [ Example: Metric filter ]

Der Metrikfilter erhöht die Metrik immer dann, wenn ein JSON-Protokollereignis die Eigenschaften `eventType` und `"sourceIPAddress"` enthält.

```
{ $.eventType = "*" && $.sourceIPAddress != 123.123.* }
```

Wenn Sie einen JSON-Metrikfilter erstellen, können Sie jede der Eigenschaften im Metrikfilter als Dimension angeben. Um `eventType` als Dimension festzulegen, verwenden Sie zum Beispiel Folgendes:

```
"eventType" : $.eventType
```

Die Beispielmetrik enthält eine Dimension mit dem Namen `"eventType"`, und der Wert der Dimension im Beispiel-Protokollereignis ist `"UpdateTrail"`.

------

### Publizieren von Dimensionen mit Metriken aus durch Leerzeichen getrennten Protokollereignissen
<a name="logs-metric-filters-dimensions-space-delimited"></a>

Die folgenden Beispiele enthalten Code-Snippets, die beschreiben, wie in einem Leerzeichen-getrennten Metrikfilter Dimensionen angegeben werden.

------
#### [ Example: Space-delimited log event ]

```
                                
127.0.0.1 Prod frank [10/Oct/2000:13:25:15 -0700] "GET /index.html HTTP/1.0" 404 1534
```

------
#### [ Example: Metric filter ]

```
                                
[ip, server, username, timestamp, request, status_code, bytes > 1000]
```

Der Metrikfilter erhöht die Metrik, wenn ein Leerzeichen-getrenntes Protokollereignis eines der im Filter angegebenen Felder enthält. Zum Beispiel findet der Metrikfilter die folgenden Felder und Werte im Leerzeichen-getrennten Beispiel-Protokollereignis.

```
{
   "$bytes": "1534", 
   "$status_code": "404", 

   "$request": "GET /index.html HTTP/1.0", 
   "$timestamp": "10/Oct/2000:13:25:15 -0700", 
   "$username": "frank",
   "$server": "Prod", 
   "$ip": "127.0.0.1"
}
```

Wenn Sie einen Leerzeichen-getrennten Metrikfilter erstellen, können Sie jedes der Felder im Metrikfilter als Dimension angeben. Um `server` als Dimension festzulegen, verwenden Sie zum Beispiel Folgendes:

```
"server" : $server
```

Der Beispiel-Metrikfilter hat eine Dimension mit dem Namen `server`, und der Wert der Dimension im Beispiel-Protokollereignis ist `"Prod"`.

------
#### [ Example: Match terms with AND (&&) and OR (\$1\$1) ]

Sie können die logischen Operatoren AND („&&“) und OR („\$1\$1“) verwenden, um Leerzeichen-getrennte Metrikfilter zu erstellen, die Bedingungen enthalten. Der folgende Metrikfilter gibt Protokollereignisse zurück, bei denen der erste Begriff in den Ereignissen ERROR (FEHLER) oder eine beliebige WARN-Zeichenfolge ist.

```
[w1=ERROR || w1=%WARN%, w2]
```

------

## Verwendung von Werten in Protokollereignissen zum Erhöhen des Metrikwerts
<a name="publishing-values-found-in-logs"></a>

Sie können Metrikfilter erstellen, die numerische Werte aus Ihren Protokollereignissen veröffentlichen. Die Vorgehensweise in diesem Abschnitt zeigt anhand des folgenden Beispiels für einen Metrikfilter, wie Sie einen numerischen Wert in einem JSON-Protokollereignis in einer Metrik veröffentlichen können.

```
{ $.latency = * } metricValue: $.latency
```

**Einen Metrikfilter erstellen, der einen Wert in einem Protokollereignis veröffentlicht**

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 **Logs** (Protokolle) und dann **Log groups** (Protokollgruppen) aus.

1. Wählen oder erstellen Sie eine Protokollgruppe.

   Informationen zum Erstellen einer Protokollgruppe finden Sie unter [Erstellen einer Protokollgruppe in CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*.

1. Wählen Sie **Aktionen** und dann **Metrikfilter erstellen**.

1. Geben Sie unter **Filter Pattern** (Filtermuster) den Wert **\$1 \$1.latency = \$1 \$1** ein und wählen Sie dann **Next** (Weiter).

1. Geben Sie für **Metric Name** (Metrikname) **myMetric** ein.

1. Geben Sie für **Metrikwert** **\$1.latency** ein.

1. Geben Sie für **Default Value** (Standardwert) **0** ein und wählen Sie dann **Next** (Weiter).

   Es wird empfohlen, einen Standardwert anzugeben, auch wenn der Wert 0 ist. Wenn Sie einen Standardwert festlegen, können Daten genauer CloudWatch gemeldet werden, und es wird CloudWatch verhindert, dass lückenhafte Messwerte aggregiert werden. CloudWatch aggregiert und meldet Metrikwerte jede Minute.

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

Der Beispiel-Metrikfilter stimmt mit dem Begriff `"latency"` im Beispiel-JSON-Protokollereignis überein und veröffentlicht einen numerischen Wert von 50 für die Metrik **myMetric**.

```
{
"latency": 50,
"requestType": "GET"
}
```

# Erstellen von Metrikfiltern
<a name="MonitoringPolicyExamples"></a>

Die folgenden Schritte und Beispiele zeigen, wie Sie Metrikfilter erstellen.

**Topics**
+ [Erstellen eines Metrikfilters für eine Protokollgruppe](CreateMetricFilterProcedure.md)
+ [Beispiel: Zählen von Protokollereignissen](CountingLogEventsExample.md)
+ [Beispiel: Zählen des Vorkommens eines Begriffs](CountOccurrencesExample.md)
+ [Beispiel: Zählen von HTTP-404-Codes](Counting404Responses.md)
+ [Beispiel: Zählen von HTTP-4xx-Codes](FindCountMetric.md)
+ [Beispiel: Extrahieren von Feldern aus einem Apache-Protokoll und Zuweisen von Dimensionen](ExtractBytesExample.md)

# Erstellen eines Metrikfilters für eine Protokollgruppe
<a name="CreateMetricFilterProcedure"></a>

Gehen Sie wie folgt vor, um einen Metrikfilter für eine Protokollgruppe zu erstellen. Die Metrik wird erst angezeigt, wenn einige Datenpunkte dafür vorliegen.

**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 **Logs** (Protokolle) und dann **Log groups** (Protokollgruppen) aus. 

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

1.  Wählen Sie `Actions` und dann **Create metric filter** (Metrikfilter erstellen). 

1.  Für **Filter pattern** (Filtermuster) geben Sie ein Filtermuster ein. Weitere Informationen finden Sie unter [Filtermustersyntax für Metrikfilter, Abonnementfilter, Filterprotokollereignisse und Live Tail](FilterAndPatternSyntax.md). 

1.  (Optional) Wenn Sie zentralisierte Protokollgruppen verwenden, können Sie unter **Filterauswahlkriterien** Filter angeben, die auf dem Quellkonto (`@aws.account`), der Quellregion (`@aws.region`) oder beiden Bedingungen basieren.

1.  (Optional) Um das Filtermuster zu testen, geben Sie unter **Test Pattern** (Muster testen) ein oder mehrere Protokollereignisse zum Testen des Musters ein. Jedes Protokollereignis muss in einer Zeile formatiert sein. Zeilenumbrüche werden verwendet, um Protokollereignisse in dem Kästchen **Log event messages** (Protokollereignisnachrichten) zu trennen. 

1.  Wählen Sie **Next** (Weiter) aus und geben Sie einen Namen für Ihren Metrikfilter ein. 

1.  Geben Sie unter **Metrikdetails** für **Metrik-Namespace** einen Namen für den CloudWatch Namespace ein, in dem die Metrik veröffentlicht wird. Wenn der Namespace noch nicht vorhanden ist, stellen Sie sicher, dass **Create new** (Neu erstellen) ausgewählt ist. 

1.  Unter **Metric name (Metrikname)** geben Sie einen Namen für die neue Metrik ein. 

1.  Geben Sie für **Metric value (Metrikwert)** 1 ein, wenn der Metrikfilter Vorkommen der Schlüsselwörter im Filter zählt. Dadurch wird die Metrik für jedes Protokollereignis, das eines der Schlüsselwörter enthält, um 1 erhöht. 

    Alternativ können Sie ein Token wie **\$1size** eingeben. Dadurch wird die Metrik für jedes Protokollereignis, das ein `size`-Feld enthält, um den Wert der Zahl in der `size` erhöht. 

1.  (Optional) Wählen Sie für **Unit (Einheit)** eine Einheit aus, die der Metrik zugewiesen werden soll. Wenn Sie keine Einheit angeben, wird `None` als Einheit eingestellt. 

1.  (Optional) Geben Sie die Namen und Token für bis zu drei Dimensionen für die Metrik ein. Wenn Sie Metriken, die von Metrikfiltern erstellt werden, Dimensionen zuweisen, können Sie diesen Metriken keine Standardwerte zuweisen. 
**Anmerkung**  
 Dimensionen werden nur in JSON- oder durch Leerzeichen getrennten Metrikfiltern unterstützt. 

1.  Wählen Sie **Metrikfilter erstellen** aus. Sie finden den Metrikfilter, den Sie über den Navigationsbereich erstellt haben. Wählen Sie **Logs** (Protokolle) und anschließend **Log groups** (Protokollgruppen) aus. Wählen Sie den Namen der Protokollgruppe aus, für die Sie den Metrikfilter erstellt haben, und wählen Sie dann den Tabulator **Metric filters** (Metrikfilter). 

# Beispiel: Zählen von Protokollereignissen
<a name="CountingLogEventsExample"></a>

Die einfachste Art der Überwachung von Protokollereignissen ist die Zählung der Anzahl von Protokollereignissen. Dies ist sinnvoll, um alle Ereignisse zu zählen, um eine "Heartbeat"-Überwachung zu erstellen oder um lediglich die Erstellung von Metrikfiltern zu üben.

Im folgenden CLI-Beispiel MyAppAccessCount wird ein Metrikfilter namens auf die Protokollgruppe MyApp /access.log angewendet, um die Metrik EventCount im CloudWatch Namespace MyNamespace zu erstellen. Der Filter ist so konfiguriert, dass er dem Inhalt eines beliebigen Protokollereignisses entspricht und die Metrik um "1" erhöht wird.

**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 einer Protokollgruppe aus.

1. Wählen Sie `Actions`, **Metrikfilter erstellen** aus.

1. Lassen Sie die Felder **Filtermuster** und **Zu testende Protokolldaten auswählen** leer.

1. Wählen Sie **Weiter** und geben Sie dann für **Filtername** **EventCount** ein.

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

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

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

1. Geben Sie für **Standardwert** „0“ ein und wählen Sie dann **Weiter**. Die Angabe eines Standardwerts stellt sicher, dass auch in Zeiträumen, in denen keine Protokollereignisse auftreten, Daten gemeldet werden, und verhindert so lückenhafte Metriken, in denen manchmal gar keine Daten vorkommen.

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/access.log \
  --filter-name EventCount \
  --filter-pattern " " \
  --metric-transformations \
  metricName=MyAppEventCount,metricNamespace=MyNamespace,metricValue=1,defaultValue=0
```

Sie können diese neue Richtlinie durch Veröffentlichen beliebiger Ereignisdaten testen. Sie sollten Datenpunkte sehen, die in der Metrik veröffentlicht wurden MyAppAccessEventCount.

**Um Ereignisdaten mit dem zu posten AWS CLI**  
Führen Sie über die Eingabeaufforderung den folgenden Befehl aus:

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

# 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"
```

# Beispiel: Zählen von HTTP-404-Codes
<a name="Counting404Responses"></a>

Mithilfe von CloudWatch Logs können Sie überwachen, wie oft Ihre Apache-Server eine HTTP 404-Antwort zurückgeben. Dabei handelt es sich um den Antwortcode für die Seite, die nicht gefunden wurde. Sie sollten diese Zahl überwachen, um zu verstehen, wie oft die Besucher Ihrer Website die gesuchte Ressource nicht finden. Gehen Sie davon aus, dass die Protokolldatensätze so strukturiert sind, dass sie folgende Informationen für jedes Protokollereignis (Besuch der Website) enthalten:
+ IP-Adresse des Anforderers
+ RFC 1413-Identität
+ Username
+ Zeitstempel
+ Anforderungsmethode mit angeforderter Ressource und Protokoll
+ Anzufordernder HTTP-Antwortcode
+ Bei der Anforderung übertragene Bytes.

Ein Beispiel könnte folgendermaßen aussehen:

```
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET /apache_pb.gif HTTP/1.0" 404 2326
```

Sie können eine Regel festlegen, die versucht, Ereignisse in der Struktur der HTTP 404-Fehler zu finden. Dies ist in folgendem Beispiel dargestellt:

**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 `Actions`, **Metrikfilter erstellen** aus.

1. Geben Sie für **Filtermuster** **[IP, UserInfo, User, Timestamp, RequestInfo, StatusCode=404, Bytes]** ein.

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 als **Filtername HTTP404** **Fehler** ein.

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

1. Geben Sie für **Metrikname** **ApacheNotFoundErrorCount** ein.

1. Vergewissern Sie sich, dass **Metrikwert** „1“ lautet. Dadurch ist festgelegt, dass die Zählung für jedes Protokollereignis „404 Error“ 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 Metrikfilter zu erstellen, verwenden Sie AWS CLI**  
Führen Sie über die Eingabeaufforderung den folgenden Befehl aus:

```
aws logs put-metric-filter \
  --log-group-name MyApp/access.log \
  --filter-name HTTP404Errors \
  --filter-pattern '[ip, id, user, timestamp, request, status_code=404, size]' \
  --metric-transformations \
      metricName=ApacheNotFoundErrorCount,metricNamespace=MyNamespace,metricValue=1
```

In diesem Beispiel werden Literalzeichen wie die linke und rechte eckige Klammern, Anführungszeichen und die Zeichenfolge 404 verwendet. Das Muster muss mit der gesamten Protokollereignisnachricht für das zu überwachende Protokollereignis übereinstimmen.

Sie können überprüfen, ob der Metrikfilter erstellt wurde, indem Sie den Befehl **describe-metric-filters** ausführen. Die Ausgabe sollte in etwa wie folgt aussehen:

```
aws logs describe-metric-filters --log-group-name MyApp/access.log

{
    "metricFilters": [
        {
            "filterName": "HTTP404Errors", 
            "metricTransformations": [
                {
                    "metricValue": "1", 
                    "metricNamespace": "MyNamespace", 
                    "metricName": "ApacheNotFoundErrorCount"
                }
            ], 
            "creationTime": 1399277571078, 
            "filterPattern": "[ip, id, user, timestamp, request, status_code=404, size]"
        }
    ]
}
```

Jetzt können Sie einige Ereignisse manuell veröffentlichen:

```
aws logs put-log-events \
--log-group-name MyApp/access.log --log-stream-name hostname \
--log-events \
timestamp=1394793518000,message="127.0.0.1 - bob [10/Oct/2000:13:55:36 -0700] \"GET /apache_pb.gif HTTP/1.0\" 404 2326" \
timestamp=1394793528000,message="127.0.0.1 - bob [10/Oct/2000:13:55:36 -0700] \"GET /apache_pb2.gif HTTP/1.0\" 200 2326"
```

Kurz nachdem Sie diese Beispielprotokollereignisse gespeichert haben, können Sie die Metrik abrufen, die in der CloudWatch Konsole als benannt ist ApacheNotFoundErrorCount.

# Beispiel: Zählen von HTTP-4xx-Codes
<a name="FindCountMetric"></a>

Wie im vorherigen Beispiel sollten Sie die Zugriffsprotokolle für Webservices sowie die Ebenen des HTTP-Antwortcodes überwachen. Sie sollten beispielsweise alle Fehler auf HTTP-400-Ebene überwachen. Sie sollten jedoch einen neuen Metrikfilter für jeden Rückgabecode angeben.

Im folgenden Beispiel wird gezeigt, wie Sie eine Metrik erstellen, die alle Antworten auf der Ebene des HTTP 400-Codes aus einem Zugriffsprotokoll enthält, und dazu das Format des Apache-Zugriffsprotokolls aus dem Beispiel [Beispiel: Zählen von HTTP-404-Codes](Counting404Responses.md) verwenden.

**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 für den Apache-Server aus.

1. Wählen Sie `Actions`, **Metrikfilter erstellen** aus.

1. Geben Sie für **Filter pattern (Filtermuster)** **[ip, id, user, timestamp, request, status\$1code=4\$1, size]** ein.

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 **Next (Weiter)** und geben Sie dann für **Filter name (Filtername)** **HTTP4xxErrors** ein.

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

1. Geben Sie als **Metriknamen HTTP4xx** **Errors** ein.

1. Geben Sie für **Metric value (Metrikwert)** 1 ein. Dadurch ist festgelegt, dass die Zählung für jedes Protokollereignis, das einen „4xx“-Fehler enthält, um 1 erhöht wird.

1. Geben Sie für **Default value (Standardwert)** 0 ein und wählen Sie dann **Next (Weiter)**. 

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

**Um einen Metrikfilter zu erstellen, verwenden Sie AWS CLI**  
Führen Sie über die Eingabeaufforderung den folgenden Befehl aus:

```
aws logs put-metric-filter \
  --log-group-name MyApp/access.log \
  --filter-name HTTP4xxErrors \
  --filter-pattern '[ip, id, user, timestamp, request, status_code=4*, size]' \
  --metric-transformations \
  metricName=HTTP4xxErrors,metricNamespace=MyNamespace,metricValue=1,defaultValue=0
```

Sie können die folgenden Daten in put-Ereignisaufrufen verwenden, um diese Regel zu testen. Wenn Sie die Überwachungsregel im vorherigen Beispiel nicht entfernt haben, werden zwei verschiedene Metriken generiert.

```
127.0.0.1 - - [24/Sep/2013:11:49:52 -0700] "GET /index.html HTTP/1.1" 404 287
127.0.0.1 - - [24/Sep/2013:11:49:52 -0700] "GET /index.html HTTP/1.1" 404 287
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /~test/ HTTP/1.1" 200 3
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /favicon.ico HTTP/1.1" 404 308
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /favicon.ico HTTP/1.1" 404 308
127.0.0.1 - - [24/Sep/2013:11:51:34 -0700] "GET /~test/index.html HTTP/1.1" 200 3
```

# Beispiel: Extrahieren von Feldern aus einem Apache-Protokoll und Zuweisen von Dimensionen
<a name="ExtractBytesExample"></a>

Manchmal ist es hilfreich, Werte aus einzelnen Protokollereignissen für Metrikwerte zu verwenden statt sie zu zählen. In diesem Beispiel wird gezeigt, wie Sie eine Extraktionsregel zum Erstellen einer Metrik erstellen können, mit der die von einem Apache-Webserver übertragenen Bytes gemessen werden.

In diesem Beispiel wird auch gezeigt, wie Sie der Metrik, die Sie erstellen, Dimensionen zuweisen.

**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 für den Apache-Server aus.

1. Wählen Sie `Actions`, **Metrikfilter erstellen** aus.

1. Geben Sie für **Filter pattern (Filtermuster)** **[ip, id, user, timestamp, request, status\$1code, size]** ein.

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 **Next (Weiter)** und geben Sie dann für **Filter name (Filtername)** **size** ein.

1. Geben Sie unter **Metric details (Metrikdetails)** für **Metric Namespace (Metrik-Namespace)** **MyNameSpace** ein. Da es sich um einen neuen Namespace handelt, stellen Sie sicher, dass **Create new (Neu erstellen)** ausgewählt ist.

1. Geben Sie für **Metric name (Metrikname)** **BytesTransferred** ein

1. Geben Sie für **Metric value (Metrikwert)** **\$1size** ein.

1. Wählen Sie für **Unit (Einheit)** **Byte** aus.

1. Geben Sie unter **Dimension Name** die Zeichenfolge **IP** ein.

1. Geben Sie für **Dimension Value (Dimensionswert)** **\$1ip** ein und wählen Sie dann **Next (Weiter)**.

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

**Um diesen Metrikfilter mit dem AWS CLI**  
Führen Sie über die Eingabeaufforderung den folgenden Befehl aus.

```
aws logs put-metric-filter \
--log-group-name MyApp/access.log \
 --filter-name BytesTransferred \
 --filter-pattern '[ip, id, user, timestamp, request, status_code, size]' \
 --metric-transformations  \
 metricName=BytesTransferred,metricNamespace=MyNamespace,metricValue='$size'
```

```
aws logs put-metric-filter \
--log-group-name MyApp/access.log \
--filter-name BytesTransferred \
--filter-pattern '[ip, id, user, timestamp, request, status_code, size]' \
--metric-transformations  \
metricName=BytesTransferred,metricNamespace=MyNamespace,metricValue='$size',unit=Bytes,dimensions='{{IP=$ip}}'
```

**Anmerkung**  
Verwenden Sie in diesem Befehl dieses Format, um mehrere Dimensionen anzugeben.  

```
aws logs put-metric-filter \
--log-group-name my-log-group-name \
--filter-name my-filter-name \
--filter-pattern 'my-filter-pattern' \
--metric-transformations  \
metricName=my-metric-name,metricNamespace=my-metric-namespace,metricValue=my-token,unit=unit,dimensions='{dimension1=$dim,dimension2=$dim2,dim3=$dim3}'
```

Sie können die folgenden Daten in put-log-event Aufrufen verwenden, um diese Regel zu testen. Damit werden zwei unterschiedliche Metriken erstellt, wenn Sie die Überwachungsregel im vorherigen Beispiel nicht entfernt haben.

```
127.0.0.1 - - [24/Sep/2013:11:49:52 -0700] "GET /index.html HTTP/1.1" 404 287
127.0.0.1 - - [24/Sep/2013:11:49:52 -0700] "GET /index.html HTTP/1.1" 404 287
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /~test/ HTTP/1.1" 200 3
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /favicon.ico HTTP/1.1" 404 308
127.0.0.1 - - [24/Sep/2013:11:50:51 -0700] "GET /favicon.ico HTTP/1.1" 404 308
127.0.0.1 - - [24/Sep/2013:11:51:34 -0700] "GET /~test/index.html HTTP/1.1" 200 3
```

# Auflisten von Metrikfiltern
<a name="ListingMetricFilters"></a>

Sie können alle Metrikfilter in einer Protokollgruppe auflisten.

**Um Metrikfilter mithilfe der CloudWatch Konsole aufzulisten**

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 im Inhaltsbereich in der Liste der Protokollgruppen in der Spalte **Metric Filters** die Anzahl der Filter aus.

   Auf dem Bildschirm **Log Groups > Filters for** werden alle Metrikfilter für die Protokollgruppe aufgelistet.

**Um metrische Filter aufzulisten, verwenden Sie AWS CLI**  
Führen Sie über die Eingabeaufforderung den folgenden Befehl aus:

```
aws logs describe-metric-filters --log-group-name MyApp/access.log
```

Das Folgende ist eine Beispielausgabe:

```
{
    "metricFilters": [
        {
            "filterName": "HTTP404Errors", 
            "metricTransformations": [
                {
                    "metricValue": "1", 
                    "metricNamespace": "MyNamespace", 
                    "metricName": "ApacheNotFoundErrorCount"
                }
            ], 
            "creationTime": 1399277571078, 
            "filterPattern": "[ip, id, user, timestamp, request, status_code=404, size]"
        }
    ]
}
```

# Löschen eines Metrikfilters
<a name="DeletingMetricFilter"></a>

Eine Richtlinie wird anhand des Namens und der entsprechenden Protokollgruppe identifiziert.

**Um einen Metrikfilter mit der CloudWatch Konsole zu löschen**

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 im Inhaltsbereich in der Spalte **Metric Filter (Metrikfilter)** die Anzahl der Metrikfilter für die Protokollgruppe aus.

1. Wählen Sie unter **Metric Filters (Metrikfilter)** das Kontrollkästchen rechts neben dem Namen des Filters aus, den Sie löschen möchten. Wählen Sie dann **Löschen** aus.

1. Wenn Sie zur Bestätigung aufgefordert werden, wählen Sie **Delete (Löschen)**.

**Um einen metrischen Filter mit dem zu löschen AWS CLI**  
Führen Sie über die Eingabeaufforderung den folgenden Befehl aus:

```
aws logs delete-metric-filter --log-group-name MyApp/access.log \
 --filter-name MyFilterName
```