Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Überwachen 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.