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.
# Überwachung von Amazon DocumentDB
Die Überwachung Ihrer AWS Dienste ist ein wichtiger Bestandteil, damit Ihre Systeme gesund bleiben und optimal funktionieren. Es ist ratsam, Überwachungsdaten aus allen Teilen Ihrer AWS Lösung zu sammeln, damit Sie Fehler oder Beeinträchtigungen leichter debuggen und beheben können, falls sie auftreten sollten. Bevor Sie mit der Überwachung Ihrer AWS Lösungen beginnen, empfehlen wir Ihnen, die folgenden Fragen zu prüfen und Antworten darauf zu formulieren:
+ Was sind Ihre Überwachungsziele?
+ Welche Ressourcen werden Sie überwachen?
+ Wie oft werden Sie diese Ressourcen überwachen?
+ Welche Überwachungstools werden verwendet?
+ Wer ist für die Überwachung verantwortlich?
+ Wer ist zu benachrichtigen und auf welche Weise, wenn etwas schief geht?
Um Ihre aktuellen Leistungsmuster zu verstehen, Leistungsanomalien zu identifizieren und Methoden zur Behebung von Problemen zu formulieren, sollten Sie grundlegende Leistungskennzahlen für verschiedene Zeiten und unter unterschiedlichen Lastbedingungen festlegen. Bei der Überwachung Ihrer AWS Lösung empfehlen wir Ihnen, Ihre historischen Monitoring-Daten zu speichern, damit Sie future darauf zurückgreifen und Ihre Baselines erstellen können.
Die zulässigen Werte für Leistungsmetriken sind im Allgemeinen davon abhängig, wie die Ausgangsbasis aussieht und wofür die Anwendung gedacht ist. Prüfen Sie, ob dauerhafte oder tendenzielle Abweichungen von Ihrer Ausgangsbasis vorliegen. Im Folgenden werden Hinweise zu bestimmten Arten von Kennzahlen gegeben:
+ **Hohe CPU- oder RAM-Auslastung** — Hohe Werte für die CPU- oder RAM-Auslastung können angemessen sein, vorausgesetzt, sie entsprechen Ihren Zielen für Ihre Anwendung (wie Durchsatz oder Parallelität) und werden erwartet.
+ **Speichervolumenverbrauch** — Untersuchen Sie den Speicherverbrauch (`VolumeBytesUsed`), wenn der genutzte Speicherplatz konstant 85 Prozent des gesamten Speichervolumens ausmacht oder mehr beträgt. Legen Sie fest, ob Sie Daten aus dem Speicher-Volume löschen oder Daten in ein anderes System archivieren können, um Platz zu schaffen. Weitere Informationen erhalten Sie unter [Amazon DocumentDB DocumentDB-Speicher](how-it-works.md#how-it-works.storage) und [Amazon DocumentDB Kontingente und Beschränkungen](limits.md).
+ **Netzwerkverkehr** — Wenden Sie sich bezüglich des Netzwerkverkehrs an Ihren Systemadministrator, um zu erfahren, wie hoch der zu erwartende Durchsatz für Ihr Domänennetzwerk und Ihre Internetverbindung ist. Überprüfen Sie den Netzwerkdatenverkehr, wenn der Durchsatz dauerhaft unter dem erwarteten Wert liegt.
+ **Datenbankverbindungen** — Erwägen Sie, Datenbankverbindungen einzuschränken, wenn Sie eine hohe Anzahl von Benutzerverbindungen in Verbindung mit einer verringerten Instanzleistung und Reaktionszeit feststellen. Die optimale Anzahl der Benutzerverbindungen für Ihre Instance ist von der Instance-Klasse und der Komplexität der Operationen abhängig, die ausgeführt werden.
+ **IOPS-Metriken** — Die erwarteten Werte für IOPS-Metriken hängen von der Festplattenspezifikation und der Serverkonfiguration ab. Verwenden Sie daher Ihren Basiswert, um herauszufinden, was typisch ist. Prüfen Sie, ob dauerhafte Abweichungen von den Werten Ihrer Ausgangsbasis vorliegen. Für eine optimale IOPS-Leistung stellen Sie sicher, dass Ihr typisches Working Set in den Speicher passt, um Lese- und Schreibvorgänge zu minimieren.
Amazon DocumentDB (mit MongoDB-Kompatibilität) bietet eine Vielzahl von CloudWatch Amazon-Metriken, die Sie überwachen können, um den Zustand und die Leistung Ihrer Amazon DocumentDB-Cluster und -Instances zu ermitteln. Sie können Amazon DocumentDB-Metriken mit verschiedenen Tools anzeigen, darunter der Amazon DocumentDB DocumentDB-Konsole AWS CLI, CloudWatch API und Performance Insights.
**Topics**
+ [Den Status eines Clusters überwachen](monitoring_docdb-cluster_status.md)
+ [Den Status einer Instance überwachen](monitoring_docdb-instance_status.md)
+ [Amazon DocumentDB DocumentDB-Empfehlungen anzeigen](view-docdb-recommendations.md)
+ [Ereignisabonnements](event-subscriptions.md)
+ [Überwachen von Amazon DocumentDB mit CloudWatch](cloud_watch.md)
+ [Protokollieren Amazon DocumentDB DocumentDB-API-Aufrufen mit CloudTrail](logging-with-cloudtrail.md)
+ [Profilierung von Vorgängen](profiling.md)
+ [Überwachung mit Performance Insights](performance-insights.md)
# Den Status eines Amazon DocumentDB-Clusters überwachen
Der Status eines Clusters zeigt den Zustand des Clusters an. Sie können den Status eines Clusters mithilfe der Amazon DocumentDB DocumentDB-Konsole oder des AWS CLI `describe-db-clusters` Befehls anzeigen.
**Topics**
+ [Werte für den Cluster-Status](#monitoring_docdb-status_values)
+ [Den Status eines Clusters überwachen](#monitor-cluster-status)
## Werte für den Cluster-Status
In der folgenden Tabelle sind die gültigen Werte für den Cluster-Status aufgeführt.
| Cluster-Status | Description |
| --- | --- |
| active | Der Cluster ist aktiv. Dieser Status gilt nur für elastische Cluster. |
| available | Der Cluster ist stabil und verfügbar. Dieser Status gilt nur für instanzbasierte Cluster. |
| backing-up | Der Cluster wird derzeit gesichert. |
| creating | Der Cluster wird gerade erstellt. Ist während der Erstellung unzugänglich. |
| deleting | Der Cluster wird gerade gelöscht. Ist während des Löschvorgangs nicht zugreifbar. |
| failing-over | Ein Failover von der primären Instance zu einem Amazon DocumentDB DocumentDB-Replikat wird durchgeführt. |
| inaccessible-encryption-credentials | Auf den AWS KMS Schlüssel, der zum Verschlüsseln oder Entschlüsseln des Clusters verwendet wurde, kann nicht zugegriffen werden. |
| maintenance | Ein Wartungsupdate wird auf den Cluster angewendet. Dieser Status wird für Wartungsarbeiten auf Clusterebene verwendet, die Amazon DocumentDB weit im Voraus plant. |
| migrating | Es wird gerade ein Cluster-Snapshot in einen Cluster wiederhergestellt. |
| migration-failed | Eine Migration ist fehlgeschlagen. |
| modifying | Der Cluster wird aufgrund einer Kundenanfrage, den Cluster zu ändern, geändert. |
| renaming | Der Cluster wird aufgrund einer Kundenanfrage auf Instance-Umbenennung umbenannt. |
| resetting-master-credentials | Die Master-Anmeldeinformationen für den Cluster werden auf eine Kundenanfrage auf Zurücksetzung hin zurückgesetzt. |
| upgrading | Die Cluster-Engine wird auf eine neue Version aktualisiert. |
## Den Status eines Clusters überwachen
------
#### [ Using the AWS-Managementkonsole ]
Verwenden Sie das folgende Verfahren, AWS-Managementkonsole um den Status eines Clusters zu ermitteln.
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
1. **Im Cluster-Navigationsfeld sehen Sie die Spalte Cluster-ID.** Ihre Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.
![\[Die Cluster-Tabelle zeigt, wie eine Instance unter einem Cluster verschachtelt ist.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/choose-clusters.png)
1. Suchen Sie in der Spalte **Cluster-ID** den Namen der Instance, an der Sie interessiert sind. Um den Status der Instance zu ermitteln, lesen Sie dann über diese Zeile bis zur Spalte **Status**, wie unten gezeigt.
![\[Die Cluster-Instance zeigt den verfügbaren Status an.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cluster-status-con.png)
------
#### [ Using the AWS CLI ]
Wenn Sie AWS CLI den Status eines Clusters ermitteln möchten, verwenden Sie den `describe-db-clusters` Vorgang. Der folgende Code ermittelt den Status des Clusters `sample-cluster`.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Für Windows:
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
[
[
"sample-cluster",
"available"
]
]
```
------
# Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen
Amazon DocumentDB bietet Informationen über den aktuellen Zustand jeder konfigurierten Instanz in der Datenbank.
Es gibt drei Statustypen, die Sie für eine Amazon DocumentDB DocumentDB-Instance anzeigen können:
+ Instance-Status: Dieser Status wird in der Spalte **Status** der Cluster-Tabelle im angezeigt AWS-Managementkonsole und zeigt den aktuellen Lebenszykluszustand der Instance an. Die in der Spalte **Status** angezeigten Werte werden aus dem `Status` Feld der `DescribeDBCluster` API-Antwort abgeleitet.
+ Integritätsstatus der Instanz: Dieser Status wird in der Spalte **Instanzstatus** der Clustertabelle im angezeigt AWS-Managementkonsole und gibt an, ob die Datenbank-Engine, die Komponente, die für die Verwaltung und das Abrufen von Daten verantwortlich ist, läuft. Die in der Spalte **Instance-Zustand** angezeigten Werte basieren auf der CloudWatch `EngineUptime` Amazon-Systemmetrik.
+ Wartungsstatus: Dieser Status wird in der Spalte **Wartung** der Cluster-Tabelle im angezeigt AWS-Managementkonsole und gibt den Status aller Wartungsereignisse an, die auf eine Instance angewendet werden müssen. Der Wartungsstatus ist unabhängig vom Status der anderen Instanzen und wird von der `PendingMaintenanceAction` API abgeleitet. Weitere Informationen zum Wartungsstatus finden Sie unter [Wartung von Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html).
**Topics**
+ [Instance-Statuswerte](#monitoring_docdb-instance_status-values)
+ [Überwachen Sie den Instance-Status mit dem AWS-Managementkonsole oder AWS CLI](#monitoring-instance-status)
+ [Werte für den Integritätsstatus der Instanz](#instance-health-status-values)
+ [Überwachen des Zustands der Instanz mit dem AWS-Managementkonsole](#monitoring-instance-health-status)
## Instance-Statuswerte
Die folgende Tabelle führt die möglichen Statuswerte für Instances auf und gibt an, wie welcher Status berechnet wird. Die Tabelle gibt an, ob Sie für Instance und Speicher, nur für Speicher oder weder für Instance noch Speicher zahlen müssen. Für alle Instance-Status wird immer die Sicherungsnutzung berechnet.
| Instance-Status | Berechnet | Description |
| --- | --- | --- |
| available | Berechnet | Die Instance ist stabil und verfügbar. |
| backing-up | Berechnet | Die Instance wird derzeit gesichert. |
| configuring-log-exports | Berechnet | Das Veröffentlichen von Protokolldateien in Amazon CloudWatch Logs wird für diese Instance aktiviert oder deaktiviert. |
| creating | Nicht berechnet | Die Instance wird gerade erstellt. Während die Instance erstellt wird, kann nicht auf sie zugegriffen werden. |
| deleting | Nicht berechnet | Die Instance wird gerade gelöscht. |
| failed | Nicht berechnet | Die Instance ist ausgefallen und Amazon DocumentDB konnte sie nicht wiederherstellen. Um die Daten wiederherzustellen, führen Sie eine point-in-time Wiederherstellung zum letzten wiederherstellbaren Zeitpunkt der Instance durch. |
| inaccessible-encryption-credentials | Nicht berechnet | Auf den AWS KMS Schlüssel, der zum Verschlüsseln oder Entschlüsseln der Instanz verwendet wird, konnte nicht zugegriffen werden. |
| incompatible-network | Nicht berechnet | Amazon DocumentDB versucht, eine Wiederherstellungsaktion für eine Instance durchzuführen, kann dies jedoch nicht tun, da sich die VPC in einem Zustand befindet, der verhindert, dass die Aktion abgeschlossen werden kann. Dieser Status kann auftreten, wenn beispielsweise alle verfügbaren IP-Adressen in einem Subnetz verwendet wurden und Amazon DocumentDB keine IP-Adresse für die Instance abrufen konnte. |
| maintenance | Berechnet | Amazon DocumentDB wendet ein Wartungsupdate auf die Instance an. Dieser Status wird für Wartungsarbeiten auf Instanzebene verwendet, die Amazon DocumentDB weit im Voraus plant. Wir evaluieren derzeit Möglichkeiten, Kunden über diesen Status auch weitere Wartungsaktionen kenntlich zu machen. |
| modifying | Berechnet | Die Instance wird aufgrund einer Anforderung zur Änderung der Instance geändert. |
| rebooting | Berechnet | Die Instance wird aufgrund einer Anfrage oder eines Amazon DocumentDB DocumentDB-Prozesses, der einen Neustart der Instance erfordert, neu gestartet. |
| renaming | Berechnet | Die Instance wird aufgrund einer Anforderung zur Umbenennung umbenannt. |
| resetting-master-credentials | Berechnet | Die Master-Anmeldeinformationen für die Instance werden aufgrund einer Anforderung zum Zurücksetzen zurückgesetzt. |
| restore-error | Berechnet | Bei dem Versuch, einen oder aus einem Snapshot wiederherzustellen, ist bei der Instance ein point-in-time Fehler aufgetreten. |
| starting | Berechnet für Speicher | Die Instance wird gestartet. |
| stopped | Berechnet für Speicher | Die Instance wird angehalten. |
| stopping | Berechnet für Speicher | Die Instance wird gestoppt. |
| storage-full | Berechnet | Die Instance hat seine Speicherkapazitätszuteilung erreicht. Dieser Status ist kritisch und sollte sofort behoben werden. Sie müssen den verfügbaren Speicherplatz hochskalieren, indem Sie die Instance entsprechend ändern. Stellen Sie CloudWatch Amazon-Alarme so ein, dass Sie gewarnt werden, wenn der Speicherplatz knapp wird, damit Sie nicht in diese Situation geraten. |
## Überwachen Sie den Instance-Status mit dem AWS-Managementkonsole oder AWS CLI
Verwenden Sie das AWS-Managementkonsole oder AWS CLI , um den Status Ihrer Instanz zu überwachen.
------
#### [ Using the AWS-Managementkonsole ]
Verwenden Sie das folgende Verfahren, AWS-Managementkonsole um den Status eines Clusters zu ermitteln.
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Anmerkung**
Beachten Sie, dass im Cluster-Navigationsfeld in der Spalte **Cluster-ID sowohl Cluster** als auch Instances angezeigt werden. Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.
![\[Liste der Cluster und Instances auf der Cluster-Seite in der Amazon DocumentDB DocumentDB-Konsole.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/clusters.png)
1. Suchen Sie den Namen der Instance, an der Sie interessiert sind. Um den Status der Instance zu ermitteln, prüfen Sie die Zeile in die Spalte **Status**.
![\[Die Statusspalte zeigt den verfügbaren Status für Cluster und Instances auf der Cluster-Seite an.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/instance-status.png)
------
#### [ Using the AWS CLI ]
Wenn Sie AWS CLI den Status eines Clusters ermitteln möchten, verwenden Sie den `describe-db-instances` Vorgang. Der folgende Code ermittelt den Status der Instance `sample-cluster-instance-01`.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance-01 \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'
```
Für Windows:
```
aws docdb describe-db-instances ^
--db-instance-identifier sample-cluster-instance-01 ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
[
[
"sample-cluster-instance-01",
"available"
]
]
```
------
## Werte für den Integritätsstatus der Instanz
In der folgenden Tabelle sind die möglichen Integritätsstatuswerte für Instances aufgeführt. Die Spalte **Instanzstatus** in der **Cluster-Tabelle** in der zeigt AWS-Managementkonsole, ob die Datenbank-Engine, die Komponente, die für das Speichern, Verwalten und Abrufen von Daten verantwortlich ist, normal funktioniert. In dieser Spalte wird auch angegeben, ob die `EngineUptime` Systemmetrik CloudWatch, verfügbar in, den Integritätsstatus jeder Instanz anzeigt.
| Instance-Zustand | Description |
| --- | --- |
| fehlerfrei | Die Datenbank-Engine läuft in der Amazon DocumentDB DocumentDB-Instance. |
| ungesund | Die Datenbank-Engine läuft nicht oder wurde vor weniger als einer Minute neu gestartet. |
## Überwachen des Zustands der Instanz mit dem AWS-Managementkonsole
Verwenden Sie den AWS-Managementkonsole , um den Integritätsstatus Ihrer Instance zu überwachen.
Verwenden Sie bei der Verwendung die folgenden Schritte AWS-Managementkonsole, um den Integritätsstatus der Instanz zu verstehen.
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Anmerkung**
Im **Cluster-Navigationsfeld** werden in der Spalte **Cluster-ID sowohl Cluster** als auch Instances angezeigt. Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.
![\[Liste der Cluster und Instances auf der Cluster-Seite in der Amazon DocumentDB DocumentDB-Konsole.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/clusters.png)
1. Suchen Sie den Namen der Instance, an der Sie interessiert sind. Um den Status der Instanz zu ermitteln, lesen Sie dann in dieser Zeile bis zur Spalte **Instanzstatus** nach, wie in der folgenden Abbildung dargestellt:
![\[Die Spalte „Instanzstatus“ zeigt den Status „Fehlerfrei“ und „Fehlerhaft“ für Instances, die auf der Seite „Cluster“ aufgeführt sind.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/health-status-1.png)
**Anmerkung**
Die Abfrage des Instance-Integritätsstatus erfolgt alle 60 Sekunden und basiert auf der CloudWatch `EngineUptime` Systemmetrik. Die Werte in der Spalte **Instanzstatus** werden automatisch aktualisiert.
# Amazon DocumentDB DocumentDB-Empfehlungen anzeigen
Amazon DocumentDB bietet eine Liste automatisierter Empfehlungen für Datenbankressourcen wie Instances und Cluster. Diese Empfehlungen dienen als Leitfaden für bewährte Verfahren, indem Sie Ihre Cluster- und Instance-Konfigurationen analysieren.
Ein Beispiel für diese Empfehlungen finden Sie im Folgenden:
| Typ | Beschreibung | Empfehlung | Zusätzliche Informationen |
| --- | --- | --- | --- |
| Eine -Instance | Der Cluster enthält nur eine Instanz | Leistung und Verfügbarkeit: Wir empfehlen, eine weitere Instanz mit derselben Instanzklasse in einer anderen Availability Zone hinzuzufügen. | [Amazon DocumentDB Hochverfügbarkeit und Replikation](https://docs.aws.amazon.com/documentdb/latest/developerguide/replication.html) |
Amazon DocumentDB generiert Empfehlungen für eine Ressource, wenn die Ressource erstellt oder geändert wird. Amazon DocumentDB scannt Ihre Ressourcen auch regelmäßig und generiert Empfehlungen.
**Um Empfehlungen von Amazon DocumentDB einzusehen und entsprechende Maßnahmen zu ergreifen**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. **Wählen Sie im Navigationsbereich Empfehlungen aus:**
![\[Navigationsbereich der Amazon DocumentDB DocumentDB-Konsole mit ausgewählter Option Empfehlungen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/recommendations-nav-1.png)
1. Erweitern Sie im Dialogfeld „**Empfehlungen**“ den gewünschten Bereich und wählen Sie die empfohlene Aufgabe aus.
Im folgenden Beispiel bezieht sich die empfohlene Aufgabe auf einen Amazon DocumentDB-Cluster mit nur einer Instance. Es wird empfohlen, eine weitere Instance hinzuzufügen, um die Leistung und Verfügbarkeit zu verbessern.
![\[Das Empfehlungsformular mit einer ausgewählten empfohlenen Aufgabe für einen Amazon DocumentDB-Cluster.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/recommendations-1.png)
1. Klicken Sie auf **Jetzt bewerben**.
In diesem Beispiel wird das Dialogfeld „**Instanzen hinzufügen**“ angezeigt:
![\[Das Formular Instanzen hinzufügen mit Optionen für Instanzeinstellungen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/add-instances-1.png)
1. Ändern Sie die Einstellungen Ihrer neuen Instanz und klicken Sie auf **Erstellen**.
# Amazon DocumentDB DocumentDB-Veranstaltungsabonnements verwenden
Amazon DocumentDB verwendet Amazon Simple Notification Service (Amazon SNS), um Benachrichtigungen bereitzustellen, wenn ein Amazon DocumentDB DocumentDB-Ereignis eintritt. Diese Benachrichtigungen können in jeder Form erfolgen, die von Amazon SNS für eine unterstützt wird AWS-Region, z. B. eine E-Mail, eine Textnachricht oder ein Anruf an einen HTTP-Endpunkt.
Amazon DocumentDB gruppiert diese Ereignisse in Kategorien, die Sie abonnieren können, sodass Sie benachrichtigt werden können, wenn ein Ereignis in dieser Kategorie eintritt. Sie können eine Ereigniskategorie für eine Instance, einen Cluster, einen Snapshot, einen Cluster-Snapshot oder eine Parametergruppe abonnieren. Wenn Sie beispielsweise die Backup-Kategorie für eine bestimmte Instanz abonnieren, werden Sie jedes Mal benachrichtigt, wenn ein Backup-bezogenes Ereignis eintritt, das sich auf die Instanz auswirkt. Sie erhalten auch eine Benachrichtigung, wenn sich ein Abonnement für ein Ereignis ändert.
Ereignisse treten sowohl auf Cluster- als auch auf Instanzebene auf, sodass Sie Ereignisse empfangen können, wenn Sie einen Cluster oder eine Instance abonnieren.
Ereignisabonnements werden an die Adressen gesendet, die Sie bei der Erstellung des Abonnements angegeben haben. Möglicherweise möchten Sie mehrere verschiedene Abonnements erstellen, z. B. ein Abonnement, das alle Ereignisbenachrichtigungen empfängt, und ein anderes Abonnement, das nur kritische Ereignisse für Ihre Produktionsinstanzen enthält. Sie können die Benachrichtigungen ganz einfach deaktivieren, ohne ein Abonnement zu löschen. Setzen Sie dazu das Optionsfeld **Aktiviert** in der Amazon DocumentDB DocumentDB-Konsole auf **Nein**.
**Wichtig**
Amazon DocumentDB garantiert nicht die Reihenfolge der Ereignisse, die in einem Event-Stream gesendet werden. Die Reihenfolge der Ereignisse kann sich ändern.
Amazon DocumentDB verwendet den Amazon-Ressourcennamen (ARN) eines Amazon SNS-Themas, um jedes Abonnement zu identifizieren. Die Amazon DocumentDB DocumentDB-Konsole erstellt den ARN für Sie, wenn Sie das Abonnement erstellen.
Die Abrechnung von Amazon DocumentDB DocumentDB-Veranstaltungsabonnements erfolgt über Amazon SNS. Bei Verwendung von Ereignisbenachrichtigungen fallen Amazon-SNS-Gebühren an. Weitere Informationen finden Sie unter Preise für den Amazon Simple Notification Service (SNS). Abgesehen von den Amazon SNS SNS-Gebühren stellt Amazon DocumentDB keine Event-Abonnements in Rechnung.
**Topics**
+ [Abonnieren von Ereignissen](event-subscriptions.subscribe.md)
+ [-Abonnements verwalten](event-subscriptions.managing.md)
+ [Kategorien und Nachrichten](event-subscriptions.categories-messages.md)
# Amazon DocumentDB DocumentDB-Veranstaltungen abonnieren
Sie können die Amazon DocumentDB DocumentDB-Konsole verwenden, um Veranstaltungsabonnements wie folgt zu abonnieren:
1. Melden Sie sich AWS-Managementkonsole unter an. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)
1. Wählen Sie im Navigationsbereich **Ereignisabonnements** aus.
![\[Navigationsbereich der Amazon DocumentDB DocumentDB-Konsole mit hervorgehobener Option „Event-Abonnements“.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/subscribe-event-subs.png)
1. Wählen Sie im Bereich **Ereignisabonnements** **Ereignisabonnement erstellen** aus.
![\[Bereich „Event-Abonnements“, in dem die Schaltfläche „Event-Abonnement erstellen“ in der oberen rechten Ecke hervorgehoben wird.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/subscribe-create.png)
1. Gehen Sie im Dialogfeld **Ereignisabonnement erstellen** wie folgt vor:
+ Geben Sie unter **Name** einen Namen für das Abonnement für Ereignisbenachrichtigungen ein.
![\[Das Formular „Event-Abonnement erstellen“ mit dem Abschnitt „Details“ und dem Eingabefeld „Name“.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/subscribe-name.png)
+ Wählen Sie für **Target** aus, wohin Sie Benachrichtigungen senden möchten. Sie können einen vorhandenen **ARN** oder **Neues E-Mail-Thema** wählen, um den Namen eines Themas und eine Empfängerliste einzugeben.
![\[Der Abschnitt Ziel mit Optionen, mit denen Sie angeben können, wohin Benachrichtigungen gesendet werden sollen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/subscribe-target.png)
+ Wählen Sie für **Quelle** einen Quelltyp aus. Wählen Sie abhängig vom ausgewähltem Quelltyp die Ereigniskategorien und Quellen aus, für die Sie Ereignisbenachrichtigungen erhalten möchten.
![\[Im Bereich Quelle wählen Sie einen Quelltyp aus, von dem Sie Ereignisbenachrichtigungen erhalten möchten.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/subscribe-source.png)
+ Wählen Sie **Erstellen** aus.
![\[Der Quellbereich mit der Schaltfläche Erstellen in der unteren rechten Ecke.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/subscribe-create-2.png)
# Verwaltung von Abonnements für Amazon DocumentDB DocumentDB-Ereignisbenachrichtigungen
Wenn Sie im Navigationsbereich der Amazon DocumentDB DocumentDB-Konsole **Event-Abonnements** auswählen, können Sie Abonnementkategorien und eine Liste Ihrer aktuellen Abonnements einsehen. Sie können auch ein bestimmtes Abonnement ändern oder löschen.
## So ändern Sie Ihre aktuellen Amazon DocumentDB DocumentDB-Abonnements für Ereignisbenachrichtigungen
1. Melden Sie sich AWS-Managementkonsole unter an. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)
1. Wählen Sie im Navigationsbereich **Ereignisabonnements** aus. Im Bereich **Ereignisabonnements** werden all Ihre Abonnements für Ereignisbenachrichtigungen angezeigt.
![\[Navigationsbereich der Amazon DocumentDB DocumentDB-Konsole mit hervorgehobener Option „Event-Abonnements“.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/modify-event-subs.png)
1. Wählen Sie im Bereich **Ereignisabonnements** das Abonnement, das Sie modifizieren möchten, und klicken Sie auf **Bearbeiten**.
![\[Der Bereich „Event-Abonnements“ zeigt ein ausgewähltes Abonnement und die Schaltfläche Bearbeiten.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/modify-edit.png)
1. Nehmen Sie Ihre Änderungen am Abonnement im Bereich **Ziel** oder **Quelle** vor. Sie können Quell-IDs hinzufügen oder entfernen, indem Sie diese im Bereich Quelle auswählen oder ihre Auswahl aufheben.
![\[Das Formular „Event-Abonnement ändern“ hebt den Bereich „Ziel“ hervor.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/modify-target.png)
1. Wählen Sie **Ändern** aus. Die Amazon DocumentDB DocumentDB-Konsole zeigt an, dass das Abonnement geändert wird.
![\[Das Ende des Formulars „Event-Abonnement ändern“ mit hervorgehobener Schaltfläche „Ändern“.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/modify-button.png)
## Löschen eines Abonnements für Amazon DocumentDB DocumentDB-Ereignisbenachrichtigungen
Sie können ein Abonnement löschen, wenn Sie es nicht mehr benötigen. Alle Abonnenten des Themas erhalten dann keine weiteren Ereignisbenachrichtigungen, die über dieses Abonnement ausgegeben wurden.
1. Melden Sie sich AWS-Managementkonsole unter an. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)
1. Wählen Sie im Navigationsbereich **Ereignisabonnements** aus.
![\[Navigationsbereich der Amazon DocumentDB DocumentDB-Konsole mit hervorgehobener Option „Event-Abonnements“.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/delete-event-subs.png)
1. Wählen Sie im Bereich **Ereignisabonnements** das Abonnement aus, das Sie löschen möchten.
![\[Der Bereich „Event-Abonnements“ zeigt ein ausgewähltes Abonnement.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/delete-select.png)
1. Wählen Sie **Löschen** aus.
![\[Der Bereich für Veranstaltungsabonnements, in dem die Schaltfläche Löschen hervorgehoben wird.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/delete-delete.png)
1. In einem Popup-Fenster werden Sie gefragt, ob Sie diese Benachrichtigung dauerhaft löschen möchten. Wählen Sie **Löschen** aus.
![\[Ein Dialogfeld, das das Löschen des Event-Abonnements bestätigt, wobei die Schaltfläche Löschen in der unteren rechten Ecke hervorgehoben ist.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/event-subs/delete-delete-2.png)
# Amazon DocumentDB DocumentDB-Ereigniskategorien und Meldungen
Amazon DocumentDB generiert eine beträchtliche Anzahl von Ereignissen in Kategorien, die Sie über die Konsole abonnieren können. Jede Kategorie bezieht sich auf einen Quelltyp, bei dem es sich um eine Instance, einen Cluster, einen Snapshot oder eine Parametergruppe handeln kann.
**Anmerkung**
Amazon DocumentDB verwendet bestehende Amazon RDS-Ereignisdefinitionen und IDs.
## Amazon DocumentDB DocumentDB-Ereignisse, die von Instances stammen
| Kategorie | Description |
| --- | --- |
| Verfügbarkeit | Die Instanz wurde neu gestartet. |
| Verfügbarkeit | Die Instanz wurde heruntergefahren. |
| Konfigurationsänderung | Änderung auf eine Instanzklasse anwenden. |
| Konfigurationsänderung | Das Anwenden der Änderung auf eine Instanzklasse wurde abgeschlossen. |
| Konfigurationsänderung | Primäre Anmeldeinformationen zurücksetzen. |
| Erstellung | Instanz wurde erstellt. |
| Löschung | Instanz wurde gelöscht |
| Ausfall | Die Instanz ist aufgrund einer inkompatiblen Konfiguration oder eines zugrunde liegenden Speicherproblems ausgefallen. Starten Sie a point-in-time-restore für die Instanz. |
| Benachrichtigung | Die Instanz wurde gestoppt. |
| Benachrichtigung | Instanz wurde gestartet. |
| Benachrichtigung | Die Instanz wird gestartet, weil sie die maximal zulässige Zeit für das Stoppen überschritten hat. |
| Wiederherstellung | Die Wiederherstellung der Instanz wurde gestartet. Die Wiederherstellungsdauer variiert je nach zu wiederherstellender Datenmenge. |
| Wiederherstellung | Die Wiederherstellung der Instanz ist abgeschlossen. |
| Ausführen von Sicherheits-Patches | Das Betriebssystem-Update ist für Ihre Instance verfügbar. Informationen zum Anwenden von Updates finden Sie unter [Wartung von Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html). |
## Amazon DocumentDB DocumentDB-Ereignisse, die aus einem Cluster stammen
| Kategorie | Description |
| --- | --- |
| Erstellung | Cluster wurde erstellt |
| Löschung | Cluster wurde gelöscht. |
| Failover | Der vorherige Primärserver wird erneut beworben. |
| Failover | Der Failover zur Instanz wurde abgeschlossen. |
| Failover | Der Failover zur DB-Instance wurde gestartet: %s |
| Failover | Derselbe AZ-Failover zur DB-Instance wurde gestartet: %s |
| Failover | Cross-AZ-Failover zur DB-Instance gestartet: %s |
| Wartung | Der Cluster wurde gepatcht. |
| Wartung | Der Datenbank-Cluster befindet sich in einem Zustand, der nicht aktualisiert werden kann: %s |
| Benachrichtigung | Der Cluster wurde gestoppt. |
| Benachrichtigung | Der Cluster wurde gestartet. |
| Benachrichtigung | Der Clusterstopp ist fehlgeschlagen. |
| Benachrichtigung | Der Cluster wird gestartet, weil er die maximal zulässige Zeit für das Stoppen überschritten hat. |
| Benachrichtigung | Der Cluster wurde von %s in %s umbenannt. |
## Amazon DocumentDB DocumentDB-Ereignisse, die aus einem Cluster-Snapshot stammen
Die folgende Tabelle zeigt die Ereigniskategorie und eine Liste der Ereignisse, wenn ein Amazon DocumentDB-Cluster-Snapshot der Quelltyp ist.
| Kategorie | Description |
| --- | --- |
| backup | Ein manueller Cluster-Snapshot wird erstellt. |
| backup | Ein manueller Cluster-Snapshot wurde erstellt. |
| backup | Erstellen eines automatisierten Cluster-Snapshots. |
| backup | Automatisierter Cluster-Snapshot erstellt. |
## Amazon DocumentDB DocumentDB-Ereignisse, die aus einer Parametergruppe stammen
Die folgende Tabelle zeigt den Ereignistyp sowie eine Liste der Ereignisse für den Fall, dass der Quelltyp „Parametergruppe“ ist.
| Kategorie | Description |
| --- | --- |
| Konfigurationsänderung | Der Parameter %s wurde mit der Methode %s auf %s aktualisiert |
# Überwachen von Amazon DocumentDB mit CloudWatch
Amazon DocumentDB (mit MongoDB-Kompatibilität) ist in Amazon integriert, CloudWatch sodass Sie Betriebsmetriken für Ihre Cluster sammeln und analysieren können. Sie können diese Metriken mit der CloudWatch Konsole, der Amazon DocumentDB DocumentDB-Konsole, der AWS Command Line Interface (AWS CLI) oder der CloudWatch API überwachen.
CloudWatch ermöglicht es Ihnen auch, Alarme einzustellen, sodass Sie benachrichtigt werden können, wenn ein Metrikwert einen von Ihnen angegebenen Schwellenwert überschreitet. Sie können Amazon CloudWatch Events sogar so einrichten, dass im Falle eines Verstoßes Korrekturmaßnahmen ergriffen werden. Weitere Informationen zur Verwendung CloudWatch und zu Alarmen finden Sie in der [ CloudWatch Amazon-Dokumentation](https://docs.aws.amazon.com/cloudwatch/index.html).
**Topics**
+ [Amazon DocumentDB-Metriken](#cloud_watch-metrics_list)
+ [CloudWatch Daten anzeigen](#cloud_watch-view_data)
+ [Abmessungen von Amazon DocumentDB](#cloud_watch-metrics_dimensions)
+ [Überwachung von Opcounter-Metriken](#cloud_watch-monitoring_opcounters)
+ [Überwachen von Datenbankverbindungen](#cloud_watch-monitoring_connections)
## Amazon DocumentDB-Metriken
Um den Zustand und die Leistung Ihres Amazon DocumentDB-Clusters und Ihrer Amazon DocumentDB-Instances zu überwachen, können Sie die folgenden Metriken in der Amazon DocumentDB-Konsole einsehen.
**Anmerkung**
Die Metriken in den folgenden Tabellen gelten sowohl für instanzbasierte als auch für elastische Cluster.
**Topics**
+ [Metriken zur Ressourcenauslastung](#resource-utilization)
+ [Latenzmetriken](#latency-metrics)
+ [NVMe-gestützte Instance-Metriken](#nvme-metrics)
+ [Betriebsmetriken](#operations-metrics)
+ [Durchsatzmetriken](#throughput-metrics)
+ [Systemmetriken](#system-metrics)
+ [Metriken für T3-Instanzen](#t3-instance-metrics)
### Metriken zur Ressourcenauslastung
| Metrik | Description |
| --- | --- |
| BackupRetentionPeriodStorageUsed | Die Gesamtmenge des Backup-Speichers in Byte, der zur Unterstützung der point-in-time Wiederherstellungsfunktion innerhalb des Aufbewahrungsfensters von Amazon DocumentDB verwendet wird. Ist in dem von der TotalBackupStorageBilled-Metrik gemeldeten Gesamtwert enthalten. Wird für jeden Amazon DocumentDB-Cluster separat berechnet. |
| ChangeStreamLogSize | Die Menge des Speichers, der vom Cluster zum Speichern des Änderungsstream-Protokolls in Megabyte verwendet wird. Dieser Wert ist eine Teilmenge des Gesamtspeichers für den Cluster (VolumeBytesUsed) und wirkt sich auf die Kosten des Clusters aus. Informationen zu Speicherpreisen finden Sie auf der [Amazon DocumentDB DocumentDB-Produktseite.](https://aws.amazon.com//documentdb/pricing) Die Protokollgröße des Änderungsstreams ist vom Umfang der Änderungen auf Ihrem Cluster und der Aufbewahrungsdauer des Änderungsstream-Protokoll abhängig. Weitere Informationen zu Änderungsstreams finden Sie unter [Change-Streams mit Amazon DocumentDB verwenden](change_streams.md). |
| CPUUtilization | Prozentsatz der CPU-Nutzung durch eine Instance. |
| DatabaseConnections | Die Anzahl der Verbindungen (aktiv und inaktiv), die auf einer Instance im Abstand von 1 Minute geöffnet sind. |
| DatabaseConnectionsMax | Die maximale Anzahl offener Datenbankverbindungen (aktiv und inaktiv) auf einer Instance in einem Zeitraum von 1 Minute. |
| DatabaseConnectionsLimit | Die maximale Anzahl gleichzeitiger Datenbankverbindungen (aktiv und inaktiv), die für eine Instance zu einem bestimmten Zeitpunkt zulässig sind. |
| DatabaseCursors | Die Anzahl der auf einer Instance geöffneten Cursor, die im Abstand von 1 Minute geöffnet werden. |
| DatabaseCursorsMax | Die maximale Anzahl geöffneter Cursor auf einer Instance in einem Zeitraum von 1 Minute. |
| DatabaseCursorsLimit | Die maximale Anzahl von Cursorn, die auf einer Instanz zu einem bestimmten Zeitpunkt zulässig sind. |
| DatabaseCursorsTimedOut | Die Anzahl der Cursor, bei denen innerhalb eines Zeitraums von 1 Minute ein Timeout aufgetreten ist. |
| FreeableMemory | Die Menge des verfügbaren Arbeitsspeichers (RAM-Speicher) in Bytes. |
| FreeLocalStorage | Diese Metrik gibt die Menge an Speicher an, der für jede Instance für temporäre Tabellen und Protokolle zur Verfügung steht. Dieser Wert hängt von der Instance-Klasse ab. Sie können die Menge an freiem Speicherplatz für eine Instance erhöhen, indem Sie eine größere Instance-Klasse für Ihre Instance auswählen. (Dies gilt nicht für DocumentDB Serverless.) |
| LowMemThrottleQueueDepth | Die Warteschlangentiefe für Anfragen, die aufgrund von zu wenig verfügbarem Speicherplatz gedrosselt werden und in einer Frequenz von 1 Minute abgerufen werden. |
| LowMemThrottleMaxQueueDepth | Die maximale Warteschlangentiefe für Anfragen, die aufgrund von zu wenig verfügbarem Speicherplatz in einem Zeitraum von 1 Minute gedrosselt werden. |
| LowMemNumOperationsThrottled | Die Anzahl der Anfragen, die aufgrund von zu wenig verfügbarem Speicherplatz in einem Zeitraum von 1 Minute gedrosselt werden. |
| SnapshotStorageUsed | Die Gesamtmenge des Backup-Speichers in Byte, der von allen Snapshots für einen bestimmten Amazon DocumentDB-Cluster außerhalb seines Aufbewahrungsfensters für Backups verbraucht wird. Ist in dem von der TotalBackupStorageBilled-Metrik gemeldeten Gesamtwert enthalten. Wird für jeden Amazon DocumentDB-Cluster separat berechnet. |
| SwapUsage | Größe des auf der Instance genutzten Auslagerungsbereichs. |
| TotalBackupStorageBilled | Die Gesamtmenge an Backup-Speicher in Byte, die Ihnen für einen bestimmten Amazon DocumentDB-Cluster in Rechnung gestellt wird. Umfasst den Sicherungsspeicher gemessen an den Metriken SnapshotStorageUsed und BackupRetentionPeriodStorageUsed. Wird für jeden Amazon DocumentDB-Cluster separat berechnet. |
| TransactionsOpen | Die Anzahl der offenen Transaktionen auf einer Instance, die im Abstand von 1 Minute ausgeführt wurden. |
| TransactionsOpenMax | Die maximale Anzahl von Transaktionen, die in einem Zeitraum von 1 Minute auf einer Instance geöffnet werden. |
| TransactionsOpenLimit | Die maximale Anzahl gleichzeitiger Transaktionen, die auf einer Instance zu einem bestimmten Zeitpunkt zulässig sind. |
| VolumeBytesUsed | Die Menge des von Ihrem Cluster verwendeten Speicherplatzes in Byte. Dieser Wert wirkt sich auf die Kosten des Clusters aus. Preisinformationen finden Sie auf der [Amazon DocumentDB DocumentDB-Produktseite.](https://aws.amazon.com//documentdb/pricing) |
### Latenzmetriken
| Metrik | Description |
| --- | --- |
| DBClusterReplicaLagMaximum | Die maximale Verzögerung in Millisekunden zwischen der primären Instance und jeder Amazon DocumentDB DocumentDB-Instance im Cluster. |
| DBClusterReplicaLagMinimum | Die Mindestverzögerung zwischen der Primär-Instance und jeder Replikat-Instance im Cluster, angegeben in Millisekunden. |
| DBInstanceReplicaLag | Die Verzögerung in Millisekunden, wenn Updates von der Primär-Instance an eine Replikat-Instance repliziert werden. |
| ReadLatency | Die durchschnittliche Zeit, die pro Festplattenvorgang benötigt wird. I/O |
| WriteLatency | Die durchschnittliche Zeit, in Millisekunden, die pro Festplattenvorgang benötigt wird. I/O |
### NVMe-gestützte Instance-Metriken
| Metrik | Description |
| --- | --- |
| NVMeStorageCacheHitRatio | Der Prozentsatz der Anfragen, die vom mehrstufigen Cache bedient werden. |
| FreeNVMeStorage | Die Menge des verfügbaren kurzlebigen Speichers NVMe . |
| ReadIOPSNVMeStorage | Die durchschnittliche Anzahl von I/O Festplatten-Lesevorgängen in NVMe flüchtigem Speicher. |
| ReadLatencyNVMeStorage | Die durchschnittliche Zeit, die pro Festplattenlesevorgang für I/O NVMe Ephemeral Storage benötigt wird. |
| ReadThroughputNVMeStorage | Die durchschnittliche Anzahl der pro Sekunde von der Festplatte gelesenen Byte für NVMe Ephemeral Storage. |
| WriteIOPSNVMeStorage | Die durchschnittliche Anzahl von I/O Schreibvorgängen auf der Festplatte in NVMe Ephemeral Storage. |
| WriteLatencyNVMeStorage | Die durchschnittliche Zeit, die pro I/O Schreibvorgang auf der Festplatte für NVMe Ephemeral Storage benötigt wird. |
| WriteThroughputNVMeStorage | Die durchschnittliche Anzahl der pro Sekunde auf die Festplatte geschriebenen Byte für kurzlebigen NVMe Speicher. |
### Betriebsmetriken
| Metrik | Description |
| --- | --- |
| DocumentsDeleted | Die Anzahl der gelöschten Dokumente in einem Zeitraum von 1 Minute. |
| DocumentsInserted | Die Anzahl der eingefügten Dokumente in einem Zeitraum von 1 Minute. |
| DocumentsReturned | Die Anzahl der zurückgegebenen Dokumente in einem Zeitraum von 1 Minute. |
| DocumentsUpdated | Die Anzahl der aktualisierten Dokumente in einem Zeitraum von 1 Minute. |
| OpcountersCommand | Die Anzahl der Befehle, die in einem Zeitraum von 1 Minute ausgegeben wurden. |
| OpcountersDelete | Die Anzahl der Löschvorgänge, die in einem Zeitraum von 1 Minute ausgeführt wurden. |
| OpcountersGetmore | Die Anzahl der innerhalb einer Minute ausgegebenen Getmores. |
| OpcountersInsert | Die Anzahl der innerhalb eines Zeitraums von 1 Minute ausgeführten Insert-Operationen. |
| OpcountersQuery | Die Anzahl der Abfragen, die in einem Zeitraum von 1 Minute ausgegeben wurden. |
| OpcountersUpdate | Die Anzahl der Aktualisierungsvorgänge, die in einem Zeitraum von 1 Minute ausgeführt wurden. |
| TransactionsStarted | Die Anzahl der Transaktionen, die in einem Zeitraum von 1 Minute auf einer Instance gestartet wurden. |
| TransactionsCommitted | Die Anzahl der Transaktionen, die in einem Zeitraum von 1 Minute auf einer Instance festgeschrieben wurden. |
| TransactionsAborted | Die Anzahl der Transaktionen, die auf einer Instance in einem Zeitraum von 1 Minute abgebrochen wurden. |
| TTLDeletedDocuments | Die Anzahl der Dokumente, die von a TTLMonitor in einem Zeitraum von 1 Minute gelöscht wurden. |
### Durchsatzmetriken
| Metrik | Description |
| --- | --- |
| NetworkReceiveThroughput | Der von Clients erhaltene Netzwerkdurchsatz für jede Instance im Cluster, angegeben in Bytes pro Sekunde. Dieser Durchsatz beinhaltet nicht den Netzwerkdatenverkehr zwischen den Instances im Cluster und dem Cluster-Volume. |
| NetworkThroughput | Die Menge des Netzwerkdurchsatzes in Byte pro Sekunde, der von jeder Instance im Amazon DocumentDB-Cluster sowohl von Clients empfangen als auch an diese übertragen wird. Dieser Durchsatz beinhaltet nicht den Netzwerkdatenverkehr zwischen den Instances im Cluster und dem Cluster-Volume. |
| NetworkTransmitThroughput | Der an Clients gesendete Netzwerkdurchsatz für jede Instance im Cluster, angegeben in Bytes pro Sekunde. Dieser Durchsatz beinhaltet nicht den Netzwerkdatenverkehr zwischen den Instances im Cluster und dem Cluster-Volume. |
| ReadIOPS | Die durchschnittliche Anzahl von I/O Festplatten-Lesevorgängen pro Sekunde. Amazon DocumentDB meldet Lese- und Schreib-IOPS getrennt und in 1-Minuten-Intervallen. |
| ReadThroughput | Die durchschnittliche Anzahl Byte, die pro Sekunde vom Datenträger gelesen werden. |
| StorageNetworkReceiveThroughput | Die Menge des Netzwerkdurchsatzes in Byte pro Sekunde, den jede Instance im Cluster vom Amazon DocumentDB-Cluster-Speichervolume empfängt. |
| StorageNetworkTransmitThroughput | Die Menge an Netzwerkdurchsatz in Byte pro Sekunde, die von jeder Instance im Cluster an das Amazon DocumentDB-Cluster-Speichervolume gesendet wird. |
| StorageNetworkThroughput | Die Menge des Netzwerkdurchsatzes in Byte pro Sekunde, der von jeder Instance im Amazon DocumentDB-Cluster empfangen und an das Amazon DocumentDB-Cluster-Speichervolume gesendet wurde. |
| VolumeReadIOPs | Die durchschnittliche Anzahl von abgerechneten I/O Lesevorgängen auf einem Cluster-Volume, die in 5-Minuten-Intervallen gemeldet werden. In Rechnung gestellte Lesevorgänge werden auf Cluster-Volume-Ebene berechnet, aus allen Instances im Cluster zusammengestellt und dann in fünfminütigen Intervallen gemeldet. Der Wert wird anhand des Werts der Metrik für Leseoperationen über einen fünfminütigen Zeitraum berechnet. Sie können die Menge an in Rechnung gestellten Leseoperationen pro Sekunde bestimmen, indem Sie den Wert der Metrik für in Rechnung gestellte Leseoperationen durch 300 Sekunden teilen. Wenn der beispielsweise 13.686 `VolumeReadIOPs` zurückgibt, dann sind die fakturierten Lesevorgänge pro Sekunde 45 (13.686/300 = 45,62). In Rechnung gestellte Operationen fallen für Abfragen für nicht im Buffer-Cache enthaltene Datenbankseiten an, die erst aus dem Speicher geladen werden müssen. Sie sehen evtl. Spitzenwerte in den in Rechnung gestellten Operationen, da Abfrageergebnisse aus dem Speicher gelesen und anschließend in den Buffer-Cache geladen werden. |
| VolumeWriteIOPs | Die durchschnittliche Anzahl von fakturierten I/O Schreibvorgängen auf einem Cluster-Volume, die in 5-Minuten-Intervallen gemeldet wird. In Rechnung gestellte Schreibvorgänge werden auf Cluster-Volume-Ebene berechnet, aus allen Instances im Cluster aggregiert und dann in 5-Minuten-Intervallen gemeldet. Der Wert wird anhand des Werts der Schreiboperationsmetrik über einen Zeitraum von 5 Minuten berechnet. Sie können die Menge der in Rechnung gestellten Schreiboperationen pro Sekunde ermitteln, indem Sie den Wert der Schreiboperations-Abrechnungsmetrik durch 300 Sekunden teilen. Wenn beispielsweise 13.686 `VolumeWriteIOPs` zurückgegeben wird, beträgt die fakturierte Schreiboperation pro Sekunde 45 (13.686/300 = 45,62). Beachten Sie, dass die `VolumeReadIOPs` `VolumeWriteIOPs` Metriken von der DocumentDB-Speicherebene berechnet werden und auch die von der Primär- und Replikatinstanz IOs durchgeführten Messungen beinhalten. Die Daten werden alle 20 bis 30 Minuten aggregiert und dann in Intervallen von 5 Minuten gemeldet, sodass in dem Zeitraum derselbe Datenpunkt für die Metrik ausgegeben wird. Wenn Sie nach einer Metrik suchen, die mit Ihren Einfügevorgängen über ein Intervall von 1 Minute korreliert, können Sie die WriteIOps-Metrik auf Instanzebene verwenden. Die Metrik ist auf der Registerkarte Überwachung Ihrer primären Amazon DocumentDB DocumentDB-Instance verfügbar. |
| WriteIOPS | Die durchschnittliche Anzahl von I/O Schreibvorgängen auf der Festplatte pro Sekunde. Bei Verwendung auf Clusterebene WriteIOPs werden sie für alle Instanzen im Cluster ausgewertet. Lese- und Schreib-IOPS werden separat und in 1-Minuten-Intervallen angegeben. |
| WriteThroughput | Die durchschnittliche Anzahl von Bytes, die pro Sekunde auf den Datenträger geschrieben werden. |
### Systemmetriken
| Metrik | Description |
| --- | --- |
| AvailableMVCCIds | Ein Zähler, der die Anzahl der verbleibenden Schreibvorgänge anzeigt, bevor der Wert Null erreicht wird. Wenn dieser Zähler Null erreicht, wechselt Ihr Cluster in den schreibgeschützten Modus, bis die Daten zurückgewonnen und IDs recycelt werden. Der Zähler nimmt mit jedem Schreibvorgang ab und steigt, wenn alte MVCCs bei der Garbage-Collection recycelt werden. IDs |
| BufferCacheHitRatio | Der Prozentsatz der vom Buffer-Cache bedienten Anfragen. |
| DiskQueueDepth | Die Anzahl der I/O Operationen, die darauf warten, auf die Festplatte geschrieben oder von der Festplatte gelesen zu werden. |
| EngineUptime | Die Gesamtlaufzeit der Instance in Sekunden. |
| IndexBufferCacheHitRatio | Der Prozentsatz der Indexanforderungen, die vom Puffercache bedient werden. Möglicherweise stellen Sie unmittelbar nach dem Löschen eines Indexes, einer Sammlung oder einer Datenbank einen Anstieg von mehr als 100 Prozent für die Metrik fest. Dies wird nach 60 Sekunden automatisch korrigiert. Diese Einschränkung wird in einem future Patch-Update behoben. |
| LongestActiveGCRuntime | Dauer des längsten aktiven Garbage-Collection-Vorgangs in Sekunden. Wird jede Minute aktualisiert und verfolgt nur aktive Vorgänge, ausgenommen Prozesse, die innerhalb des Zeitfensters von einer Minute abgeschlossen werden. |
### Metriken für T3-Instanzen
| Metrik | Description |
| --- | --- |
| CPUCreditUsage | Die Anzahl der CPU-Credits, die während des Messzeitraums ausgegeben wurden. |
| CPUCreditBalance | Die Anzahl der CPU-Credits, die eine Instance gesammelt hat. Dieser Saldo wird während der Steigerung der CPU-Leistung aufgebraucht, da die CPU-Guthaben schneller verbraucht als erworben werden. |
| CPUSurplusCreditBalance | Die Anzahl der überschüssigen CPU-Guthaben, die zur Aufrechterhaltung der CPU-Leistung ausgegeben wurden, wenn der CPUCredit Balance-Wert Null ist. |
| CPUSurplusCreditsCharged | Die Anzahl der überschüssigen CPU-Guthaben, die die maximale Anzahl an CPU-Credits überschreiten, die innerhalb von 24 Stunden verdient werden können, sodass zusätzliche Gebühren anfallen. Weitere Informationen finden Sie unter [Überwachen Ihres CPU-Guthabens](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-monitoring-cpu-credits.html). |
## CloudWatch Daten anzeigen
Sie können CloudWatch Amazon-Daten mit der CloudWatch Konsole, der Amazon DocumentDB-Konsole AWS Command Line Interface (AWS CLI) oder der CloudWatch API anzeigen.
------
#### [ Using the AWS-Managementkonsole ]
Gehen Sie wie folgt vor, um CloudWatch Metriken mit der Amazon DocumentDB Management Console anzuzeigen.
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Tipp**
Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.
1. **Im Cluster-Navigationsfeld sehen Sie die Spalte Cluster-ID.** Ihre Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.
![\[Die Cluster-Tabelle zeigt, wie eine Instance unter einem Cluster verschachtelt ist.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/choose-clusters.png)
1. Wählen Sie aus der Liste der Instances den Namen der Instance aus, für die Sie Metriken benötigen.
1. Wählen Sie auf der daraufhin angezeigten Instance-Übersichtsseite den Tab **Monitoring**, um grafische Darstellungen der Metriken Ihrer Amazon DocumentDB DocumentDB-Instance anzuzeigen. Da für jede Metrik ein Diagramm generiert werden muss, kann es einige Minuten dauern, bis die **CloudWatch**Grafiken gefüllt sind.
Die folgende Abbildung zeigt die grafische Darstellung von zwei CloudWatch Metriken in der Amazon DocumentDB DocumentDB-Konsole, `WriteIOPS` und`ReadIOPS`.
![\[Zwei Liniendiagramme, die die WriteIOPS- und CloudWatch ReadIOps-Metriken in der Amazon DocumentDB DocumentDB-Konsole darstellen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/cw-metrics-con.png)
------
#### [ Using the CloudWatch Management Console ]
Gehen Sie wie folgt vor, um CloudWatch Metriken mit der CloudWatch Management Console anzuzeigen.
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter[https://console.aws.amazon.com/cloudwatch](https://console.aws.amazon.com/cloudwatch).
1. Wählen Sie im Navigationsbereich **Metriken** aus. Wählen Sie dann aus der Liste der Dienstnamen **DocDB** aus.
1. Wählen Sie eine Metrikdimension (z. B. **Cluster-Metriken**).
1. Auf der Registerkarte **Alle Metriken** werden alle Metriken für diese Dimension in **DocDB** angezeigt.
1. Um die Tabelle sortieren, verwenden Sie die Spaltenüberschrift.
1. Um eine Metrik grafisch darzustellen, müssen Sie das Kontrollkästchen neben der Metrik aktivieren. Um alle Metriken auszuwählen, aktivieren Sie das Kontrollkästchen in der Kopfzeile der Tabelle.
1. Um nach Metrik zu filtern, bewegen Sie den Mauszeiger über den Metriknamen und wählen Sie den Dropdown-Pfeil neben dem Metriknamen aus. Wählen Sie dann **Zur Suche hinzufügen** aus, wie in der Abbildung unten gezeigt.
![\[Der Tab Alle Metriken listet Metriken auf, wobei eine Dropdownliste für einen Metriknamen angezeigt wird.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/cloudwatch-filter-metrics.png)
------
#### [ Using the AWS CLI ]
Verwenden Sie den CloudWatch `get-metric-statistics` Vorgang mit den folgenden Parametern, um CloudWatch Daten für Amazon DocumentDB anzuzeigen.
**Parameters**
+ **--namespace** – Erforderlich. Der Service-Namespace, für den Sie CloudWatch -Metriken anzeigen möchten. Für Amazon DocumentDB muss dies der Fall sein. `AWS/DocDB`
+ **--metric-name** – Erforderlich. Der Name der Metrik, für die Sie Daten benötigen.
+ **--start-time** – Erforderlich. Der Zeitstempel, der den ersten zurückzugebenden Datenpunkt bestimmt.
Der angegebene Wert wird eingeschlossen. Die Ergebnisse umfassen Datenpunkte mit dem angegebenen Zeitstempel. Der Zeitstempel muss im ISO 8601 UTC-Format angegeben werden (z. B. 2016-10-03T23:00:00Z).
+ **--end-time** – Erforderlich. Der Zeitstempel, der den letzten zurückzugebenden Datenpunkt bestimmt.
Der angegebene Wert wird eingeschlossen. Die Ergebnisse umfassen Datenpunkte mit dem angegebenen Zeitstempel. Der Zeitstempel muss im ISO 8601 UTC-Format angegeben werden (z. B. 2016-10-03T23:00:00Z).
+ **--period** – Erforderlich. Die Granularität der zurückgegebenen Datenpunkte in Sekunden. Für Metriken mit regulärer Auflösung kann ein Zeitraum gerade mal eine Minute (60 Sekunden) betragen. Der Wert muss ein Vielfaches von 60 sein. Für hochauflösende Metriken, die in Abständen von weniger als einer Minute erfasst werden, kann der Zeitraum 1, 5, 10, 30, 60 oder ein Vielfaches von 60 betragen.
+ **--dimensions**— Fakultativ. Wenn die Metrik mehrere Dimensionen enthält, müssen Sie für jede Dimension einen Wert angeben. CloudWatch behandelt jede eindeutige Kombination von Dimensionen als separate Metrik. Wenn eine bestimmte Kombination von Dimensionen nicht veröffentlicht wurde, können Sie keine Metriken dafür abrufen. Sie müssen die gleichen Dimensionen angeben, die bei der Erstellung der Metriken verwendet wurden.
+ **--statistics**— Fakultativ. Die Metrik-Statistiken abgesehen von den Perzentil-Statistiken. Verwenden Sie für Perzentil-Statistiken `ExtendedStatistics`. Wenn Sie `GetMetricStatistics` aufrufen, müssen Sie `Statistics` oder `ExtendedStatistics` angeben, aber nicht beides.
**Gültige Werte:**
+ `SampleCount`
+ `Average`
+ `Sum`
+ `Minimum`
+ `Maximum`
+ **--extended-statistics**— Fakultativ. Die `percentile`-Statistiken. Geben Sie Werte zwischen p0.0 und p100 an. Wenn Sie `GetMetricStatistics` aufrufen, müssen Sie `Statistics` oder `ExtendedStatistics` angeben, aber nicht beides.
+ **--unit**— Fakultativ. Die Einheit für eine bestimmte Metrik. Metriken können in mehreren Einheiten angegeben werden. Wenn Sie keine Einheit festlegen, werden alle Einheiten zurückgegeben. Wenn Sie nur eine Einheit angeben, die für die Metrik nicht unterstützt wird, erhalten Sie keine Ergebnisse für den Aufruf.
**Mögliche Werte:**
+ `Seconds`
+ `Microseconds`
+ `Milliseconds`
+ `Bytes`
+ `Kilobytes`
+ `Megabytes`
+ `Gigabytes`
+ `Terabytes`
+ `Bits`
+ `Kilobytes`
+ `Megabits`
+ `Gigabits`
+ `Terabits`
+ `Percent`
+ `Count`
+ `Bytes/Second`
+ `Kilobytes/Second`
+ `Megabytes/Second`
+ `Gigabytes/Second`
+ `Terabytes/Second`
+ `Bits/Second`
+ `Kilobits/Second`
+ `Megabits/Second`
+ `Gigabits/Second`
+ `Terabits/Second`
+ `Count/Second`
+ `None`
**Example**
Im folgenden Beispiel wird die maximale `CPUUtilization` für einen Zeitraum von 2 Stunden gezeigt, wobei alle 60 Sekunden eine Messung erfolgt.
Für Linux, macOS oder Unix:
```
aws cloudwatch get-metric-statistics \
--namespace AWS/DocDB \
--dimensions \
Name=DBInstanceIdentifier,Value=docdb-2019-01-09-23-55-38 \
--metric-name CPUUtilization \
--start-time 2019-02-11T05:00:00Z \
--end-time 2019-02-11T07:00:00Z \
--period 60 \
--statistics Maximum
```
Für Windows:
```
aws cloudwatch get-metric-statistics ^
--namespace AWS/DocDB ^
--dimensions ^
Name=DBInstanceIdentifier,Value=docdb-2019-01-09-23-55-38 ^
--metric-name CPUUtilization ^
--start-time 2019-02-11T05:00:00Z ^
--end-time 2019-02-11T07:00:00Z ^
--period 60 ^
--statistics Maximum
```
Die Ausgabe dieser Operation sieht in etwa wie folgt aus.
```
{
"Label": "CPUUtilization",
"Datapoints": [
{
"Unit": "Percent",
"Maximum": 4.49152542374361,
"Timestamp": "2019-02-11T05:51:00Z"
},
{
"Unit": "Percent",
"Maximum": 4.25000000000485,
"Timestamp": "2019-02-11T06:44:00Z"
},
********* some output omitted for brevity *********
{
"Unit": "Percent",
"Maximum": 4.33333333331878,
"Timestamp": "2019-02-11T06:07:00Z"
}
]
}
```
------
## Abmessungen von Amazon DocumentDB
Die Metriken für Amazon DocumentDB werden anhand der Werte für das Konto oder den Vorgang qualifiziert. Sie können die CloudWatch Konsole verwenden, um Amazon DocumentDB DocumentDB-Daten abzurufen, die nach einer der Dimensionen in der folgenden Tabelle gefiltert wurden.
| Dimension | Description |
| --- | --- |
| DBClusterIdentifier | Filtert die Daten, die Sie für einen bestimmten Amazon DocumentDB-Cluster anfordern. |
| DBClusterIdentifier, Role | Filtert die Daten, die Sie für einen bestimmten Amazon DocumentDB-Cluster anfordern, und aggregiert die Metrik nach Instance-Rolle (WRITER/READER). Sie können beispielsweise Metriken für alle READER-Instances eines Clusters zusammenfassen. |
| DBInstanceIdentifier | Filtert die angeforderten Daten für eine spezifische Datenbank-Instance. |
## Überwachung von Opcounter-Metriken
Opcounter-Metriken haben einen Wert ungleich Null (normalerweise \$150) für inaktive Cluster. Dies liegt daran, dass Amazon DocumentDB regelmäßige Zustandsprüfungen, interne Abläufe und Aufgaben zur Erfassung von Kennzahlen durchführt.
## Überwachen von Datenbankverbindungen
Wenn Sie die Anzahl der Verbindungen mithilfe von Datenbank-Engine-Befehlen wie anzeigen`db.runCommand( { serverStatus: 1 })`, werden Ihnen möglicherweise bis zu 10 Verbindungen mehr angezeigt, als Sie `DatabaseConnections` CloudWatch durchschauen. Dies liegt daran, dass Amazon DocumentDB regelmäßige Zustandsprüfungen und Aufgaben zur Erfassung von Kennzahlen durchführt, die nicht berücksichtigt werden. `DatabaseConnections` `DatabaseConnections`steht nur für vom Kunden initiierte Verbindungen.
# Protokollieren Amazon DocumentDB DocumentDB-API-Aufrufen mit AWS CloudTrail
Amazon DocumentDB (mit MongoDB-Kompatibilität) ist in einen Service integriert AWS CloudTrail, der eine Aufzeichnung der Aktionen von Benutzern, Rollen oder einem AWS Service in Amazon DocumentDB (mit MongoDB-Kompatibilität) bereitstellt. CloudTrail erfasst alle AWS CLI API-Aufrufe für Amazon DocumentDB als Ereignisse, einschließlich Aufrufe von der Amazon DocumentDB-Konsole und von Codeaufrufen an das Amazon DocumentDB-SDK. Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Übermittlung von CloudTrail Ereignissen an einen Amazon S3 S3-Bucket aktivieren, einschließlich Ereignissen für Amazon DocumentDB. Wenn Sie keinen Trail konfigurieren, können Sie die neuesten Ereignisse trotzdem auf der CloudTrail Konsole im **Event-Verlauf** einsehen. Anhand der von CloudTrail gesammelten Informationen können Sie die Anfrage an Amazon DocumentDB (mit MongoDB-Kompatibilität), die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde und andere Details ermitteln.
**Wichtig**
Für bestimmte Verwaltungsfunktionen verwendet Amazon DocumentDB eine Betriebstechnologie, die mit Amazon Relational Database Service (Amazon RDS) gemeinsam genutzt wird. Amazon DocumentDB DocumentDB-Konsolen- und API-Aufrufe werden als Aufrufe der Amazon RDS-API protokolliert. AWS CLI
Weitere Informationen AWS CloudTrail finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## Amazon DocumentDB DocumentDB-Informationen in CloudTrail
CloudTrail ist auf Ihrem aktiviert AWS-Konto , wenn Sie das Konto erstellen. Wenn Aktivitäten in Amazon DocumentDB (mit MongoDB-Kompatibilität) auftreten, wird diese Aktivität zusammen mit anderen AWS Serviceereignissen in der CloudTrail Ereignishistorie in einem **Ereignis** aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem anzeigen, suchen und herunterladen. AWS-Konto Weitere Informationen finden Sie unter [Ereignisse mit CloudTrail Ereignisverlauf anzeigen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Für eine fortlaufende Aufzeichnung der Ereignisse in Ihrem AWS-Konto, einschließlich Ereignissen für Amazon DocumentDB (mit MongoDB-Kompatibilität), erstellen Sie einen Trail. Ein Trail ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie einen Trail in der Konsole anlegen, gilt dieser für alle AWS-Regionen-Regionen. Der Trail protokolliert Ereignisse aus allen Regionen in der AWS -Partition und stellt die Protokolldateien in dem von Ihnen angegebenen Amazon-S3-Bucket bereit. Darüber hinaus können Sie andere AWS Dienste konfigurieren, um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie in folgenden Themen im *AWS CloudTrail -Benutzerhandbuch*:
+ [Übersicht zum Erstellen eines Trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Unterstützte Dienste und Integrationen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Konfiguration von Amazon SNS SNS-Benachrichtigungen für CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Empfangen von CloudTrail Protokolldateien aus mehreren Regionen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)
+ [Empfangen von CloudTrail Protokolldateien von mehreren Konten](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Jedes Event oder jeder Protokolleintrag enthält Informationen über den Ersteller der Anfrage. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte:
+ Ob die Anforderung mit Root- oder -Benutzeranmeldeinformationen ausgeführt wurde.
+ Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde.
+ Ob die Anfrage von einem anderen AWS Dienst gestellt wurde.
Weitere Informationen finden Sie unter [CloudTrail userIdentity-Element](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
# Profilierung von Amazon DocumentDB DocumentDB-Vorgängen
Sie können den Profiler in Amazon DocumentDB (mit MongoDB-Kompatibilität) verwenden, um die Ausführungszeit und Details der Operationen zu protokollieren, die auf Ihrem Cluster ausgeführt wurden. Profiler ist für die Überwachung der langsamsten Operationen in Ihrem Cluster nützlich. So können Sie die Leistung einzelner Abfragen und die allgemeine Cluster-Leistung verbessern.
Standardmäßig ist die Profiler-Funktion deaktiviert. Wenn diese Option aktiviert ist, protokolliert der Profiler Vorgänge, die länger dauern als ein vom Kunden definierter Schwellenwert (z. B. 100 ms), in Amazon CloudWatch Logs. Zu den protokollierten Details gehören der Befehl, für den das Profil erstellt wird, die Uhrzeit, die Planübersicht und die Client-Metadaten. Nachdem die Vorgänge in CloudWatch Logs protokolliert wurden, können Sie Logs Insights verwenden, um Ihre Amazon DocumentDB CloudWatch DocumentDB-Profilerstellungsdaten zu analysieren, zu überwachen und zu archivieren. Häufige Abfragen sind in Abschnitt [Häufig gestellte Fragen](#profiling.common-queries) zu finden.
Wenn aktiviert, verbraucht der Profiler zusätzliche Ressourcen im Cluster. Sie sollten mit einem hohen Schwellenwert (z. B. 500 ms) beginnen und den Wert allmählich senken, um langsame Operationen zu identifizieren. Ein anfänglicher Schwellenwert von 50 ms kann für Anwendungen mit hohem Durchsatz zu Leistungsproblemen im Cluster führen. Der Profiler ist auf Cluster-Ebene aktiviert und funktioniert auf allen Instances und Datenbanken in einem Cluster. Amazon DocumentDB protokolliert Operationen nach bestem Wissen und Gewissen in Amazon CloudWatch Logs.
Amazon DocumentDB erhebt zwar keine zusätzlichen Gebühren für die Aktivierung des Profilers, Ihnen werden jedoch die Standardtarife für die Nutzung von Logs berechnet. CloudWatch Informationen zu den Preisen für CloudWatch Logs finden Sie unter [ CloudWatch Amazon-Preise](https://aws.amazon.com/cloudwatch/pricing/).
**Topics**
+ [Unterstützte Vorgänge](#profiling.supported-commands)
+ [Einschränkungen](#profiling.limitations)
+ [Den Profiler aktivieren](#profiling.enable-profiling)
+ [Den Profiler deaktivieren](#profiling.disable-profiling)
+ [Export von Profiler-Protokollen deaktivieren](#profiling.disabling-logs-export)
+ [Greifen Sie auf Ihre Profiler-Protokolle zu](#profiling.accessing)
+ [Häufig gestellte Fragen](#profiling.common-queries)
## Unterstützte Vorgänge
Amazon DocumentDB Profiler unterstützt die folgenden Operationen:
+ `aggregate`
+ `count`
+ `delete`
+ `distinct`
+ `find` (OP\$1QUERY und Befehl)
+ `findAndModify`
+ `insert`
+ `update`
## Einschränkungen
Der Profiler für langsame Abfragen kann Profiler-Protokolle nur ausgeben, wenn die gesamte Ergebnismenge der Abfrage in einen Stapel passt und wenn die Ergebnismenge weniger als 16 MB (maximale BSON-Größe) beträgt. Ergebnissätze, die größer als 16 MB sind, werden automatisch in mehrere Batches aufgeteilt.
Die meisten Treiber oder Shells legen möglicherweise eine kleine Standardstapelgröße fest. Sie können die Batchgröße als Teil Ihrer Abfrage angeben. Für die Erfassung langsamer Abfrageprotokolle empfehlen wir eine Batchgröße, die die Größe Ihrer erwarteten Ergebnismenge übersteigt. Wenn Sie sich bezüglich der Größe der Ergebnismenge nicht sicher sind oder wenn sie variiert, können Sie die Batchgröße auch auf eine große Zahl festlegen (z. B. 100.000).
Die Verwendung einer größeren Batchgröße bedeutet jedoch, dass mehr Ergebnisse aus der Datenbank abgerufen werden müssen, bevor eine Antwort an den Client gesendet wird. Bei einigen Abfragen kann dies zu längeren Verzögerungen führen, bis Sie Ergebnisse erhalten. Wenn Sie nicht vorhaben, die gesamte Ergebnismenge zu verwenden, ist es möglich, dass Sie mehr I/Os für die Verarbeitung der Abfrage ausgeben und das Ergebnis dann verwerfen.
## Den Amazon DocumentDB DocumentDB-Profiler aktivieren
Die Aktivierung des Profilers auf einem Cluster erfolgt in drei Schritten. Stellen Sie sicher, dass alle Schritte abgeschlossen sind, da andernfalls keine Profilerstellungsprotokolle an Logs gesendet CloudWatch werden. Profiler wird auf Cluster-Ebene festgelegt und auf allen Datenbanken und Instances des Clusters ausgeführt.
**So aktivieren Sie den Profiler in einem Cluster**
1. Da Sie eine Standard-Cluster-Parametergruppe nicht ändern können, stellen Sie sicher, dass Sie über eine verfügbare benutzerdefinierte Cluster-Parametergruppe verfügen. Weitere Informationen finden Sie unter [Amazon DocumentDB-Cluster-Parametergruppen erstellen](cluster_parameter_groups-create.md).
1. Ändern Sie mithilfe einer verfügbaren benutzerdefinierten Cluster-Parametergruppe die folgenden Parameter: `profiler`, `profiler_threshold_ms` und `profiler_sampling_rate`. Weitere Informationen finden Sie unter [Amazon DocumentDB-Cluster-Parametergruppen ändern](cluster_parameter_groups-modify.md).
1. Erstellen oder ändern Sie Ihren Cluster, um die benutzerdefinierte Cluster-Parametergruppe zu verwenden und den Export von `profiler` Protokollen in Logs zu CloudWatch ermöglichen.
In den folgenden Abschnitten wird gezeigt, wie Sie diese Schritte mithilfe von AWS-Managementkonsole und AWS Command Line Interface (AWS CLI) implementieren.
------
#### [ Using the AWS-Managementkonsole ]
1. Bevor Sie beginnen, erstellen Sie einen Amazon DocumentDB-Cluster und eine benutzerdefinierte Cluster-Parametergruppe, falls Sie noch keinen haben. Weitere Informationen erhalten Sie unter [Amazon DocumentDB-Cluster-Parametergruppen erstellen](cluster_parameter_groups-create.md) und [Einen Amazon DocumentDB-Cluster erstellen](db-cluster-create.md).
1. Ändern Sie die folgenden Parameter mithilfe einer verfügbaren benutzerdefinierten Cluster-Parametergruppe. Weitere Informationen finden Sie unter [Amazon DocumentDB-Cluster-Parametergruppen ändern](cluster_parameter_groups-modify.md).
+ `profiler`— Aktiviert oder deaktiviert die Erstellung von Abfrageprofilen. Zugelassene Werte sind `enabled ` und `disabled`. Der Standardwert ist `disabled`. Um Profiling zu aktivieren, legen Sie den Wert auf `enabled` fest.
+ `profiler_threshold_ms`— Wenn auf gesetzt `profiler` ist`enabled`, werden alle Befehle protokolliert, die länger dauern als ` profiler_threshold_ms` angegeben. CloudWatch Zugelassene Werte sind `[50-INT_MAX]`. Der Standardwert ist `100`.
+ `profiler_sampling_rate`— Der Anteil der langsamen Operationen, für die ein Profil erstellt oder protokolliert werden sollte. Zugelassene Werte sind `[0.0-1.0]`. Der Standardwert ist `1.0`.
1. Ändern Sie Ihren Cluster so, dass er die benutzerdefinierte Cluster-Parametergruppe verwendet, und legen Sie fest, dass die Profiler-Protokollexporte auf Amazon CloudWatch veröffentlicht werden sollen.
1. Wählen Sie im Navigationsbereich die Option **Clusters (Cluster)**, um die benutzerdefinierte Parametergruppe zu einem Cluster hinzuzufügen.
1. Wählen Sie die Schaltfläche links neben dem Namen des Clusters, dem Sie die Parametergruppe zuordnen möchten. Wählen Sie **Actions (Aktionen)** und dann **Modify (Ändern)** aus, um den Cluster zu ändern.
1. Wählen Sie unter **Cluster options (Cluster-Optionen)** die benutzerdefinierte Parametergruppe aus dem obigen Schritt aus, um sie Ihrem Cluster hinzuzufügen.
1. Wählen Sie unter **Protokollexporte** die Option **Profiler-Protokolle** aus, die auf Amazon CloudWatch veröffentlicht werden sollen.
1. Wählen Sie **Continue (Weiter)** aus, um eine Übersicht Ihrer Änderungen anzuzeigen.
1. Nachdem Sie Ihre Änderungen überprüft haben, können Sie diese sofort oder während des nächsten Wartungsfensters unter **Scheduling of modifications (Planen von Änderungen)** anwenden.
1. Wählen Sie **Modify cluster (Cluster ändern)** aus, um den Cluster mit der neuen Parametergruppe zu aktualisieren.
------
#### [ Using the AWS CLI ]
Mit dem folgenden Verfahren wird der Profiler für alle unterstützten Operationen für den Cluster `sample-cluster` aktiviert.
1. Bevor Sie beginnen, stellen Sie sicher, dass Sie über eine benutzerdefinierte Clusterparametergruppe verfügen, indem Sie den folgenden Befehl ausführen und die Ausgabe für eine Clusterparametergruppe überprüfen, die nicht `default` im Namen und die Parametergruppenfamilie `docdb3.6` hat. Wenn Sie über keine nicht standardmäßige Clusterparametergruppe verfügen, siehe [Amazon DocumentDB-Cluster-Parametergruppen erstellen](cluster_parameter_groups-create.md).
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName,DBParameterGroupFamily]'
```
In der folgenden Ausgabe erfüllt nur `sample-parameter-group ` beide Kriterien.
```
[
[
"default.docdb3.6",
"docdb3.6"
],
[
"sample-parameter-group",
"docdb3.6"
]
]
```
1. Ändern Sie mithilfe Ihrer benutzerdefinierten Cluster-Parametergruppe die folgenden Parameter:
+ `profiler`— Aktiviert oder deaktiviert die Erstellung von Abfrageprofilen. Zugelassene Werte sind `enabled ` und `disabled`. Der Standardwert ist `disabled`. Um Profiling zu aktivieren, legen Sie den Wert auf `enabled` fest.
+ `profiler_threshold_ms`— Wenn auf gesetzt `profiler` ist`enabled`, dauern alle Befehle länger, als protokolliert `profiler_threshold_ms` wurden. CloudWatch Zugelassene Werte sind `[50-INT_MAX]`. Der Standardwert ist `100`.
+ `profiler_sampling_rate`— Der Anteil langsamer Operationen, für den ein Profil erstellt oder protokolliert werden sollte. Zugelassene Werte sind `[0.0-1.0]`. Der Standardwert ist `1.0`.
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters ParameterName=profiler,ParameterValue=enabled,ApplyMethod=immediate \
ParameterName=profiler_threshold_ms,ParameterValue=100,ApplyMethod=immediate \
ParameterName=profiler_sampling_rate,ParameterValue=0.5,ApplyMethod=immediate
```
1. Ändern Sie Ihren Amazon DocumentDB-Cluster so, dass er die `sample-parameter-group` benutzerdefinierte Cluster-Parametergruppe aus dem vorherigen Schritt verwendet und den Parameter `--enable-cloudwatch-logs-exports` auf `profiler` setzt.
Der folgende Code ändert den Cluster so`sample-cluster`, dass er den `sample-parameter-group` aus dem vorherigen Schritt verwendet, und erweitert `profiler` die aktivierten CloudWatch Logs-Exporte.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--db-cluster-parameter-group-name sample-parameter-group \
--cloudwatch-logs-export-configuration '{"EnableLogTypes":["profiler"]}'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
{
"DBCluster": {
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2020-04-07T02:05:12.479Z",
"Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "3.6.0",
"LatestRestorableTime": "2020-04-08T22:08:59.317Z",
"Port": 27017,
"MasterUsername": "test",
"PreferredBackupWindow": "02:00-02:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-01-10T22:13:38.261Z",
"EnabledCloudwatchLogsExports": [
"profiler"
],
"DeletionProtection": true
}
}
```
------
## Den Amazon DocumentDB DocumentDB-Profiler deaktivieren
Um den Profiler zu deaktivieren, deaktivieren Sie sowohl den `profiler` Parameter als auch den Export von `profiler` Protokollen in Logs. CloudWatch
### Deaktivieren des Profilers
Sie können den `profiler` Parameter entweder mit AWS-Managementkonsole oder AWS CLI wie folgt deaktivieren.
------
#### [ Using the AWS-Managementkonsole ]
Das folgende Verfahren verwendet die AWS-Managementkonsole , um Amazon DocumentDB `profiler` zu deaktivieren.
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Wählen Sie im Navigationsbereich **Parameter groups (Parametergruppen)** aus. Wählen Sie dann den Namen der Cluster-Parametergruppe aus, für die Sie den Profiler deaktivieren möchten.
1. Klicken Sie auf der Seite **Cluster parameters (Clusterparameter)** auf die Schaltfläche links neben dem `profiler`-Parameter und wählen Sie **Edit (Bearbeiten)**.
1. Wählen Sie im Dialogfeld **Modify profiler (Profiler ändern)** `disabled` in der Liste aus.
1. Wählen Sie **Modify Cluster Parameter (Cluster-Parameter ändern)**.
------
#### [ Using the AWS CLI ]
Um `profiler` auf einem Cluster mithilfe der AWS CLI zu deaktivieren, ändern Sie den Cluster wie folgt.
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters ParameterName=profiler,ParameterValue=disabled,ApplyMethod=immediate
```
------
## Export von Profiler-Protokollen deaktivieren
Sie können den Export von `profiler` Protokollen in Logs deaktivieren, CloudWatch indem Sie entweder das AWS-Managementkonsole oder verwenden AWS CLI, und zwar wie folgt.
------
#### [ Using the AWS-Managementkonsole ]
Im folgenden Verfahren wird der verwendet AWS-Managementkonsole , um den Export von Protokollen durch Amazon DocumentDB zu CloudWatch deaktivieren.
1. Öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**. Wählen Sie die Schaltfläche links neben dem Namen des Clusters, für den Sie den Export von Protokollen deaktivieren möchten.
1. Wählen Sie aus dem Menü **Actions (Aktionen)** die Option **Modify (Ändern)** aus.
1. Scrollen Sie nach unten zum Abschnitt **Log exports (Protokollexporte)** und deaktivieren Sie **Profiler logs (Profiler-Protokolle)**.
1. Klicken Sie auf **Weiter**.
1. Überprüfen Sie Ihre Änderungen und wählen Sie dann aus, wann diese Änderung auf Ihren Cluster angewendet werden soll.
+ **Apply during the next scheduled maintenance window (Anwendung während des nächsten geplanten Wartungsfensters)**
+ **Apply immediately (Sofort anwenden)**
1. Wählen Sie **Cluster bearbeiten** aus.
------
#### [ Using the AWS CLI ]
Der folgende Code modifiziert den Cluster `sample-cluster ` und deaktiviert Profiler-Logs. CloudWatch
**Example**
Für Linux, macOS oder Unix:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--cloudwatch-logs-export-configuration '{"DisableLogTypes":["profiler"]}'
```
Für Windows:
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--cloudwatch-logs-export-configuration '{"DisableLogTypes":["profiler"]}'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
{
"DBCluster": {
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2020-04-08T02:05:17.266Z",
"Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "3.6.0",
"LatestRestorableTime": "2020-04-09T05:14:44.356Z",
"Port": 27017,
"MasterUsername": "test",
"PreferredBackupWindow": "02:00-02:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-01-10T22:13:38.261Z",
"DeletionProtection": true
}
}
```
------
## Zugreifen auf Ihre Amazon DocumentDB DocumentDB-Profiler-Protokolle
Gehen Sie wie folgt vor, um auf Ihre Profilprotokolle bei Amazon zuzugreifen CloudWatch.
1. Öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Stellen Sie sicher, dass Sie sich in derselben Region wie Ihr Amazon DocumentDB-Cluster befinden.
1. Wählen Sie im Navigationsbereich **Protokolle** aus.
1. Um die Profiler-Protokolle für Ihren Cluster zu finden, wählen Sie in der Liste `/aws/docdb/yourClusterName/profiler` aus.
Die Profilprotokolle für jede Ihrer Instances sind unter den jeweiligen Instance-Namen verfügbar.
## Häufig gestellte Fragen
Im Folgenden finden Sie einige häufige Abfragen, die Sie verwenden können, um Ihre Befehle, für die Profile erstellt wurden, zu analysieren. Weitere Informationen zu CloudWatch Logs Insights finden Sie unter [Analysieren von Protokolldaten mit CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) und [Beispielabfragen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax-examples.html).
### Ruft die 10 langsamsten Vorgänge für eine angegebene Sammlung ab
```
filter ns="test.foo" | sort millis desc | limit 10
```
### Ruft alle Aktualisierungsvorgänge für eine Sammlung ab, die mehr als 60 ms gedauert haben
```
filter millis > 60 and op = "update"
```
### Holen Sie sich die 10 langsamsten Operationen des letzten Monats
```
sort millis desc | limit 10
```
### Abrufen aller Abfragen mit einer COLLSCAN-Planübersicht
```
filter planSummary="COLLSCAN"
```
# Überwachung mit Performance Insights
Performance Insights erweitert die bestehenden Amazon DocumentDB DocumentDB-Überwachungsfunktionen, um die Leistung Ihres Clusters zu veranschaulichen und Sie bei der Analyse aller Probleme zu unterstützen, die sich darauf auswirken. Mit dem Performance Insights Insights-Dashboard können Sie die Datenbanklast visualisieren und die Last nach Wartezeiten, Abfrageanweisungen, Hosts oder Anwendungen filtern.
**Anmerkung**
Performance Insights ist nur für Amazon DocumentDB 3.6, 4.0, 5.0 und 8.0 instanzbasierte Cluster verfügbar.
**Wie ist es nützlich?**
+ Datenbankleistung visualisieren — Visualisieren Sie die Last, um festzustellen, wann und wo sich die Last in der Datenbank befindet
+ Ermitteln Sie, was die Belastung der Datenbank verursacht — Ermitteln Sie, welche Abfragen, Hosts und Anwendungen zur Belastung Ihrer Instance beitragen
+ Ermitteln Sie, wann Ihre Datenbank ausgelastet ist — Vergrößern Sie das Performance Insights Insights-Dashboard, um sich auf bestimmte Ereignisse zu konzentrieren, oder zoomen Sie heraus, um Trends über einen längeren Zeitraum zu betrachten
+ Warnung beim Laden der Datenbank — Automatischer Zugriff auf neue Datenbank-Lademetriken, von CloudWatch wo aus Sie die DB-Lademetriken zusammen mit anderen Amazon DocumentDB-Metriken überwachen und Warnmeldungen zu diesen einrichten können
**Was sind die Einschränkungen von Amazon DocumentDB Performance Insights?**
+ Performance Insights in den Regionen AWS GovCloud (USA-Ost) und AWS GovCloud (US-West) sind nicht verfügbar
+ Performance Insights for Amazon DocumentDB speichert Leistungsdaten für bis zu 7 Tage
+ Abfragen, die länger als 1.024 Byte sind, werden in Performance Insights nicht aggregiert
**Topics**
+ [Konzepte von Performance Insights](performance-insights-concepts.md)
+ [Aktivieren und Deaktivieren von Performance Insights](performance-insights-enabling.md)
+ [Konfigurieren von Zugriffsrichtlinien für Performance Insights](performance-insights-policies.md)
+ [Analyse der Metriken mit dem Performance-Insights-Dashboard](performance-insights-analyzing.md)
+ [Abrufen von Metriken mit der Performance-Insights-API](performance-insights-metrics.md)
+ [CloudWatch Amazon-Metriken für Performance Insights](performance-insights-cloudwatch.md)
+ [Performance Insights für Zählermetriken](performance-insights-counter-metrics.md)
# Konzepte von Performance Insights
**Topics**
+ [Durchschnittliche aktive Sitzungen](#performance-insights-concepts-sessions)
+ [Dimensionen](#performance-insights-concepts-dimensions)
+ [Maximale vCPU](#performance-insights-concepts-maxvcpu)
## Durchschnittliche aktive Sitzungen
Datenbanklast (DB-Last) misst den Aktivitätsgrad in Ihrer Datenbank. Die wichtigste Metrik für Performance Insights ist `DB Load`, die jede Sekunde erfasst wird. Die Einheit für die `DBLoad` Metrik ist der *Average Active Sessions (AAS)* für eine Amazon DocumentDB DocumentDB-Instance.
Eine *aktive* Sitzung ist eine Verbindung, die Arbeit an die Amazon DocumentDB DocumentDB-Instance übermittelt hat und auf eine Antwort wartet. Wenn Sie beispielsweise eine Anfrage an eine Amazon DocumentDB DocumentDB-Instance senden, ist die Datenbanksitzung aktiv, während die Instance die Abfrage verarbeitet.
Um die Anzahl der durchschnittlich aktiven Sitzungen AAS zu erhalten, ruft Performance Insights die Anzahl der Sitzungen ab, die gleichzeitig eine Abfrage ausführen. Die AAS ist die Gesamtzahl der Sitzungen geteilt durch die Gesamtzahl der Beispiele. Die folgende Tabelle zeigt fünf aufeinanderfolgende Beispiele einer laufenden Abfrage.
| Beispiel | Anzahl der Sitzungen, die eine Abfrage ausführen | AAS | Berechnung |
| --- | --- | --- | --- |
| 1 | 2 | 2 | 2 Sitzungen/1 Beispiel |
| 2 | 0 | 1 | 2 Sitzungen/2 Beispiele |
| 3 | 4 | 2 | 6 Sitzungen/3 Beispiele |
| 4 | 0 | 1.5 | 6 Sitzungen/4 Beispiele |
| 5 | 4 | 2 | 10 Sitzungen/5 Beispiele |
Im vorherigen Beispiel beträgt der DB-Load für das Zeitintervall von 1-5 2 AAS. Eine Erhöhung der DB-Last bedeutet, dass im Durchschnitt mehr Sitzungen für die Datenbank ausgeführt werden.
## Dimensionen
Die`DB Load` Metrik unterscheidet sich von den anderen Zeitreihenmetriken, da Sie sie in Unterkomponenten aufteilen können, die als Dimensionen bezeichnet werden. Sie können sich Dimensionen als Kategorien für die verschiedenen Merkmale der `DB Load`-Metrik vorstellen. Bei der Diagnose von Leistungsproblemen sind die Dimensionen **Wait States** und **Top Query** am nützlichsten.
**Wartezustände**
Ein *Wartestatus* bewirkt, dass eine Abfrageanweisung auf das Eintreten eines bestimmten Ereignisses wartet, bevor sie weiter ausgeführt werden kann. Beispielsweise kann eine Abfrageanweisung warten, bis eine gesperrte Ressource entsperrt ist. Durch die Kombination `DB Load` mit Wartezuständen können Sie sich ein vollständiges Bild vom Sitzungsstatus machen. Hier sind verschiedene Wartezustände von Amazon DocumentDB:
| Amazon DocumentDB DocumentDB-Wartestatus | Beschreibung des Wartestatus |
| --- | --- |
| Riegeln | Der Latch-Wartestatus tritt auf, wenn die Sitzung darauf wartet, den Pufferpool auszulagern. Häufiges Ein- und Auslagern in den Pufferpool kann häufiger vorkommen, wenn das System häufig umfangreiche Abfragen verarbeitet, Sammlungsscans durchführt oder wenn der Pufferpool zu klein ist, um den Arbeitssatz zu verarbeiten. |
| CPU | Der CPU-Wartestatus tritt auf, wenn die Sitzung auf die CPU wartet. |
| CollectionLock | Der CollectionLock Wartestatus tritt ein, wenn die Sitzung darauf wartet, eine Sperre für die Sammlung zu erlangen. Diese Ereignisse treten auf, wenn DDL-Operationen für die Sammlung ausgeführt werden. |
| DocumentLock | Der DocumentLock Wartestatus tritt ein, wenn die Sitzung darauf wartet, ein Dokument zu sperren. Eine hohe Anzahl gleichzeitiger Schreibvorgänge auf dasselbe Dokument führt zu mehr DocumentLock Wartezuständen in diesem Dokument. |
| SystemLock | Der SystemLock Wartestatus tritt auf, wenn die Sitzung auf dem System wartet. Dies kann der Fall sein, wenn häufig Abfragen mit langer Laufzeit, lang andauernde Transaktionen oder eine hohe Parallelität im System auftreten. |
| IO | Der IO-Wartestatus tritt auf, wenn die Sitzung auf den Abschluss der IO wartet. |
| BufferLock | Der BufferLock Wartestatus tritt ein, wenn die Sitzung darauf wartet, eine Sperre für eine gemeinsam genutzte Seite im Puffer zu erlangen. BufferLockWartezustände können verlängert werden, wenn andere Prozesse die Cursor auf den angeforderten Seiten offen halten. |
| LowMemThrottle | Der LowMemThrottle Wartestatus tritt auf, wenn die Sitzung aufgrund einer hohen Speicherauslastung auf der Amazon DocumentDB DocumentDB-Instance wartet. Wenn dieser Status für eine lange Zeit andauert, sollten Sie erwägen, die Instance zu skalieren, um zusätzlichen Speicher bereitzustellen. Weitere Informationen finden Sie unter [Resource Governor](https://docs.aws.amazon.com/documentdb/latest/developerguide/how-it-works.html). |
| BackgroundActivity | Der BackgroundActivity Wartestatus tritt auf, wenn die Sitzung auf interne Systemprozesse wartet. |
| Sonstige | Der Wartestatus Andere ist ein interner Wartestatus. Wenn dieser Status über einen längeren Zeitraum andauert, sollten Sie erwägen, diese Abfrage zu beenden. Weitere Informationen finden Sie unter [Wie finde und beende ich Abfragen mit langer Laufzeit oder blockierter Ausführung](https://docs.aws.amazon.com/documentdb/latest/developerguide/user_diagnostics.html#user_diagnostics-query_terminating.html)? |
**Die häufigsten Abfragen**
Während bei Wartezuständen Engpässe auftreten, zeigen Abfragen am häufigsten, welche Abfragen am meisten zur Datenbanklast beitragen. Beispielsweise könnten derzeit viele Abfragen gleichzeitig in der Datenbank ausgeführt werden, aber eine einzelne Abfrage könnte 99 % der DB-Last verbrauchen. In diesem Fall könnte die hohe Belastung auf ein Problem mit der Abfrage hinweisen.
## Maximale vCPU
Das Diagramm **Datenbanklast** im Dashboard dient zum Erfassen, Aggregieren und Anzeigen von Sitzungsinformationen. Um zu sehen, ob aktive Sitzungen die maximale CPU überschreiten, sehen Sie sich ihre Beziehung zur **Max vCPU**-Linie an. Der **Max vCPU-Wert** wird durch die Anzahl der vCPU-Kerne (virtuelle CPU) für Ihre Amazon DocumentDB DocumentDB-Instance bestimmt.
Wenn die DB-Last häufig über der **Max vCPU**-Linie liegt und der primäre Wartezustand „CPU“ lautet, ist die CPU überlastet. In diesem Fall möchten Sie möglicherweise die Verbindungen zur Instance drosseln, alle Abfragen mit hoher CPU-Last optimieren oder eine größere Instance-Klasse in Betracht ziehen. Hohe und konsistente Instances von Wartezuständen deuten darauf hin, dass es möglicherweise Engpässe oder Probleme mit Ressourcenkonflikten gibt, die behoben werden müssen. Dies kann auch dann zutreffen, wenn die DB-Last die mit **Max vCPU** definierte Linie nicht überschreitet.
# Aktivieren und Deaktivieren von Performance Insights
Um Performance Insights zu nutzen, aktivieren Sie es auf Ihrer DB-Instance. Sie können sie bei Bedarf später 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
In der Konsole können Sie Performance Insights aktivieren oder deaktivieren, wenn Sie eine neue DB-Instance erstellen oder ändern.
### Mit dem AWS-Managementkonsole
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 **Performance Insights** aktivieren** wählen.
**Anweisungen für die Konsole**
1. Um einen Cluster zu erstellen, folgen Sie den Anweisungen unter [Erstellen eines Amazon DocumentDB-Clusters](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-create.html).
1. Wählen Sie im Abschnitt **Performance Insights die Option Performance Insights aktivieren** aus.
![\[Der Bereich Performance Insights mit der ausgewählten Option Performance Insights aktivieren.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**Anmerkung**
Die Aufbewahrungsfrist für Performance Insights 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 mit Ihrem AWS KMS Schlüssel. 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
Sie können eine DB-Instance ändern, um Performance Insights mithilfe der Konsole oder zu aktivieren oder zu deaktivieren AWS CLI.
------
#### [ Using the AWS-Managementkonsole ]
**Anweisungen für die Konsole**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB 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 **Enable Performance Insights** wählen, können Sie Ihren AWS AWS KMS Schlüssel angeben. Performance Insights verschlüsselt alle potenziell sensiblen Daten mit Ihrem AWS KMS Schlüssel. Die Daten werden während der Übertragung und im Ruhezustand verschlüsselt. Weitere Informationen finden Sie unter [Amazon DocumentDB DocumentDB-Daten im Ruhezustand verschlüsseln](https://docs.aws.amazon.com/documentdb/latest/developerguide/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 **während des nächsten geplanten Wartungsfensters 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 durch Angabe aktivieren oder deaktivieren`--enable-performance-insights`, indem Sie 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 an:
+ `--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
```
------
# Konfigurieren von Zugriffsrichtlinien für Performance Insights
Um auf Performance Insights zugreifen zu können, müssen Sie über die entsprechenden Berechtigungen von AWS Identity and Access Management (IAM) verfügen. Sie haben folgende Möglichkeiten, Zugriff zu gewähren:
+ Fügen Sie die verwaltete Richtlinie `AmazonRDSPerformanceInsightsReadOnly` an einen Berechtigungssatz oder eine Rolle an.
+ Erstellen Sie eine benutzerdefinierte IAM-Richtlinie und fügen Sie diese an einen Berechtigungssatz oder eine Rolle an.
Wenn Sie bei der Aktivierung von Performance Insights einen vom Kunden verwalteten Schlüssel angegeben haben, stellen Sie außerdem sicher, dass die Benutzer in Ihrem Konto über die Berechtigungen `kms:Decrypt` und `kms:GenerateDataKey` für den KMS-Schlüssel verfügen.
**Anmerkung**
Für die encryption-at-rest Verwaltung von AWS KMS Schlüsseln und Sicherheitsgruppen nutzt Amazon DocumentDB Betriebstechnologie, die mit [Amazon](https://aws.amazon.com/rds) RDS gemeinsam genutzt wird.
## Anhängen der RDSPerformance InsightsReadOnly Amazon-Richtlinie an einen IAM-Principal
`AmazonRDSPerformanceInsightsReadOnly`ist eine AWS verwaltete Richtlinie, die Zugriff auf alle schreibgeschützten Operationen der Amazon DocumentDB Performance Insights-API gewährt. Derzeit sind alle Operationen in dieser API schreibgeschützt. Wenn Sie `AmazonRDSPerformanceInsightsReadOnly` an einen Berechtigungssatz oder eine Rolle anfügen, kann der Empfänger Performance Insights mit anderen Konsolenfunktionen verwenden.
## Erstellen einer benutzerdefinierten IAM-Richtlinie für Performance Insights
Für Benutzer, die nicht über die `AmazonRDSPerformanceInsightsReadOnly`-Richtlinien verfügen, können Sie den Zugriff auf Performance Insights gewähren, indem Sie eine benutzerverwaltete IAM-Richtlinie erstellen oder ändern. Wenn Sie die Richtlinie an einen Berechtigungssatz oder eine Rolle anhängen, kann der Empfänger Performance Insights verwenden.
**Erstellen eine benutzerdefinierten Richtlinie**
1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole.
1. Wählen Sie im Navigationsbereich **Richtlinien**.
1. Wählen Sie **Richtlinie erstellen** aus.
1. Wählen Sie auf der Seite **Create Policy** (Richtlinie erstellen) die Registerkarte „JSON“ aus.
1. Kopieren Sie den folgenden Text und fügen Sie ihn ein. *us-east-1* Ersetzen Sie ihn durch den Namen Ihrer AWS Region und *111122223333* durch Ihre Kundenkontonummer.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "rds:DescribeDBInstances",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "rds:DescribeDBClusters",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "pi:DescribeDimensionKeys",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetDimensionKeyDetails",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetResourceMetadata",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetResourceMetrics",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:ListAvailableResourceDimensions",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:ListAvailableResourceMetrics",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
}
]
}
```
------
1. Wählen Sie **Richtlinie prüfen**.
1. Geben Sie einen Namen und optional eine Beschreibung für die Richtlinie an und wählen Sie dann **Create policy** (Richtlinie erstellen) aus.
Sie können die Richtlinie nun an einen Berechtigungssatz oder eine Rolle anfügen. Das folgende Verfahren setzt voraus, dass Sie für diesen Zweck bereits einen Benutzer zur Verfügung haben.
**So fügen Sie die Richtlinie an einen Benutzer an**
1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole.
1. Klicken Sie im Navigationsbereich auf **Users (Benutzer)**.
1. Wählen Sie einen vorhandenen Benutzer aus der Liste aus.
**Wichtig**
Um Performance Insights verwenden zu können, stellen Sie sicher, dass Sie zusätzlich zur benutzerdefinierten Richtlinie Zugriff auf Amazon DocumentDB haben. [Die **AmazonDocDBReadOnlyAccess**vordefinierte Richtlinie bietet beispielsweise schreibgeschützten Zugriff auf Amazon DoCDB. Weitere Informationen finden Sie unter Zugriff mithilfe von Richtlinien verwalten.](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAM.html#security_iam_access-manage)
1. Wählen Sie auf der Seite **Summary** (Übersicht) die Option **Add permissions** (Berechtigungen hinzufügen) aus.
1. Wählen Sie **Attach existing policies directly** (Vorhandene Richtlinien direkt zuordnen). Geben Sie in **Suche** die ersten Zeichen Ihres Richtliniennamens ein, wie nachfolgend gezeigt.
![\[Auswählen einer Richtlinie\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/pi-add-permissions.png)
1. Wählen Sie Ihre Richtlinie und wählen Sie anschließend **Nächster Schritt: Prüfen**.
1. Wählen Sie **Add permissions** (Berechtigungen hinzufügen) aus.
## Konfiguration einer AWS KMS Richtlinie für Performance Insights
Performance Insights verwendet an AWS KMS key , um sensible Daten zu verschlüsseln. Wenn Sie Performance Insights über die API oder die Konsole aktivieren, haben Sie folgende Möglichkeiten:
+ Wählen Sie die Standardeinstellung Von AWS verwalteter Schlüssel.
Amazon DocumentDB verwendet die Von AWS verwalteter Schlüssel für Ihre neue DB-Instance. Amazon DocumentDB erstellt eine Von AWS verwalteter Schlüssel für Ihr AWS Konto. Ihr AWS Konto hat Von AWS verwalteter Schlüssel für Amazon DocumentDB für jede AWS Region ein anderes.
+ Wählen Sie einen kundenverwalteten Schlüssel.
Wenn Sie einen vom Kunden verwalteten Schlüssel angeben, benötigen Benutzer in Ihrem Konto, die die Performance Insights API aufrufen, die Berechtigungen `kms:Decrypt` und `kms:GenerateDataKey` für den KMS-Schlüssel. Sie können diese Berechtigungen über IAM-Richtlinien konfigurieren. Wir empfehlen jedoch, dass Sie diese Berechtigungen über Ihre KMS-Schlüsselrichtlinie verwalten. Weitere Informationen finden Sie unter [Verwenden von Schlüsselrichtlinien in AWS -KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html).
**Example**
Das folgende Beispiel für eine Schlüsselrichtlinie zeigt, wie Sie Ihrer KMS-Schlüsselrichtlinie Anweisungen hinzufügen können. Diese Anweisungen erlaubt den Zugriff auf Performance Insights. Je nachdem, wie Sie das verwenden AWS KMS, möchten Sie möglicherweise einige Einschränkungen ändern. Bevor Sie Ihrer Richtlinie Anweisungen hinzufügen, entfernen Sie alle Kommentare.
# Analyse der Metriken mit dem Performance Insights-Dashboard
Das Dashboard von Performance Insights enthält Informationen zur Datenbank-Performance, die Sie bei der Analyse und Behebung von Performance-Problemen unterstützen. Auf der Hauptseite des Dashboards können Sie Informationen zur Datenbanklast (DB-Load) einsehen. Sie können die Datenbanklast nach Dimensionen wie Wartestatus oder Abfrage „aufteilen“.
**Topics**
+ [Überblick über Performance Insights](performance-insights-dashboard-overview.md)
+ [Öffnen des Performance Insights-Dashboards](performance-insights-dashboard-opening.md)
+ [Analysieren der Datenbanklast nach Wartezuständen](performance-insights-analyzing-db-load.md)
+ [Überblick über den Tab „Häufigste Suchanfragen“](performance-insights-top-queries.md)
+ [Das Datenbank-Ladediagramm vergrößern](performance-insights-zoom-db-load.md)
# Überblick über Performance Insights
Das Dashboard ist die einfachste Möglichkeit, mit Performance Insights zu interagieren. Das folgende Beispiel zeigt das Dashboard für eine Amazon DocumentDB DocumentDB-Instance. Standardmäßig zeigt das Dashboard von Performance Insights die Daten der letzten Stunde an.
![\[Das Performance Insights Insights-Dashboard zeigt die CPU-Auslastung und die Datenbanklast im Laufe der Zeit für eine Amazon DocumentDB DocumentDB-Instance.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/overview-dashboard.png)
Das Dashboard ist in folgende Teile gegliedert:
1. **Zählermetriken** — Zeigt Daten für bestimmte Leistungsindikatormetriken an.
1. **Datenbanklast** — Zeigt, wie die DB-Last im Vergleich zur DB-Instance-Kapazität abschneidet, wie sie in der Zeile **Max vCPU** dargestellt wird.
1. **Top-Dimensionen** — Zeigt die wichtigsten Dimensionen an, die zur DB-Auslastung beitragen. Zu diesen Dimensionen gehören `waits``queries`,`hosts`,`databases`, und`applications`.
**Topics**
+ [Zählermetriken-Diagramm](#performance-insights-overview-metrics)
+ [Datenbank-Ladediagramm](#performance-insights-overview-db-load-chart)
+ [Dimensionen pro Tabelle](#performance-insights-overview-top-dimensions)
## Zählermetriken-Diagramm
Mithilfe von Zählermetriken können Sie das Performance-Insights-Dashboard anpassen und bis zu 10 weitere Diagramme aufnehmen. Diese Grafiken zeigen eine Auswahl von Dutzenden von Betriebssystemmetriken. Diese Informationen können mit der Datenbanklast korreliert werden, um Performance-Probleme zu identifizieren und zu analysieren.
Das **Counter Metrics (Zählermetriken)**-Diagramm enthält Daten zu Leistungsindikatoren.
![\[Diagramm mit Zählermetriken, das die CPU-Auslastung im Zeitverlauf zeigt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/counter-metrics.png)
Um die Leistungsindikatoren zu ändern, wählen Sie **Metriken verwalten** aus. Sie können mehrere **Betriebssystemmetriken** auswählen, wie im folgenden Screenshot gezeigt. Um Details für jede Metrik anzuzeigen, bewegen Sie den Mauszeiger über den Metriknamen.
![\[Oberfläche zur Metrikauswahl im Performance Insights Insights-Dashboard mit Optionen für Betriebssystemmetriken.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/overview-os-metrics.png)
## Datenbank-Ladediagramm
Das Diagramm zum **Laden der Datenbank** zeigt, wie die Datenbankaktivität im Vergleich zur Instanzkapazität abschneidet, wie sie in der Zeile **Max. vCPU** dargestellt wird. Standardmäßig stellt das gestapelte Liniendiagramm die DB-Last als durchschnittliche aktive Sitzungen pro Zeiteinheit dar. Die DB-Last wird nach Wartestatus aufgeteilt (gruppiert).
![\[Das Diagramm zur Datenbankauslastung zeigt die durchschnittlichen aktiven Sitzungen im Laufe der Zeit, wobei die CPU-Auslastung gegen Ende stark ansteigt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/database-load.png)
**DB-Last aufgeteilt nach Dimensionen**
Sie können die Last als aktive Sitzungen anzeigen, die nach unterstützten Dimensionen gruppiert sind. Die folgende Abbildung zeigt die Abmessungen für die Amazon DocumentDB DocumentDB-Instance.
![\[Diagramm, das das Laden der Datenbank mit verschiedenen „Slice by“ -Optionen in einer Dropdownliste zeigt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/database-load-sliced.png)
**DB-Ladedetails für ein Dimensionselement**
Um Details zu einem DB-Lastelement innerhalb einer Dimension anzuzeigen, bewegen Sie den Mauszeiger über den Elementnamen. Die folgende Abbildung zeigt Details für eine Abfrageanweisung.
![\[Balkendiagramm, das das Laden der Datenbank mit zusätzlichen Details zeigt, wenn Sie den Mauszeiger über einen Elementnamen bewegen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/database-load-details.png)
Um Details zu einem Element für den ausgewählten Zeitraum in der Legende anzuzeigen, bewegen Sie den Mauszeiger über dieses Element.
![\[Balkendiagramm, das die Datenbanklast mit zusätzlichen Details zeigt, wenn Sie den Mauszeiger über einen Balken bewegen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/database-load-hover.png)
## Dimensionen pro Tabelle
In der **Tabelle mit den obersten Abmessungen** wird die Datenbanklast nach verschiedenen Dimensionen aufgeteilt. Eine Dimension ist eine Kategorie oder „Aufteilung“ für verschiedene Merkmale der DB-Last. Wenn es sich bei der Dimension um eine Abfrage handelt**, werden in den häufigsten Abfragen** die Abfrageanweisungen angezeigt, die am meisten zur DB-Auslastung beitragen.
Wählen Sie eine der folgenden Dimensionsregisterkarten.
![\[Auf der Registerkarte „Dimensionen der häufigsten Abfragen“ werden die beiden wichtigsten Abfragen angezeigt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/top-dimensions.png)
Die folgende Tabelle enthält eine kurze Beschreibung der einzelnen Registerkarten.
| Tab | Description |
| --- | --- |
| Top waits (Top-Warteereignis) | Das Ereignis, auf das das Datenbank-Backend wartet |
| Die häufigsten Abfragen | Die Abfrageanweisungen, die derzeit ausgeführt werden |
| Top hosts (Top-Hosts) | Die Host-IP und der Port des verbundenen Clients |
| Top databases (Top-Datenbanken) | Der Name der Datenbank, mit der der Client verbunden ist |
| Top applications (Top-Anwendungen) | Der Name der Anwendung, die mit der Datenbank verbunden ist |
Informationen zum Analysieren von Abfragen mithilfe der Registerkarte „Häufig **gestellte Abfragen**“ finden Sie unter[Überblick über die Registerkarte „Häufigste Abfragen“](performance-insights-top-queries.md).
# Öffnen des Performance Insights-Dashboards
**Gehen Sie wie folgt vor, um das Performance Insights Insights-Dashboard in der AWS Management Console anzuzeigen:**
1. Öffnen Sie die Performance Insights Insights-Konsole unter [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/home#performance-insights).
1. Wählen Sie eine DB-Instance aus. Das Performance Insights Insights-Dashboard wird für diese Amazon DocumentDB DocumentDB-Instance angezeigt.
Für Amazon DocumentDB DocumentDB-Instances mit aktiviertem Performance Insights können Sie das Dashboard auch aufrufen, indem Sie in der Liste der Instances den Eintrag **Sessions** auswählen. Unter **Aktuelle Aktivität** zeigt das Element **Sitzungen** die Datenbanklast von durchschnittlichen, aktiven Sitzungen der letzten fünf Minuten an. Der Balken zeigt die Last grafisch an. Wenn die Leiste leer ist, befindet sich die Instance im Leerlauf. Wenn die Last ansteigt, wird der Balken blau ausgefüllt. Wenn die Last die Anzahl virtueller CPUs (vCPUs) in der Instanzklasse überschreitet, färbt sich der Balken rot, was auf einen potenziellen Engpass hinweist.
![\[Die Cluster-Seite zeigt einen regionalen Amazon DocumentDB-Cluster sowie die CPU und die aktuelle Aktivität jeder Cluster-Instance.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/opening-clusters.png)
1. (Optional) Wählen Sie über eine der Schaltflächen rechts oben ein anderes Zeitintervall aus. Um das Intervall beispielsweise auf 1 Stunde zu ändern, wählen Sie **1h** aus.
![\[Schaltflächen für Zeitintervalle zwischen fünf Minuten und einer Woche.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/opening-time.png)
Im folgenden Screenshot beträgt das DB-Ladeintervall 1 Stunde.
![\[Balkendiagramm, das die Datenbanklast zeigt, gemessen in durchschnittlichen aktiven Sitzungen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/opening-db-load.png)
1. Um Ihre Daten automatisch zu aktualisieren, aktivieren **Sie Automatische Aktualisierung**.
![\[Die Schaltfläche für die auto Aktualisierung ist aktiviert und erscheint neben den Zeitintervallschaltflächen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/opening-auto-refresh.png)
Das Performance Insights-Dashboard wird automatisch mit neuen Daten aktualisiert. Die Aktualisierungsrate hängt von der Menge der angezeigten Daten ab:
+ „5 Minuten“ wird alle 5 Sekunden aktualisiert.
+ 1 Stunde, wird jede Minute aktualisiert.
+ 5 Stunden, wird jede Minute aktualisiert.
+ „24 Stunden“ wird alle 5 Minuten aktualisiert.
+ „1 Woche“ wird jede Stunden aktualisiert.
# Analysieren der Datenbanklast nach Wartezuständen
Wenn das Diagramm zur **Datenbankauslastung (DB-Last)** einen Engpass anzeigt, können Sie herausfinden, woher die Last kommt. Betrachten Sie dazu die Tabelle mit den Hauptlastelementen unterhalb des **Datenbanklast**-Diagramms Wählen Sie ein bestimmtes Element aus, z. B. eine Abfrage oder eine Anwendung, um dieses Element genauer zu untersuchen und Details zu diesem Element anzuzeigen.
Die Datenbanklast, gruppiert nach Waits und Top-Abfragen, bietet in der Regel den besten Einblick in Leistungsprobleme. DB-Last gruppiert nach Wartezeiten zeigt an, ob Ressourcen- oder Parallelitätsengpässe in der Datenbank vorhanden sind. In diesem Fall wird auf der Registerkarte „**Häufigste Abfragen**“ der Tabelle mit den am häufigsten ausgelasteten Elementen angezeigt, welche Abfragen für diese Auslastung verantwortlich sind.
Ihr typischer Workflow für die Diagnose von Performance-Problemen ist folgendermaßen:
1. Überprüfen Sie das Diagramm der **durchschnittlich aktiven Sitzungen** auf irgendwelche Ereignisse, in denen die Datenbanklast die **Max CPU**-Linie übersteigt.
1. Wenn ja, schauen Sie sich das Diagramm der **durchschnittlich aktiven Sitzungen** an und identifizieren Sie, welcher Wartezustand oder welche Zustände primär dafür verantwortlich sind.
1. Identifizieren Sie die Digest-Abfragen, die die Last verursacht haben, indem Sie sehen, welche der Abfragen auf der Registerkarte „**Häufigste Abfragen**“ in der Tabelle mit den am häufigsten geladenen Elementen am meisten zu diesen Wartezuständen beitragen. Sie können diese anhand der Spalte **Load by Wait (AAS)** identifizieren.
1. Wählen Sie auf der Registerkarte „Häufig gestellte Abfragen“ eine dieser **Digest-Abfragen** aus, um sie zu erweitern und die untergeordneten Abfragen zu sehen, aus denen sie besteht.
Sie können auch sehen, welche Hosts oder Anwendungen die meiste Last verursachen, indem Sie jeweils **Top-Hosts** oder **Top-Anwendungen** auswählen. Anwendungsnamen werden in der Verbindungszeichenfolge zur Amazon DocumentDB DocumentDB-Instance angegeben. `Unknown`gibt an, dass das Anwendungsfeld nicht angegeben wurde.
Im folgenden Dashboard machen beispielsweise **CPU-Wartezeiten** den größten Teil der DB-Last aus. Wenn Sie unter Häufigste **Abfragen die oberste** Abfrage auswählen, wird das Diagramm zur Datenbankauslastung so ausgerichtet, dass der Schwerpunkt auf der höchsten Last liegt, die durch die ausgewählte Abfrage verursacht wird.
![\[Diagramm zur Datenbankauslastung, das den Anstieg der CPU-Auslastung zeigt. Eine entsprechende Registerkarte mit den häufigsten Abfragen zeigt die Abfragen, die am meisten zu Wartezuständen beitragen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/db-load-1.png)
![\[Das Diagramm zur Datenbankauslastung zeigt den Anstieg der CPU-Auslastung für die Abfrage, die am meisten zu Wartezuständen beigetragen hat. Eine entsprechende Registerkarte mit den häufigsten Abfragen zeigt die untergeordneten Abfragen dieser Abfrage.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/db-load-2.png)
# Überblick über die Registerkarte „Häufigste Abfragen“
Standardmäßig werden auf der Registerkarte „**Häufigste** Abfragen“ die Abfragen angezeigt, die am meisten zur DB-Auslastung beitragen. Sie können den Abfragetext analysieren, um Ihre Abfragen zu optimieren.
**Topics**
+ [Digests abfragen](#performance-insights-top-queries-digests)
+ [Nach Waits laden (AAS)](#performance-insights-top-queries-aas)
+ [Detaillierte Abfrageinformationen anzeigen](#performance-insights-top-queries-query-info)
+ [Zugreifen auf Abfragetext für Anweisungen](#performance-insights-top-queries-accessing-text)
+ [Abfragetext für Kontoauszüge anzeigen und herunterladen](#performance-insights-top-queries-viewing-downloading)
## Zusammenfassungen von Abfragen
Ein *Abfrage-Digest* besteht aus mehreren tatsächlichen Abfragen, die sich strukturell ähneln, aber unterschiedliche Literalwerte haben können. Der Digest ersetzt fest codierte Werte durch ein Fragezeichen. Ein Abfrage-Digest könnte beispielsweise so aussehen:
```
{"find":"customerscollection","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}
```
Dieser Digest kann die folgenden untergeordneten Abfragen enthalten:
```
{"find":"customerscollection","filter":{"FirstName":"Karrie"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Met"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Rashin"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
```
Um die wörtlichen Abfrageanweisungen in einem Digest zu sehen, wählen Sie die Abfrage und dann das Pluszeichen () aus. `+` Im folgenden Screenshot ist die ausgewählte Abfrage ein Digest.
![\[Die Tabelle mit den häufigsten Abfragen zeigt einen erweiterten Abfrage-Digest, bei dem eine untergeordnete Abfrage ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/top-queries-literal.png)
**Anmerkung**
In einem Abfrage-Digest werden ähnliche Abfrageanweisungen gruppiert, sensible Informationen werden jedoch nicht geschwärzt.
## Nach Waits laden (AAS)
In **Top-Abfragen** zeigt die Spalte **Load by Waits (AAS)** den Prozentsatz der Datenbanklast, der jedem Top-Load-Element zugeordnet ist. Diese Spalte gibt die Last für dieses Element nach der Gruppierung wieder, die derzeit im **DB-Lastdiagramm** ausgewählt ist. Beispielsweise können Sie das **DB-Last-Diagramm** nach Wartezuständen gruppieren. In diesem Fall ist der Balken **DB Load by Waits (DB-Last nach Wartezuständen)** so groß, segmentiert und farbcodiert, dass angezeigt wird, zu wieviel Prozent diese Abfrage zum betreffenden Wartezustand beiträgt. Es zeigt zudem auf, welche Wartezustände sich auf die ausgewählte Abfrage auswirken.
![\[Balkendiagramm, das die Datenbanklast gruppiert nach CPU-, IO- und Latch-Wartestatus zeigt. Die entsprechende Tabelle zeigt die häufigsten Abfragen, basierend auf dem Ladevorgang pro Wartezeit.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/top-queries-aas.png)
## Detaillierte Abfrageinformationen anzeigen
In der **Abfragetabelle „Top**“ können Sie eine *Digest-Anweisung* öffnen, um die zugehörigen Informationen anzuzeigen. Die Informationen werden im unteren Bereich angezeigt.
![\[Die Tabelle mit den häufigsten Abfragen zeigt unten eine ausgewählte Abfrageanweisung und die zugehörigen Abfrageinformationen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/top-queries-detailed.png)
Die folgenden Typen von Bezeichnern (IDs) sind mit Abfrageanweisungen verknüpft:
1. **Support-Abfrage-ID** — Ein Hashwert der Abfrage-ID. Dieser Wert dient nur zum Verweisen auf eine Abfrage-ID, wenn Sie mit AWS Support arbeiten. AWS Der Support hat keinen Zugriff auf Ihre tatsächliche Anfrage IDs und Ihren Abfragetext.
1. **Support-Digest-ID** — Ein Hashwert der Digest-ID. Dieser Wert dient nur zum Verweisen auf eine Digest-ID, wenn Sie mit AWS Support zusammenarbeiten. AWS Der Support hat keinen Zugriff auf Ihre tatsächliche Zusammenfassung IDs und Ihren Abfragetext.
## Zugriff auf den Abfragetext der Anweisung
Standardmäßig enthält jede Zeile in der Tabelle mit **den häufigsten Abfragen** 500 Byte Abfragetext für jede Abfrageanweisung. Wenn eine Digest-Anweisung 500 Byte überschreitet, können Sie mehr Text anzeigen, indem Sie die Anweisung im Performance Insights Insights-Dashboard öffnen. In diesem Fall beträgt die maximale Länge der angezeigten Abfrage 1 KB. Wenn Sie eine vollständige Abfrageanweisung anzeigen, können Sie auch **Herunterladen** wählen.
## Abfragetext für Kontoauszüge anzeigen und herunterladen
Im Performance Insights Insights-Dashboard können Sie Abfragetext anzeigen oder herunterladen.
**Um mehr Abfragetext im Performance Insights Insights-Dashboard anzuzeigen**
1. Öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter: [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/)
1. Wählen Sie im Navigationsbereich **Performance-Insights** aus.
1. Wählen Sie eine DB-Instance aus. Das Performance Insights-Dashboard wird für diese DB-Instance angezeigt.
Abfrageanweisungen mit Text, der größer als 500 Byte ist, sehen wie in der folgenden Abbildung aus:
![\[Die Tabelle mit den häufigsten Abfragen, in der eine untergeordnete Abfrage ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/top-queries-statement.png)
1. Sehen Sie sich den Abschnitt mit den Abfrageinformationen an, um mehr vom Abfragetext zu sehen.
![\[Der Abschnitt mit den Abfrageinformationen zeigt den vollständigen Text der ausgewählten Abfrage.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/top-queries-query-text.png)
Das Performance Insights Insights-Dashboard kann bis zu 1 KB für jede vollständige Abfrageanweisung anzeigen.
**Anmerkung**
Um die Abfrageanweisung zu kopieren oder herunterzuladen, deaktivieren Sie alle Popup-Blocker.
# Das Diagramm zum Laden der Datenbank vergrößern
Sie können weitere Funktionen der Benutzeroberfläche von Performance Insights verwenden, um die Performance-Daten zu analysieren.
**Click-and-Drag Hineinzoomen**
In der Benutzeroberfläche von Performance Insights können Sie einen kleinen Teil des Lastdiagramms auswählen und die Details vergrößern.
![\[Balkendiagramm, das die Auslastung der Datenbank zeigt, wobei ein Teil davon zum Vergrößern hervorgehoben ist.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/pi-zoom-1.png)
Um einen Teil des Lastdiagramms zu vergrößern, wählen Sie die Startzeit und ziehen Sie mit der Maus an das Ende des gewünschten Zeitraums. Dabei wird der markierte Bereich farblich hervorgehoben. Wenn Sie die Maustaste loslassen, vergrößert das Lastdiagramm den ausgewählten Bereich, und die Tabelle mit den **wichtigsten *Elementen*** wird neu berechnet.
![\[Das Balkendiagramm zum Laden der Datenbank zeigt den vergrößerten Teil und die entsprechende Tabelle mit den oberen Wartezeiten unten.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/pi-zoom-2.png)
# Abrufen von Metriken mit der Performance-Insights-API
Wenn Performance Insights aktiviert ist, bietet die API Einblicke in die Instance-Leistung Amazon CloudWatch Logs ist die maßgebliche Quelle für angebotene Monitoring-Metriken für AWS Services.
Performance Insights bietet eine domänenspezifische Ansicht der Datenbanklast, gemessen als durchschnittliche aktive Sitzungen (AAS). Diese Metrik erscheint API-Verbrauchern als zweidimensionaler Zeitreihendatensatz. Die Zeitdimension der Daten stellt die Datenbanklastdaten für jeden Zeitpunkt im abgefragten Zeitraum bereit. Für jeden Zeitpunkt wird die Gesamtlast bezogen auf die angeforderten Dimensionen zerlegt, z. B. `Query`, `Wait-state`, `Application` oder `Host`, gemessen zum betreffenden Zeitpunkt.
Amazon DocumentDB Performance Insights überwacht Ihre Amazon DocumentDB-DB-Instance, sodass Sie die Datenbankleistung analysieren und Fehler beheben können. Eine Möglichkeit zum Anzeigen von Performance-Insights-Daten bietet die AWS-Managementkonsole. Performance Insights stellt außerdem eine öffentliche API bereit, sodass Sie Ihre eigenen Daten abfragen können. Sie können die API für Folgendes verwenden:
+ Auslagern von Daten in eine Datenbank
+ Hinzufügen von Performance-Insights-Daten zu bestehenden Überwachungs-Dashboards
+ Entwickeln von Überwachungstools
Um die Performance Insights-API zu verwenden, aktivieren Sie Performance Insights auf einer Ihrer Amazon DocumentDB DocumentDB-Instances. Weitere Informationen zum Aktivieren von Performance Insights finden Sie unter [Aktivieren und Deaktivieren von Performance Insights](performance-insights-enabling.md). Weitere Informationen zur Performance Insights-API finden Sie in der [Referenz zur Performance Insights-API](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html).
Die Performance-Insights-API bietet die folgenden Operationen.
****
| Performance-Insights-Aktion | AWS CLI Befehl | Description |
| --- | --- | --- |
| [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html](https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html) | Ruft die Schlüssel der Top N-Dimension für eine Metrik für einen bestimmten Zeitraum ab. |
| [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html) | Ruft die Attribute der angegebenen Dimensionsgruppe für eine DB-Instance oder Datenquelle ab. Wenn Sie beispielsweise eine Abfrage-ID angeben und die Dimensionsdetails verfügbar sind, wird der vollständige Text der Dimension `GetDimensionKeyDetails` abgerufen, die dieser ID `db.query.statement` zugeordnet ist. Dieser Vorgang ist nützlich, weil er `GetResourceMetrics` das Abrufen von umfangreichem Text in Abfrageanweisungen `DescribeDimensionKeys` nicht unterstützt. |
| [GetResourceMetadata](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetadata.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html) | Rufen Sie die Metadaten für verschiedene Funktionen ab. Die Metadaten könnten beispielsweise darauf hindeuten, dass eine Funktion für eine bestimmte DB-Instance ein- oder ausgeschaltet ist. |
| [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html) | Ruft Performance-Insights-Metriken für eine Reihe von Datenquellen über einen Zeitraum ab. Sie können spezifische Dimensionsgruppen und Dimensionen bereitstellen und Aggregation und Filterkriterien für jede Gruppe bereitstellen. |
| [ListAvailableResourceDimensions](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceDimensions.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html) | Rufen Sie die Dimensionen ab, die für jeden angegebenen Metriktyp für eine bestimmte Instance abgefragt werden können. |
| [ListAvailableResourceMetrics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html) | Rufen Sie alle verfügbaren Metriken der angegebenen Metriktypen ab, die für eine bestimmte DB-Instance abgefragt werden können. |
**Topics**
+ [AWS CLI für Performance Insights](#performance-insights-metrics-CLI)
+ [Abrufen von Zeitreihenmetriken](#performance-insights-metrics-time-series)
+ [AWS CLI Beispiele für Performance Insights](#performance-insights-metrics-api-examples)
## AWS CLI für Performance Insights
Sie können Performance-Insights-Daten über die anzeige AWS CLI. Hilfe zu den AWS CLI -Befehlen für Performance Insights erhalten Sie durch Eingabe der folgenden Befehle an der Befehlszeile.
```
aws pi help
```
Falls Sie das nicht AWS CLI installiert haben, finden Sie unter [Installation der AWS Befehlszeilenschnittstelle](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) im *AWS CLI Benutzerhandbuch* weitere Informationen zur Installation.
## Abrufen von Zeitreihenmetriken
Mit der `GetResourceMetrics`-Operation werden ein oder mehrere Zeitreihenmetriken aus den Performance Insights-Daten abgerufen. Für `GetResourceMetrics` ist eine Metrik und ein Zeitraum erforderlich, damit eine Antwort mit einer Liste von Datenpunkten zurückgegeben wird.
Zum Beispiel die AWS-Managementkonsole Verwendung, `GetResourceMetrics` um die Diagramme „**Counter Metrics**“ und „**Database Load**“ auszufüllen, wie in der folgenden Abbildung dargestellt.
![\[Zählermetriken- und Datenbanklastdiagramme\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/perf-insights-api-charts.png)
Alle von zurückgegebenen Metriken`GetResourceMetrics` sind Standard-Zeitreihenmetriken, mit Ausnahme von`db.load`. Diese Metrik wird im Diagramm **Database Load (Datenbanklast)** angezeigt. Die`db.load` Metrik unterscheidet sich von den anderen Zeitreihenmetriken, da Sie sie in Unterkomponenten aufteilen können, die als* Dimensionen* bezeichnet werden. In der vorherigen Abbildung wird `db.load` unterteilt und nach Wartezuständen gruppiert, aus denen `db.load` besteht.
**Anmerkung**
`GetResourceMetrics` kann auch die `db.sampleload`-Metrik zurückgeben, aber die `db.load`-Metrik ist in den meisten Fällen angemessen.
Informationen zu den Zählermetriken, die von `GetResourceMetrics` zurückgegeben werden, finden Sie unter [Performance Insights für Zählermetriken](performance-insights-counter-metrics.md).
Die folgenden Berechnungen werden für die Metriken unterstützt:
+ Durchschnitt – Der durchschnittliche Wert für die Metrik über einen bestimmten Zeitraum. Fügen Sie dem Metriknamen `.avg` an.
+ Minimum – Der minimale Wert für die Metrik über einen bestimmten Zeitraum. Fügen Sie dem Metriknamen `.min` an.
+ Maximum – Der maximale Wert für die Metrik über einen bestimmten Zeitraum. Fügen Sie dem Metriknamen `.max` an.
+ Summe – Die Summe der Metrikwerte über einen bestimmten Zeitraum. Fügen Sie dem Metriknamen `.sum` an.
+ Beispielanzahl – Die Anzahl, wie oft die Metrik über einen bestimmten Zeitraum erfasst wurde. Fügen Sie dem Metriknamen `.sample_count` an.
Nehmen wir an, dass eine Metrik beispielsweise 300 Sekunden (5 Minuten) lang erfasst wird und dass die Metrik einmal pro Minute erfasst wird. Die Werte für jede Minute sind 1, 2, 3, 4 und 5. In diesem Fall werden die folgenden Berechnungen zurückgegeben:
+ Durchschnitt – 3
+ Minimum – 1
+ Maximum – 5
+ Summe – 15
+ Beispielanzahl – 5
Hinweise zur Verwendung des `get-resource-metrics` AWS CLI Befehls finden Sie unter [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html).
Geben Sie für die `--metric-queries`-Option eine oder mehrere Abfragen an, um die entsprechenden Ergebnisse zu erhalten. Jede Abfrage besteht aus einem obligatorischen `Metric`- sowie optionalen `GroupBy`- und `Filter`-Parametern. Es folgt ein Beispiel für eine Spezifikation der `--metric-queries`-Option.
```
{
"Metric": "string",
"GroupBy": {
"Group": "string",
"Dimensions": ["string", ...],
"Limit": integer
},
"Filter": {"string": "string"
...}
```
## AWS CLI Beispiele für Performance Insights
Die folgenden Beispiele zeigen, wie Sie AWS CLI for Performance Insights verwenden können.
**Topics**
+ [Abrufen von Zählermetriken](#performance-insights-metrics-api-examples.CounterMetrics)
+ [Der DB-Lastdurchschnitt für die höchsten Wartezeiten wird abgerufen](#performance-insights-metrics-api-examples.DBLoadAverage)
+ [Der durchschnittliche DB-Ladestand für die oberste Abfrage wird abgerufen](#performance-insights-metrics-api-examples.topquery)
+ [Abrufen des nach Query gefilterten DB-Ladedurchschnitts](#performance-insights-metrics-api-examples.DBLoadAverageByQuery)
### Abrufen von Zählermetriken
Der folgende Screenshot zeigt zwei Zählermetriken-Diagramme in der AWS-Managementkonsole.
![\[Zählermetriken-Diagramme\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/performance-insights/perf-insights-api-counters-charts.png)
Das folgende Beispiel veranschaulicht, wie die Daten, die die AWS-Managementkonsole zum Erstellen der beiden Zählermetriken-Diagramme verwendet, gesammelt werden.
Für Linux, macOS oder Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries '[{"Metric": "os.cpuUtilization.user.avg" },
{"Metric": "os.cpuUtilization.idle.avg"}]'
```
Für Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries '[{"Metric": "os.cpuUtilization.user.avg" },
{"Metric": "os.cpuUtilization.idle.avg"}]'
```
Sie können einen Befehl besser lesbar gestalten, indem Sie eine Datei für die Option `--metrics-query` angeben. Im folgenden Beispiel wird eine Datei namens query.json für die Option verwendet. Die Datei enthält Folgendes.
```
[
{
"Metric": "os.cpuUtilization.user.avg"
},
{
"Metric": "os.cpuUtilization.idle.avg"
}
]
```
Führen Sie den folgenden Befehl aus, um die Datei zu verwenden.
Für Linux, macOS oder Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries file://query.json
```
Für Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries file://query.json
```
Das vorige Beispiel gibt die folgenden Werte für die Optionen an:
+ `--service-type`— `DOCDB` für Amazon DocumentDB
+ `--identifier` – Die Ressource-ID für die DB-Instance
+ `--start-time` und `--end-time` – Die ISO 8601-Werte `DateTime` für den abzufragenden Zeitraum mit mehreren unterstützten Formaten
Der Abfragezeitraum beträgt eine Stunde:
+ `--period-in-seconds` – `60` für eine Abfrage pro Minute
+ `--metric-queries` – Ein Array mit zwei Abfragen, jeweils für nur eine Metrik.
Der Metrikname verwendet Punkte, um die Metrik in eine sinnvolle Kategorie einzustufen, wobei das letzte Element eine Funktion ist. Im Beispiel lautet die Funktion `avg` für jede Abfrage. Wie bei Amazon CloudWatch sind die unterstützten Funktionen `min``max`,`total`, und`avg`.
Die Antwort sieht in etwa so aus:
```
{
"AlignedStartTime": "2022-03-13T08:00:00+00:00",
"AlignedEndTime": "2022-03-13T09:00:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{
"Key": {
"Metric": "os.cpuUtilization.user.avg"
},
"DataPoints": [
{
"Timestamp": "2022-03-13T08:01:00+00:00", //Minute1
"Value": 3.6
},
{
"Timestamp": "2022-03-13T08:02:00+00:00", //Minute2
"Value": 2.6
},
//.... 60 datapoints for the os.cpuUtilization.user.avg metric
{
"Key": {
"Metric": "os.cpuUtilization.idle.avg"
},
"DataPoints": [
{
"Timestamp": "2022-03-13T08:01:00+00:00",
"Value": 92.7
},
{
"Timestamp": "2022-03-13T08:02:00+00:00",
"Value": 93.7
},
//.... 60 datapoints for the os.cpuUtilization.user.avg metric
]
}
] //end of MetricList
} //end of response
```
Die Antwort enthält Werte für `Identifier`, `AlignedStartTime` und `AlignedEndTime`. Bei einem `--period-in-seconds`-Wert von `60` wurden Start- und Endzeiten auf die Minute ausgerichtet. Wenn der `--period-in-seconds`-Wert `3600` lautet, werden Start- und Endzeiten auf die Stunde ausgerichtet.
Die `MetricList` in der Antwort enthält eine Reihe von Einträgen, und zwar jeweils mit einem `Key`- und einem `DataPoints`-Eintrag. Jeder `DataPoint` verfügt über einen `Timestamp` und einen `Value`. Jede `Datapoints`-Liste enthält 60 Datenpunkte, da die Abfragen eine Stunde lang jede Minute Daten abfragen, und zwar mit den Werten `Timestamp1/Minute1`, `Timestamp2/Minute2` usw. bis `Timestamp60/Minute60`.
Da sich die Abfrage auf zwei verschiedene Zählermetriken bezieht, enthält die -Antwort zwei Element `MetricList`.
### Der DB-Lastdurchschnitt für die höchsten Wartezeiten wird abgerufen
Das folgende Beispiel ist dieselbe Abfrage, die AWS-Managementkonsole verwendet wird, um ein gestapeltes Flächenliniendiagramm zu generieren. In diesem Beispiel wird der Wert `db.load.avg` für die letzte Stunde abgerufen, wobei die Auslastung nach den sieben höchsten Wartezuständen aufgeteilt wird. Der Befehl ist mit dem Befehl unter identisc [Abrufen von Zählermetriken](#performance-insights-metrics-api-examples.CounterMetrics). Die Datei query.json enthält hingegen Folgendes.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.wait_state", "Limit": 7 }
}
]
```
Führen Sie den folgenden Befehl aus.
Für Linux, macOS oder Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries file://query.json
```
Für Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries file://query.json
```
Das Beispiel gibt die Metrik für `db.load.avg` und a `GroupBy` der sieben wichtigsten Wartezustände an. Einzelheiten zu gültigen Werten für dieses Beispiel finden Sie [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)in der *Performance Insights API-Referenz.*
Die Antwort sieht in etwa so aus:
```
{
"AlignedStartTime": "2022-04-04T06:00:00+00:00",
"AlignedEndTime": "2022-04-04T06:15:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{//A list of key/datapoints
"Key": {
//A Metric with no dimensions. This is the total db.load.avg
"Metric": "db.load.avg"
},
"DataPoints": [
//Each list of datapoints has the same timestamps and same number of items
{
"Timestamp": "2022-04-04T06:01:00+00:00",//Minute1
"Value": 0.0
},
{
"Timestamp": "2022-04-04T06:02:00+00:00",//Minute2
"Value": 0.0
},
//... 60 datapoints for the total db.load.avg key
]
},
{
"Key": {
//Another key. This is db.load.avg broken down by CPU
"Metric": "db.load.avg",
"Dimensions": {
"db.wait_state.name": "CPU"
}
},
"DataPoints": [
{
"Timestamp": "2022-04-04T06:01:00+00:00",//Minute1
"Value": 0.0
},
{
"Timestamp": "2022-04-04T06:02:00+00:00",//Minute2
"Value": 0.0
},
//... 60 datapoints for the CPU key
]
},//... In total we have 3 key/datapoints entries, 1) total, 2-3) Top Wait States
] //end of MetricList
} //end of response
```
In dieser Antwort gibt es drei Einträge in der`MetricList`. Es gibt einen Eintrag für die Gesamtzahl `db.load.avg` und jeweils drei Einträge für die `db.load.avg` Aufteilung nach einem der drei höchsten Wartezustände. Da es eine Gruppierungsdimension gab (im Gegensatz zum ersten Beispiel), muss es für jede Gruppierung der Metrik einen Schlüssel geben. Für jede Metrik kann nicht nur ein Schlüssel vorhanden sein, wie im Anwendungsfall der Basiszählermetrik.
### Der durchschnittliche DB-Ladestand für die oberste Abfrage wird abgerufen
Das folgende Beispiel `db.wait_state` gruppiert nach den 10 wichtigsten Abfrageanweisungen. Es gibt zwei verschiedene Gruppen für Abfrageanweisungen:
+ `db.query`— Die vollständige Abfrageanweisung, wie `{"find":"customers","filter":{"FirstName":"Jesse"},"sort":{"key":{"$numberInt":"1"}}}`
+ `db.query_tokenized`— Die tokenisierte Abfrageanweisung, wie `{"find":"customers","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}`
Bei der Analyse der Datenbankleistung kann es nützlich sein, Abfrageanweisungen, die sich nur durch ihre Parameter unterscheiden, als ein Logikelement zu betrachten. In diesem Fall können Sie `db.query_tokenized` beim Abfragen verwenden. Vor allem, wenn Sie daran interessiert sind`explain()`, ist es manchmal sinnvoller, vollständige Abfrageanweisungen mit Parametern zu untersuchen. Es besteht eine Beziehung zwischen tokenisierten und vollständigen Abfragen, wobei mehrere vollständige Abfragen (untergeordnete Abfragen) unter derselben tokenisierten Abfrage (übergeordnete Abfrage) gruppiert sind.
Der Befehl in diesem Beispiel ähnelt dem Befehl unter [Der DB-Lastdurchschnitt für die höchsten Wartezeiten wird abgerufen](#performance-insights-metrics-api-examples.DBLoadAverage). Die Datei query.json enthält hingegen Folgendes.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.query_tokenized", "Limit": 10 }
}
]
```
Im folgenden Beispiel wird verwende `db.query_tokenized`.
Für Linux, macOS oder Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 3600 \
--metric-queries file://query.json
```
Für Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 3600 ^
--metric-queries file://query.json
```
In diesem Beispiel werden Abfragen über eine Stunde mit einer Minute abgefragt. period-in-seconds
Das Beispiel gibt die Metrik für `db.load.avg` und einen `GroupBy` der sieben höchsten Wartezustände an. Einzelheiten zu gültigen Werten für dieses Beispiel finden Sie [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)in der *Performance Insights API-Referenz.*
Die Antwort sieht in etwa so aus:
```
{
"AlignedStartTime": "2022-04-04T06:00:00+00:00",
"AlignedEndTime": "2022-04-04T06:15:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{//A list of key/datapoints
"Key": {
"Metric": "db.load.avg"
},
"DataPoints": [
//... 60 datapoints for the total db.load.avg key
]
},
{
"Key": {//Next key are the top tokenized queries
"Metric": "db.load.avg",
"Dimensions": {
"db.query_tokenized.db_id": "pi-1064184600",
"db.query_tokenized.id": "77DE8364594EXAMPLE",
"db.query_tokenized.statement": "{\"find\":\"customers\",\"filter\":{\"FirstName\":\"?\"},\"sort\":{\"key\":{\"$numberInt\":\"?\"}},\"limit\"
:{\"$numberInt\":\"?\"},\"$db\":\"myDB\",\"$readPreference\":{\"mode\":\"primary\"}}"
}
},
"DataPoints": [
//... 60 datapoints
]
},
// In total 11 entries, 10 Keys of top tokenized queries, 1 total key
] //End of MetricList
} //End of response
```
Diese Antwort enthält 11 Einträge in der Abfrage `MetricList` (insgesamt 1, 10 am häufigsten tokenisierte Abfragen), wobei jeder Eintrag 24 Einträge pro Stunde enthält. `DataPoints`
Bei tokenisierten Abfragen gibt es drei Einträge in jeder Dimensionsliste:
+ `db.query_tokenized.statement`— Die tokenisierte Abfrageanweisung.
+ `db.query_tokenized.db_id `— Die synthetische ID, die Performance Insights für Sie generiert. In diesem Beispiel wird die synthetische ID `pi-1064184600` zurückgegeben.
+ `db.query_tokenized.id` – Die ID der Abfrage innerhalb von Performance-Insights.
In der AWS-Managementkonsole wird diese ID als Support-ID bezeichnet. Es trägt diesen Namen, weil es sich bei der ID um Daten handelt, die der AWS Support untersuchen kann, um Ihnen bei der Behebung eines Problems mit Ihrer Datenbank zu helfen. AWS nimmt die Sicherheit und den Schutz Ihrer Daten sehr ernst und fast alle Daten werden verschlüsselt zusammen mit Ihren gespeichert AWS KMS key. Daher AWS kann niemand im Inneren diese Daten einsehen. Im vorherigen Beispiel wird sowohl `tokenized.statement` als auch `tokenized.db_id` verschlüsselt gespeichert. Wenn Sie ein Problem mit Ihrer Datenbank haben, kann Ihnen der AWS Support unter Angabe der Support-ID weiterhelfen.
Beim Abfragen empfiehlt es sich ggf., eine `Group` in `GroupBy` anzugeben. Für eine präzisere Kontrolle der Daten, die zurückgegeben werden, sollten Sie allerdings die Dimensionsliste angeben. Wenn z. B. lediglich eine `db.query_tokenized.statement` erforderlich ist, kann der query.json-Datei ein `Dimensions`-Attribut hinzugefügt werden.
```
[
{
"Metric": "db.load.avg",
"GroupBy": {
"Group": "db.query_tokenized",
"Dimensions":["db.query_tokenized.statement"],
"Limit": 10
}
}
]
```
### Abrufen des nach Query gefilterten DB-Ladedurchschnitts
Die entsprechende API-Abfrage in diesem Beispiel ähnelt dem Befehl unter [Der durchschnittliche DB-Ladestand für die oberste Abfrage wird abgerufen](#performance-insights-metrics-api-examples.topquery). Die Datei query.json enthält hingegen Folgendes.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.wait_state", "Limit": 5 },
"Filter": { "db.query_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }
}
]
```
In dieser Antwort werden alle Werte entsprechend dem Beitrag der tokenisierten Abfrage EXAMPLE gefiltert, die in der Datei AKIAIOSFODNN7 query.json angegeben ist. Die Schlüssel haben möglicherweise auch eine andere Reihenfolge als eine Abfrage ohne Filter, da sich die gefilterte Abfrage auf die fünf Wartezustände mit den höchsten Wartezuständen ausgewirkt hat.
# CloudWatch Amazon-Metriken für Performance Insights
Performance Insights veröffentlicht automatisch Metriken auf Amazon CloudWatch. Dieselben Daten können von Performance Insights abgefragt werden, aber wenn die Metriken vorhanden sind, ist es einfach, Alarme hinzuzufügen CloudWatch . CloudWatch Die Metriken können auch leicht zu vorhandenen CloudWatch-Dashboards hinzugefügt werden.
| Metrik | Description |
| --- | --- |
| DBLoad | Die Anzahl der aktiven Sitzungen für Amazon DocumentDB. In der Regel sind Sie an den Daten für die durchschnittliche Anzahl der aktiven Sitzungen interessiert. Diese Daten werden in Performance Insights als `db.load.avg` abgefragt. |
| DBLoadCPU | Die Anzahl der aktiven Sitzungen, bei denen der Wartestatustyp CPU ist. In Performance Insights werden diese Daten abgefragt als`db.load.avg`, gefiltert nach dem Wartestatustyp. `CPU` |
| DBLoadKeine CPU | Die Anzahl der aktiven Sitzungen, bei denen der Wartestatustyp nicht CPU ist. |
**Anmerkung**
Diese Metriken werden CloudWatch nur veröffentlicht, wenn die DB-Instance ausgelastet ist.
Sie können diese Metriken mithilfe der CloudWatch Konsole AWS CLI, der oder der CloudWatch API untersuchen.
Sie können beispielsweise die Statistiken für die `DBLoad` Metrik abrufen, indem Sie den [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)Befehl ausführen.
```
aws cloudwatch get-metric-statistics \
--region ap-south-1 \
--namespace AWS/DocDB \
--metric-name DBLoad \
--period 360 \
--statistics Average \
--start-time 2022-03-14T8:00:00Z \
--end-time 2022-03-14T9:00:00Z \
--dimensions Name=DBInstanceIdentifier,Value=documentdbinstance
```
Dieses Beispiel generiert eine Ausgabe wie die folgende.
```
{
"Datapoints": [
{
"Timestamp": "2022-03-14T08:42:00Z",
"Average": 1.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:24:00Z",
"Average": 2.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:54:00Z",
"Average": 6.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:36:00Z",
"Average": 5.7,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:06:00Z",
"Average": 4.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:00:00Z",
"Average": 5.2,
"Unit": "None"
}
],
"Label": "DBLoad"
}
```
Sie können die mathematische `DB_PERF_INSIGHTS` Metrikfunktion in der CloudWatch Konsole verwenden, um Zählermetriken von Amazon DocumentDB Performance Insights abzufragen. Die `DB_PERF_INSIGHTS` Funktion beinhaltet auch die `DBLoad` Metrik in Intervallen unter einer Minute. Sie können CloudWatch Alarme für diese Messwerte einrichten. Weitere Informationen zum Erstellen eines Alarms finden Sie unter [Erstellen eines Alarms für Performance Insights Insights-Zählermetriken aus einer AWS Datenbank](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarm_database_performance_insights.html).
Weitere Informationen zu CloudWatch finden Sie unter [Was ist Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) im * CloudWatch Amazon-Benutzerhandbuch*.
# Performance Insights für Zählermetriken
Zählermetriken sind Betriebssystemmetriken im Performance Insights Insights-Dashboard. Um Leistungsprobleme zu identifizieren und zu analysieren, können Sie Zählermetriken mit der DB-Last korrelieren.
## Performance-Insights-Betriebssystemzähler
Die folgenden Betriebssystemindikatoren sind mit Amazon DocumentDB Performance Insights verfügbar.
| Zähler | Typ | Metrik |
| --- | --- | --- |
| Aktiv | memory | os.memory.active |
| buffers | memory | os.memory.buffers |
| cached | memory | os.memory.cached |
| dirty | memory | os.memory.dirty |
| free | memory | os.memory.free |
| inactive | memory | os.memory.inactive |
| mapped | memory | os.memory.mapped |
| pageTables | memory | os.memory.pageTables |
| slab | memory | os.memory.slab |
| total | memory | os.memory.total |
| writeback | memory | os.memory.writeback |
| idle | cpuUtilization | os.cpuUtilization.idle |
| system | cpuUtilization | os.cpuUtilization.system |
| total | cpuUtilization | os.cpuUtilization.total |
| user | cpuUtilization | os.cpuUtilization.user |
| wait | cpuUtilization | os.cpuUtilization.wait |
| one | loadAverageMinute | OS. loadAverageMinute. eins |
| fifteen | loadAverageMinute | os. loadAverageMinute. fünfzehn |
| fünf | loadAverageMinute | os. loadAverageMinute. fünf |
| cached | swap | os.swap.cached |
| free | swap | os.swap.free |
| in | swap | os.swap.in |
| out | swap | os.swap.out |
| total | swap | os.swap.total |
| rx | network | os.network.rx |
| tx | network | os.network.tx |
| Zahl VCPUs | general | os.general.num VCPUs |