View a markdown version of this page

Überwachung von Amazon DocumentDB mit CloudWatch - Amazon DocumentDB

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 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 mithilfe der CloudWatch Konsole, der Amazon DocumentDB-Konsole, der AWS Command Line Interface (AWS CLI) oder der API überwachen. CloudWatch

CloudWatch ermöglicht es Ihnen auch, Alarme einzurichten, 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 Abhilfemaßnahmen ergriffen werden. Weitere Informationen zur Verwendung CloudWatch und zu Alarmen finden Sie in der CloudWatch Amazon-Dokumentation.

Amazon DocumentDB-Metriken

Um den Zustand und die Leistung Ihres Amazon DocumentDB-Clusters und Ihrer 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.

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. Preisinformationen für Speicher finden Sie auf der Amazon DocumentDB-Produktseite. 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.
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 werden.
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 auf einer Instance zu einem bestimmten Zeitpunkt zulässig sind.
DatabaseConnectionsActiveMax Die maximale Anzahl aktiver Datenbankverbindungen auf einer Instance in einem Zeitraum von 1 Minute. Aktive Verbindungen sind diejenigen, die gerade einen Vorgang ausführen, im Gegensatz zu inaktiven Verbindungen. Die Kontingente für aktive Verbindungen pro Instanztyp finden Sie unterKontingente für Instanzen.
DatabaseCursors Die Anzahl der Cursor, die auf einer Instance geöffnet werden, wird im Abstand von 1 Minute ausgeführt.
DatabaseCursorsMax Die maximale Anzahl offener Cursor auf einer Instanz in einem Zeitraum von 1 Minute.
DatabaseCursorsLimit Die maximale Anzahl von Cursorn, die zu einem bestimmten Zeitpunkt auf einer Instanz 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 des geringen verfügbaren Speichers gedrosselt werden, wird im Abstand von 1 Minute abgerufen.

LowMemThrottleMaxQueueDepth

Die maximale Warteschlangentiefe für Anfragen, die aufgrund von zu wenig verfügbarem Speicher gedrosselt werden, in einem Zeitraum von 1 Minute.

LowMemNumOperationsThrottled

Die Anzahl der Anfragen, die in einem Zeitraum von 1 Minute aufgrund von zu wenig verfügbarem Speicher gedrosselt werden.

SnapshotStorageUsed Die Gesamtmenge an Backup-Speicherplatz in Byte, die 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-Speicherplatz in Byte, für die Ihnen ein bestimmtes 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 auf einer Instance geöffneten Transaktionen, die im Abstand von 1 Minute durchgeführt werden.
TransactionsOpenMax Die maximale Anzahl von Transaktionen, die auf einer Instance innerhalb eines Zeitraums von 1 Minute geöffnet werden.
TransactionsOpenLimit Die maximale Anzahl gleichzeitiger Transaktionen, die zu einem bestimmten Zeitpunkt auf einer Instance 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-Produktseite.

Latenzmetriken

Metrik Description
DBClusterReplicaLagMaximum Die maximale Verzögerung in Millisekunden zwischen der primären Instance und jeder Amazon 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-backed Metriken für Instanzen

Metrik Description
NVMeStorageCacheHitRatio Der Prozentsatz der Anfragen, die vom mehrstufigen Cache bedient werden.
FreeNVMeStorage Die Menge des verfügbaren flüchtigen NVMe-Speicherplatzes
ReadIOPSNVMeStorage Die durchschnittliche Anzahl von I/O Festplattenlesevorgängen im temporären NVMe-Speicher.
ReadLatencyNVMeStorage Die durchschnittliche Zeit, die pro Lesevorgang auf der Festplatte für temporären I/O NVMe-Speicher benötigt wird.
ReadThroughputNVMeStorage Die durchschnittliche Anzahl von Bytes, die pro Sekunde von der Festplatte für den flüchtigen NVMe-Speicher gelesen werden.
WriteIOPSNVMeStorage Die durchschnittliche Anzahl von I/O Festplattenschreibvorgängen in temporären NVMe-Speicher.
WriteLatencyNVMeStorage Die durchschnittliche Zeit, die pro I/O Festplattenschreibvorgang für temporären NVMe-Speicher benötigt wird.
WriteThroughputNVMeStorage Die durchschnittliche Anzahl von Bytes, die pro Sekunde für den flüchtigen NVMe-Speicher auf die Festplatte geschrieben werden

Metriken zum Betrieb

Metrik Description
DocumentsDeleted Die Anzahl gelöschter 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 innerhalb eines Zeitraums von 1 Minute ausgeführt wurden.
OpcountersGetmore Die Anzahl der Getmores, die innerhalb eines Zeitraums von 1 Minute ausgegeben wurden.
OpcountersInsert Die Anzahl der Insert-Operationen, die innerhalb eines Zeitraums von 1 Minute ausgeführt wurden.
OpcountersQuery Die Anzahl der Abfragen, die innerhalb eines Zeitraums von 1 Minute gestellt wurden.
OpcountersUpdate Die Anzahl der Aktualisierungsvorgänge, die innerhalb eines Zeitraums 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 auf einer Instance innerhalb eines Zeitraums von 1 Minute ausgeführt wurden.
TransactionsAborted Die Anzahl der Transaktionen, die auf einer Instance innerhalb eines Zeitraums von 1 Minute abgebrochen wurden.
TTLDeletedDocuments Die Anzahl der Dokumente, die von einem TTLMonitor in einem Zeitraum von 1 Minute gelöscht wurden.

Command-level Metriken

Amazon DocumentDB veröffentlicht Latenz- und Parallelitätsmetriken pro Befehl für. CloudWatch Mithilfe dieser Metriken können Sie ermitteln, welche Vorgänge am meisten zu Ihrer Arbeitslast beitragen, und Probleme mit der Endlatenz oder dem Druck auf Parallelität erkennen.

Jeder Befehl in der folgenden Tabelle gibt drei Metriken in einem Zeitraum von 1 Minute aus:

  • AvgDuration— Die durchschnittliche Ausführungszeit des Befehls in Mikrosekunden.

  • P100Duration— Die maximale Ausführungszeit des Befehls (100. Perzentil) in Mikrosekunden.

  • MaxConcurrent— Die maximale Anzahl gleichzeitiger Ausführungen des Befehls.

Metriknamen folgen dem Muster. Command.commandName.metricName Zum Beispiel Command.find.AvgDuration oder Command.aggregate.MaxConcurrent.

Metrik Description
Command.find Lesen Sie Abfragen mithilfe von find.
Command.insert Operationen zum Einfügen von Dokumenten.
Command.findAndModify Atomare Operationen zum Suchen und Ändern.
Command.update Operationen zur Aktualisierung von Dokumenten.
Command.delete Vorgänge zum Löschen von Dokumenten.
Command.aggregate Ausführungen von Aggregationspipelines.
Command.count Operationen zählen.
Command.distinct Abfragen mit unterschiedlichen Werten.
Command.getMore Operationen zum Abrufen von Cursor-Batches.
Command.abortTransaction Operationen zum Abbrechen von Transaktionen.
Command.commitTransaction Operationen zum Festschreiben von Transaktionen.

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 empfangen als auch an Clients ü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 Festplattenlesevorgängen pro Sekunde. Amazon DocumentDB meldet Lese- und Schreib-IOPS getrennt und in Intervallen von 1 Minute.
ReadThroughput Die durchschnittliche Anzahl Byte, die pro Sekunde vom Datenträger gelesen werden.
StorageNetworkReceiveThroughput Der Netzwerkdurchsatz, in Byte pro Sekunde, der von jeder Instance im Cluster vom Amazon DocumentDB-Cluster-Speichervolume empfangen wird.
StorageNetworkTransmitThroughput Die Menge an Netzwerkdurchsatz in Byte pro Sekunde, die von jeder Instance im Cluster an das Amazon DocumentDB-Cluster-Speichervolume gesendet wird.
StorageNetworkThroughput Der Netzwerkdurchsatz 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 der abgerechneten I/O Lesevorgänge von einem Cluster-Volume, die in Intervallen von 5 Minuten gemeldet wird. 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 beispielsweise 13.686 VolumeReadIOPs zurückgegeben wird, 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 der abgerechneten I/O Schreibvorgänge von einem Cluster-Volume, die in Intervallen von 5 Minuten 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, sind die fakturierten Schreibvorgänge pro Sekunde 45 (13.686/300 = 45,62).

Beachten Sie, dass die VolumeWriteIOPs AND-Metriken von der DocumentDB-Speicherschicht berechnet werden VolumeReadIOPs und dass sie IOs einschließen, die von der Primär- und der Replikatinstanz ausgeführt werden. Die Daten werden alle 20 bis 30 Minuten aggregiert und dann in Intervallen von 5 Minuten gemeldet, sodass der gleiche Datenpunkt für die Metrik in dem Zeitraum ausgegeben wird. Wenn Sie nach einer Metrik suchen, die Ihren Einfügeoperationen über ein Intervall von 1 Minute entspricht, können Sie die WriteIOps-Metrik auf Instance-Ebene verwenden. Die Metrik ist auf der Registerkarte „Überwachung“ Ihrer primären Amazon DocumentDB-Instance verfügbar.

WriteIOPS Die durchschnittliche Anzahl von I/O Festplatten-Schreibvorgängen pro Sekunde. Wenn sie auf Clusterebene verwendet WriteIOPs werden, 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 verfügbaren Schreibvorgänge anzeigt, bevor Null erreicht wird. Wenn dieser Zähler Null erreicht, wechselt Ihr Cluster in den schreibgeschützten Modus, bis die IDs abgerufen und wiederverwendet werden. Der Zähler sinkt mit jedem Schreibvorgang und steigt, wenn die Garbage Collection alte MVCC-IDs wiederverwendet.
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 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 zukünftigen 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 einminütigen Fensters abgeschlossen werden.

Metriken der T3-Instanz

Metrik Description
CPUCreditUsage Die Anzahl der CPU-Credits, die während des Messzeitraums ausgegeben wurden.
CPUCreditBalance Die Anzahl der CPU-Credits, die eine Instance angehäuft 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-Credits, die zur Aufrechterhaltung der CPU-Leistung ausgegeben werden, wenn der CPUCreditBalance Wert Null ist.
CPUSurplusCreditsCharged Die Anzahl der überschüssigen CPU-Credits, die die maximale Anzahl an CPU-Credits überschreiten, die innerhalb von 24 Stunden verdient werden können, und für die eine zusätzliche Gebühr anfällt. Weitere Informationen finden Sie unter CPU-Guthaben überwachen.

CloudWatch Daten anzeigen

Sie können CloudWatch Amazon-Daten mithilfe 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 mithilfe der Amazon DocumentDB Management Console anzuzeigen.

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

  2. 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 (Menu button.) aus.

  3. Im Navigationsfeld „Cluster“ sehen Sie die Spalte Cluster Identifier. Ihre Instances sind unter Clustern aufgeführt, ähnlich wie im folgenden Screenshot.

    Die Cluster-Tabelle zeigt, wie eine Instance unter einem Cluster verschachtelt ist.
  4. Wählen Sie aus der Liste der Instanzen den Namen der Instanz aus, für die Sie Metriken benötigen.

  5. Wählen Sie auf der daraufhin angezeigten Seite mit der Instanzübersicht den Tab Monitoring, um grafische Darstellungen der Metriken Ihrer Amazon 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 grafischen Darstellungen von zwei CloudWatch Metriken in der Amazon DocumentDB-Konsole undWriteIOPS. ReadIOPS

    Zwei Liniendiagramme, die die WriteIops- und CloudWatch ReadiOps-Metriken in der Amazon DocumentDB-Konsole darstellen.
Using the CloudWatch Management Console

Gehen Sie wie folgt vor, um CloudWatch Metriken mithilfe der CloudWatch Management Console anzuzeigen.

  1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB-Konsole unterhttps://console.aws.amazon.com/cloudwatch.

  2. Wählen Sie im Navigationsbereich Metriken aus. Wählen Sie dann aus der Liste der Servicenamen DocDB aus.

  3. Wählen Sie eine metrische Dimension (z. B. Cluster-Metriken).

  4. 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.

    2. 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.

    3. 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 folgenden Abbildung gezeigt.

      Auf der Registerkarte „Alle Metriken“ werden Metriken aufgeführt, wobei eine Dropdownliste für einen Metriknamen angezeigt wird.
Using the AWS CLI

Um CloudWatch Daten für Amazon DocumentDB anzuzeigen, verwenden Sie den CloudWatch get-metric-statistics Vorgang mit den folgenden Parametern.

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 UTC-Format nach ISO 8601 vorliegen (z. B. T23:00:00Z 2016-10-03).

  • --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 UTC-Format ISO 8601 vorliegen (z. B. 2016-10-03). T23: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

Beispiel

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 durch die Werte für das Konto oder den Vorgang qualifiziert. Sie können die CloudWatch Konsole verwenden, um Amazon 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 der Opcounter-Metriken

Opcounter-Metriken haben einen Wert ungleich Null (normalerweise ~50) für Cluster im Leerlauf. Das 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 anzeigendb.runCommand( { serverStatus: 1 }), werden Ihnen möglicherweise bis zu 10 Verbindungen mehr angezeigt, als Sie in DatabaseConnections CloudWatch Durchsicht sehen. Dies liegt daran, dass Amazon DocumentDB regelmäßig Zustandsprüfungen und Aufgaben zur Erfassung von Kennzahlen durchführt, die in DatabaseConnections nicht berücksichtigt werden. DatabaseConnectionssteht nur für vom Kunden initiierte Verbindungen.