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
Il monitoraggio AWS dei servizi è una parte importante per mantenere i sistemi integri e funzionanti in modo ottimale. È consigliabile raccogliere i dati di monitoraggio da tutte le parti della AWS soluzione in modo da poter eseguire più facilmente il debug e correggere eventuali guasti o deterioramenti. Prima di iniziare a monitorare le AWS soluzioni, ti consigliamo di prendere in considerazione e formulare risposte alle seguenti domande:
+ Quali sono gli obiettivi del monitoraggio?
+ Quali risorse verranno monitorate?
+ Con quale frequenza eseguirai il monitoraggio di queste risorse?
+ Quali strumenti di monitoraggio verranno utilizzati?
+ Chi è il responsabile del monitoraggio?
+ In caso di errore, a chi vanno inviate le notifiche e con quale modalità?
Per comprendere i tuoi modelli attuali relativi alle prestazioni, identificare le anomalie e formulare metodi per risolvere i problemi, è opportuno stabilire dei parametri di base per le prestazioni da applicare in momenti diversi e con diverse condizioni di carico. Durante il monitoraggio della AWS soluzione, si consiglia di archiviare i dati di monitoraggio storici per riferimenti futuri e per stabilire le proprie linee di base.
In generale, i valori accettabili per i parametri di prestazione dipendono dalla baseline e da cosa sta facendo l'applicazione. Indagare le variazioni della baseline coerenti o che rappresentano dei trend. Di seguito sono riportati alcuni suggerimenti su tipi di parametri specifici:
+ **Utilizzo elevato di CPU o RAM**: potrebbero essere appropriati valori elevati per l'utilizzo di CPU o RAM, a condizione che siano in linea con gli obiettivi dell'applicazione (ad esempio velocità effettiva o concorrenza) e siano previsti.
+ **Consumo del volume di** archiviazione: verifica il consumo di storage (`VolumeBytesUsed`) se lo spazio utilizzato è costantemente pari o superiore all'85% dello spazio totale del volume di archiviazione. Verifica se puoi eliminare dati dal volume di archiviazione o archiviare dati su un sistema diverso per liberare spazio. Per ulteriori informazioni, consultare [Archiviazione Amazon DocumentDB](how-it-works.md#how-it-works.storage) e [Quote e limiti di Amazon DocumentDB](limits.md).
+ **Traffico** di rete: per quanto riguarda il traffico di rete, contatta l'amministratore di sistema per capire qual è il throughput previsto per la rete di dominio e la connessione Internet. Indaga il traffico di rete se il throughput è costantemente al di sotto del valore previsto.
+ **Connessioni al database**: valuta la possibilità di limitare le connessioni al database se riscontri un numero elevato di connessioni utente e un calo delle prestazioni dell'istanza e dei tempi di risposta. Il numero ideale di connessioni utente per l'istanza dipende dalla classe di istanza e dalla complessità delle operazioni eseguite.
+ **Metriche IOPS**: i valori previsti per le metriche IOPS dipendono dalle specifiche del disco e dalla configurazione del server, quindi utilizza la linea di base per conoscere le caratteristiche tipiche. Verifica se i valori effettivi sono costantemente diversi rispetto a quelli di riferimento. Per prestazioni IOPS ottimali, verifica che il working set tipico possa essere caricato nella memoria per ridurre al minimo le operazioni di lettura e scrittura.
Amazon DocumentDB (con compatibilità con MongoDB) offre una varietà di CloudWatch parametri Amazon che puoi monitorare per determinare lo stato e le prestazioni dei cluster e delle istanze di Amazon DocumentDB. Puoi visualizzare i parametri di Amazon DocumentDB utilizzando vari strumenti, tra cui la console Amazon DocumentDB, l'API CloudWatch e Performance AWS CLI Insights.
**Topics**
+ [Monitoraggio dello stato di un cluster](monitoring_docdb-cluster_status.md)
+ [Monitoraggio dello stato di un'istanza](monitoring_docdb-instance_status.md)
+ [Visualizzazione dei consigli di Amazon DocumentDB](view-docdb-recommendations.md)
+ [Abbonamenti a eventi](event-subscriptions.md)
+ [Monitoraggio di Amazon DocumentDB con CloudWatch](cloud_watch.md)
+ [Registrazione delle chiamate API di Amazon DocumentDB con CloudTrail](logging-with-cloudtrail.md)
+ [Operazioni di profilazione](profiling.md)
+ [Monitoraggio con Performance Insights](performance-insights.md)
# Monitoraggio dello stato di un cluster Amazon DocumentDB
Lo stato di un cluster ne indica l'integrità. Puoi visualizzare lo stato di un cluster utilizzando la console Amazon DocumentDB o il AWS CLI `describe-db-clusters` comando.
**Topics**
+ [Valori dello stato del cluster](#monitoring_docdb-status_values)
+ [Monitoraggio dello stato di un cluster](#monitor-cluster-status)
## Valori dello stato del cluster
Nella tabella seguente sono elencati i valori validi per lo stato di un cluster.
| Stato del cluster | Description |
| --- | --- |
| active | Il cluster è attivo. Questo stato si applica solo ai cluster elastici. |
| available | Il cluster è integro e disponibile. Questo stato si applica solo ai cluster basati su istanze. |
| backing-up | Il cluster è attualmente sottoposto a backup. |
| creating | Il cluster è in fase di creazione. L'accesso durante la creazione non è consentito. |
| deleting | Il cluster è in fase di eliminazione. L'accesso durante l'eliminazione non è consentito. |
| failing-over | Viene eseguito un failover dall'istanza principale a una replica di Amazon DocumentDB. |
| inaccessible-encryption-credentials | Non è AWS KMS possibile accedere alla chiave utilizzata per crittografare o decrittografare il cluster. |
| maintenance | È in corso l'applicazione di un aggiornamento di manutenzione al cluster. Questo stato viene utilizzato per la manutenzione a livello di cluster che Amazon DocumentDB pianifica con largo anticipo. |
| migrating | Una snapshot del cluster è stata ripristinata in un cluster. |
| migration-failed | Una migrazione non è riuscita. |
| modifying | È in corso la modifica del cluster in seguito alla richiesta da parte di un cliente. |
| renaming | È in corso la ridenominazione del cluster in seguito alla richiesta da parte di un cliente. |
| resetting-master-credentials | È in corso il ripristino delle credenziali master del cluster in seguito alla richiesta da parte di un cliente. |
| upgrading | La versione del motore del cluster è in fase di aggiornamento. |
## Monitoraggio dello stato di un cluster
------
#### [ Using the Console di gestione AWS ]
Quando si utilizza Console di gestione AWS per determinare lo stato di un cluster, utilizzare la procedura seguente.
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Cluster**.
1. **Nella casella di navigazione Clusters, vedrai la colonna Cluster identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente.
![\[Tabella dei cluster che mostra come un'istanza viene annidata in un cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png)
1. Nella colonna **Identificatore del cluster**, trova il nome dell'istanza che ti interessa. Quindi, per trovare lo stato dell'istanza, leggi in quella riga fino alla colonna **Status**, come mostrato di seguito.
![\[Istanza del cluster che mostra lo stato disponibile.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-status-con.png)
------
#### [ Using the AWS CLI ]
Quando si utilizza il AWS CLI per determinare lo stato di un cluster, utilizzare l'`describe-db-clusters`operazione. Il codice seguente individua lo stato del cluster `sample-cluster`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Per Windows:
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
[
"sample-cluster",
"available"
]
]
```
------
# Monitoraggio dello stato di un'istanza Amazon DocumentDB
Amazon DocumentDB fornisce informazioni sulla condizione corrente di ogni istanza configurata nel database.
Esistono tre tipi di stato che è possibile visualizzare per un'istanza Amazon DocumentDB:
+ Stato dell'istanza: questo stato è mostrato nella colonna **Status** della tabella del cluster Console di gestione AWS e mostra le condizioni correnti del ciclo di vita dell'istanza. I valori mostrati nella colonna **Status** derivano dal `Status` campo della risposta `DescribeDBCluster` API.
+ Stato di integrità dell'istanza: questo stato è mostrato nella colonna Stato dell'**istanza** della tabella del cluster Console di gestione AWS e mostra se il motore di database, il componente responsabile della gestione e del recupero dei dati, è in esecuzione. I valori mostrati nella colonna **Instance Health** si basano sulla metrica CloudWatch `EngineUptime` del sistema Amazon.
+ Stato di manutenzione: questo stato è mostrato nella colonna **Manutenzione** della tabella del cluster Console di gestione AWS e indica lo stato di qualsiasi evento di manutenzione che deve essere applicato a un'istanza. Lo stato di manutenzione è indipendente dallo stato delle altre istanze e deriva dall'`PendingMaintenanceAction`API. Per ulteriori informazioni sullo stato della manutenzione, consulta Maintenance [Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html).
**Topics**
+ [Valori di stato delle istanze](#monitoring_docdb-instance_status-values)
+ [Monitoraggio dello stato dell'istanza utilizzando o Console di gestione AWS AWS CLI](#monitoring-instance-status)
+ [Valori dello stato di integrità dell'istanza](#instance-health-status-values)
+ [Monitoraggio dello stato di integrità dell'istanza utilizzando il Console di gestione AWS](#monitoring-instance-health-status)
## Valori di stato delle istanze
Nella tabella seguente sono elencati i possibili valori di stato per le istanze e la modalità di fatturazione per ogni stato. Viene inoltre indicato se è prevista la fatturazione per l'istanza e lo storage, solo per lo storage oppure se la fatturazione non è prevista. Per tutti gli stati delle istanze, l'utilizzo del backup viene inserito in fattura.
| stato dell’istanza | Fatturato | Description |
| --- | --- | --- |
| available | Fatturato | L'istanza è integra e disponibile. |
| backing-up | Fatturato | L'istanza è attualmente sottoposta a backup. |
| configuring-log-exports | Fatturato | La pubblicazione dei file di registro su Amazon CloudWatch Logs è abilitata o disabilitata per questa istanza. |
| creating | Non fatturato | L'istanza è in fase di creazione. Non è possibile accedere all'istanza mentre è in fase di creazione. |
| deleting | Non fatturato | L'istanza è in fase di eliminazione. |
| failed | Non fatturato | L'istanza ha avuto esito negativo e Amazon DocumentDB non è stato in grado di ripristinarla. Per ripristinare i dati, esegui un point-in-time ripristino all'ora di ripristino più recente dell'istanza. |
| inaccessible-encryption-credentials | Non fatturato | Non è stato possibile accedere alla AWS KMS chiave utilizzata per crittografare o decrittografare l'istanza. |
| incompatible-network | Non fatturato | Amazon DocumentDB sta tentando di eseguire un'azione di ripristino su un'istanza, ma non è in grado di farlo perché il VPC si trova in uno stato che impedisce il completamento dell'azione. Questo stato può verificarsi se, ad esempio, tutti gli indirizzi IP disponibili in una sottorete erano in uso e Amazon DocumentDB non è in grado di ottenere un indirizzo IP per l'istanza. |
| maintenance | Fatturato | Amazon DocumentDB sta applicando un aggiornamento di manutenzione all'istanza. Questo stato viene utilizzato per la manutenzione a livello di istanza che Amazon DocumentDB pianifica con largo anticipo. Stiamo valutando nuovi modi per fornire altre operazioni di manutenzione ai clienti attraverso questo stato. |
| modifying | Fatturato | È in corso la modifica dell'istanza in seguito a una richiesta di eseguire tale operazione. |
| rebooting | Fatturato | L'istanza viene riavviata a causa di una richiesta o di un processo Amazon DocumentDB che richiede il riavvio dell'istanza. |
| renaming | Fatturato | È in corso la ridenominazione dell'istanza in seguito a una richiesta di eseguire tale operazione. |
| resetting-master-credentials | Fatturato | È in corso il ripristino delle credenziali master dell'istanza in seguito a una richiesta di eseguire tale operazione. |
| restore-error | Fatturato | L'istanza ha riscontrato un errore nel tentativo di ripristinare uno snapshot o da uno snapshot. point-in-time |
| starting | Fatturato per storage | L'istanza è in fase di avvio. |
| stopped | Fatturato per storage | L'istanza è stata arrestata. |
| stopping | Fatturato per storage | L'istanza è in fase di arresto. |
| storage-full | Fatturato | L'istanza ha raggiunto la capacità di storage allocata. Si tratta di uno stato critico che richiede l'immediata risoluzione del problema; dimensionare la capacità di storage modificando l'istanza. Imposta gli CloudWatch allarmi di Amazon per avvisarti quando lo spazio di archiviazione si sta esaurendo in modo da non incorrere in questa situazione. |
## Monitoraggio dello stato dell'istanza utilizzando o Console di gestione AWS AWS CLI
Usa Console di gestione AWS o AWS CLI per monitorare lo stato della tua istanza.
------
#### [ Using the Console di gestione AWS ]
Quando si utilizza il Console di gestione AWS per determinare lo stato di un cluster, utilizzare la procedura seguente.
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Cluster**.
**Nota**
Tieni presente che nella casella di navigazione Cluster, la colonna **Cluster identifier mostra sia i cluster** che le istanze. Le istanze sono elencate sotto i cluster, in modo simile all'immagine seguente.
![\[Elenco di cluster e istanze nella pagina Cluster della console Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/clusters.png)
1. Trova il nome dell'istanza che ti interessa. Quindi, per trovare lo stato dell'istanza, leggi la riga in corrispondenza della colonna **Status (Stato)**, come illustrato di seguito.
![\[Colonna di stato che mostra lo stato disponibile per i cluster e le istanze nella pagina Cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/instance-status.png)
------
#### [ Using the AWS CLI ]
Quando si utilizza AWS CLI per determinare lo stato di un cluster, utilizzare l'operazione. `describe-db-instances` Il codice seguente individua lo stato dell'istanza `sample-cluster-instance-01`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance-01 \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'
```
Per Windows:
```
aws docdb describe-db-instances ^
--db-instance-identifier sample-cluster-instance-01 ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
[
"sample-cluster-instance-01",
"available"
]
]
```
------
## Valori dello stato di integrità dell'istanza
La tabella seguente elenca i possibili valori dello stato di integrità per le istanze. La colonna **Instance Health**, situata nella tabella **Clusters** di Console di gestione AWS, mostra se il motore di database, il componente responsabile dell'archiviazione, della gestione e del recupero dei dati, funziona normalmente. Questa colonna indica anche se la metrica di `EngineUptime` sistema, disponibile in CloudWatch, mostra lo stato di integrità di ogni istanza.
| Stato di integrità dell'istanza | Description |
| --- | --- |
| integro | Il motore di database è in esecuzione nell'istanza Amazon DocumentDB. |
| malsano | Il motore del database non è in esecuzione o è stato riavviato meno di un minuto fa. |
## Monitoraggio dello stato di integrità dell'istanza utilizzando il Console di gestione AWS
Utilizza il Console di gestione AWS per monitorare lo stato di integrità della tua istanza.
Durante l'utilizzo Console di gestione AWS, utilizza i seguenti passaggi per comprendere lo stato di integrità dell'istanza.
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Cluster**.
**Nota**
Nella casella di navigazione **Cluster**, la colonna **Cluster identifier mostra sia i cluster** che le istanze. Le istanze sono elencate sotto i cluster, in modo simile all'immagine seguente.
![\[Elenco di cluster e istanze nella pagina Cluster della console Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/clusters.png)
1. Trova il nome dell'istanza che ti interessa. Quindi, per trovare lo stato dell'istanza, leggi dall'altra parte della riga fino alla colonna relativa **allo stato dell'istanza**, come mostrato nell'immagine seguente:
![\[Colonna di integrità dell'istanza che mostra gli stati integri e non integri per le istanze elencate nella pagina Cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/health-status-1.png)
**Nota**
Il polling sullo stato di integrità delle istanze viene eseguito ogni 60 secondi e si basa sulla metrica del sistema. CloudWatch `EngineUptime` I valori nella colonna **Instance Health** vengono aggiornati automaticamente.
# Visualizzazione dei consigli di Amazon DocumentDB
Amazon DocumentDB fornisce un elenco di consigli automatici per le risorse del database, come istanze e cluster. Questi consigli forniscono indicazioni sulle best practice analizzando le configurazioni di cluster e istanze.
Come esempio di questi consigli, consulta quanto segue:
| Tipo | Descrizione | Raccomandazione | Informazioni aggiuntive |
| --- | --- | --- | --- |
| Una istanza | Il cluster contiene solo un'istanza | Prestazioni e disponibilità: consigliamo di aggiungere un'altra istanza con la stessa classe di istanza in una zona di disponibilità diversa. | [Amazon DocumentDB Alta disponibilità e replica](https://docs.aws.amazon.com/documentdb/latest/developerguide/replication.html) |
Amazon DocumentDB genera consigli per una risorsa quando la risorsa viene creata o modificata. Amazon DocumentDB analizza inoltre periodicamente le tue risorse e genera consigli.
**Per visualizzare e agire in base ai consigli di Amazon DocumentDB**
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. **Nel riquadro di navigazione, scegli Consigli:**
![\[Pannello di navigazione della console Amazon DocumentDB con l'opzione Recommendations selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/recommendations-nav-1.png)
1. Nella finestra di dialogo **Consigli**, espandi la sezione di interesse e seleziona l'attività consigliata.
Nell'esempio seguente, l'attività consigliata si applica a un cluster Amazon DocumentDB con una sola istanza. Si consiglia di aggiungere un'altra istanza per migliorare le prestazioni e la disponibilità.
![\[Il modulo Consigli che mostra un'attività consigliata selezionata per un cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/recommendations-1.png)
1. Fai clic su **Applica ora**.
Per questo esempio, viene visualizzata la finestra di dialogo **Aggiungi istanze**:
![\[Il modulo Aggiungi istanze con opzioni per le impostazioni delle istanze.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/add-instances-1.png)
1. Modifica le impostazioni della nuova istanza e fai clic su **Crea**.
# Utilizzo delle sottoscrizioni agli eventi di Amazon DocumentDB
Amazon DocumentDB utilizza Amazon Simple Notification Service (Amazon SNS) per fornire notifiche quando si verifica un evento Amazon DocumentDB. Queste notifiche possono essere in qualsiasi forma supportata da Amazon SNS Regione AWS, ad esempio un'e-mail, un messaggio di testo o una chiamata a un endpoint HTTP.
Amazon DocumentDB raggruppa questi eventi in categorie a cui puoi abbonarti in modo da ricevere notifiche quando si verifica un evento in quella categoria. Puoi iscriverti a una categoria di eventi per un'istanza, un cluster, un'istantanea, un'istantanea del cluster o per un gruppo di parametri. Ad esempio, se ti iscrivi alla categoria Backup per una determinata istanza, ricevi una notifica ogni volta che si verifica un evento relativo al backup che influisce sull'istanza. Riceverai anche una notifica quando la sottoscrizione di un evento cambia.
Gli eventi si verificano sia a livello di cluster che a livello di istanza, quindi puoi riceverli se ti iscrivi a un cluster o a un'istanza.
Le sottoscrizioni agli eventi vengono inviate agli indirizzi forniti al momento della creazione dell'abbonamento. Potresti voler creare diversi abbonamenti, ad esempio un abbonamento che riceve tutte le notifiche degli eventi e un altro abbonamento che include solo eventi critici per le istanze di produzione. Puoi disattivare facilmente la notifica senza eliminare una sottoscrizione. A tale scopo, imposta il pulsante di **opzione Enabled** su **No** nella console Amazon DocumentDB.
**Importante**
Amazon DocumentDB non garantisce l'ordine degli eventi inviati in un flusso di eventi. Tale ordine è soggetto a modifiche.
Amazon DocumentDB utilizza l'Amazon Resource Name (ARN) di un argomento Amazon SNS per identificare ogni abbonamento. La console Amazon DocumentDB crea automaticamente l'ARN al momento della creazione dell'abbonamento.
La fatturazione per gli abbonamenti agli eventi Amazon DocumentDB avviene tramite Amazon SNS. L'uso della notifica degli eventi è soggetta alle tariffe di Amazon SNS. Per ulteriori informazioni, consulta Prezzi di Amazon Simple Notification Service. Oltre ai costi di Amazon SNS, Amazon DocumentDB non fattura gli abbonamenti agli eventi.
**Topics**
+ [Sottoscrizione agli eventi](event-subscriptions.subscribe.md)
+ [Gestione delle sottoscrizioni a](event-subscriptions.managing.md)
+ [Categorie e messaggi](event-subscriptions.categories-messages.md)
# Iscrizione agli eventi di Amazon DocumentDB
Puoi utilizzare la console Amazon DocumentDB per sottoscrivere sottoscrizioni a eventi, come segue:
1. Accedi all'indirizzo. Console di gestione AWS [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione selezionare **Event subscriptions (Sottoscrizioni di eventi)**.
![\[Pannello di navigazione della console Amazon DocumentDB con l'opzione Event Subscriptions evidenziata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/subscribe-event-subs.png)
1. Nel riquadro **Event subscriptions (Sottoscrizioni di eventi)** scegliere **Create event subscription (Crea sottoscrizione di eventi)**.
![\[Riquadro Sottoscrizioni agli eventi che evidenzia il pulsante Crea abbonamento agli eventi nell'angolo in alto a destra.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/subscribe-create.png)
1. Nella finestra di dialogo **Create event subscription (Crea sottoscrizione di eventi)**, seguire questa procedura:
+ Per **Name (Nome)**, immettere un nome per la sottoscrizione alle notifiche eventi.
![\[Il modulo di iscrizione per la creazione di un evento che mostra la sezione Dettagli e il campo di immissione del nome.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/subscribe-name.png)
+ Per **Target**, scegli a chi inviare le notifiche. Puoi scegliere un **ARN** esistente o scegliere **Nuovo argomento e-mail** per inserire il nome di un argomento e un elenco di destinatari.
![\[La sezione Target con opzioni per specificare a dove inviare le notifiche.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/subscribe-target.png)
+ Per **Sorgente**, scegli un tipo di fonte. A seconda del tipo di origine selezionato, scegliere le categorie di eventi e le origini da cui ricevere le notifiche eventi.
![\[La sezione Sorgente da cui selezionare un tipo di fonte da cui ricevere le notifiche degli eventi.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/subscribe-source.png)
+ Scegli **Create** (Crea).
![\[La sezione Sorgente con il pulsante Crea nell'angolo in basso a destra.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/subscribe-create-2.png)
# Gestione degli abbonamenti per le notifiche di eventi di Amazon DocumentDB
Se scegli **Abbonamenti a eventi** nel pannello di navigazione della console Amazon DocumentDB, puoi visualizzare le categorie di abbonamento e un elenco degli abbonamenti correnti. Puoi anche modificare o eliminare una sottoscrizione specifica.
## Per modificare gli attuali abbonamenti alle notifiche di eventi di Amazon DocumentDB
1. Accedi all'indirizzo. Console di gestione AWS [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione selezionare **Event subscriptions (Sottoscrizioni di eventi)**. Il riquadro **Event subscriptions (Sottoscrizioni di eventi)** mostra tutte le sottoscrizioni delle notifiche degli eventi.
![\[Pannello di navigazione della console Amazon DocumentDB con l'opzione Event Subscriptions evidenziata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/modify-event-subs.png)
1. Nel riquadro **Event subscriptions (Sottoscrizioni di eventi)** scegliere la sottoscrizione da modificare e selezionare **Edit (Modifica)**.
![\[Il riquadro Sottoscrizioni agli eventi che mostra un abbonamento selezionato e il pulsante Modifica.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/modify-edit.png)
1. Apportare le modifiche alla sottoscrizione nella sezione **Target (Destinazione)** o **Source (Origine)**. Puoi aggiungere o rimuovere gli identificatori di origine selezionandoli o deselezionandoli nella sezione Origine.
![\[Il modulo Modifica la sottoscrizione all'evento che evidenzia la sezione Target.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/modify-target.png)
1. Scegli **Modifica**. La console Amazon DocumentDB indica che l'abbonamento è in fase di modifica.
![\[La fine del modulo di iscrizione all'evento Modify con il pulsante Modifica evidenziato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/modify-button.png)
## Eliminazione di una sottoscrizione di notifica di eventi Amazon DocumentDB
Puoi eliminare un abbonamento quando questo non è più necessario. Tutti gli abbonati all'argomento non riceveranno più le notifiche di eventi specificate dall'abbonamento.
1. Accedi all'indirizzo. Console di gestione AWS [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione selezionare **Event subscriptions (Sottoscrizioni di eventi)**.
![\[Pannello di navigazione della console Amazon DocumentDB con l'opzione Event Subscriptions evidenziata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/delete-event-subs.png)
1. Nel riquadro **Sottoscrizione a eventi** scegliere la sottoscrizione che si vuole eliminare.
![\[Il riquadro Sottoscrizioni agli eventi che mostra un abbonamento selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/delete-select.png)
1. Scegli **Elimina**.
![\[Il riquadro Sottoscrizioni agli eventi che evidenzia il pulsante Elimina.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/delete-delete.png)
1. Apparirà una finestra pop-up che ti chiederà se desideri eliminare definitivamente questa notifica. Scegli **Elimina**.
![\[Una finestra di dialogo che conferma l'eliminazione della sottoscrizione all'evento con il pulsante Elimina evidenziato nell'angolo in basso a destra.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/event-subs/delete-delete-2.png)
# Categorie e messaggi di eventi di Amazon DocumentDB
Amazon DocumentDB genera un numero significativo di eventi in categorie a cui è possibile abbonarsi utilizzando la console. Ogni categoria si applica a un tipo di sorgente, che può essere un'istanza, un cluster, un'istantanea o un gruppo di parametri.
**Nota**
Amazon DocumentDB utilizza le definizioni di eventi Amazon RDS esistenti e. IDs
## Eventi Amazon DocumentDB provenienti da istanze
| Categoria | Description |
| --- | --- |
| availability | L'istanza è stata riavviata. |
| disponibilità | La chiusura dell'istanza. |
| modifica della configurazione | Applicazione della modifica a una classe di istanza. |
| modifica della configurazione | È stata completata l'applicazione della modifica a una classe di istanza. |
| modifica della configurazione | Reimposta le credenziali primarie. |
| creazione | Istanza creata. |
| eliminazione | Istanza eliminata |
| errore | L'istanza non è riuscita a causa di una configurazione incompatibile o di un problema di archiviazione sottostante. Inizia a point-in-time-restore per l'istanza. |
| notification | Istanza interrotta. |
| notification | Istanza avviata. |
| notification | L'istanza viene avviata a causa del superamento del tempo massimo consentito per l'interruzione. |
| recupero | Il ripristino dell'istanza è iniziato. La durata del recupero varia in funzione della quantità di dati da recuperare. |
| recupero | Il ripristino dell'istanza è completo. |
| applicazione di patch di sicurezza | L'aggiornamento del sistema operativo è disponibile per la tua istanza. Per informazioni sull'applicazione degli aggiornamenti, consulta [Maintaining Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html). |
## Eventi Amazon DocumentDB provenienti da un cluster
| Categoria | Description |
| --- | --- |
| creazione | Cluster creato |
| eliminazione | Cluster eliminato. |
| failover | Promuovere nuovamente le primarie precedenti. |
| failover | Failover sull'istanza completato. |
| failover | Failover avviato sull'istanza DB: %s |
| failover | È stato avviato il failover dello stesso tipo AZ sull'istanza DB: %s |
| failover | Avviato il failover cross AZ verso l'istanza DB: %s |
| manutenzione | Il cluster è stato patchato. |
| manutenzione | Il cluster di database è in uno stato che non può essere aggiornato: %s |
| notification | Il cluster si è fermato. |
| notification | Il cluster è iniziato. |
| notification | L'arresto del cluster non è riuscito. |
| notification | Il cluster viene avviato a causa del superamento del tempo massimo consentito per l'interruzione. |
| notification | Cluster rinominato da %s a %s. |
## Eventi Amazon DocumentDB provenienti da uno snapshot del cluster
La tabella seguente mostra la categoria di eventi e un elenco di eventi quando uno snapshot del cluster Amazon DocumentDB è il tipo di origine.
| Categoria | Description |
| --- | --- |
| backup | Creazione di uno snapshot del cluster manuale in corso. |
| backup | Snapshot del cluster manuale creato. |
| backup | Creazione snapshot cluster automatizzato. |
| backup | Snapshot di cluster automatizzato creato. |
## Eventi Amazon DocumentDB originati dal gruppo di parametri
Nella tabella seguente sono indicati la categoria di evento e un elenco di eventi quando il tipo di origine è un gruppo di parametri.
| Categoria | Description |
| --- | --- |
| modifica della configurazione | Parametro aggiornato da %s a %s con il metodo di applicazione %s |
# 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](https://docs.aws.amazon.com/cloudwatch/index.html).
**Topics**
+ [Metriche di Amazon DocumentDB](#cloud_watch-metrics_list)
+ [Visualizzazione CloudWatch dei dati](#cloud_watch-view_data)
+ [Dimensioni di Amazon DocumentDB](#cloud_watch-metrics_dimensions)
+ [Monitoraggio delle metriche di Opcounter](#cloud_watch-monitoring_opcounters)
+ [Monitoraggio delle connessioni al database](#cloud_watch-monitoring_connections)
## 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.
**Topics**
+ [Parametri di utilizzo delle risorse](#resource-utilization)
+ [Metriche di latenza](#latency-metrics)
+ [NVMe-metriche delle istanze supportate](#nvme-metrics)
+ [Metriche operative](#operations-metrics)
+ [Metriche di throughput](#throughput-metrics)
+ [Parametri del sistema](#system-metrics)
+ [Metriche delle istanze T3](#t3-instance-metrics)
### Parametri di utilizzo delle risorse
| Metrica | Description |
| --- | --- |
| BackupRetentionPeriodStorageUsed | La quantità totale di storage di backup in byte 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](https://aws.amazon.com//documentdb/pricing). 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](change_streams.md). |
| CPUUtilization | La percentuale di CPU utilizzata da un'istanza. |
| DatabaseConnections | Il numero di connessioni (attive e inattive) aperte su un'istanza eseguita con una frequenza di 1 minuto. |
| DatabaseConnectionsMax | Il numero massimo di connessioni al database aperte (attive e inattive) su un'istanza in un periodo di 1 minuto. |
| DatabaseConnectionsLimit | Il numero massimo di connessioni simultanee al database (attive e inattive) consentite su un'istanza in un dato momento. |
| DatabaseCursors | Il numero di cursori aperti su un'istanza acquisita con una frequenza di 1 minuto. |
| DatabaseCursorsMax | Il numero massimo di cursori aperti su un'istanza in un periodo di 1 minuto. |
| DatabaseCursorsLimit | Il numero massimo di cursori consentiti su un'istanza in un dato momento. |
| DatabaseCursorsTimedOut | Il numero di cursori scaduti in un periodo di 1 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. (Questo non si applica a DocumentDB Serverless.) |
| LowMemThrottleQueueDepth | La profondità della coda per le richieste che vengono limitate a causa della scarsa memoria disponibile occupata con una frequenza di 1 minuto. |
| LowMemThrottleMaxQueueDepth | La profondità massima di coda per le richieste che vengono limitate a causa della scarsa memoria disponibile in un periodo di 1 minuto. |
| LowMemNumOperationsThrottled | Il numero di richieste che vengono limitate a causa della scarsa memoria disponibile in un periodo di 1 minuto. |
| SnapshotStorageUsed | La quantità totale di storage di backup in byte consumata 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 byte 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 eseguita con una frequenza di 1 minuto. |
| TransactionsOpenMax | Il numero massimo di transazioni aperte su un'istanza in un periodo di 1 minuto. |
| TransactionsOpenLimit | Il numero massimo di transazioni simultanee consentite su un'istanza in un dato momento. |
| 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](https://aws.amazon.com//documentdb/pricing). |
### Metriche di latenza
| Metrica | Description |
| --- | --- |
| DBClusterReplicaLagMaximum | Il ritardo massimo, 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à media di tempo impiegata per operazione su disco. I/O |
| WriteLatency | Il tempo medio, in millisecondi, impiegato per operazione su disco. I/O |
### NVMe-metriche delle istanze supportate
| Metrica | Description |
| --- | --- |
| 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 I/O operazioni di lettura del disco su Ephemeral Storage. NVMe |
| ReadLatencyNVMeStorage | Il tempo medio impiegato per ogni I/O operazione di lettura del disco per Ephemeral Storage. NVMe |
| ReadThroughputNVMeStorage | Il numero medio di byte letti dal disco al secondo per Ephemeral Storage. NVMe |
| WriteIOPSNVMeStorage | Il numero medio di I/O operazioni di scrittura su disco su Ephemeral Storage. NVMe |
| WriteLatencyNVMeStorage | Il tempo medio impiegato per ogni I/O operazione 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
| Metrica | Description |
| --- | --- |
| DocumentsDeleted | Il numero di documenti eliminati in un periodo di 1 minuto. |
| DocumentsInserted | Il numero di documenti inseriti in un periodo di 1 minuto. |
| DocumentsReturned | Il numero di documenti restituiti in un periodo di 1 minuto. |
| DocumentsUpdated | Il numero di documenti aggiornati in un periodo di 1 minuto. |
| OpcountersCommand | Il numero di comandi emessi in un periodo di 1 minuto. |
| OpcountersDelete | Il numero di operazioni di eliminazione eseguite in un periodo di 1 minuto. |
| OpcountersGetmore | Il numero di getmore emessi in un periodo di 1 minuto. |
| OpcountersInsert | Il numero di operazioni di inserimento emesse in un periodo di 1 minuto. |
| OpcountersQuery | Il numero di interrogazioni emesse in un periodo di 1 minuto. |
| OpcountersUpdate | Il numero di operazioni di aggiornamento eseguite in un periodo di 1 minuto. |
| TransactionsStarted | Il numero di transazioni avviate su un'istanza in un periodo di 1 minuto. |
| TransactionsCommitted | Il numero di transazioni eseguite su un'istanza in un periodo di 1 minuto. |
| TransactionsAborted | Il numero di transazioni interrotte su un'istanza in un periodo di 1 minuto. |
| TTLDeletedDocuments | Il numero di documenti eliminati da TTLMonitor a in un periodo di 1 minuto. |
### Metriche di throughput
| Metrica | Description |
| --- | --- |
| 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 I/O operazioni di lettura del disco al secondo. Amazon DocumentDB riporta gli IOPS di lettura e scrittura separatamente e a intervalli di 1 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 | Il numero medio di I/O operazioni di lettura fatturate da un volume di cluster, riportato 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 | Il numero medio di I/O operazioni di scrittura fatturate da un volume di cluster, riportato 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 I/O operazioni 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
| Metrica | Description |
| --- | --- |
| AvailableMVCCIds | Un contatore che mostra il numero di operazioni di scrittura rimanenti disponibili prima di raggiungere lo zero. Quando questo contatore raggiunge lo zero, il cluster entrerà in modalità di sola lettura fino a quando non IDs verrà recuperato e riciclato. Il contatore diminuisce a ogni operazione di scrittura e aumenta man mano che la Garbage Collection ricicla il vecchio MVCC. IDs |
| BufferCacheHitRatio | La percentuale di richieste gestite dalla cache del buffer. |
| DiskQueueDepth | Il numero di I/O operazioni che attendono di essere scritte o lette dal disco. |
| 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. |
| LongestActiveGCRuntime | Durata in secondi del processo di raccolta dei rifiuti attivo più lungo. Si aggiorna ogni minuto e tiene traccia solo delle operazioni attive, esclusi i processi che vengono completati entro la finestra di un minuto. |
### Metriche delle istanze T3
| Metrica | Description |
| --- | --- |
| 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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-monitoring-cpu-credits.html). |
## 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 Console di gestione AWS ]
Per visualizzare i CloudWatch parametri utilizzando la console di gestione Amazon DocumentDB, completa i seguenti passaggi.
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **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.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente.
![\[Tabella dei cluster che mostra come un'istanza viene annidata in un cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png)
1. Dall'elenco delle istanze, scegli il nome dell'istanza per cui desideri le metriche.
1. 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 grafici a linee che rappresentano i parametri WriteIops e CloudWatch ReadiOps nella console Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cw-metrics-con.png)
------
#### [ Using the CloudWatch Management Console ]
Per visualizzare i CloudWatch parametri utilizzando la console di gestione, completa i seguenti passaggi CloudWatch .
1. Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo. [https://console.aws.amazon.com/cloudwatch](https://console.aws.amazon.com/cloudwatch)
1. Nel riquadro di navigazione, seleziona **Parametri**. Quindi, dall'elenco dei nomi di servizio, scegli **DocDB**.
1. Scegli una dimensione metrica (ad esempio, **Cluster Metrics**).
1. **La scheda **Tutte le metriche** mostra tutte le metriche per quella dimensione in DocDB.**
1. Per ordinare la tabella, utilizza l'intestazione della colonna.
1. 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.
1. 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.
![\[La scheda Tutte le metriche elenca le metriche, con un elenco a discesa visualizzato per il nome di una metrica.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cloudwatch-filter-metrics.png)
------
#### [ Using the AWS CLI ]
Per visualizzare CloudWatch i dati per Amazon DocumentDB, utilizza l' CloudWatch `get-metric-statistics`operazione con i seguenti parametri.
**Parameters**
+ **--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`
**Example**
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 | Description |
| --- | --- |
| 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 \$150) 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 visualizzi il numero di connessioni utilizzando comandi del motore di database come`db.runCommand( { serverStatus: 1 })`, ad esempio, potresti vedere fino a 10 connessioni in più rispetto a quelle visualizzate. `DatabaseConnections` 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` `DatabaseConnections`rappresenta solo connessioni avviate dal cliente.
# Registrazione delle chiamate API di Amazon DocumentDB con AWS CloudTrail
Amazon DocumentDB (con compatibilità con MongoDB) è integrato con AWS CloudTrail, un servizio che fornisce un registro delle azioni intraprese da utenti, ruoli o un servizio in AWS Amazon DocumentDB (con compatibilità MongoDB). CloudTrail acquisisce tutte le chiamate AWS CLI API per Amazon DocumentDB come eventi, incluse le chiamate dalla console Amazon DocumentDB e le chiamate di codice all'SDK Amazon DocumentDB. Se crei un trail, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per Amazon DocumentDB. **Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti sulla CloudTrail console nella cronologia degli eventi.** Utilizzando le informazioni raccolte da CloudTrail, puoi determinare la richiesta effettuata ad Amazon DocumentDB (compatibile con MongoDB), l'indirizzo IP da cui è stata effettuata la richiesta, chi ha effettuato la richiesta, quando è stata effettuata e altri dettagli.
**Importante**
Per alcune funzionalità di gestione, Amazon DocumentDB utilizza la tecnologia operativa condivisa con Amazon Relational Database Service (Amazon RDS). Le chiamate alla console e alle API di Amazon DocumentDB vengono registrate come chiamate effettuate all'API Amazon RDS. AWS CLI
[Per ulteriori informazioni AWS CloudTrail, consulta AWS CloudTrail la Guida per l'utente.](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)
## Informazioni su Amazon DocumentDB in CloudTrail
CloudTrail è abilitato sul tuo account al Account AWS momento della creazione dell'account. **Quando si verifica un'attività in Amazon DocumentDB (con compatibilità con MongoDB), tale attività viene registrata in un CloudTrail evento insieme ad altri AWS eventi di servizio nella cronologia degli eventi.** Puoi visualizzare, cercare e scaricare eventi recenti nel tuo. Account AWS Per ulteriori informazioni, consulta [Visualizzazione degli eventi con la cronologia degli CloudTrail eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Per una registrazione continua degli eventi nel tuo Account AWS, inclusi gli eventi per Amazon DocumentDB (con compatibilità con MongoDB), crea un trail. Un trail consente di CloudTrail inviare file di log a un bucket Amazon S3. Per impostazione predefinita, quando si crea un percorso nella console, questo sarà valido in tutte le Regioni AWS. Il percorso registra gli eventi di tutte le Regioni nella partizione AWS e distribuisce i file di log nel bucket Amazon S3 specificato. Inoltre, puoi configurare altri AWS servizi per analizzare ulteriormente e agire in base ai dati sugli eventi raccolti nei CloudTrail log. Per ulteriori informazioni, consulta gli argomenti seguenti nella *Guida per l'utente di AWS CloudTrail *:
+ [Panoramica della creazione di un trail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Servizi e integrazioni supportati](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configurazione delle notifiche Amazon SNS per CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Ricezione di file di CloudTrail registro da più regioni](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)
+ [Ricezione di file di CloudTrail registro da più account](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Ogni evento o voce di log include informazioni sull'utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue:
+ Se la richiesta è stata effettuata con credenziali utente o root.
+ Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee per un ruolo o un utente federato.
+ Se la richiesta è stata effettuata da un altro AWS servizio.
Per ulteriori informazioni, consulta [Elemento CloudTrail userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
# Profilazione delle operazioni di Amazon DocumentDB
Puoi utilizzare il profiler in Amazon DocumentDB (con compatibilità MongoDB) per registrare il tempo di esecuzione e i dettagli delle operazioni eseguite sul tuo cluster. Il profiler è utile per monitorare le operazioni più lente sul cluster per aiutare a migliorare le prestazioni delle singole query e le prestazioni complessive del cluster.
Per impostazione predefinita, la funzionalità profiler è disabilitata. Se abilitato, il profiler registra le operazioni che richiedono più tempo di un valore di soglia definito dal cliente (ad esempio, 100 ms) in Amazon Logs. CloudWatch I dettagli registrati includono il comando profilato, l'ora, il riepilogo del piano e i metadati del client. Dopo aver registrato le operazioni su CloudWatch Logs, puoi utilizzare CloudWatch Logs Insights per analizzare, monitorare e archiviare i dati di profilazione di Amazon DocumentDB. Le query comuni vengono fornite nella sezione [Domande comuni](#profiling.common-queries).
Se abilitato, il profiler utilizza risorse aggiuntive nel cluster. Ti consigliamo di iniziare con un valore di soglia elevato (ad esempio, 500 ms) e di ridurre gradualmente il valore per identificare le operazioni lente. Iniziare con un valore di soglia di 50 ms può causare problemi di prestazioni sul cluster per applicazioni a throughput elevato. Il profiler è abilitato a livello di cluster e funziona su tutte le istanze e i database di un cluster. Amazon DocumentDB registra le operazioni su Amazon CloudWatch Logs con la massima diligenza possibile.
Sebbene Amazon DocumentDB non imponga alcun costo aggiuntivo per abilitare il profiler, ti vengono addebitate le tariffe standard per l'utilizzo dei log. CloudWatch Per informazioni sui prezzi di CloudWatch Logs, consulta i [ CloudWatch prezzi di Amazon](https://aws.amazon.com/cloudwatch/pricing/).
**Topics**
+ [Operazioni supportate](#profiling.supported-commands)
+ [Limitazioni](#profiling.limitations)
+ [Abilitazione del profiler](#profiling.enable-profiling)
+ [Disabilitazione del profiler](#profiling.disable-profiling)
+ [Disabilitazione dell'esportazione dei log del profiler](#profiling.disabling-logs-export)
+ [Accesso ai log del profiler](#profiling.accessing)
+ [Domande comuni](#profiling.common-queries)
## Operazioni supportate
Il profiler Amazon DocumentDB supporta le seguenti operazioni:
+ `aggregate`
+ `count`
+ `delete`
+ `distinct`
+ `find` (OP\$1QUERY e comando)
+ `findAndModify`
+ `insert`
+ `update`
## Limitazioni
Lo slow query profiler è in grado di emettere i log del profiler solo se l'intero set di risultati della query può essere contenuto in un batch e se il set di risultati è inferiore a 16 MB (dimensione massima BSON). I set di risultati superiori a 16 MB vengono automaticamente suddivisi in più batch.
La maggior parte dei driver o delle shell può impostare una dimensione del batch predefinita piccola. È possibile specificare la dimensione del batch come parte della query. Per acquisire i log delle query lente, si consiglia di utilizzare un batch di dimensioni superiori a quelle del set di risultati previsto. Se non siete sicuri della dimensione del set di risultati o se questa varia, potete anche impostare la dimensione del batch su un numero elevato (ad esempio 100k).
Tuttavia, l'utilizzo di un batch di dimensioni maggiori significa che sarà necessario recuperare più risultati dal database prima di inviare una risposta al client. Per alcune domande, ciò potrebbe creare ritardi più lunghi prima di ottenere risultati. Se non si prevede di utilizzare l'intero set di risultati, è possibile che si spenda di più I/Os per elaborare la query e buttare via il risultato.
## Abilitazione del profiler Amazon DocumentDB
L'abilitazione del profiler su un cluster è un processo in tre fasi. Assicurati che tutti i passaggi siano stati completati, altrimenti i log di profilazione non verranno inviati a Logs. CloudWatch Il profiler è impostato a livello di cluster e viene eseguito su tutti i database e le istanze del cluster.
**Per abilitare il profiler su un cluster**
1. Poiché non puoi modificare un gruppo predefinito di parametri del cluster, assicurati di disporre di un gruppo personalizzato di parametri del cluster. Per ulteriori informazioni, consulta [Creazione di gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-create.md).
1. Utilizzando un gruppo di parametri personalizzato del cluster disponibile, modifica i seguenti parametri: `profiler`, `profiler_threshold_ms`, e `profiler_sampling_rate`. Per ulteriori informazioni, consulta [Modifica dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-modify.md).
1. Crea o modifica il cluster per utilizzare il gruppo di parametri del cluster personalizzato e per abilitare l'esportazione `profiler` dei log in Logs. CloudWatch
Le sezioni seguenti mostrano come implementare questi passaggi utilizzando Console di gestione AWS and the AWS Command Line Interface ().AWS CLI
------
#### [ Using the Console di gestione AWS ]
1. Prima di iniziare, crea un cluster Amazon DocumentDB e un gruppo di parametri cluster personalizzato se non ne hai già uno. Per ulteriori informazioni, consultare [Creazione di gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-create.md) e [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md).
1. Utilizzando un gruppo personalizzato di parametri del cluster disponibile, modifica i parametri seguenti. Per ulteriori informazioni, consulta [Modifica dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-modify.md).
+ `profiler`— Abilita o disabilita la profilazione delle query. I valori consentiti sono `enabled ` e `disabled`. Il valore predefinito è `disabled`. Per abilitare il profiling, impostare il valore su `enabled`.
+ `profiler_threshold_ms`— Quando `profiler` è impostato su`enabled`, ` profiler_threshold_ms` vengono registrati tutti i comandi che richiedono più tempo del previsto. CloudWatch I valori consentiti sono `[50-INT_MAX]`. Il valore predefinito è `100`.
+ `profiler_sampling_rate`— La frazione di operazioni lente che devono essere profilate o registrate. I valori consentiti sono `[0.0-1.0]`. Il valore predefinito è `1.0`.
1. Modifica il cluster per utilizzare il gruppo di parametri del cluster personalizzato e imposta le esportazioni dei log del profiler per la pubblicazione su Amazon CloudWatch.
1. Nel riquadro di navigazione scegliere **Clusters (Cluster)** per aggiungere il nuovo gruppo di parametri personalizzato a un cluster.
1. Scegliere il pulsante a sinistra del nome del cluster a cui si desidera associare il gruppo di parametri. Selezionare **Actions (Operazioni)**, quindi **Modify (Modifica)** per modificare il cluster.
1. In **Cluster options (Opzioni cluster)**, scegliere il gruppo di parametri personalizzato dal passaggio precedente per aggiungerlo al cluster.
1. In **Esportazioni di log**, seleziona **i log di Profiler** da pubblicare su Amazon. CloudWatch
1. Scegliere **Continue (Continua)** per visualizzare un riepilogo delle modifiche.
1. Dopo aver verificato le modifiche, è possibile applicarle immediatamente o durante la successiva finestra di manutenzione in **Scheduling of modifications (Pianificazione delle modifiche)**.
1. Scegliere **Modify cluster (Modifica cluster)** per aggiornare il cluster con il nuovo gruppo di parametri.
------
#### [ Using the AWS CLI ]
La procedura seguente abilita il profiler su tutte le operazioni supportate per il cluster `sample-cluster`.
1. Prima di iniziare, assicurati di avere un gruppo di parametri del cluster personalizzati disponibile eseguendo il comando seguente e verificando che l'output di un gruppo di parametri del cluster non abbia `default` nel nome e che abbia `docdb3.6` come famiglia del gruppi di parametri. Se non disponi di un gruppo di parametri cluster non predefinito, consulta [Creazione di gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups-create.md).
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName,DBParameterGroupFamily]'
```
Nel seguente output, solo `sample-parameter-group ` soddisfa entrambi i criteri.
```
[
[
"default.docdb3.6",
"docdb3.6"
],
[
"sample-parameter-group",
"docdb3.6"
]
]
```
1. Utilizzando il gruppo personalizzato di parametri del cluster, modifica i parametri seguenti:
+ `profiler`— Abilita o disabilita la profilazione delle query. I valori consentiti sono `enabled ` e `disabled`. Il valore predefinito è `disabled`. Per abilitare il profiling, impostare il valore su `enabled`.
+ `profiler_threshold_ms`— Quando `profiler` è impostato su`enabled`, tutti i comandi richiedono più tempo di quello a `profiler_threshold_ms` cui sono stati registrati. CloudWatch I valori consentiti sono `[50-INT_MAX]`. Il valore predefinito è `100`.
+ `profiler_sampling_rate`— La frazione di operazioni lente che devono essere profilate o registrate. I valori consentiti sono `[0.0-1.0]`. Il valore predefinito è `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. Modifica il tuo cluster Amazon DocumentDB in modo che utilizzi il gruppo di parametri del cluster `sample-parameter-group` personalizzato del passaggio precedente e imposti il parametro `--enable-cloudwatch-logs-exports` su. `profiler`
Il codice seguente modifica il cluster in `sample-cluster` modo che utilizzi quello del `sample-parameter-group` passaggio precedente e lo aggiunge `profiler` alle esportazioni di CloudWatch Logs abilitate.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--db-cluster-parameter-group-name sample-parameter-group \
--cloudwatch-logs-export-configuration '{"EnableLogTypes":["profiler"]}'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"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
}
}
```
------
## Disattivazione del profiler Amazon DocumentDB
Per disabilitare il profiler, si disabilitano sia il `profiler` parametro che l'esportazione dei `profiler` log in Logs. CloudWatch
### Disabilitazione del profiler
È possibile disabilitare il `profiler` parametro utilizzando Console di gestione AWS o AWS CLI, come segue.
------
#### [ Using the Console di gestione AWS ]
La procedura seguente utilizza Console di gestione AWS per disabilitare Amazon DocumentDB`profiler`.
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel riquadro di navigazione scegliere **Parameter groups (Gruppi di parametri)**. Scegliere quindi il nome del gruppo di parametri del cluster su cui si desidera disabilitare il profiler.
1. Nella pagina **Cluster parameters (Parametri cluster) ** risultante, selezionare il pulsante a sinistra del parametro `profiler` e scegliere **Edit (Modifica)**.
1. Nella finestra di dialogo **Modify profiler (Modifica profiler)**, scegliere `disabled` nell'elenco.
1. Scegliere **Modify cluster parameter (Modifica parametro cluster)**.
------
#### [ Using the AWS CLI ]
Per disabilitare `profiler` su un cluster utilizzando l' AWS CLI, modificare il cluster come segue.
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters ParameterName=profiler,ParameterValue=disabled,ApplyMethod=immediate
```
------
## Disabilitazione dell'esportazione dei log del profiler
È possibile disabilitare l'esportazione dei `profiler` log in CloudWatch Logs utilizzando o, come segue. Console di gestione AWS AWS CLI
------
#### [ Using the Console di gestione AWS ]
La procedura seguente utilizza Console di gestione AWS per disabilitare l'esportazione dei log in Amazon DocumentDB in. CloudWatch
1. [Apri la console Amazon DocumentDB in https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Cluster**. Scegliere il pulsante a sinistra del nome del cluster per il quale si desidera disabilitare l'esportazione dei log.
1. Nel menu **Actions (Operazioni)** selezionare **Modify (Modifica)**.
1. Scorrere verso il basso fino alla sezione **Log exports (Esportazioni log)** e deselezionare **Profiler logs (Log del profiler)**.
1. Scegli **Continua**.
1. Esaminare le modifiche, quindi scegliere quando applicare la modifica al cluster.
+ **Apply during the next scheduled maintenance window (Applica durante la prossima finestra di manutenzione pianificata)**
+ **Apply immediately (Applica immediatamente)**
1. Scegliere **Modify cluster (Modifica cluster)**.
------
#### [ Using the AWS CLI ]
Il codice seguente modifica il cluster `sample-cluster ` e disabilita i log del profiler. CloudWatch
**Example**
Per Linux, macOS o Unix:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--cloudwatch-logs-export-configuration '{"DisableLogTypes":["profiler"]}'
```
Per Windows:
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--cloudwatch-logs-export-configuration '{"DisableLogTypes":["profiler"]}'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"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
}
}
```
------
## Accesso ai log del profiler di Amazon DocumentDB
Segui questi passaggi per accedere ai log del tuo profilo su Amazon CloudWatch.
1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Assicurati di trovarti nella stessa regione del cluster Amazon DocumentDB.
1. Nel riquadro di navigazione scegli **Logs (Log)**.
1. Per trovare i log del profiler per il cluster, nell'elenco scegliere `/aws/docdb/yourClusterName/profiler`.
I log del profiler per ogni istanza sono disponibili nei rispettivi nomi di istanza.
## Domande comuni
Di seguito sono riportate alcune query comuni che è possibile utilizzare per analizzare i comandi profilati. [Per ulteriori informazioni su CloudWatch Logs Insights, vedere [Analisi dei dati di registro con CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) e Query di esempio.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax-examples.html)
### Ottieni le 10 operazioni più lente su una raccolta specificata
```
filter ns="test.foo" | sort millis desc | limit 10
```
### Ottieni tutte le operazioni di aggiornamento su una raccolta che ha richiesto più di 60 ms
```
filter millis > 60 and op = "update"
```
### Ottieni le 10 operazioni più lente dell'ultimo mese
```
sort millis desc | limit 10
```
### Ottenere tutte le query con un riepilogo del piano COLLSCAN
```
filter planSummary="COLLSCAN"
```
# Monitoraggio con Performance Insights
Performance Insights si aggiunge alle funzionalità di monitoraggio esistenti di Amazon DocumentDB per illustrare le prestazioni del cluster e aiutarti ad analizzare eventuali problemi che lo riguardano. Con la dashboard Performance Insights, puoi visualizzare il carico del database e filtrarlo per attese, istruzioni di query, host o applicazioni.
**Nota**
Performance Insights è disponibile solo per i cluster basati su istanze Amazon DocumentDB 3.6, 4.0, 5.0 e 8.0.
**In che modo è utile?**
+ Visualizza le prestazioni del database: visualizza il carico per determinare quando e dove si trova il carico sul database
+ Determina la causa del carico sul database: determina quali query, host e applicazioni stanno contribuendo al carico sull'istanza
+ Determina quando c'è carico sul tuo database: ingrandisci la dashboard di Performance Insights per concentrarti su eventi specifici o rimpicciolisci per esaminare le tendenze in un arco di tempo più ampio
+ Avviso sul caricamento del database: accedi automaticamente alle nuove metriche di carico del database da CloudWatch dove puoi monitorare le metriche di carico del DB insieme ad altre metriche di Amazon DocumentDB e impostare avvisi su di esse.
**Quali sono i limiti di Amazon DocumentDB Performance Insights?**
+ Performance Insights nelle regioni AWS GovCloud (Stati Uniti orientali) e AWS GovCloud (Stati Uniti occidentali) non sono disponibili
+ Performance Insights for Amazon DocumentDB conserva fino a 7 giorni di dati sulle prestazioni
+ Le query più lunghe di 1.024 byte non vengono aggregate in Performance Insights
**Topics**
+ [Concetti di Performance Insights](performance-insights-concepts.md)
+ [Abilitazione e disattivazione di Performance Insights](performance-insights-enabling.md)
+ [Configurazione delle policy di accesso per Performance Insights](performance-insights-policies.md)
+ [Analisi delle metriche utilizzando il pannello di controllo Performance Insights](performance-insights-analyzing.md)
+ [Recupero dei parametri con l'API Performance Insights](performance-insights-metrics.md)
+ [CloudWatch Metriche Amazon per Performance Insights](performance-insights-cloudwatch.md)
+ [Performance Insights per le contrometriche](performance-insights-counter-metrics.md)
# Concetti di Performance Insights
**Topics**
+ [Media delle sessioni attive](#performance-insights-concepts-sessions)
+ [Dimensioni](#performance-insights-concepts-dimensions)
+ [Max vCPU](#performance-insights-concepts-maxvcpu)
## Media delle sessioni attive
Il carico del database (carico DB)misura il livello di attività nel database. Il parametro chiave in Performance Insights è `DB Load`, che viene raccolto ogni secondo. L'unità per la `DBLoad` metrica è l'*Average Active Sessions (AAS)* per un'istanza Amazon DocumentDB.
Una sessione *attiva* è una connessione che ha inviato lavoro all'istanza di Amazon DocumentDB ed è in attesa di una risposta. Ad esempio, se invii una query a un'istanza Amazon DocumentDB, la sessione del database è attiva mentre l'istanza elabora la query.
Per ottenere le sessioni attive medie (AAS), Performance Insights esegue il campionamento del numero di sessioni che eseguono contemporaneamente una query. L'AAS è il numero totale di sessioni diviso per il numero totale di campioni. La tabella seguente mostra cinque esempi consecutivi di una query in esecuzione.
| Project N.E.M.O. | Numero di sessioni che eseguono query | AAS | Calcolo |
| --- | --- | --- | --- |
| 1 | 2 | 2 | 2 sessioni/1 campione |
| 2 | 0 | 1 | 2 sessioni/2 campioni |
| 3 | 4 | 2 | 6 sessioni/3 campioni |
| 4 | 0 | 1.5 | 6 sessioni/4 campioni |
| 5 | 4 | 2 | 10 sessioni/5 campioni |
Nell'esempio precedente, il DB Load per l'intervallo di tempo compreso tra 1 e 5 è 2 AAS. Un aumento del carico database significa che, in media, più sessioni sono in esecuzione sul database.
## Dimensioni
Il parametro `DB Load` è diverso dagli altri parametri di serie temporali in quanto può essere suddiviso in sottocomponenti detti dimensioni. Le dimensioni possono essere considerate come categorie per le diverse caratteristiche della metrica `DB Load`. **Quando si diagnosticano problemi di prestazioni, le dimensioni più utili sono **gli stati di attesa** e la top query.**
**stati di attesa**
Uno *stato di attesa* fa sì che un'istruzione di query attenda il verificarsi di un evento specifico prima di poter continuare a essere eseguita. Ad esempio, un'istruzione di query potrebbe attendere lo sblocco di una risorsa bloccata. `DB Load`Combinando gli stati di attesa, è possibile ottenere un quadro completo dello stato della sessione. Ecco diversi stati di attesa di Amazon DocumentDB:
| Stato di attesa di Amazon DocumentDB | Descrizione dello stato di attesa |
| --- | --- |
| Chiavistello | Lo stato di attesa Latch si verifica quando la sessione è in attesa di impaginare il pool di buffer. Il paging frequente in entrata e in uscita dal buffer pool può avvenire più spesso quando il sistema elabora frequentemente query di grandi dimensioni, scansioni di raccolta o quando il pool di buffer è troppo piccolo per gestire il set di lavoro. |
| CPU | Lo stato di attesa della CPU si verifica quando la sessione è in attesa della CPU. |
| CollectionLock | Lo stato di CollectionLock attesa si verifica quando la sessione è in attesa di acquisire un blocco sulla raccolta. Questi eventi si verificano quando sono presenti operazioni DDL sulla raccolta. |
| DocumentLock | Lo stato di DocumentLock attesa si verifica quando la sessione è in attesa di acquisire un blocco su un documento. Un numero elevato di scritture simultanee sullo stesso documento contribuirà a aumentare gli stati di DocumentLock attesa su quel documento. |
| SystemLock | Lo stato di SystemLock attesa si verifica quando la sessione è in attesa sul sistema. Ciò può verificarsi in presenza di frequenti interrogazioni di lunga durata, transazioni di lunga durata o elevata concorrenza nel sistema. |
| IO | Lo stato di attesa IO si verifica quando la sessione è in attesa del completamento dell'IO. |
| BufferLock | Lo stato di BufferLock attesa si verifica quando la sessione è in attesa di acquisire un blocco su una pagina condivisa nel buffer. BufferLockgli stati di attesa possono essere prolungati se altri processi mantengono i cursori aperti sulle pagine richieste. |
| LowMemThrottle | Lo stato di LowMemThrottle attesa si verifica quando la sessione è in attesa a causa della forte pressione della memoria sull'istanza di Amazon DocumentDB. Se questo stato persiste a lungo, valuta la possibilità di scalare l'istanza per fornire memoria aggiuntiva. Per ulteriori informazioni, consulta [Resource](https://docs.aws.amazon.com/documentdb/latest/developerguide/how-it-works.html) Governor. |
| BackgroundActivity | Lo stato di BackgroundActivity attesa si verifica quando la sessione è in attesa di processi interni del sistema. |
| Altro | L'altro stato di attesa è uno stato di attesa interno. Se questo stato persiste a lungo, valuta la possibilità di terminare questa interrogazione. Per ulteriori informazioni, vedi [Come posso trovare e terminare le interrogazioni di lunga durata o bloccate](https://docs.aws.amazon.com/documentdb/latest/developerguide/user_diagnostics.html#user_diagnostics-query_terminating.html)? |
**Le domande più frequenti**
Mentre gli stati di attesa mostrano dei punti deboli, le query principali mostrano quali sono le query che contribuiscono maggiormente al carico del database. Ad esempio, molte query potrebbero essere attualmente in esecuzione nel database, ma una singola query potrebbe consumare il 99% del carico DB. In questo caso, il carico elevato potrebbe indicare un problema con la query.
## Max vCPU
Nel dashboard, il grafico di **caricamento del database** raccoglie, aggrega e visualizza le informazioni sulla sessione. Per verificare se le sessioni attive superano la CPU massima, esaminare la loro relazione con la linea **vCPU massima**. Il valore **Max vCPU** è determinato dal numero di core vCPU (CPU virtuale) per l'istanza Amazon DocumentDB.
Se il carico è spesso sopra la linea **vCPU massima** e lo stato di attesa primario è CPU, la CPU è sovraccarica. In questo caso, potresti voler limitare le connessioni all'istanza, ottimizzare qualsiasi query con un carico di CPU elevato o prendere in considerazione una classe di istanza più grande. Istanze elevate e costanti di qualsiasi stato di attesa indicano che possono verificarsi colli di bottiglia o problemi di conflitto delle risorse da risolvere. Questo può valere anche se il carico database non supera il valore della riga **CPU massima**.
# Abilitazione e disattivazione di Performance Insights
Per utilizzare Performance Insights, è necessario attivarlo nell'istanza database. Puoi disabilitarlo in un secondo momento, se necessario. L'attivazione e la disattivazione di Performance Insights non determina tempi di inattività, riavvio o failover.
L'agente Performance Insights consuma CPU e memoria limitate sull'host DB. Quando il carico del DB è elevato, l'agente limita l'impatto sulle prestazioni raccogliendo i dati meno frequentemente.
## Abilitazione di Performance Insights durante la creazione di un cluster
Nella console è possibile attivare o disattivare Performance Insights quando si crea o si modifica una nuova istanza DB.
### Utilizzando il Console di gestione AWS
Nella console, puoi abilitare Performance Insights quando crei un cluster Amazon DocumentDB. Quando crei un nuovo cluster Amazon DocumentDB, abilita Performance Insights scegliendo **Enable Performance Insights nella sezione Performance** **Insights**.
**Istruzioni per la console**
1. Per creare un cluster, segui le istruzioni per la [creazione di un cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-create.html).
1. Seleziona **Abilita Performance Insights** nella sezione Performance Insights.
![\[La sezione Performance Insights con l'opzione Abilita Performance Insights selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**Nota**
Il periodo di conservazione dei dati di Performance Insights sarà di sette giorni.
** AWS KMS chiave**: specifica la tua chiave AWS KMS. Performance Insights crittografa tutti i dati potenzialmente sensibili utilizzando la tua AWS KMS chiave. I dati vengono crittografati mentre sono in transito o inattivi. Per ulteriori informazioni, vedere Configurazione di una AWS AWS KMS policy per Performance Insights.
## Abilitazione e disabilitazione durante la modifica di un'istanza
È possibile modificare un'istanza DB per abilitare o disabilitare Performance Insights utilizzando la console o AWS CLI.
------
#### [ Using the Console di gestione AWS ]
**Istruzioni della console**
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Scegli **Cluster**.
1. Scegliere un'istanza DB e scegliere **Modifica**.
1. Nella sezione Performance Insights, scegli **Abilita Performance Insights** o **Disabilita Performance Insights**.
**Nota**
Se scegli **Enable Performance Insights**, puoi specificare la tua AWS AWS KMS chiave. Performance Insights crittografa tutti i dati potenzialmente sensibili utilizzando la tua AWS KMS chiave. I dati vengono crittografati mentre sono in transito o inattivi. Per ulteriori informazioni, [consulta Encrypting Amazon DocumentDB Data](https://docs.aws.amazon.com/documentdb/latest/developerguide/encryption-at-rest.html) at Rest.
1. Scegli **Continue** (Continua).
1. In **Scheduling of Modifications (Pianificazione delle modifiche)**, scegliere **Apply immediately (Applica immediatamente)**. Se scegli **Applica durante la successiva finestra di manutenzione pianificata**, l'istanza ignora questa impostazione e abilita immediatamente Performance Insights.
1. Scegli **Modify instance (Modifica istanza)**.
------
#### [ Using the AWS CLI ]
Quando si utilizzano i `modify-db-instance` AWS AWS CLI comandi `create-db-instance` o, è possibile abilitare Performance Insights `--enable-performance-insights` specificando o disabilitarlo `--no-enable-performance-insights` specificando.
La seguente procedura descrive come attivare Performance Insights per un'istanza database utilizzando AWS AWS CLI.
**AWS AWS CLI istruzioni**
Chiamate il `modify-db-instance` AWS AWS CLI comando e fornite i seguenti valori:
+ `--db-instance-identifer`— Il nome dell'istanza DB
+ `--enable-performance-insights` per abilitare o `--no-enable-performance-insights` per disabilitare
**Example**
L'esempio seguente abilita Performance Insights per`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
```
------
# Configurazione delle policy di accesso per Performance Insights
Per accedere a Performance Insights, devi avere le autorizzazioni appropriate da AWS Identity and Access Management (IAM). Per concedere l'accesso sono disponibili le seguenti opzioni:
+ Collega la policy gestita `AmazonRDSPerformanceInsightsReadOnly` a un set di autorizzazioni o a un ruolo.
+ Crea una policy IAM personalizzata e collegala a un set di autorizzazioni o un ruolo.
Inoltre, se è stato specificata una chiave gestita dal cliente durante l'attivazione di Performance Insights, è necessario assicurarsi che gli utenti dell'account dispongano delle autorizzazioni `kms:Decrypt` e `kms:GenerateDataKey` sulla chiave KMS.
**Nota**
[Per quanto encryption-at-rest riguarda la gestione delle AWS KMS chiavi e dei gruppi di sicurezza, Amazon DocumentDB sfrutta la tecnologia operativa condivisa con Amazon RDS.](https://aws.amazon.com/rds)
## Allegare la RDSPerformance InsightsReadOnly policy di Amazon a un principale IAM
`AmazonRDSPerformanceInsightsReadOnly`è una policy AWS gestita che garantisce l'accesso a tutte le operazioni di sola lettura dell'API Amazon DocumentDB Performance Insights. Al momento, tutte le operazioni in questa API sono di sola lettura. Se si collega `AmazonRDSPerformanceInsightsReadOnly` a un set di autorizzazioni o un ruolo, il destinatario può utilizzare Performance Insights insieme ad altre funzionalità della console.
## Creazione di una policy IAM personalizzata per Approfondimenti sulle prestazioni
Per gli utenti che non hanno accesso completo alla policy `AmazonRDSPerformanceInsightsReadOnly`, si può concedere l'accesso a Performance Insights creando o modificando una policy IAM gestita dall'utente. Quando alleghi la policy a un set di autorizzazioni o a un ruolo, il destinatario può utilizzare Performance Insights.
**Per creare una policy personalizzata**
1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nel riquadro di navigazione, scegli **Policy**.
1. Scegli **Create Policy** (Crea policy).
1. Nella pagina **Create Policy** (Crea policy), seleziona la scheda JSON.
1. Copia e incolla il testo seguente, sostituendolo *us-east-1* con il nome della tua AWS regione e *111122223333* con il numero del tuo account cliente.
------
#### [ 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. Scegliere **Esamina policy**.
1. Specifica un nome per la policy e, facoltativamente, una descrizione e quindi scegli **Crea policy**.
Ora è possibile collegare la policy a un set di autorizzazioni o un ruolo. La seguente procedura presuppone che si disponga già di un utente disponibile allo scopo.
**Per collegare la policy a un utente**
1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nel pannello di navigazione, seleziona **Utenti**.
1. Seleziona un utente esistente dall'elenco.
**Importante**
Per utilizzare Performance Insights, assicurati di avere accesso ad Amazon DocumentDB oltre alla policy personalizzata. [Ad esempio, la policy **AmazonDocDBReadOnlyAccess**predefinita fornisce l'accesso in sola lettura ad Amazon DocDB. Per ulteriori informazioni, consulta Gestione dell'accesso tramite policy.](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAM.html#security_iam_access-manage)
1. Nella pagina **Summary (Riepilogo)**, scegli **Add permissions (Aggiungi autorizzazioni)**.
1. Scegli **Attach existing policies directly** (Collega direttamente le policy esistenti). Per **Search (Ricerca)** digita i primi caratteri del nome della policy, come mostrato di seguito.
![\[Scelta di una policy\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/pi-add-permissions.png)
1. Scegli la policy e quindi seleziona **Next: Review (Successivo: Rivedi)**.
1. Scegli **Add Permissions (Aggiungi autorizzazioni)**.
## Configurazione di una AWS KMS policy per Performance Insights
Performance Insights utilizza an AWS KMS key per crittografare i dati sensibili. Quando si abilita Performance Insights mediante l'API o la console, sono disponibili le seguenti opzioni:
+ Scegli l'impostazione predefinita Chiave gestita da AWS.
Amazon DocumentDB utilizza la Chiave gestita da AWS per la tua nuova istanza DB. Amazon DocumentDB ne crea uno Chiave gestita da AWS per il tuo AWS account. Il tuo AWS account ha un nome diverso Chiave gestita da AWS per Amazon DocumentDB per ogni AWS regione.
+ Scegli una chiave gestita dal cliente.
Se si specifica una chiave gestita dal cliente, gli utenti dell'account che chiamano l'API Performance Insights necessitano delle autorizzazioni `kms:Decrypt` e `kms:GenerateDataKey` per la chiave KMS. È possibile configurare queste autorizzazioni mediante le policy IAM. Tuttavia, è consigliabile gestire queste autorizzazioni mediante la policy della chiave KMS. Per ulteriori informazioni, consulta [Utilizzo di policy chiave in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html).
**Example**
La seguente policy chiave di esempio mostra come aggiungere istruzioni alla propria policy della chiave KMS. Queste istruzioni consentono l'accesso a Performance Insights. A seconda di come utilizzi il AWS KMS, potresti voler modificare alcune restrizioni. Prima di aggiungere istruzioni alle policy, ai criteri, rimuovi tutti i commenti.
# Per analizzare il parametro utilizzando il pannello di controllo di Performance Insights
Il pannello di controllo di Performance Insights contiene informazioni sulle performance del database, per consentire di analizzare e risolvere i problemi di performance. Nella pagina principale della dashboard, puoi visualizzare le informazioni sul carico del database (caricamento del DB). È possibile «suddividere» il carico del DB in base a dimensioni quali stati di attesa o query.
**Topics**
+ [Panoramica del pannello di controllo di Performance Insights](performance-insights-dashboard-overview.md)
+ [Per aprire il pannello di controllo di Performance Insights](performance-insights-dashboard-opening.md)
+ [Analisi del carico del database in base agli stati di attesa](performance-insights-analyzing-db-load.md)
+ [Panoramica della scheda Domande principali](performance-insights-top-queries.md)
+ [Ingrandimento del grafico di caricamento del database](performance-insights-zoom-db-load.md)
# Panoramica del pannello di controllo di Performance Insights
Il pannello di controllo è il modo più semplice per interagire con Performance Insights. L'esempio seguente mostra il pannello di controllo per un'istanza di Amazon DocumentDB. Per impostazione predefinita, il pannello di controllo di Performance Insights mostra i dati relativi agli ultimi 60 minuti.
![\[Dashboard Performance Insights che mostra l'utilizzo della CPU e il carico del database nel tempo per un'istanza Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/overview-dashboard.png)
Il pannello di controllo è diviso nelle seguenti parti:
1. **Parametri dei contatori**: mostra i dati relativi ai contatori delle prestazioni specifici.
1. **Caricamento del database**: mostra il confronto tra il carico del database e la capacità dell'istanza DB rappresentata dalla riga **Max vCPU**.
1. **Dimensioni principali**: mostra le dimensioni principali che contribuiscono al carico del DB. Queste dimensioni includono `waits``queries`,`hosts`,`databases`, e`applications`.
**Topics**
+ [Grafico Parametri contatore](#performance-insights-overview-metrics)
+ [Grafico di carico database](#performance-insights-overview-db-load-chart)
+ [Tabella dimensioni superiori](#performance-insights-overview-top-dimensions)
## Grafico Parametri contatore
Con i parametri contatore, puoi personalizzare il pannello di controllo di Performance Insights per includere fino a 10 grafici aggiuntivi. Questi grafici mostrano una selezione di dozzine di metriche del sistema operativo. Queste informazioni possono essere correlate ai carichi dei database per agevolare l’individuazione e l’analisi di problemi legati alle prestazioni.
Il grafico **Counter Metrics** (Parametri contatore) visualizza i dati per i contatori delle prestazioni.
![\[Grafico dei contatori che mostra l'utilizzo della CPU nel tempo.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/counter-metrics.png)
**Per modificare i contatori delle prestazioni, scegli Gestisci le metriche.** Puoi selezionare più **metriche del sistema operativo** come mostrato nella schermata seguente. Per visualizzare i dettagli relativi a qualsiasi metrica, passare il mouse sul nome della metrica.
![\[Interfaccia di selezione delle metriche del dashboard di Performance Insights con opzioni di metriche del sistema operativo.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/overview-os-metrics.png)
## Grafico di carico database
Il grafico di **carico del database** mostra il confronto tra l'attività del database e la capacità dell'istanza rappresentata dalla riga **Max vCPU**. Per impostazione predefinita, il grafico a linee in pila rappresenta il carico DB come sessioni attive medie per unità di tempo. Il carico DB viene suddiviso (raggruppato) in base agli stati di attesa.
![\[Il grafico di carico del database mostra la media delle sessioni attive nel tempo, con un picco di utilizzo della CPU verso la fine.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/database-load.png)
**Carico del database suddiviso per dimensioni**
È possibile scegliere di visualizzare il carico sotto forma di sessioni attive raggruppate in base alle dimensioni supportate. L'immagine seguente mostra le dimensioni dell'istanza Amazon DocumentDB.
![\[Grafico che mostra il carico del database con varie opzioni «Slice by» visualizzate in un elenco a discesa.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/database-load-sliced.png)
**Dettagli del carico DB per un elemento della dimensione**
Per visualizzare i dettagli su un elemento del carico del database all’interno di una dimensione, passa il mouse sul nome dell’elemento. L'immagine seguente mostra i dettagli di un'istruzione di interrogazione.
![\[Grafico a barre che mostra il carico del database con dettagli aggiuntivi visualizzati al passaggio del mouse sul nome di un elemento.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/database-load-details.png)
Per visualizzare i dettagli relativi a qualsiasi elemento per il periodo di tempo selezionato nella legenda, passa il mouse su tale elemento.
![\[Grafico a barre che mostra il carico del database con dettagli aggiuntivi visualizzati al passaggio del mouse su una barra.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/database-load-hover.png)
## Tabella dimensioni superiori
La **tabella delle dimensioni principali suddivide** il carico del DB in base a dimensioni diverse. Una dimensione è una categoria o una suddivisione per le diverse caratteristiche del carico del database. Se la dimensione è una query, **Top queries mostra le** istruzioni di query che contribuiscono maggiormente al carico del DB.
Scegli una delle seguenti schede di dimensione.
![\[La scheda Dimensioni delle query principali che mostra le due query principali.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/top-dimensions.png)
La tabella seguente fornisce una breve descrizione di ciascuna scheda.
| Scheda | Description |
| --- | --- |
| Principali stati d’attesa | L’evento per il quale il back-end del database è in attesa |
| Le domande più frequenti | Le istruzioni di interrogazione attualmente in esecuzione |
| Host principali | L'IP e la porta dell'host del client connesso |
| Database principali | Nome del database a cui è connesso il client |
| Applicazioni principali | Il nome dell’applicazione connessa al database |
Per informazioni su come analizzare le interrogazioni utilizzando la scheda **Interrogazioni principali, consulta**. [Panoramica della scheda Domande principali](performance-insights-top-queries.md)
# Per aprire il pannello di controllo di Performance Insights
**Per visualizzare il dashboard di Performance Insights nella console di AWS gestione, attenersi alla seguente procedura:**
1. Apri la console Performance Insights all'indirizzo [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/home#performance-insights).
1. Scegli un’istanza database. La dashboard Performance Insights viene mostrata per quell'istanza di Amazon DocumentDB.
Per le istanze Amazon DocumentDB con Performance Insights abilitata, puoi anche accedere alla dashboard selezionando la voce **Sessions** nell'elenco delle istanze. In **Attività corrente** la voce **Sessioni** mostra il carico del database in sessioni attive medie negli ultimi cinque minuti. Il grafico mostra graficamente il carico: Quando la barra è vuota, l'istanza è inattiva. Con l’aumentare del carico, la barra si riempie ed è di colore blu. Quando il carico supera il numero di virtual CPUs (vCPUs) nella classe dell'istanza, la barra diventa rossa, indicando un potenziale collo di bottiglia.
![\[La pagina Clusters che mostra un cluster regionale di Amazon DocumentDB, la CPU e l'attività corrente di ogni istanza del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/opening-clusters.png)
1. (Facoltativo) Scegliere un intervallo di tempo diverso selezionando un pulsante in alto a destra. **Ad esempio, per modificare l'intervallo a 1 ora, seleziona 1 ora.**
![\[Pulsanti con intervallo di tempo che vanno da cinque minuti a una settimana.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/opening-time.png)
Nella schermata seguente, l'intervallo di caricamento del DB è di 1 ora.
![\[Grafico a barre che mostra il carico del database misurato in sessioni attive medie.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/opening-db-load.png)
1. Per aggiornare automaticamente i dati, abilita l'**aggiornamento automatico**.
![\[Il pulsante di aggiornamento automatico è abilitato, visualizzato accanto ai pulsanti dell'intervallo di tempo.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/opening-auto-refresh.png)
Il pannello di controllo di Performance Insights si aggiorna automaticamente con i nuovi dati. La frequenza di aggiornamento dipende dalla quantità di dati visualizzati:
+ Se scegli 5 minuti, l'aggiornamento avviene ogni 5 secondi.
+ 1 ora si aggiorna ogni minuto.
+ 5 ore si aggiorna ogni minuto.
+ Se scegli 24 ore, l'aggiornamento avviene ogni 5 minuti.
+ Se scegli 1 settimana, l'aggiornamento avviene ogni ora.
# Analisi del carico del database in base agli stati di attesa
Se il grafico di caricamento del **database (carico del DB)** mostra un punto debole, puoi scoprire da dove proviene il carico. A questo scopo, osserva la tabella Top Load Items (Elementi con carico) sotto la tabella **Database load (Carico database)**. Scegli un elemento particolare, ad esempio una query o un'applicazione, per approfondire quell'elemento e visualizzarne i dettagli.
Il carico del database raggruppato per attese e query principali in genere fornisce le informazioni più dettagliate sui problemi di prestazioni. Il carico del database raggruppato in base alle attese mostra la presenza di eventuali colli di bottiglia nel database relativamente alle risorse o alla simultaneità. In questo caso, la scheda **Interrogazioni principali** della tabella degli elementi di caricamento principale mostra le query che generano tale carico.
Il flusso di lavoro tipico per diagnosticare problemi di performance è il seguente:
1. Esaminare il grafico **Database load (Carico database)** per determinare se sono presenti eventi imprevisti di superamento della riga **Max CPU (CPU max)** da parte del carico del database.
1. Se sono presenti, osservare il grafico **Database load (Carico database)** e individuare lo stato o gli stati di attesa che sono i principali responsabili.
1. Identifica le query di riepilogo che causano il caricamento visualizzando quali delle query presenti nella scheda Top queries nella tabella **Top** Load Items stanno contribuendo maggiormente a questi stati di attesa. È possibile identificarle tramite la colonna **Load by Wait (AAS)**.
1. Scegliete una di queste query di riepilogo nella scheda **Query principali** per espanderla e visualizzare le query secondarie da cui è composta.
Puoi anche vedere quali host o applicazioni contribuiscono maggiormente al carico selezionando **Top host o **Top** applications**, rispettivamente. I nomi delle applicazioni sono specificati nella stringa di connessione all'istanza Amazon DocumentDB. `Unknown`indica che il campo dell'applicazione non è stato specificato.
Ad esempio, nella dashboard seguente, **la CPU** attende la maggior parte del carico del DB. Selezionando la query principale in **Prime query**, verrà analizzato il grafico di caricamento del database in modo da concentrarsi sulla maggior parte del carico apportato dalla query di selezione.
![\[Grafico di carico del database che mostra il picco di utilizzo della CPU. Una scheda Top queries corrispondente mostra le query che contribuiscono maggiormente agli stati di attesa.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/db-load-1.png)
![\[Il grafico di carico del database mostra il picco di utilizzo della CPU per la query che contribuisce maggiormente agli stati di attesa. Una scheda Top queries corrispondente mostra le query secondarie di quella query.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/db-load-2.png)
# Panoramica della scheda Domande principali
Per impostazione predefinita, la scheda **Top query** mostra le query che contribuiscono maggiormente al carico del DB. È possibile analizzare il testo della query per ottimizzare le query.
**Topics**
+ [Digest di query](#performance-insights-top-queries-digests)
+ [Caricamento per attesa (AAS)](#performance-insights-top-queries-aas)
+ [Visualizzazione di informazioni dettagliate sulle interrogazioni](#performance-insights-top-queries-query-info)
+ [Accesso al testo della richiesta di istruzioni](#performance-insights-top-queries-accessing-text)
+ [Visualizzazione e download del testo della richiesta di istruzione](#performance-insights-top-queries-viewing-downloading)
## Digest delle query
Un *Query Digest* è un insieme di più query effettive strutturalmente simili ma che potrebbero avere valori letterali diversi. Il digest sostituisce i valori codificati con un punto interrogativo. Ad esempio, un Query Digest potrebbe avere il seguente aspetto:
```
{"find":"customerscollection","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}
```
Questo digest può includere le seguenti query figlio:
```
{"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"}}
```
Per visualizzare le istruzioni di query letterali in un digest, selezionate la query, quindi scegliete il simbolo più (). `+` Nella schermata seguente, la query selezionata è un digest.
![\[La tabella Top queries mostra un digest di query espanso con una query figlio selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/top-queries-literal.png)
**Nota**
Un Query Digest raggruppa istruzioni di query simili, ma non oscura informazioni riservate.
## Caricamento per attesa (AAS)
In **Top queries**, la colonna **Load by waits (AAS)** illustra la percentuale di carico del database associata a ciascun elemento di primo caricamento. **Questa colonna riflette il carico di quell'elemento in base al raggruppamento attualmente selezionato nel grafico di caricamento del DB.** Ad esempio, è possibile raggruppare il **Carico DB** in base agli stati di attesa. In questo caso, la barra **DB Load by Waits (Carico del database in base alle attese)** è dimensionata, segmentata e rappresentata da un colore per mostrare qual è il contributo della query a un dato stato di attesa. Mostra anche quali stati di attesa stanno influenzando la query selezionata.
![\[Grafico a barre che mostra il carico del database raggruppato per CPU, IO e stati di attesa di latch. La tabella corrispondente mostra le query principali in base al caricamento per attesa.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/top-queries-aas.png)
## Visualizzazione di informazioni dettagliate sulle interrogazioni
Nella tabella **Top query**, è possibile aprire un'*istruzione digest* per visualizzarne le informazioni. Le informazioni vengono visualizzate nel riquadro inferiore.
![\[Di seguito è riportata la tabella Top queries che mostra un'istruzione di query selezionata e le relative informazioni sulla query.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/top-queries-detailed.png)
I seguenti tipi di identificatori (IDs) sono associati alle istruzioni di interrogazione:
1. **Support query ID**: un valore hash dell'ID della query. Questo valore serve solo per fare riferimento a un ID di query quando si lavora con AWS Support. AWS Il supporto non ha accesso alla richiesta IDs e al testo della query effettivi.
1. **Support digest ID**: un valore hash dell'ID digest. Questo valore serve solo per fare riferimento a un ID digest quando si lavora con Support AWS . AWS Il supporto non ha accesso al testo effettivo del digest IDs e della query.
## Accesso al testo della richiesta di dichiarazione
Per impostazione predefinita, ogni riga della tabella **Top queries** mostra 500 byte di testo di query per ogni istruzione di query. Quando un'istruzione digest supera i 500 byte, puoi visualizzare altro testo aprendo l'istruzione nella dashboard di Performance Insights. In questo caso, la lunghezza massima per la query visualizzata è 1 KB. Se visualizzi un'istruzione di interrogazione completa, puoi anche scegliere **Scarica**.
## Visualizzazione e download del testo della richiesta di istruzione
Nella dashboard di Performance Insights, puoi visualizzare o scaricare il testo della query.
**Per visualizzare altro testo della query nella dashboard di Performance Insights**
1. Apri la console Amazon DocumentDB all'indirizzo: [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/)
1. Nel pannello di navigazione scegli **Approfondimenti sulle prestazioni**.
1. Scegli istanza database. Viene visualizzato il pannello di controllo di Performance Insights per l'istanza database.
Le istruzioni di query con testo più grande di 500 byte appariranno come nell'immagine seguente:
![\[La tabella Top queries con una query secondaria selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/top-queries-statement.png)
1. Esamina la sezione delle informazioni sulla query per visualizzare una parte maggiore del testo della query.
![\[La sezione delle informazioni sull'interrogazione che mostra il testo completo dell'interrogazione selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/top-queries-query-text.png)
Il dashboard Performance Insights può visualizzare fino a 1 KB per ogni istruzione di query completa.
**Nota**
Per copiare o scaricare l'istruzione di interrogazione, disattiva tutti i blocchi popup.
# Ingrandimento del diagramma di caricamento del database
Si possono utilizzare altre funzionalità dell'interfaccia utente di Performance Insights per analizzare i dati sulle performance.
**Click-and-Drag Ingrandisci**
Nell'interfaccia di Performance Insights, puoi scegliere una piccola parte del grafico di carico e ingrandire il dettaglio.
![\[Grafico a barre che mostra il carico del database, con una parte evidenziata per lo zoom avanti.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/pi-zoom-1.png)
Per ingrandire una parte del grafico di carico, scegli l'ora di inizio e trascina fino alla fine del periodo di tempo che ti interessa. Una volta fatto, l'area selezionata è evidenziata. Quando rilasciate il mouse, il grafico di carico si ingrandisce sull'area selezionata e la tabella **Primi *elementi*** viene ricalcolata.
![\[Grafico a barre di caricamento del database che mostra la parte ingrandita, con la corrispondente tabella Top waits riportata di seguito.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/pi-zoom-2.png)
# Recupero dei parametri con l'API Performance Insights
Quando Performance Insights è abilitato, l'API fornisce visibilità sulle prestazioni dell'istanza. Amazon CloudWatch Logs fornisce la fonte autorevole per i parametri di monitoraggio dei servizi forniti. AWS
Performance Insights offre una vista specifica del dominio del carico del database misurato come numero medio di sessioni attive (AAS). Questo parametro viene visualizzata dai consumer API come un set di dati temporali bidimensionali. La dimensione temporale dei dati fornisce i dati relativi al carico del database per ogni momento dell'intervallo di tempo in cui è stata eseguita la query. Ogni punto temporale scompone il carico complessivo in relazione alle dimensioni richieste, come `Query`, `Wait-state`, `Application` o `Host`, misurato in corrispondenza di quel punto temporale.
Amazon DocumentDB Performance Insights monitora l'istanza DB di Amazon DocumentDB per consentirti di analizzare e risolvere i problemi relativi alle prestazioni del database. Un modo per visualizzare i dati di Performance Insights è disponibile nella Console di gestione AWS. Performance Insights fornisce inoltre un'API pubblica per eseguire query sui dati. Puoi usare l'API per effettuare quanto segue:
+ Scaricamento dei dati in un database
+ Aggiungi dati Performance Insights ai pannelli di controllo di monitoraggio esistenti
+ Crea strumenti di monitoraggio
Per utilizzare l'API Performance Insights, abilita Performance Insights su una delle tue istanze Amazon DocumentDB. Per informazioni sull'abilitazione di Performance Insights, consulta [Abilitazione e disattivazione di Performance Insights](performance-insights-enabling.md). Per ulteriori informazioni sull'API di Performance Insights, consulta la [Documentazione di riferimento dell'API di Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html).
L'API di Performance Insights fornisce le seguenti operazioni.
****
| Operazione di Performance Insights | AWS CLI comando | 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) | Recupera le prime N chiavi di dimensione per un parametro per un determinato periodo di tempo. |
| [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) | Recupera gli attributi del gruppo di dimensioni specificato per un'istanza database o un'origine dati. Ad esempio, se si specifica un ID di query e se i dettagli della dimensione sono disponibili, `GetDimensionKeyDetails` recupera il testo completo della dimensione `db.query.statement` associata a questo ID. Questa operazione è utile perché `DescribeDimensionKeys` non supporta `GetResourceMetrics` il recupero di testo di istruzioni di query di grandi dimensioni. |
| [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) | Recupera i metadati per diverse caratteristiche. Ad esempio, i metadati potrebbero indicare che una caratteristica è attivata o disattivata su un'istanza database specifica. |
| [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) | Recupera parametri Performance Insights per un set di origini dati, su un periodo di tempo. Puoi fornire gruppi di dimensioni e dimensioni specifiche e fornire criteri di aggregazione e filtro per ogni gruppo. |
| [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) | Recupera le dimensioni su cui è possibile eseguire query per ogni tipo di parametro specificato su un'istanza specificata. |
| [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) | Recupera tutti i parametri disponibili dei tipi di parametro specificati su cui è possibile eseguire query per un'istanza database specificata. |
**Topics**
+ [AWS CLI per Performance Insights](#performance-insights-metrics-CLI)
+ [Recupero dei parametri di serie temporali](#performance-insights-metrics-time-series)
+ [AWS CLI esempi di Performance Insights](#performance-insights-metrics-api-examples)
## AWS CLI per Performance Insights
Puoi visualizzare i dati di Performance Insights utilizzando la AWS CLI. Puoi visualizzare la guida per i comandi AWS CLI per Performance Insights inserendo quanto segue nella riga di comando.
```
aws pi help
```
Se non lo avete AWS CLI installato, consultate [Installazione dell'interfaccia a riga di AWS comando](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) nella *Guida per l'AWS CLI utente* per informazioni sull'installazione.
## Recupero dei parametri di serie temporali
L'operazione `GetResourceMetrics` recupera uno o più parametri di serie temporali dai dati di Performance Insights. `GetResourceMetrics` richiede un parametro e un periodo di tempo e restituisce una risposta con un elenco di punti di dati.
Ad esempio, gli Console di gestione AWS usi `GetResourceMetrics` per compilare il grafico **Counter Metrics** e il grafico **Database Load**, come illustrato nell'immagine seguente.
![\[Grafici Counter Metrics (Parametri contatore) e Database Load (Carico del database)\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/perf-insights-api-charts.png)
Tutti i parametri restituiti da `GetResourceMetrics` sono parametri di serie temporali standard ad eccezione di `db.load`. Questo parametro è visualizzato nel grafico **Database Load (Carico del database)**. Il parametro `db.load` è diverso dagli altri parametri di serie temporali in quanto può essere suddiviso in sottocomponenti detti *dimensioni*. Nell'immagine precedente, `db.load` è suddiviso e raggruppato in base agli stati delle attese che formano il `db.load`.
**Nota**
`GetResourceMetrics` può anche restituire il parametro `db.sampleload`, ma il parametro `db.load` è appropriato nella maggior parte dei casi.
Per informazioni sui parametri contatore restituiti da `GetResourceMetrics`, consulta [Performance Insights per le contrometriche](performance-insights-counter-metrics.md).
I seguenti calcoli sono supportati per i parametri:
+ Media: il valore medio per il parametro su un periodo di tempo. Aggiungi `.avg` al nome parametro.
+ Minimo: il valore minimo per il parametro su un periodo di tempo. Aggiungi `.min` al nome parametro.
+ Massimo: il valore massimo per il parametro su un periodo di tempo. Aggiungi `.max` al nome parametro.
+ Somma: la somma dei valori dei parametri su un periodo di tempo. Aggiungi `.sum` al nome parametro.
+ Conteggio di esempio: il numero di volte che il parametro è stato raccolto su un periodo di tempo. Aggiungi `.sample_count` al nome parametro.
Ad esempio, supponiamo che un parametro venga raccolto per 300 secondi (5 minuti) e che il parametro venga raccolto una volta al minuto. I valori per ogni minuto sono 1, 2, 3, 4 e 5. In questo caso. vengono restituiti i seguenti calcoli:
+ Media: 3
+ Minimo: 1
+ Massimo: 5
+ Somma: 15
+ Conteggio del campione: 5
Per informazioni sull'utilizzo del `get-resource-metrics` AWS CLI comando, vedere. [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)
Per l'opzione `--metric-queries`, specifica una o più query per cui ottenere risultati. Ciascuna query consiste di un parametro obbligatorio `Metric` e parametri facoltativi `GroupBy` e `Filter`. Di seguito è riportato un esempio della specifica di un'opzione `--metric-queries`.
```
{
"Metric": "string",
"GroupBy": {
"Group": "string",
"Dimensions": ["string", ...],
"Limit": integer
},
"Filter": {"string": "string"
...}
```
## AWS CLI esempi di Performance Insights
Gli esempi seguenti mostrano come utilizzare AWS CLI for Performance Insights.
**Topics**
+ [Recupero dei parametri contatore](#performance-insights-metrics-api-examples.CounterMetrics)
+ [Recupero della media di carico del DB per i principali stati di attesa](#performance-insights-metrics-api-examples.DBLoadAverage)
+ [Recupero della media di carico del DB per Top Query](#performance-insights-metrics-api-examples.topquery)
+ [Recupero della media di carico del DB filtrata per Query](#performance-insights-metrics-api-examples.DBLoadAverageByQuery)
### Recupero dei parametri contatore
Lo screenshot seguente mostra due grafici dei parametri contatore nella Console di gestione AWS.
![\[Grafici Counter Metrics (Parametri contatore).\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/performance-insights/perf-insights-api-counters-charts.png)
L'esempio seguente mostra come raccogliere gli stessi dati che utilizza la Console di gestione AWS per generare i due grafici dei parametri contatore.
Per Linux, macOS o 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"}]'
```
Per 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"}]'
```
Puoi agevolare la lettura del comando specificando un file per l'opzione `--metrics-query`. Il seguente esempio utilizza un file denominato query.json per l'opzione. Il file presenta i seguenti contenuti.
```
[
{
"Metric": "os.cpuUtilization.user.avg"
},
{
"Metric": "os.cpuUtilization.idle.avg"
}
]
```
Esegui il comando seguente per utilizzare il file.
Per Linux, macOS o 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
```
Per 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
```
L'esempio precedente specifica i seguenti valori per le opzioni:
+ `--service-type`— `DOCDB` per Amazon DocumentDB
+ `--identifier` – L'ID risorsa per l'istanza database
+ `--start-time` e `--end-time` – I valori ISO 8601 `DateTime` per il periodo su cui eseguire le query, con supporto di più formati
Esegue query per un intervallo di tempo di un'ora:
+ `--period-in-seconds` – `60` per una query al minuto
+ `--metric-queries` – Una serie di due query, ognuna solo per un parametro
Il nome del parametro utilizza punti per classificare il parametro in una categoria utile, dove l'ultimo elemento è una funzione. Nell'esempio, la funzione è `avg` per ciascuna query. Come per Amazon CloudWatch, le funzioni supportate sono `min``max`,`total`, e`avg`.
La risposta è simile a quella riportata di seguito.
```
{
"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
```
La risposta presenta un `Identifier`, un `AlignedStartTime` e un `AlignedEndTime`. Poiché il valore `--period-in-seconds` era `60`, l'ora di inizio e fine è stata allineata al minuto. Se `--period-in-seconds` fosse stato `3600`, l'ora di inizio e fine sarebbe stata allineata all'ora.
`MetricList` nella risposta ha una serie di voci, ciascuna con una voce `Key` e una voce `DataPoints`. Ciascun `DataPoint` ha un `Timestamp` e un `Value`. Ciascun elenco `Datapoints` ha 60 punti di dati in quanto le query sono per dati al minuto nell'arco di un'ora, con `Timestamp1/Minute1`, `Timestamp2/Minute2` e così via, fino a `Timestamp60/Minute60`.
Poiché la query è per due diversi parametri contatore, la risposta contiene due element `MetricList`.
### Recupero della media di carico del DB per i principali stati di attesa
L'esempio seguente è la stessa query Console di gestione AWS utilizzata per generare un grafico a linee ad area impilata. Questo esempio recupera l'`db.load.avg`ultima ora con il carico diviso in base ai primi sette stati di attesa. Il comando è come quello in [Recupero dei parametri contatore](#performance-insights-metrics-api-examples.CounterMetrics). Tuttavia, il file query.json presenta i seguenti contenuti.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.wait_state", "Limit": 7 }
}
]
```
Eseguire il comando riportato qui di seguito.
Per Linux, macOS o 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
```
Per 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
```
L'esempio specifica la metrica `db.load.avg` e una dei primi sette `GroupBy` stati di attesa. Per i dettagli sui valori validi per questo esempio, consulta il *riferimento [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)all'API Performance Insights.*
La risposta è simile a quella riportata di seguito.
```
{
"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 questa risposta, ci sono tre voci in`MetricList`. È disponibile una voce per il totale `db.load.avg` e tre voci ciascuna per la `db.load.avg` divisione in base a uno dei primi tre stati di attesa. Poiché esisteva una dimensione di raggruppamento (a differenza del primo esempio), deve esserci una chiave per ogni raggruppamento della metrica. Può esserci una sola chiave per ciascun parametro, come nel caso d'uso del parametro contatore di base.
### Recupero della media di carico del DB per Top Query
L'esempio seguente raggruppa in `db.wait_state` base alle prime 10 istruzioni di query. Esistono due gruppi diversi per le istruzioni di interrogazione:
+ `db.query`— L'istruzione di interrogazione completa, ad esempio `{"find":"customers","filter":{"FirstName":"Jesse"},"sort":{"key":{"$numberInt":"1"}}}`
+ `db.query_tokenized`— L'istruzione di interrogazione tokenizzata, ad esempio `{"find":"customers","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}`
Quando si analizzano le prestazioni del database, può essere utile considerare come un unico elemento logico le istruzioni di query che differiscono solo in base ai relativi parametri. Pertanto, puoi utilizzare `db.query_tokenized` durante le query. Tuttavia, specialmente se sei interessato`explain()`, a volte è più utile esaminare istruzioni di query complete con parametri. Esiste una relazione padre-figlio tra le query tokenizzate e quelle complete, con più query complete (figli) raggruppate sotto la stessa query tokenizzata (principale).
Il comando in questo esempio è simile a quello in [Recupero della media di carico del DB per i principali stati di attesa](#performance-insights-metrics-api-examples.DBLoadAverage). Tuttavia, il file query.json presenta i seguenti contenuti.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.query_tokenized", "Limit": 10 }
}
]
```
Nell'esempio seguente viene utilizzato `db.query_tokenized`.
Per Linux, macOS o 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
```
Per 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
```
Questo esempio esegue una query di durata superiore a 1 ora, con un minuto. period-in-seconds
L'esempio specifica la metrica `db.load.avg` e una dei primi sette `GroupBy` stati di attesa. Per i dettagli sui valori validi per questo esempio, consulta il *riferimento [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)all'API Performance Insights.*
La risposta è simile a quella riportata di seguito.
```
{
"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
```
Questa risposta contiene 11 voci `MetricList` (1 in totale, 10 delle principali query tokenizzate), con 24 voci all'ora per ogni voce. `DataPoints`
Per le query tokenizzate, ci sono tre voci in ogni elenco di dimensioni:
+ `db.query_tokenized.statement`— L'istruzione di interrogazione tokenizzata.
+ `db.query_tokenized.db_id `— L'ID sintetico che Performance Insights genera per te. Questo esempio restituisce l'ID sintetico `pi-1064184600`.
+ `db.query_tokenized.id` – L'ID della query all'interno di Performance Insights.
Nel Console di gestione AWS, questo ID è denominato Support ID. Si chiama così perché l'ID è costituito da dati che AWS Support può esaminare per aiutarti a risolvere un problema con il tuo database. AWS prende molto sul serio la sicurezza e la privacy dei tuoi dati e quasi tutti i dati vengono archiviati crittografati con il tuo. AWS KMS key Pertanto, nessuno all'interno AWS può guardare questi dati. Nell'esempio precedente, sia `tokenized.statement` che `tokenized.db_id` vengono archiviati crittografati. Se hai un problema con il tuo database, AWS Support può aiutarti facendo riferimento al Support ID.
Quando si eseguo query, potrebbe essere utile specificare un `Group` in `GroupBy`. Tuttavia, per un controllo più dettagliato dei dati restituiti, occorre specificare l'elenco delle dimensioni. Ad esempio, se tutto ciò di cui si necessita è `db.query_tokenized.statement`, è possibile aggiungere l'attributo `Dimensions` al file query.json.
```
[
{
"Metric": "db.load.avg",
"GroupBy": {
"Group": "db.query_tokenized",
"Dimensions":["db.query_tokenized.statement"],
"Limit": 10
}
}
]
```
### Recupero della media di carico del DB filtrata per Query
La query dell'API corrispondente in questo esempio è simile al comando in [Recupero della media di carico del DB per Top Query](#performance-insights-metrics-api-examples.topquery). Tuttavia, il file query.json presenta i seguenti contenuti.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.wait_state", "Limit": 5 },
"Filter": { "db.query_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }
}
]
```
In questa risposta, tutti i valori vengono filtrati in base al contributo della query AKIAIOSFODNN7 tokenizzata EXAMPLE specificata nel file query.json. Le chiavi potrebbero inoltre seguire un ordine diverso rispetto a una query senza filtro, poiché sono i primi cinque stati di attesa che hanno influito sulla query filtrata.
# CloudWatch Metriche Amazon per Performance Insights
Performance Insights pubblica automaticamente i parametri su Amazon. CloudWatch Gli stessi dati possono essere interrogati da Performance Insights, ma l'inserimento delle metriche CloudWatch semplifica l'aggiunta di allarmi. CloudWatch Agevola inoltre l'aggiunta dei parametri ai pannelli di controllo di CloudWatch esistenti.
| Metrica | Description |
| --- | --- |
| DBLoad | Il numero di sessioni attive per Amazon DocumentDB. Generalmente, si richiedono i dati per il numero medio di sessioni attive. In Performance Insights, questi dati sono oggetto di query come `db.load.avg`. |
| DBLoadCPU | Il numero di sessioni attive in cui il tipo di stato di attesa è CPU. In Performance Insights, questi dati vengono interrogati come`db.load.avg`, filtrati in base al tipo di stato di attesa. `CPU` |
| DBLoadNon CPU | Il numero di sessioni attive in cui il tipo di stato di attesa non è CPU. |
**Nota**
Queste metriche vengono pubblicate CloudWatch solo in caso di carico sull'istanza DB.
Puoi esaminare queste metriche utilizzando la CloudWatch console AWS CLI, l'o l' CloudWatchAPI.
Ad esempio, puoi ottenere le statistiche per la `DBLoad` metrica eseguendo il [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)comando.
```
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
```
Questo esempio genera un output simile a quello riportato di seguito.
```
{
"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"
}
```
Puoi utilizzare la funzione matematica `DB_PERF_INSIGHTS` metrica nella CloudWatch console per interrogare i parametri dei contatori di Amazon DocumentDB Performance Insights. La `DB_PERF_INSIGHTS` funzione include anche la `DBLoad` metrica a intervalli inferiori al minuto. Puoi impostare CloudWatch allarmi su queste metriche. Per maggiori dettagli su come creare un allarme, consulta [Creare un allarme sulle metriche dei contatori di Performance Insights da un AWS database](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarm_database_performance_insights.html).
Per ulteriori informazioni su CloudWatch, consulta [What is Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) nella *Amazon CloudWatch User Guide*.
# Performance Insights per le contrometriche
Le metriche dei contatori sono metriche del sistema operativo nella dashboard di Performance Insights. Per agevolare l'individuazione e l'analisi di problemi legati alle prestazioni, è possibile correlare i parametri contatore ai carichi dei database.
## Contatori del sistema operativo in Performance Insights
I seguenti contatori del sistema operativo sono disponibili con Amazon DocumentDB Performance Insights.
| Contatore | Tipo | Parametro |
| --- | --- | --- |
| attive | 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 | sistema operativo. loadAverageMinute.uno |
| fifteen | loadAverageMinute | così. loadAverageMinute.quindici |
| cinque | loadAverageMinute | così. loadAverageMinute.cinque |
| 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 |
| nume VCPUs | general | os.general.num VCPUs |