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