Szenario: Veröffentlichen von CloudWatch-Metriken
In diesem Szenario verwenden Sie die AWS Command Line Interface (AWS CLI), um eine einzelne Metrik für eine hypothetische Anwendung mit dem Namen GetStarted zu veröffentlichen. Falls Sie die AWS CLI noch nicht installiert und konfiguriert haben, finden Sie dazu Informationen unter Einrichtung mit der AWS Command Line Interface im AWS Command Line Interface-Benutzerhandbuch.
Aufgaben
Schritt 1: Festlegen der Datenkonfiguration
In diesem Szenario veröffentlichen Sie Datenpunkte, mit denen die Anfragelatenz für die Anwendung nachverfolgt wird. Wählen Sie einen Namen für die Metrik und den Namespace, den Sie für sinnvoll halten. Vergeben Sie für die Metrik in diesem Beispiel den Namen RequestLatency und platzieren Sie alle Datenpunkte im Namespace GetStarted.
Sie veröffentlichen mehrere Datenpunkte, die zusammen 3 Stunden Latenzdaten ergeben. Die Rohdaten umfassen 15 über drei Stunden verteilte Anfragelatenz-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 in CloudWatch als einzelne Datenpunkte veröffentlichen oder als aggregierte Gruppe von Datenpunkten, die so genannte Statistikgruppe. 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 |
|---|---|---|---|---|---|
|
|
||||
|
|
||||
|
|
||||
|
|
||||
|
|
|
|
|
|
|
|
|
|
|
|
Schritt 2: Hinzufügen von Metriken zu CloudWatch
Nachdem Sie die Konfiguration Ihrer Daten festgelegt haben, können Sie die Daten hinzufügen.
So veröffentlichen Sie Datenpunkte in CloudWatch
-
Führen Sie bei der Eingabeaufforderung die folgenden Befehle put-metric-data 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 \ --timestamp2016-10-14T20:30:00Z--value 87 --unit Milliseconds aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \ --timestamp2016-10-14T20:30:00Z--value 51 --unit Milliseconds aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \ --timestamp2016-10-14T20:30:00Z--value 125 --unit Milliseconds aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \ --timestamp2016-10-14T20:30:00Z--value 235 --unit Milliseconds -
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 \ --timestamp2016-10-14T21:30:00Z--statistic-values Sum=577,Minimum=65,Maximum=189,SampleCount=5 --unit Milliseconds -
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: Statistiken von CloudWatch abrufen
Nachdem Sie nun die Metriken in CloudWatch veröffentlicht haben, können Sie die auf diesen Metriken basierenden Statistiken abrufen, indem Sie den Befehl get-metric-statistics wie folgt verwenden. 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-time2016-10-14T00:00:00Z--end-time2016-10-15T00:00:00Z--period 60
Das Folgende ist Ausgabebeispiel:
{ "Datapoints": [], "Label": "Request:Latency" }
Schritt 4: Anzeigen von Schaubildern mit der Konsole
Nach dem Veröffentlichen von Metriken in CloudWatch können Sie die CloudWatch-Konsole verwenden, um sich statistische Schaubilder anzeigen zu lassen.
So zeigen Sie Schaubilder Ihrer Statistiken auf der Konsole an
-
Öffnen Sie die CloudWatch-Konsole unter https://console.aws.amazon.com/cloudwatch/
. -
Wählen Sie im Bereich Navigation Metrics aus.
-
Geben Sie auf der Registerkarte All metrics (Alle Metriken) in das Suchfeld RequestLatency ein und drücken Sie die Eingabetaste.
-
Aktivieren Sie das Kontrollkästchen für die Metrik RequestLatency. Im oberen Bereich wird ein Schaubild der Metrikdaten angezeigt.
Weitere Informationen finden Sie unter Grafisches Darstellen von Metriken.