

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.

# Verwenden der erweiterten Integritätsberichte mit der Elastic-Beanstalk-API
<a name="health-enhanced-api"></a>

Da AWS Elastic Beanstalk erweiterte Integritätsberichte Rollen- und Lösungs-Stack-Anforderungen haben, müssen Sie Skripts und Code, die Sie vor der Veröffentlichung von Enhanced Health Reporting verwendet haben, aktualisieren, bevor Sie sie verwenden können. Um die Abwärtskompatibilität zu gewährleisten, ist bei einer Umgebungserstellung mithilfe der Elastic-Beanstalk-API die Funktion der erweiterten Integritätsberichte standardmäßig deaktiviert.

Sie konfigurieren die erweiterte Statusberichterstattung, indem Sie die Servicerolle, das Instance-Profil und die CloudWatch Amazon-Konfigurationsoptionen für Ihre Umgebung festlegen. Dafür gibt es drei Möglichkeiten: Sie legen die Konfigurationsoptionen im Ordner `.ebextensions` fest, Sie nutzen gespeicherte Konfigurationen oder Sie nehmen die Konfiguration direkt im Parameter `create-environment` des Aufrufs `option-settings` vor.

Um mit der API oder der AWS Befehlszeilenschnittstelle (CLI) eine Umgebung zu erstellen, die Enhanced Health unterstützt, müssen Sie: SDKs
+ Erstellen Sie eine Servicerolle und ein Instance-Profil mit den entsprechenden [Berechtigungen](concepts-roles.md).
+ Erstellen Sie eine neue Umgebung mit einer neuen [Plattformversion](concepts.platforms.md).
+ Legen Sie die [Konfigurationsoptionen](command-options.md) für Zustandssystemtyp, Instance-Profil und Servicerolle fest.

Verwenden Sie die folgenden Konfigurationsoptionen in den Namespaces `aws:elasticbeanstalk:healthreporting:system`, `aws:autoscaling:launchconfiguration` und `aws:elasticbeanstalk:environment`, um die erweiterten Zustandsberichte in der Umgebung zu konfigurieren. 

## Konfigurationsoptionen für erweiterte Zustandsberichte
<a name="health-enhanced-api-options"></a>

**SystemType**

Namespace: `aws:elasticbeanstalk:healthreporting:system`

Legen Sie den Wert auf fest, um die Funktion der erweiterten Zustandsberichte zu nutzen **enhanced**.

**IamInstanceProfile**

Namespace: `aws:autoscaling:launchconfiguration`

Geben Sie den Namen eines Instance-Profils an, das für die Verwendung mit Elastic Beanstalk konfiguriert ist.

**ServiceRole**

Namespace: `aws:elasticbeanstalk:environment`

Geben Sie den Namen einer Servicerolle an, die für die Verwendung mit Elastic Beanstalk konfiguriert ist.

**ConfigDocument** (optional)

Namespace: `aws:elasticbeanstalk:healthreporting:system`

Ein JSON-Dokument, das die Instanz- und Umgebungsmetriken definiert, in denen veröffentlicht CloudWatch werden soll. Beispiel:

```
{
  "CloudWatchMetrics":
    {
    "Environment":
      {
      "{{ApplicationLatencyP99.9}}":60,
      "{{InstancesSevere}}":60
      }
    "Instance":
      {
      "{{ApplicationLatencyP85}}":60,
      "{{CPUUser}}": 60
      }
    }
  "Version":1
}
```

**Anmerkung**  
Je nach der Bereitstellung für Elastic Beanstalk erfordern Config-Dokumente möglicherweise eine spezielle Formatierung (z. B. Escape-Anführungszeichen). Beispiele finden Sie unter [Bereitstellen von benutzerdefinierten Metrikkonfigurations-Dokumenten](health-enhanced-cloudwatch.md#health-enhanced-cloudwatch-configdocument).