

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.

# Überwachen Sie EC2 Amazon-API-Anfragen mit Amazon CloudWatch
<a name="monitor"></a>

Sie können EC2 Amazon-API-Anfragen mithilfe von Amazon CloudWatch überwachen. Amazon sammelt Rohdaten und verarbeitet sie zu lesbaren, nahezu in Echtzeit verfügbaren Metriken. Diese Metriken bieten eine einfache Möglichkeit, die Nutzung und die Ergebnisse der EC2 Amazon-API-Operationen im Laufe der Zeit zu verfolgen. Diese Informationen geben Ihnen einen besseren Überblick über die Leistung Ihrer Webanwendungen und ermöglichen es Ihnen, eine Vielzahl von Problemen zu identifizieren und zu diagnostizieren. Sie können auch Alarme einrichten, die auf bestimmte Schwellenwerte achten und Benachrichtigungen senden oder bestimmte Maßnahmen ergreifen, wenn diese Schwellenwerte erreicht werden.

Weitere Informationen zu CloudWatch finden Sie im [ CloudWatch Amazon-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).

**Wichtig**  
Amazon EC2 API-Metriken sind eine optionale Funktion. Sie müssen Zugriff auf diese Funktion beantragen. Weitere Informationen finden Sie unter [EC2 Amazon-API-Metriken aktivieren](#enable-ec2-api-metrics).

**Topics**
+ [

## EC2 Amazon-API-Metriken aktivieren
](#enable-ec2-api-metrics)
+ [

## EC2 Amazon-API-Metriken und -Dimensionen
](#monitor-metrics_dimensions)
+ [

## Aufbewahrung metrischer Daten
](#monitor-retention)
+ [

## Überwachung von Anfragen, die in Ihrem Namen gestellt wurden
](#throttling-metrics)
+ [

## Fakturierung
](#monitor-billing)
+ [

## Mit Amazon arbeiten CloudWatch
](#monitor-using)

## EC2 Amazon-API-Metriken aktivieren
<a name="enable-ec2-api-metrics"></a>

Gehen Sie wie folgt vor, um Zugriff auf diese Funktion für Sie anzufordern AWS-Konto.

**Um Zugriff auf diese Funktion anzufordern**

1. [AWS Support Zentrum](https://console.aws.amazon.com/support/home#/) öffnen.

1. Wählen Sie **Create case** (Fall erstellen) aus.

1. Wählen Sie **Konto und Fakturierung** aus.

1. Wählen Sie für **Service** **die Optionen Allgemeine Informationen und Erste Schritte** aus.

1. Wählen Sie als **Kategorie** die Option **Nutzung AWS und Dienste** aus.

1. Wählen Sie **Next step: Additional information** (Nächster Schritt: Zusätzliche Informationen).

1. Geben Sie unter **Subject (Betreff)** **Request access to Amazon EC2 API metrics** ein.

1. Geben Sie für **Beschreibung** den Text **Please grant my account access to Amazon EC2 API metrics. Related page: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/monitor.html** ein. Geben Sie auch die Region an, auf die Sie Zugriff benötigen.

1. Klicken Sie auf **Next step: Solve now or contact us** ( ()Nächster Schritt): Jetzt lösen oder Support kontaktieren).

1. Wählen Sie auf der Registerkarte **Kontakt** Ihre bevorzugte Kontaktsprache und Kontaktmethode aus.

1. Wählen Sie **Absenden** aus.

## EC2 Amazon-API-Metriken und -Dimensionen
<a name="monitor-metrics_dimensions"></a>

### Kennzahlen
<a name="monitor-metrics"></a>

Die EC2 Amazon-API-Metriken sind im `AWS/EC2/API` Namespace enthalten. In den folgenden Tabellen sind die Metriken aufgeführt, die für EC2 Amazon-API-Anfragen verfügbar sind.


| Metrik | Description | 
| --- | --- | 
|  `ClientErrors` |  Die Anzahl der fehlgeschlagenen API-Anfragen, die durch Client-Fehler verursacht wurden. Diese Fehler werden normalerweise durch etwas verursacht, das der Client getan hat, z. B. durch die Angabe eines falschen oder ungültigen Parameters in der Anfrage oder durch die Verwendung einer Aktion oder Ressource im Namen eines Benutzers, der nicht berechtigt ist, die Aktion oder Ressource zu verwenden. Einheit: Anzahl  | 
|  `RequestLimitExceeded` |  Wie oft die von Amazon zulässige maximale Anforderungsrate für Ihr Konto überschritten EC2 APIs wurde.  EC2 Amazon-API-Anfragen werden gedrosselt, um die Leistung des Service aufrechtzuerhalten. Wenn Ihre Anfragen gedrosselt wurden, erhalten Sie die Fehlermeldung. `Client.RequestLimitExceeded` Einheit: Anzahl  | 
|  `AwsTriggeredRequestLimitExceeded` |  Die Anzahl der fehlgeschlagenen API-Anfragen, die durch die Drosselung verursacht wurden, die aufgrund eines Betriebsproblems angewendet AWS wurde. Wenn diese Drosselung auftritt, erhalten Sie eine `Client.RequestLimitExceeded` Fehlermeldung mit der Meldung, dass Ihre Anfrage aufgrund eines Betriebsproblems gedrosselt wurde. AWS Diese Drosselung ist vorübergehend und wird automatisch behoben, sobald das Betriebsproblem behoben ist. Implementieren Sie eine exponentielle Backoff- und Wiederholungslogik, um diese temporären Drosselungen problemlos zu handhaben. Einheit: Anzahl  | 
|  `ServerErrors` |  Die Anzahl der fehlgeschlagenen API-Anfragen, die durch interne Serverfehler verursacht wurden. Diese Fehler werden normalerweise durch einen AWS serverseitigen Fehler, eine Ausnahme oder einen Ausfall verursacht. Einheit: Anzahl  | 
|  `SuccessfulCalls` |  Die Anzahl der erfolgreichen API-Anfragen. Einheit: Anzahl  | 

### Dimensionen
<a name="monitor-dimensions"></a>

Die EC2 Amazon-Metrikdaten können für alle EC2 API-Aktionen gefiltert werden. Weitere Informationen zu Dimensionen finden Sie unter [ CloudWatch Amazon-Konzepte](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html).

## Aufbewahrung metrischer Daten
<a name="monitor-retention"></a>

 EC2 Amazon-API-Metriken werden in Intervallen von 1 Minute CloudWatch an gesendet. CloudWatch speichert Metrikdaten wie folgt:
+ Datenpunkte mit einem Zeitraum von 60 Sekunden (1 Minute) stehen 15 Tage lang zur Verfügung
+ Datenpunkte mit einem Zeitraum von 300 Sekunden (5 Minuten) sind 63 Tage lang verfügbar.
+ Datenpunkte mit einem Zeitraum von 3600 Sekunden (1 Stunde) sind für 455 Tage (15 Monate) verfügbar.

## Überwachung von Anfragen, die in Ihrem Namen gestellt wurden
<a name="throttling-metrics"></a>

API-Anfragen, die von AWS Diensten in Ihrem Namen gestellt werden, wie Anfragen von dienstbezogenen Rollen, werden nicht auf Ihre API-Drosselungslimits angerechnet und sie senden keine Kennzahlen CloudWatch für Ihr Konto an Amazon. Diese Anfragen können nicht überwacht werden mit. CloudWatch

API-Anfragen, die in Ihrem Namen von Drittanbietern gestellt werden, werden auf Ihre API-Drosselungslimits angerechnet und sie senden Messwerte CloudWatch für Ihr Konto an Amazon. Diese Anfragen können mit überwacht werden. CloudWatch

## Fakturierung
<a name="monitor-billing"></a>

Es gelten die CloudWatch Standardpreise und Gebühren. Für die Nutzung der EC2 Amazon-API-Metriken fallen keine zusätzlichen Gebühren an. Weitere Informationen finden Sie unter [ CloudWatch Amazon-Preise](https://aws.amazon.com/cloudwatch/pricing/).

## Mit Amazon arbeiten CloudWatch
<a name="monitor-using"></a>

**Contents**
+ [

### CloudWatch Metriken anzeigen
](#monitor-using-viewing)
+ [

### CloudWatch Alarme erstellen
](#monitor-creating)

### CloudWatch Metriken anzeigen
<a name="monitor-using-viewing"></a>

Gehen Sie wie folgt vor, um die EC2 Amazon-API-Metriken anzuzeigen.

**Voraussetzung**  
Sie müssen den Zugriff auf EC2 Amazon-API-Metriken für Ihr Konto aktivieren. Weitere Informationen finden Sie unter [EC2 Amazon-API-Metriken aktivieren](#enable-ec2-api-metrics).

**So zeigen Sie die EC2 Amazon-API-Metriken mit 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 Navigationsbereich **Metriken**, **Alle Metriken** aus.

1. Wählen Sie auf der Registerkarte **Durchsuchen** unter **Metriken** die gewünschte Region aus, um die Metriken anzuzeigen.

1. Wählen Sie den **EC2**Metrik-Namespace aus.

1. Um die Metriken anzuzeigen, wählen Sie die Metrikdimension aus, z. B. Metriken **pro Instanz**.
**Anmerkung**  
Metriken werden nach zwei Wochen Inaktivität ausgeblendet. Wenn sie in den letzten zwei Wochen keine neuen Datenpunkte erhalten haben, erscheinen sie nicht mehr in der Konsole, werden nicht angezeigt, wenn Sie ihren Metriknamen oder ihre Dimensionsnamen in das Suchfeld der Konsole eingeben, und sie werden nicht mit dem Befehl [AWS CLI list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) zurückgegeben. Verwenden Sie die Befehle [get-metric-data]()oder [get-metric-statistics](), um diese Metriken abzurufen.

**So zeigen Sie EC2 Amazon-API-Metriken über die Befehlszeile an**

Verwenden Sie einen der folgenden Befehle:
+ [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) ()AWS CLI

  ```
  aws cloudwatch list-metrics --namespace "AWS/EC2/API"
  ```
+ [Get- CWMetric Liste (](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-CWMetricList.html))AWS Tools for Windows PowerShell

  ```
  Get-CWMetricList -Namespace "AWS/EC2/API"
  ```

### CloudWatch Alarme erstellen
<a name="monitor-creating"></a>

Sie können einen CloudWatch Alarm erstellen, der eine Amazon SNS SNS-Nachricht sendet, wenn sich der Status des Alarms ändert. Ein Alarm überwacht eine Metrik über einen bestimmten, von Ihnen definierten Zeitraum. Es sendet eine Benachrichtigung an ein SNS-Thema, die auf dem Wert der Metrik im Verhältnis zu einem bestimmten Schwellenwert über mehrere Zeiträume basiert.

Sie können beispielsweise einen Alarm erstellen, der die Anzahl der DescribeInstances API-Anfragen überwacht, die aufgrund von serverseitigen Fehlern fehlschlagen. Der folgende Alarm sendet eine E-Mail-Benachrichtigung, wenn die Anzahl der DescribeInstances fehlgeschlagenen API-Anfragen innerhalb von 5 Minuten einen Schwellenwert von 10 serverseitigen Fehlern erreicht.

**Voraussetzung**  
Sie müssen den Zugriff auf die EC2 Amazon-API-Metriken für Ihr Konto aktivieren. Weitere Informationen finden Sie unter [EC2 Amazon-API-Metriken aktivieren](#enable-ec2-api-metrics).

**Um einen Alarm für EC2 DescribeInstances Amazon-API-Anforderungsserverfehler 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 **Alarms** (Alarme) und **All alarms** (Alle Alarme) aus.

1. Wählen Sie **Create alarm** (Alarm erstellen) aus.

1. **Wählen Sie Metrik auswählen** und geben Sie dann Folgendes an:

   1. Wählen Sie **EC2/API**.

   1. Wählen Sie **Metriken pro Aktion** aus.

   1. Aktivieren Sie das Kontrollkästchen neben dem Eintrag **DescribeInstances**, der sich in derselben Zeile wie der **ServerErrors**Metrikname befindet.

   1. Wählen Sie **Select metric** (Metrik auswählen) aus.

1. Die Seite **Specify metric and conditions (Metrik und Bedingungen festlegen)** wird angezeigt, die ein Diagramm und andere Informationen über die von Ihnen ausgewählte Metrik und Statistik anzeigt.

   1. Geben Sie unter **Metrik** Folgendes an:

      1. Wählen Sie für **Statistic (Statistik)** **Sum (Summe)** aus.

      1. Vergewissern Sie sich, dass für **Zeitraum** die Option **5 Minuten** ausgewählt ist.

   1. Geben Sie unter **Conditions (Bedingungen)** Folgendes an:

      1. Wählen Sie für **Threshold type** (Schwellenwerttyp) die Option **Static** (Statisch) aus.

      1. **Wählen Sie für **Wann immer ServerErrors ist** die Option **Größer/Gleich >=**.**

      1. **Für** als... , geben Sie **10** ein.

   1. Wählen Sie **Weiter** aus.

1. Die Seite **Configure actions** (Konfigurieren von Aktionen) wird angezeigt.

   1. Geben Sie unter **Benachrichtigung** Folgendes an:

     1. Wählen Sie für **Trigger im Alarmzustand** die Option **Bei Alarm** aus.

     1. **Wählen Sie für Ein SNS-Thema** **auswählen die Option Bestehendes SNS-Thema auswählen oder Neues Thema** **erstellen** aus und füllen Sie die erforderlichen Felder für die Benachrichtigung aus.

     1. Wählen Sie **Weiter** aus.

1. Die Seite „**Namen und Beschreibung hinzufügen**“ wird angezeigt. 

   1. Geben Sie **unter Alarmname** einen Namen für Ihren Alarm ein. Der Name darf nur ASCII-Zeichen enthalten.

   1. Geben Sie **unter Alarmbeschreibung** eine optionale Beschreibung für Ihren Alarm ein.

   1. Wählen Sie **Weiter** aus.

1. Die Seite **„Vorschau und Erstellung**“ wird angezeigt. Vergewissern Sie sich, dass die Informationen korrekt sind, und wählen Sie dann **Alarm erstellen**.

Weitere Informationen finden Sie unter [Verwenden von CloudWatch Amazon-Alarmen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) im * CloudWatch Amazon-Benutzerhandbuch*.