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à. # 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)