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 Metrikfiltern
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
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
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
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
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
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
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
```