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.
# Veröffentlichen von benutzerdefinierten Metriken
Sie können Ihre eigenen Messwerte CloudWatch mithilfe des OpenTelemetry Protokolls (OTLP) oder der CloudWatch API veröffentlichen.
## Veröffentlichen Sie Metriken mit OpenTelemetry (empfohlen)
Für neue Implementierungen empfehlen wir die Verwendung von OpenTelemetry zum Veröffentlichen benutzerdefinierter Metriken in CloudWatch. OpenTelemetry bietet herstellerunabhängige Instrumentierung mit umfangreicheren beschreibenden Bezeichnungen und Unterstützung für Metriktypen wie Messwert, Summe, Histogramm und Exponentialhistogramm.
Um Metriken zu veröffentlichen, konfigurieren Sie Ihren OpenTelemetry Collector oder Ihr SDK so OpenTelemetry, dass Metriken an den OTLP-Endpunkt gesendet werden. CloudWatch Über OTLP gesendete Metriken können mit der Prometheus Query Language (PromQL) in Query Studio abgefragt werden. CloudWatch Sie können auch CloudWatch ProMQL-basierte Alarme für diese Metriken einrichten.
Hauptunterschiede zum API-Ansatz: CloudWatch
| Feature | OpenTelemetry (OTLP) | CloudWatch API () PutMetricData |
| --- | --- | --- |
| Beschriftungen pro Metrik | Bis zu 150 | Bis zu 30 Dimensionen |
| Metriktypen | Messgerät, Summe, Histogramm, Exponentialhistogramm | Einzelwerte, Statistiksätze |
| Granularity | In der gesendeten Auflösung aufgenommen | 1 Sekunde (hohe Auflösung) oder 1 Minute (Standard) |
| Sprache der Abfrage | PromQL | GetMetricStatistics, Einblicke in Metriken |
| Alarme | ProMQL-basierte Alarme CloudWatch | CloudWatch Standardalarme |
| Instrumentierung | Herstellerunabhängig und für Sammler OpenTelemetry SDKs | AWS SDK oder CLI |
Informationen zu den ersten Schritten finden Sie unter [Metriken senden mit OpenTelemetry](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OpenTelemetry-Sections.html).
## Veröffentlichen Sie Metriken mithilfe der CloudWatch API
Sie können benutzerdefinierte Metriken auch mithilfe der PutMetricData API oder der veröffentlichen AWS CLI. Bei diesem Ansatz werden CloudWatch Namespaces, Metriknamen und Dimensionen verwendet.
**Topics**
+ [Veröffentlichen Sie Metriken mit OpenTelemetry (empfohlen)](#publishMetricsOTLP)
+ [Veröffentlichen Sie Metriken mithilfe der CloudWatch API](#publishMetricsCWAPI)
+ [Hochauflösende Metriken](#high-resolution-metrics)
+ [Dimensionen verwenden](#usingDimensions)
+ [Einzelne Datenpunkte veröffentlichen](#publishingDataPoints)
+ [Statistikgruppen veröffentlichen](#publishingDataPoints1)
+ [Den Nullwert veröffentlichen](#publishingZero)
+ [Veröffentlichen von Metriken beenden](#CloudWatch-Stop-Publishing-Metrics)
## Hochauflösende Metriken
Jede Metrik entspricht einer der folgenden:
+ Standardauflösung; hierbei haben die Daten eine Granularität von einer Minute
+ Hohe Auflösung; hierbei haben die Daten eine Granularität von einer Sekunde
Von AWS Diensten erzeugte Metriken haben standardmäßig die Standardauflösung. Wenn Sie eine benutzerdefinierte Metrik veröffentlichen, hat diese entweder die Standardauflösung oder eine hohe Auflösung. Wenn Sie eine Metrik mit hoher Auflösung veröffentlichen, wird sie mit einer Auflösung von 1 Sekunde CloudWatch gespeichert, sodass Sie sie mit einem Zeitraum von 1 Sekunde, 5 Sekunden, 10 Sekunden, 30 Sekunden oder einem beliebigen Vielfachen von 60 Sekunden lesen und abrufen können.
Mit hochauflösenden Metriken erhalten Sie genauere Einblicke in die Aktivitäten Ihrer Anwendung, die unter einer Minute liegen. Denken Sie daran, dass jeder `PutMetricData`-Aufruf einer benutzerdefinierten Metrik in Rechnung gestellt wird, sodass höhere Gebühren entstehen können, wenn Sie häufiger `PutMetricData`-Aufrufe hochauflösender Metrik ausführen. Weitere Informationen zur CloudWatch Preisgestaltung finden Sie unter [ CloudWatch Amazon-Preise](https://aws.amazon.com/cloudwatch/pricing/).
Wenn Sie einen Alarm für eine hochauflösende Metrik festlegen, können Sie einen hochauflösenden Alarm für einen Zeitraum von 10 Sekunden oder 30 Sekunden oder einen regelmäßigen Alarm für einen Zeitraum festlegen, der ein Mehrfaches von 60 Sekunden beträgt. Die Gebühr für hochauflösende Alarme mit einem Zeitraum von 10 oder 30 Sekunden ist höher.
## Dimensionen verwenden
In benutzerdefinierten Metriken, wird der Parameter `--dimensions` häufig verwendet. Eine Dimension macht außerdem deutlich, um welche Metrik es sich handelt und welche Daten darin gespeichert werden. Sie können einer Metrik bis zu 30 Dimensionen zuweisen, und jede Dimension wird durch ein Name-Wert-Paar definiert.
Die Art und Weise, wie Sie eine Dimension angeben, ist bei der Verwendung verschiedener Befehle unterschiedlich. Mit [put-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-data.html)geben Sie jede Dimension als *MyName* = an*MyValue*, und mit [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)oder verwenden [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html)Sie das Format `Name=`*MyName*, `Value=`*MyValue*. Mit dem folgenden Befehl wird eine `Buffers`-Metrik mit zwei Dimensionen namens `InstanceId` und `InstanceType` veröffentlicht.
```
aws cloudwatch put-metric-data --metric-name Buffers --namespace MyNameSpace --unit Bytes --value 231434333 --dimensions InstanceId=1-23456789,InstanceType=m1.small
```
Dieser Befehl ruft die Statistiken für dieselbe Metrik ab. Trennen Sie Namen und Wert einer einzelnen Dimension durch Kommata voneinander ab. Wenn Sie mit mehreren Dimensionen arbeiten, verwenden Sie zwischen einer Dimension und der nächsten ein Leerzeichen.
```
aws cloudwatch get-metric-statistics --metric-name Buffers --namespace MyNameSpace --dimensions Name=InstanceId,Value=1-23456789 Name=InstanceType,Value=m1.small --start-time 2016-10-15T04:00:00Z --end-time 2016-10-19T07:00:00Z --statistics Average --period 60
```
Wenn eine einzelne Metrik mehrere Dimensionen umfasst, müssen Sie bei der Verwendung einen Wert für jede definierte Dimension angeben [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html). Die Amazon S3 S3-Metrik `BucketSizeBytes` umfasst beispielsweise die Dimensionen `BucketName` und`StorageType`, sodass Sie beide Dimensionen mit angeben müssen [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html).
```
aws cloudwatch get-metric-statistics --metric-name BucketSizeBytes --start-time 2017-01-23T14:23:00Z --end-time 2017-01-26T19:30:00Z --period 3600 --namespace AWS/S3 --statistics Maximum --dimensions Name=BucketName,Value=amzn-s3-demo-bucket Name=StorageType,Value=StandardStorage --output table
```
Um die für eine Metrik definierten Dimensionen anzuzeigen, verwenden Sie den Befehl [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html).
## Einzelne Datenpunkte veröffentlichen
Um einen einzelnen Datenpunkt für eine neue oder bestehende Metrik zu veröffentlichen, verwenden Sie den [put-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-data.html)Befehl mit einem Wert und einem Zeitstempel. Die folgenden Aktionen veröffentlichen z. B. jeweils einen Datenpunkt.
```
aws cloudwatch put-metric-data --metric-name PageViewCount --namespace MyService --value 2 --timestamp 2016-10-20T12:00:00.000Z
aws cloudwatch put-metric-data --metric-name PageViewCount --namespace MyService --value 4 --timestamp 2016-10-20T12:00:01.000Z
aws cloudwatch put-metric-data --metric-name PageViewCount --namespace MyService --value 5 --timestamp 2016-10-20T12:00:02.000Z
```
Wenn Sie diesen Befehl mit einem neuen Metriknamen aufrufen, CloudWatch wird eine Metrik für Sie erstellt. Ordnet CloudWatch andernfalls Ihre Daten der vorhandenen Metrik zu, die Sie angegeben haben.
**Anmerkung**
Wenn Sie eine Metrik erstellen, kann es bis zu 2 Minuten dauern, bis Sie mit dem [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)Befehl Statistiken für die neue Metrik abrufen können. Es kann jedoch bis zu 15 Minuten dauern, bevor die neue Metrik in der Liste der Metriken angezeigt wird, die mit dem Befehl [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) abgerufen wird.
Sie können zwar Datenpunkte mit Zeitstempeln veröffentlichen, die bis zu einer Tausendstelsekunde genau sind, CloudWatch aggregiert die Daten jedoch auf eine Mindestgranularität von 1 Sekunde. CloudWatch zeichnet den Durchschnitt (Summe aller Elemente geteilt durch die Anzahl der Elemente) der für jeden Zeitraum erhaltenen Werte sowie die Anzahl der Stichproben, den Höchstwert und den Minimalwert für denselben Zeitraum auf. Die Metrik `PageViewCount` aus den vorherigen Beispielen enthält z. B. drei Datenpunkte mit Zeitstempeln im Abstand von wenigen Sekunden. Wenn Sie Ihren Zeitraum auf 1 Minute festgelegt haben, werden die drei Datenpunkte CloudWatch aggregiert, da sie alle Zeitstempel innerhalb eines Zeitraums von 1 Minute haben.
Mit dem Befehl **get-metric-statistics** können Sie Statistiken basierend auf den veröffentlichten Datenpunkten abrufen.
```
aws cloudwatch get-metric-statistics --namespace MyService --metric-name PageViewCount \
--statistics "Sum" "Maximum" "Minimum" "Average" "SampleCount" \
--start-time 2016-10-20T12:00:00.000Z --end-time 2016-10-20T12:05:00.000Z --period 60
```
Es folgt eine Beispielausgabe.
```
{
"Datapoints": [
{
"SampleCount": 3.0,
"Timestamp": "2016-10-20T12:00:00Z",
"Average": 3.6666666666666665,
"Maximum": 5.0,
"Minimum": 2.0,
"Sum": 11.0,
"Unit": "None"
}
],
"Label": "PageViewCount"
}
```
## Statistikgruppen veröffentlichen
Sie können Ihre Daten vor dem Veröffentlichen in aggregieren. CloudWatch Bei mehreren Datenpunkten pro Minute wird die Anzahl der Aufrufe für **put-metric-data** durch die Aggregierung der Daten minimiert. Anstatt zum Beispiel den Befehl **put-metric-data** mehrfach für drei Datenpunkte aufzurufen, die in einem Abstand von drei Sekunden zueinander liegen, können Sie die Daten in einer Statistikgruppe zusammenfassen (= aggregieren), die Sie mit einem Aufruf mit dem Parameter `--statistic-values` veröffentlichen.
```
aws cloudwatch put-metric-data --metric-name PageViewCount --namespace MyService --statistic-values Sum=11,Minimum=2,Maximum=5,SampleCount=3 --timestamp 2016-10-14T12:00:00.000Z
```
CloudWatch benötigt Rohdatenpunkte, um Perzentile zu berechnen. Wenn Sie Daten stattdessen mit einer Statistikgruppe veröffentlichen, können Sie nur dann eine Perzentil-Statistik für diese Daten abrufen, wenn eine der folgenden Bedingungen erfüllt ist:
+ Der `SampleCount` der Statistikgruppe ist 1.
+ `Minimum` und `Maximum` der Statistikgruppe sind gleich.
## Den Nullwert veröffentlichen
Wenn Ihre Daten seltener erfasst werden und es Zeiträume ohne verknüpfte Daten gibt, können Sie den Wert Null (`0`) für diesen Zeitraum oder gar keinen Wert veröffentlichen. Wenn Sie durch regelmäßige Aufrufe an `PutMetricData` den Zustand Ihrer Anwendung überwachen, können Sie Null anstelle von gar keinem Wert veröffentlichen. Sie können beispielsweise einen CloudWatch -Alarm festlegen, der Sie benachrichtigt, wenn Ihre Anwendung nicht alle fünf Minuten Metriken veröffentlicht. Eine solche Anwendung soll für die Zeiträume ohne verknüpfte Daten Nullen veröffentlichen.
Sie können auch Nullen veröffentlichen, wenn Sie die Gesamtzahl der Datenpunkte nachverfolgen möchten, oder um Statistiken, wie z. B. Mindest- und durchschnittliche Datenpunkte, den Wert "0" enthalten sollen.
## Veröffentlichen von Metriken beenden
Um die Veröffentlichung benutzerdefinierter Messwerte für zu beenden CloudWatch, ändern Sie den Code Ihrer Anwendung oder Ihres Dienstes so, dass er nicht mehr verwendet wird. **PutMetricData** CloudWatch ruft keine Metriken aus Anwendungen ab, sondern empfängt nur das, was an sie weitergeleitet wird. Um also die Veröffentlichung Ihrer Metriken zu beenden, müssen Sie sie an der Quelle stoppen.