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.

# Aktivieren und Deaktivieren von Performance Insights
<a name="performance-insights-enabling"></a>

Um Performance Insights zu nutzen, aktivieren Sie es auf Ihrer DB-Instance. Sie können es später bei Bedarf deaktivieren. Das Aktivieren und Deaktivieren von Performance Insights führt nicht zu Ausfallzeiten, einem Neustart oder einem Failover.

Der Performance-Insights-Agent verbraucht eine begrenzte Menge an CPU und Arbeitsspeicher auf dem DB-Host. Wenn die DB-Last hoch ist, begrenzt der Agent die Auswirkungen auf die Leistung, indem Daten seltener erfasst werden.

## Aktivieren von Performance Insights beim Erstellen eines Clusters
<a name="performance-insights-enabling-create-instance"></a>

In der Konsole können Sie Performance Insights aktivieren oder deaktivieren, wenn Sie eine neue DB-Instance erstellen oder ändern.

### Verwendung der AWS-Managementkonsole
<a name="create-instance-console"></a>

In der Konsole können Sie Performance Insights aktivieren, wenn Sie einen Amazon DocumentDB-Cluster erstellen. Wenn Sie einen neuen Amazon DocumentDB-Cluster erstellen, aktivieren Sie Performance Insights, indem Sie ** im Abschnitt Performance Insights die Option Enable ** Performance Insights ** auswählen**.

**Anweisungen für die Konsole**

1. Um einen Cluster zu erstellen, folgen Sie den Anweisungen zum [ Erstellen eines Amazon DocumentDB-Clusters. ](https://docs.aws.amazon.com/documentdb/latest/devguide/db-cluster-create.html)

1. Wählen Sie ** im Abschnitt Performance Insights die Option Performance Insights ** aktivieren aus.  
![Der Abschnitt Performance Insights, in dem die Option Performance Insights aktivieren ausgewählt ist.](http://docs.aws.amazon.com/de_de/documentdb/latest/devguide/images/performance-insights/select-performance-insights.png)
**Anmerkung**  
Die Aufbewahrungsfrist für Performance Insights-Daten beträgt sieben Tage.

   ** AWS KMS Schlüssel ** — Geben Sie Ihren AWS KMS-Schlüssel an. Performance Insights verschlüsselt alle potenziell sensiblen Daten mithilfe Ihres AWS KMS Schlüssels. Die Daten werden während der Übertragung und im Ruhezustand verschlüsselt. Weitere Informationen finden Sie unter Konfiguration einer AWS AWS KMS Richtlinie für Performance Insights.

## Aktivierung und Deaktivierung beim Ändern einer Instanz
<a name="performance-insights-enabling-modify-instance"></a>

Sie können eine DB-Instance ändern, um Performance Insights mithilfe der Konsole oder zu aktivieren oder AWS CLI zu deaktivieren.

------
#### [ Using the AWS-Managementkonsole ]

**Anweisungen für die Konsole**

1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB-Konsole unter [ https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).

1. Klicken Sie auf **Cluster**.

1. Wählen Sie eine DB-Instance aus und wählen Sie **Ändern**.

1. Wählen Sie im Abschnitt Performance Insights entweder Performance Insights ** aktivieren ** oder Performance Insights ** deaktivieren aus. **
**Anmerkung**  
Wenn Sie Performance Insights ** aktivieren wählen**, können Sie Ihren AWS AWS KMS Schlüssel angeben. Performance Insights verschlüsselt alle potenziell sensiblen Daten mithilfe Ihres AWS KMS Schlüssels. Die Daten werden während der Übertragung und im Ruhezustand verschlüsselt. Weitere Informationen finden Sie unter [ Verschlüsseln von Amazon DocumentDB-Daten im Ruhezustand. ](https://docs.aws.amazon.com/documentdb/latest/devguide/encryption-at-rest.html)

1. Klicken Sie auf **Weiter**.

1. Wählen Sie für **Einplanung von Änderungen** die Option **Sofort anwenden** aus. Wenn Sie im nächsten geplanten Wartungsfenster ** Anwenden wählen**, ignoriert Ihre Instance diese Einstellung und aktiviert Performance Insights sofort.

1. Wählen Sie **Modify instance** (Instance ändern).

------
#### [ Using the AWS CLI ]

Wenn Sie die `modify-db-instance` AWS AWS CLI Befehle `create-db-instance` oder verwenden, können Sie Performance Insights aktivieren, indem Sie sie angeben`--enable-performance-insights`, oder deaktivieren, indem Sie Folgendes angeben`--no-enable-performance-insights`.

Im folgenden Verfahren wird beschrieben, wie Sie mit der AWS AWS CLI Performance-Insights für eine DB-Instance aktivieren oder deaktivieren.



**AWS AWS CLI Anweisungen **

Rufen Sie den `modify-db-instance` AWS AWS CLI Befehl auf und geben Sie die folgenden Werte ein:
+ `--db-instance-identifer`— Der Name der DB-Instance
+ `--enable-performance-insights` zum Aktivieren oder `--no-enable-performance-insights` zum Deaktivieren

**Example**  
Das folgende Beispiel aktiviert Performance Insights für`sample-db-instance`:  

```
aws docdb modify-db-instance \
    --db-instance-identifier sample-db-instance \
    --enable-performance-insights
```

```
aws docdb modify-db-instance ^
    --db-instance-identifier sample-db-instance ^
    --enable-performance-insights
```

------