

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.

# Szenario: Metriken veröffentlichen in CloudWatch
<a name="PublishMetrics"></a>

In diesem Szenario verwenden Sie AWS Command Line Interface (AWS CLI), um eine einzelne Metrik für eine hypothetische Anwendung mit dem Namen zu veröffentlichen. *GetStarted* Falls Sie den noch nicht installiert und konfiguriert haben AWS CLI, finden Sie weitere Informationen unter [Getting Up with the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) im *AWS Command Line Interface Benutzerhandbuch*.

**Topics**
+ [Schritt 1: Festlegen der Datenkonfiguration](#define-data-domain)
+ [Schritt 2: Fügen Sie Metriken hinzu CloudWatch](#add-metrics-to-scenario)
+ [Schritt 3: Holen Sie sich Statistiken von CloudWatch](#GetStatistics)
+ [Schritt 4: Anzeigen von Schaubildern mit der Konsole](#ViewGraphs)

## Schritt 1: Festlegen der Datenkonfiguration
<a name="define-data-domain"></a>

In diesem Szenario veröffentlichen Sie Datenpunkte, mit denen die Anforderungslatenz für die Anwendung nachverfolgt wird. Wählen Sie einen Namen für die Metrik und den Namespace, den Sie für sinnvoll halten. Geben Sie in diesem Beispiel der Metrik einen Namen *RequestLatency*und platzieren Sie alle Datenpunkte im *GetStarted*Namespace. 

Sie veröffentlichen mehrere Datenpunkte, die zusammen 3 Stunden Latenzdaten ergeben. Die Rohdaten umfassen 15 über drei Stunden verteilte Anforderungslatenz-Messwerte. Jeder Messwert wird in Millisekunden dargestellt: 
+ Stunde eins: 87, 51, 125, 235
+ Stunde zwei: 121, 113, 189, 65, 89
+ Stunde drei: 100, 47, 133, 98, 100, 328

Sie können Daten CloudWatch als einzelne Datenpunkte oder als aggregierten Satz von Datenpunkten, der als *Statistiksatz* bezeichnet wird, veröffentlichen. Sie können Metriken mit einer Granularität von bis zu einer Minute aggregieren. Sie können die aggregierten Datenpunkte in CloudWatch als eine Gruppe von Statistiken mit vier vordefinierten Schlüsseln veröffentlichen: `Sum`, `Minimum`, `Maximum` und `SampleCount`.

Sie veröffentlichen die Datenpunkte aus einer Stunde als einzelne Datenpunkte. Für die Daten aus den Stunden zwei und drei aggregieren Sie die Datenpunkte und veröffentlichen eine Statistikgruppe für jede Stunde. Die wichtigsten Werte sind in der folgenden Tabelle gezeigt.


| Stunde | Rohdaten | Summe | Minimum | Maximum | SampleCount | 
| --- | --- | --- | --- | --- | --- | 
| `1` | `87` |  |  |  |  | 
| `1` | `51` |  |  |  |  | 
| `1` | `125` |  |  |  |  | 
| `1` | `235` |  |  |  |  | 
| `2` | `121, 113, 189, 65, 89` | `577` | `65` | `189` | `5` | 
| `3` | `100, 47, 133, 98, 100, 328` | `806` | `47` | `328` | `6` | 

## Schritt 2: Fügen Sie Metriken hinzu CloudWatch
<a name="add-metrics-to-scenario"></a>

Nachdem Sie die Konfiguration Ihrer Daten festgelegt haben, können Sie die Daten hinzufügen.

**Um Datenpunkte zu veröffentlichen CloudWatch**

1. Führen Sie in einer Befehlszeile die folgenden [put-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-data.html)Befehle aus, um Daten für die erste Stunde hinzuzufügen. Ersetzen Sie den beispielhaften Zeitstempel durch einen Zeitstempel in koordinierter Weltzeit (UTC, Coordinated Universal Time), der zwei Stunden in der Vergangenheit liegt.

   ```
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --timestamp {{2016-10-14T20:30:00Z}} --value 87 --unit Milliseconds
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --timestamp {{2016-10-14T20:30:00Z}} --value 51 --unit Milliseconds
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --timestamp {{2016-10-14T20:30:00Z}} --value 125 --unit Milliseconds
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --timestamp {{2016-10-14T20:30:00Z}} --value 235 --unit Milliseconds
   ```

1. Fügen Sie Daten für die zweite Stunde hinzu, und verwenden Sie dazu einen Zeitstempel, der eine Stunde später als die erste Stunde liegt.

   ```
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --timestamp {{2016-10-14T21:30:00Z}} --statistic-values Sum=577,Minimum=65,Maximum=189,SampleCount=5 --unit Milliseconds
   ```

1. Fügen Sie Daten für die dritte Stunde hinzu und lassen Sie dabei den standardmäßig auf die aktuelle Zeit eingestellten Zeitstempel weg. 

   ```
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --statistic-values Sum=806,Minimum=47,Maximum=328,SampleCount=6 --unit Milliseconds
   ```

## Schritt 3: Holen Sie sich Statistiken von CloudWatch
<a name="GetStatistics"></a>

Nachdem Sie nun Metriken veröffentlicht haben CloudWatch, können Sie mithilfe des folgenden [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)Befehls Statistiken abrufen, die auf diesen Metriken basieren. Stellen Sie sicher, dass Sie die `--start-time` und `--end-time` weit genug in der Vergangenheit abgeben, um den frühesten Zeitstempel, den Sie veröffentlicht haben, mit zu erfassen.

```
aws cloudwatch get-metric-statistics --namespace GetStarted --metric-name RequestLatency --statistics Average \
--start-time {{2016-10-14T00:00:00Z}} --end-time {{2016-10-15T00:00:00Z}} --period 60
```

Das Folgende ist eine Beispielausgabe:

```
{
	"Datapoints": [],
	"Label": "Request:Latency"
}
```

## Schritt 4: Anzeigen von Schaubildern mit der Konsole
<a name="ViewGraphs"></a>

Nachdem Sie Metriken veröffentlicht haben CloudWatch, können Sie die CloudWatch Konsole verwenden, um statistische Diagramme anzuzeigen.

**So zeigen Sie Schaubilder Ihrer Statistiken auf der Konsole an**

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

1. Wählen Sie im Bereich **Navigation** **Metrics** aus.

1. Geben Sie auf der Registerkarte **Alle Metriken** in das Suchfeld ein **RequestLatency**und drücken Sie die Eingabetaste.

1. Aktivieren Sie das Kontrollkästchen für die **RequestLatency**Metrik. Im oberen Bereich wird ein Schaubild der Metrikdaten angezeigt.

Weitere Informationen finden Sie unter [Grafisches Darstellen von Metriken](graph_metrics.md).