Monitoraggio di Amazon DocumentDB con CloudWatch - Amazon DocumentDB

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Monitoraggio di Amazon DocumentDB con CloudWatch

Amazon DocumentDB (compatibile con MongoDB) si integra con Amazon per CloudWatch consentirti di raccogliere e analizzare i parametri operativi per i tuoi cluster. Puoi monitorare questi parametri utilizzando la CloudWatch console, la console Amazon DocumentDB, AWS Command Line Interface il AWS CLI() o CloudWatch l'API.

CloudWatch consente inoltre di impostare allarmi in modo da poter essere avvisati se un valore metrico supera una soglia specificata. Puoi anche configurare Amazon CloudWatch Events per intraprendere azioni correttive in caso di violazione. Per ulteriori informazioni sull'utilizzo CloudWatch e sugli allarmi, consulta la CloudWatch documentazione di Amazon.

Metriche di Amazon DocumentDB

Per monitorare lo stato e le prestazioni del cluster e delle istanze di Amazon DocumentDB, puoi visualizzare i seguenti parametri nella console Amazon DocumentDB.

Nota

Le metriche nelle tabelle seguenti si applicano sia ai cluster basati su istanze che ai cluster elastici.

Parametri di utilizzo delle risorse

Parametro Descrizione
BackupRetentionPeriodStorageUsed La quantità totale di storage di backup in GiB utilizzata per supportare la funzionalità di point-in-time ripristino all'interno della finestra di conservazione di Amazon DocumentDB. Incluso nel totale riportato dal parametro TotalBackupStorageBilled. Calcolato separatamente per ogni cluster Amazon DocumentDB.
ChangeStreamLogSize La quantità di storage utilizzata dal cluster per archiviare il log del flusso di modifiche in megabyte. Questo valore è un sottoinsieme dello storage totale per il cluster (VolumeBytesUsed) e influisce sul costo del cluster. Per informazioni sui prezzi dello storage, consulta la pagina del prodotto Amazon DocumentDB. La dimensione del log del flusso di modifiche è una funzione della quantità di modifiche applicata nel cluster e della durata di conservazione prolungata del flusso di modifiche. Per ulteriori informazioni sui flussi di modifiche, consulta Utilizzo dei flussi di modifica con Amazon DocumentDB.
CPUUtilization La percentuale di CPU utilizzata da un'istanza.
DatabaseConnections Il numero di connessioni aperte su un'istanza acquisita con una frequenza di un minuto.
DatabaseConnectionsMax Il numero massimo di connessioni al database aperte su un'istanza in un periodo di un minuto.
DatabaseCursors Il numero di cursori aperti su un'istanza acquisita con una frequenza di un minuto.
DatabaseCursorsMax Il numero massimo di cursori aperti su un'istanza in un periodo di un minuto.
DatabaseCursorsTimedOut Il numero di cursori scaduti in un periodo di un minuto.
FreeableMemory La quantità di memoria RAM disponibile, in byte.
FreeLocalStorage

Questo parametro indica la quantità di storage disponibile in ogni istanza per le tabelle e i log temporanei. Questo valore dipende dalla classe di istanza. Puoi aumentare la quantità di storage gratuito per un'istanza scegliendo una classe di istanza più ampia per l'istanza.

LowMemThrottleQueueDepth

La profondità della coda per le richieste che vengono limitate a causa della scarsa memoria disponibile occupata con una frequenza di un minuto.

LowMemThrottleMaxQueueDepth

La profondità massima di coda per le richieste che vengono limitate a causa della scarsa memoria disponibile in un periodo di un minuto.

LowMemNumOperationsThrottled

Il numero di richieste che vengono limitate a causa della scarsa memoria disponibile in un periodo di un minuto.

SnapshotStorageUsed La quantità totale di storage di backup in GiB utilizzata da tutte le istantanee per un determinato cluster Amazon DocumentDB al di fuori della relativa finestra di conservazione del backup. Incluso nel totale riportato dal parametro TotalBackupStorageBilled. Calcolato separatamente per ogni cluster Amazon DocumentDB.
SwapUsage La quantità di spazio di swapping utilizzato sull'istanza.
TotalBackupStorageBilled La quantità totale di storage di backup in GiB per la quale ti viene fatturato un determinato cluster Amazon DocumentDB. Include lo storage di backup misurato dai parametri BackupRetentionPeriodStorageUsed e SnapshotStorageUsed. Calcolato separatamente per ogni cluster Amazon DocumentDB.
TransactionsOpen Il numero di transazioni aperte su un'istanza eseguite con una frequenza di un minuto.
TransactionsOpenMax Il numero massimo di transazioni aperte su un'istanza in un periodo di un minuto.
VolumeBytesUsed La quantità di storage in byte utilizzata dal cluster. Questo valore influisce sul costo del cluster. Per informazioni sui prezzi, consulta la pagina del prodotto Amazon DocumentDB.

Metriche di latenza

Parametro Descrizione
DBClusterReplicaLagMaximum La quantità massima di ritardo, in millisecondi, tra l'istanza principale e ogni istanza di Amazon DocumentDB nel cluster.
DBClusterReplicaLagMinimum Il ritardo minimo, in millisecondi, tra l'istanza primaria e ogni istanza di replica nel cluster.
DBInstanceReplicaLag Il ritardo, in millisecondi, durante la replica degli aggiornamenti dall'istanza primaria a un'istanza di replica.
ReadLatency La quantità di tempo media che occorre per ciascuna operazione I/O su disco.
WriteLatency La quantità di tempo media, in millisecondi, che occorre per ciascuna operazione I/O su disco.

NVMe-metriche delle istanze supportate

Parametro Descrizione
NVMeStorageCacheHitRatio La percentuale di richieste servite dalla cache a più livelli.
FreeNVMeStorage La quantità di spazio di archiviazione effimero NVMe disponibile.
ReadIOPSNVMeStorage Il numero medio di operazioni di I/O di lettura del disco su Ephemeral Storage. NVMe
ReadLatencyNVMeStorage Il tempo medio impiegato per ogni operazione di I/O di lettura del disco per Ephemeral Storage. NVMe
ReadThroughputNVMeStorage Il numero medio di byte letti dal disco al secondo per lo storage Ephemeral. NVMe
WriteIOPSNVMeStorage Il numero medio di operazioni di I/O di scrittura su disco su Ephemeral Storage. NVMe
WriteLatencyNVMeStorage Il tempo medio impiegato per ogni operazione di I/O di scrittura su disco per Ephemeral Storage. NVMe
WriteThroughputNVMeStorage Il numero medio di byte scritti su disco al secondo per lo storage Ephemeral. NVMe

Metriche operative

Parametro Descrizione
DocumentsDeleted Il numero di documenti eliminati in un periodo di un minuto.
DocumentsInserted Il numero di documenti inseriti in un periodo di un minuto.
DocumentsReturned Il numero di documenti restituiti in un periodo di un minuto.
DocumentsUpdated Il numero di documenti aggiornati in un periodo di un minuto.
OpcountersCommand Il numero di comandi emessi in un periodo di un minuto.
OpcountersDelete Il numero di operazioni di eliminazione eseguite in un periodo di un minuto.
OpcountersGetmore Il numero di getmore emessi in un periodo di un minuto.
OpcountersInsert Il numero di operazioni di inserimento emesse in un periodo di un minuto.
OpcountersQuery Il numero di interrogazioni emesse in un periodo di un minuto.
OpcountersUpdate Il numero di operazioni di aggiornamento eseguite in un periodo di un minuto.
TransactionsStarted Il numero di transazioni avviate su un'istanza in un periodo di un minuto.
TransactionsCommitted Il numero di transazioni eseguite su un'istanza in un periodo di un minuto.
TransactionsAborted Il numero di transazioni interrotte su un'istanza in un periodo di un minuto.
TTLDeletedDocuments Il numero di documenti eliminati da TTLMonitor a in un periodo di un minuto.

Metriche del throughput

Parametro Descrizione
NetworkReceiveThroughput La quantità di throughput della rete, in byte al secondo, ricevuta dai clienti per ogni istanza nel cluster. Questo throughput non include il traffico di rete tra le istanze nel cluster e il volume cluster.
NetworkThroughput La quantità di throughput di rete, in byte al secondo, ricevuta e trasmessa ai client da ciascuna istanza del cluster Amazon DocumentDB. Questo throughput non include il traffico di rete tra le istanze nel cluster e il volume cluster.
NetworkTransmitThroughput La quantità di throughput della rete, in byte al secondo, inviata ai clienti per ogni istanza nel cluster. Questo throughput non include il traffico di rete tra le istanze nel cluster e il volume cluster.
ReadIOPS Il numero medio di operazioni di I/O di lettura del disco al secondo. Amazon DocumentDB riporta gli IOPS di lettura e scrittura separatamente e a intervalli di un minuto.
ReadThroughput Il numero medio di byte letti dal disco al secondo.
StorageNetworkReceiveThroughput La quantità di throughput di rete, in byte al secondo, ricevuta dal volume di storage del cluster Amazon DocumentDB da ogni istanza del cluster.
StorageNetworkTransmitThroughput La quantità di throughput di rete, in byte al secondo, inviata al volume di storage del cluster Amazon DocumentDB da ogni istanza del cluster.
StorageNetworkThroughput La quantità di throughput di rete, in byte al secondo, ricevuta e inviata al volume di storage del cluster Amazon DocumentDB da ogni istanza del cluster Amazon DocumentDB.
VolumeReadIOPs

Numero medio delle operazioni I/O di lettura fatturate da un volume di cluster, indicato a intervalli di 5 minuti. Le operazioni di lettura fatturate sono calcolate a livello del volume del cluster, aggregate da tutte le istanze nel cluster e quindi indicate a intervalli di 5 minuti. Il valore viene calcolato prendendo il valore del parametro per le operazioni di lettura in un periodo di 5 minuti. Puoi determinare la quantità delle operazioni di lettura fatturate al secondo prendendo il valore del parametro per le operazioni di lettura fatturate e dividendolo per 300 secondi.

Ad esempio, se VolumeReadIOPs restituisce 13.686, le operazioni di lettura fatturate al secondo sono 45 (13.686/ 300 = 45,62).

Le operazioni di lettura fatturate si accumulano per le query che richiedono pagine del database che non si trovano nella cache del buffer e, per questo, devono essere caricate dallo storage. Potresti vedere dei picchi nelle operazioni di lettura fatturate poiché i risultati della query vengono letti dallo storage e, in seguito, caricati nella cache del buffer.

VolumeWriteIOPs

Numero medio delle operazioni I/O di scrittura fatturate da un volume di cluster, indicato a intervalli di 5 minuti. Le operazioni di scrittura fatturate sono calcolate a livello del volume del cluster, aggregate da tutte le istanze nel cluster e quindi indicate a intervalli di 5 minuti. Il valore è calcolato prendendo il valore del parametro delle operazioni di scrittura per un periodo che supera i 5 minuti. Puoi determinare la quantità delle operazioni di scrittura fatturate al secondo prendendo il valore del parametro delle operazioni di scrittura fatturate e dividendo per 300 secondi.

Ad esempio, se VolumeWriteIOPs restituisce 13.686, le operazioni di scrittura fatturate al secondo sono 45 (13.686/ 300 = 45,62).

Tieni presente che le VolumeWriteIOPs metriche VolumeReadIOPs e sono calcolate dal livello di archiviazione DocumentDB e IOs includono quelle eseguite dalle istanze primarie e di replica. I dati vengono aggregati ogni 20-30 minuti e quindi riportati a intervalli di 5 minuti, emettendo così lo stesso punto dati per la metrica nel periodo di tempo. Se stai cercando una metrica da correlare alle operazioni di inserimento su un intervallo di 1 minuto, puoi utilizzare la metrica WriteiOps a livello di istanza. La metrica è disponibile nella scheda di monitoraggio dell'istanza principale di Amazon DocumentDB.

WriteIOPS Il numero medio di operazioni di I/O di scrittura su disco al secondo. Se utilizzati a livello di cluster, WriteIOPs vengono valutati in tutte le istanze del cluster. Gli IOPS di lettura e scrittura vengono riportati separatamente, a intervalli di 1 minuto.
WriteThroughput Il numero medio di byte scritti sul disco al secondo.

Parametri del sistema

Parametro Descrizione
BufferCacheHitRatio La percentuale di richieste gestite dalla cache del buffer.
DiskQueueDepth il numero di richieste di scrittura simultanee sul volume di storage distribuito.
EngineUptime Il periodo di esecuzione dell'istanza, in secondi.
IndexBufferCacheHitRatio La percentuale di richieste di indice servite dalla buffer cache. Potresti vedere un picco superiore al 100% per la metrica subito dopo aver eliminato un indice, una raccolta o un database. Questo errore verrà corretto automaticamente dopo 60 secondi. Questa limitazione verrà risolta in un futuro aggiornamento della patch.

Metriche delle istanze T3

Parametro Descrizione
CPUCreditUsage Il numero di crediti CPU spesi durante il periodo di misurazione.
CPUCreditBalance Il numero di crediti CPU accumulati da un'istanza. Questo saldo è esaurito quando la CPU ottimizza le prestazioni e i crediti CPU vengono spesi più rapidamente di quanto guadagnati.
CPUSurplusCreditBalance Il numero di crediti CPU in eccesso spesi per sostenere le prestazioni della CPU quando il valore CPUCredit Balance è zero.
CPUSurplusCreditsCharged Il numero di crediti CPU in eccesso che supera il numero massimo di crediti CPU ottenibili in un periodo di 24 ore, con conseguente addebito di un costo aggiuntivo. Per ulteriori informazioni, consulta Monitoraggio dei crediti della CPU.

Visualizzazione CloudWatch dei dati

Puoi visualizzare CloudWatch i dati Amazon utilizzando la CloudWatch console, la console Amazon DocumentDB, AWS Command Line Interface (AWS CLI) o l' CloudWatch API.

Using the AWS Management Console

Per visualizzare i CloudWatch parametri utilizzando la console di gestione Amazon DocumentDB, completa i seguenti passaggi.

  1. Accedi a e apri AWS Management Console la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.

  2. Nel pannello di navigazione scegliere Clusters (Cluster).

    Suggerimento

    Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (Hamburger menu icon with three horizontal lines.) nell'angolo in alto a sinistra della pagina.

  3. Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier. Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente.

    DocumentDB clusters list showing two clusters with their identifiers and roles.
  4. Dall'elenco delle istanze, scegli il nome dell'istanza per cui desideri le metriche.

  5. Nella pagina di riepilogo dell'istanza risultante, scegli la scheda Monitoraggio per visualizzare le rappresentazioni grafiche dei parametri dell'istanza Amazon DocumentDB. Poiché è necessario generare un grafico per ogni metrica, la compilazione dei grafici potrebbe richiedere alcuni minuti. CloudWatch

    L'immagine seguente mostra le rappresentazioni grafiche di due CloudWatch parametri nella console Amazon DocumentDB e. WriteIOPS ReadIOPS

    Due delle 18 CloudWatch metriche della console Amazon DocumentDB, writeiops e readiops.
Using the CloudWatch Management Console

Per visualizzare le CloudWatch metriche utilizzando la console di CloudWatch gestione, completa i seguenti passaggi.

  1. Accedi a e apri AWS Management Console la console Amazon DocumentDB all'indirizzo. https://console.aws.amazon.com/cloudwatch

  2. Nel riquadro di navigazione, seleziona Parametri. Quindi, dall'elenco dei nomi di servizio, scegli DocDB.

  3. Scegli una dimensione metrica (ad esempio, Cluster Metrics).

  4. La scheda Tutte le metriche mostra tutte le metriche per quella dimensione in DocDB.

    1. Per ordinare la tabella, utilizza l'intestazione della colonna.

    2. Per creare il grafico di un parametro, seleziona la casella di controllo accanto al parametro. Per selezionare tutte i parametri, seleziona la casella di controllo nella riga dell'intestazione della tabella.

    3. Per filtrare per metrica, passa il mouse sul nome della metrica e seleziona la freccia a discesa accanto al nome della metrica. Quindi, scegli Aggiungi alla ricerca, come mostrato nell'immagine qui sotto.

      Filtra in base a una metrica passando il mouse sulla metrica e selezionando «Aggiungi alla ricerca».
Using the AWS CLI

Per visualizzare CloudWatch i dati per Amazon DocumentDB, utilizza l' CloudWatch get-metric-statisticsoperazione con i seguenti parametri.

Parametri
  • --namespace: obbligatorio. Lo spazio dei nomi del servizio di cui desideri visualizzare i parametri CloudWatch . Per Amazon DocumentDB, questo deve essere. AWS/DocDB

  • --metric-name: obbligatorio. Il nome della metrica per la quale desideri i dati.

  • --start-time: obbligatorio. Il timestamp che determina il primo punto dati da restituire.

    Il valore specificato è inclusivo. I risultati comprendono i punti dati con il timestamp specificato. Il timestamp deve essere in formato UTC ISO 8601, ad esempio 2016-10-03T23:00:00Z.

  • --end-time: obbligatorio. Il timestamp che determina l'ultimo punto dati da restituire.

    Il valore specificato è inclusivo. I risultati comprendono i punti dati con il timestamp specificato. Il timestamp deve essere in formato UTC ISO 8601, ad esempio 2016-10-03T23:00:00Z.

  • --period: obbligatorio. La granularità, in secondi, per i punti dati restituiti. Per i parametri con una risoluzione regolare, un periodo può avere un valore minimo di un minuto (60 secondi) e deve essere un multiplo di 60. Per i parametri ad alta risoluzione raccolti a intervalli inferiori al minuto, il periodo può essere 1, 5, 10, 30, 60 o qualsiasi multiplo di 60.

  • --dimensions— Facoltativo. Se la metrica contiene più dimensioni, è necessario includere un valore per ogni dimensione. CloudWatch considera ogni combinazione unica di dimensioni come una metrica separata. Se una specifica combinazione di dimensioni non è stata pubblicata, non puoi recuperare le statistiche associate. Occorre specificare le stesse dimensioni utilizzate al momento della creazione dei parametri.

  • --statistics— Facoltativo. Le statistiche dei parametri diverse dai percentili. Per le statistiche dei percentili, utilizzare ExtendedStatistics. Quando chiami GetMetricStatistics, devi specificare Statistics o ExtendedStatistics, ma non entrambi.

    Valori consentiti:
    • SampleCount

    • Average

    • Sum

    • Minimum

    • Maximum

  • --extended-statistics— Facoltativo. Le statistiche percentile. Specifica valori compresi tra p0.0 e p100. Quando chiami GetMetricStatistics, devi specificare Statistics o ExtendedStatistics, ma non entrambi.

  • --unit— Facoltativo. L'unità per un determinato parametro. I parametri possono essere riportati con più unità. Se non specifichi un'unità, vengono restituite tutte le unità. Se specifichi solo un'unità che il parametro non supporta, i risultati della chiamata sono nulli.

    Valori possibili:
    • 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

L'esempio seguente rileva il valore massimo di CPUUtilization per un periodo di 2 ore, durante il quale viene estratto un campione ogni 60 secondi.

Per Linux, macOS o 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

Per 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

L'aspetto dell'output di questa operazione è simile al seguente.

{ "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" } ] }

Dimensioni di Amazon DocumentDB

Le metriche per Amazon DocumentDB sono qualificate in base ai valori dell'account o dell'operazione. Puoi utilizzare la CloudWatch console per recuperare i dati di Amazon DocumentDB filtrati in base a una qualsiasi delle dimensioni nella tabella seguente.

Dimensione Descrizione
DBClusterIdentifier Filtra i dati richiesti per uno specifico cluster Amazon DocumentDB.
DBClusterIdentifier, Role Filtra i dati richiesti per uno specifico cluster Amazon DocumentDB, aggregando la metrica per ruolo di istanza (WRITER/READER). Ad esempio, puoi aggregare i parametri per tutte le istanze READER che appartengono a un cluster.
DBInstanceIdentifier Filtra i dati richiesti per un'istanza database specifica.

Monitoraggio delle metriche di Opcounter

Le metriche di Opcounter hanno un valore diverso da zero (di solito ~50) per i cluster inattivi. Questo perché Amazon DocumentDB esegue controlli periodici dello stato, operazioni interne e attività di raccolta dei parametri.

Monitoraggio delle connessioni al database

Quando si visualizza il numero di connessioni utilizzando i comandi del motore di database, ad esempiodb.runCommand( { serverStatus: 1 }), è possibile che vengano visualizzate fino a 10 connessioni in più rispetto a quelle visualizzate nella DatabaseConnections pagina CloudWatch. Ciò si verifica perché Amazon DocumentDB esegue controlli periodici dello stato di salute e attività di raccolta delle metriche che non vengono prese in considerazione. DatabaseConnections DatabaseConnectionsrappresenta solo connessioni avviate dal cliente.