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 del carico DB con Performance Insights su Amazon RDS **Importante** AWS ha annunciato la end-of-life data di Performance Insights: 30 giugno 2026. Dopo questa data, Amazon RDS non supporterà più l’esperienza della console Approfondimenti sulle prestazioni, i periodi di conservazione flessibili (1-24 mesi) e i relativi prezzi. L’API Approfondimenti sulle prestazioni continuerà a esistere senza modifiche ai prezzi. I costi per l'API Performance Insights verranno visualizzati nella AWS fattura insieme al costo di CloudWatch Database Insights. Si consiglia di aggiornare tutte le istanze di database utilizzando il livello a pagamento di Performance Insights alla modalità Advanced di Database Insights prima del 30 giugno 2026. Per informazioni sull’aggiornamento alla modalità avanzata di Database Insights, consulta [Attivazione della modalità avanzata di Database Insights per Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md). Se non si esegue alcuna azione, le istanze database che utilizzano Approfondimenti sulle prestazioni, per impostazione predefinita useranno la modalità standard di Database Insights. Con la modalità standard di Database Insights, è possibile perdere l’accesso alla cronologia dei dati sulle prestazioni di oltre 7 giorni e non essere in grado di utilizzare i piani di esecuzione e le funzionalità di analisi on demand nella console Amazon RDS. Dopo il 30 giugno 2026 solo la modalità Advanced di Database Insights supporterà i piani di esecuzione e l'analisi su richiesta. Con CloudWatch Database Insights, puoi monitorare il carico del database per la tua flotta di database e analizzare e risolvere i problemi delle prestazioni su larga scala. Per ulteriori informazioni su Database Insights, consulta [Monitoraggio dei database Amazon RDS con CloudWatch Database Insights](USER_DatabaseInsights.md). Per informazioni sui prezzi, consulta la pagina [ CloudWatch dei prezzi di Amazon](https://aws.amazon.com/cloudwatch/pricing/). Performance Insights si espande sulle caratteristiche di monitoraggio esistenti di Amazon RDS per illustrare e aiutare ad analizzare le prestazioni del database. Con il pannello di controllo di Performance Insights, puoi visualizzare il carico del database sull’istanza database Amazon RDS e filtrare il carico in base alle attese, alle istruzioni SQL, agli host o agli utenti. Per informazioni sull’uso di Performance Insights con Amazon DocumentDB, consulta *[Guida per gli sviluppatori di Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html)*. **Topics** + [Panoramica di Performance Insights su Amazon RDS](USER_PerfInsights.Overview.md) + [Attivazione e disattivazione di Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.Enabling.md) + [Panoramica dello schema di prestazioni per Approfondimenti sulle prestazioni su Amazon RDS per MariaDB o MySQL](USER_PerfInsights.EnableMySQL.md) + [Configurazione delle policy di accesso per Performance Insights](USER_PerfInsights.access-control.md) + [Analisi delle metriche utilizzando il pannello di controllo Performance Insights](USER_PerfInsights.UsingDashboard.md) + [Visualizzazione delle raccomandazioni proattive di Approfondimenti sulle prestazioni](USER_PerfInsights.InsightsRecommendationViewDetails.md) + [Recupero delle metriche con l’API Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.API.md) + [Registrazione delle chiamate Performance Insights utilizzando AWS CloudTrail](USER_PerfInsights.CloudTrail.md) + [API Approfondimenti sulle prestazioni ed endpoint VPC di interfaccia (AWS PrivateLink)](pi-vpc-interface-endpoints.md) # Panoramica di Performance Insights su Amazon RDS **Importante** AWS ha annunciato la end-of-life data di Performance Insights: 30 giugno 2026. Dopo questa data, Amazon RDS non supporterà più l’esperienza della console Approfondimenti sulle prestazioni, i periodi di conservazione flessibili (1-24 mesi) e i relativi prezzi. L’API Approfondimenti sulle prestazioni continuerà a esistere senza modifiche ai prezzi. I costi per l'API Performance Insights verranno visualizzati nella AWS fattura insieme al costo di CloudWatch Database Insights. Si consiglia di aggiornare tutte le istanze di database utilizzando il livello a pagamento di Performance Insights alla modalità Advanced di Database Insights prima del 30 giugno 2026. Per informazioni sull’aggiornamento alla modalità avanzata di Database Insights, consulta [Attivazione della modalità avanzata di Database Insights per Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md). Se non si esegue alcuna azione, le istanze database che utilizzano Approfondimenti sulle prestazioni, per impostazione predefinita useranno la modalità standard di Database Insights. Con la modalità standard di Database Insights, è possibile perdere l’accesso alla cronologia dei dati sulle prestazioni di oltre 7 giorni e non essere in grado di utilizzare i piani di esecuzione e le funzionalità di analisi on demand nella console Amazon RDS. Dopo il 30 giugno 2026 solo la modalità Advanced di Database Insights supporterà i piani di esecuzione e l'analisi su richiesta. Con CloudWatch Database Insights, puoi monitorare il carico del database per la tua flotta di database e analizzare e risolvere i problemi delle prestazioni su larga scala. Per ulteriori informazioni su Database Insights, consulta [Monitoraggio dei database Amazon RDS con CloudWatch Database Insights](USER_DatabaseInsights.md). Per informazioni sui prezzi, consulta la pagina [ CloudWatch dei prezzi di Amazon](https://aws.amazon.com/cloudwatch/pricing/). Per impostazione predefinita, RDS abilita Approfondimenti sulle prestazioni nella procedura guidata di creazione della console per tutti i motori Amazon RDS. Se in un'istanza database sono presenti più database, Performance Insights aggrega i dati sulle prestazioni. Puoi trovare una panoramica di Performance Insights per Amazon RDS nel seguente video. [![AWS Videos](http://img.youtube.com/vi/yOeWcPBT458/0.jpg)](http://www.youtube.com/watch?v=yOeWcPBT458) **Importante** I seguenti argomenti descrivono l'utilizzo di Amazon RDS Performance Insights con motori di database non Aurora. Per informazioni sull'utilizzo di Amazon RDS Performance Insights con Amazon Aurora, consulta [Uso di Amazon RDS Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html) nella *Guida per l'utente di Amazon Aurora*. **Topics** + [Caricamento database](USER_PerfInsights.Overview.ActiveSessions.md) + [CPU massima](USER_PerfInsights.Overview.MaxCPU.md) + [Supporto del motore Amazon RDS di Aurora DB, della regione e della classe di istanza per Performance Insights](USER_PerfInsights.Overview.Engines.md) + [Prezzi e conservazione dei dati per Performance Insights](USER_PerfInsights.Overview.cost.md) # Caricamento database L’opzione *Caricamento del database* misura il livello di attività della sessione nel database. `DBLoad` è la metrica chiave di Approfondimenti sulle prestazioni e Approfondimenti sulle prestazioni raccoglie il carico del database ogni secondo. **Topics** + [Sessioni attive](#USER_PerfInsights.Overview.ActiveSessions.active-sessions) + [Media delle sessioni attive](#USER_PerfInsights.Overview.ActiveSessions.AAS) + [Media delle esecuzioni attive](#USER_PerfInsights.Overview.ActiveSessions.AAE) + [Dimensioni](#USER_PerfInsights.Overview.ActiveSessions.dimensions) ## Sessioni attive Una *sessione database* rappresenta il dialogo di un'applicazione con un database relazionale. Una sessione attiva è una connessione che ha inviato lavoro a un motore del database ed è in attesa di una risposta dal motore del database. Una sessione è attiva quando è in esecuzione sulla CPU o in attesa che una risorsa diventi disponibile in modo che possa proseguire. Ad esempio, una sessione attiva potrebbe attendere la lettura di una pagina (o blocco) in memoria e quindi consumare la CPU mentre legge i dati dalla pagina. ## Media delle sessioni attive La *media delle sessioni attive (AAS)* è l'unità per il parametro `DBLoad` in Performance Insights. Misura quante sessioni sono attive contemporaneamente nel database. Ogni secondo, Performance Insights esegue il campionamento del numero di sessioni che eseguono contemporaneamente una query. Per ogni sessione attiva, Performance Insights raccoglie i seguenti dati: + Istruzione SQL + Stato della sessione (in esecuzione sulla CPU o in attesa) + Host + Utente che esegue SQL Performance Insights calcola il valore delle sessioni attive medie (AAS) dividendo il numero totale di sessioni per il numero totale di campioni per un periodo di tempo specifico. Ad esempio, nella tabella seguente vengono riportati 5 campioni consecutivi di una query in esecuzione, dove ogni campione viene acquisito a intervalli di 1 secondo. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) Nell'esempio precedente, il carico DB per l'intervallo di tempo è 2 AAS. Questa misurazione significa che, in media, sono state attive 2 sessioni alla volta durante il periodo in cui sono stati acquisiti i 5 campioni. ## Media delle esecuzioni attive La media delle esecuzioni attive (AAE) al secondo è correlata all'AAS. Per calcolare l'AAE, Performance Insights divide il tempo totale di esecuzione di una query per l'intervallo di tempo. Nella tabella seguente viene illustrato il calcolo AAE per la stessa query nella tabella precedente. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) Nella maggior parte dei casi, l'AAS e AAE per una query sono quasi uguali. Tuttavia, poiché gli input per i calcoli sono origini dati diverse, i calcoli spesso variano leggermente. ## 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 "slice by" (dividi per) per le diverse caratteristiche del parametro `DBLoad`. Quando si diagnosticano problemi di prestazioni, le dimensioni seguenti sono spesso le più utili: **Topics** + [Eventi di attesa](#USER_PerfInsights.Overview.ActiveSessions.waits) + [Prime istruzioni SQL](#USER_PerfInsights.Overview.ActiveSessions.top-sql) + [Piani](#USER_PerfInsights.Overview.ActiveSessions.plans) Per un elenco completo delle dimensioni per i motori Amazon RDS, consulta [Carico del database suddiviso per dimensioni](USER_PerfInsights.UsingDashboard.Components.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims). ### Eventi di attesa Un *evento di attesa* fa sì che un'istruzione SQL attenda che si verifichi un evento specifico prima che possa continuare l'esecuzione. Gli eventi di attesa sono una dimensione o una categoria importante per il caricamento del database perché indicano dove il lavoro è impedito. Ogni sessione attiva è in esecuzione sulla CPU o in attesa. Ad esempio, le sessioni consumano la CPU quando cercano in memoria un buffer, eseguono un calcolo o eseguono codice procedurale. Quando le sessioni non consumano la CPU, potrebbero essere in attesa che un buffer di memoria diventi libero, un file di dati da leggere o un registro in cui scrivere. Maggiore è il tempo in cui una sessione attende le risorse, minore è il tempo in cui viene eseguita sulla CPU. Quando si sintonizza un database, si tenta spesso di scoprire le risorse che le sessioni sono in attesa. Ad esempio, due o tre eventi di attesa potrebbero rappresentare il 90% del carico DB. Questa misura significa che, in media, le sessioni attive trascorrono la maggior parte del tempo in attesa di un numero limitato di risorse. Se riesci a scoprire la causa di queste attese, puoi provare a fornire una soluzione. Gli eventi di attesa variano in base al motore database: + Per informazioni su tutti gli eventi di attesa MariaDB e MySQL, consulta [Wait Event Summary Tables](https://dev.mysql.com/doc/refman/8.0/en/performance-schema-wait-summary-tables.html) nella documentazione di MySQL. + Per informazioni su tutti gli eventi di attesa PostgreSQL, consulta la pagina relativa al [processo di raccolta delle statistiche e alle tabelle degli eventi di attesa](https://www.postgresql.org/docs/current/monitoring-stats.html#WAIT-EVENT-TABLE) nella documentazione di PostgreSQL. + Per informazioni su tutti gli eventi di attesa Oracle, consulta l'argomento con le [ descrizioni degli eventi di attesa](https://docs.oracle.com/database/121/REFRN/GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2.htm#REFRN-GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2) nella documentazione Oracle. + Per informazioni su tutti gli eventi di attesa SQL Server, consulta [Types of Waits](https://docs.microsoft.com/en-us/sql/relational-databases/system-dynamic-management-views/sys-dm-os-wait-stats-transact-sql?view=sql-server-2017#WaitTypes) nella documentazione SQL Server. **Nota** Per Oracle, i processi in background a volte funzionano senza istruzioni SQL associate. In questi casi, Performance Insights segnala il tipo di processo in background concatenato da due punti e la classe di attesa associata al processo in background. I tipi di processo in background includono `LGWR`, `ARC0`, `PMON`, e così via. Ad esempio, quando lo strumento di archiviazione esegue I/O, il report di Performance Insights è simile a `ARC1:System I/O`. A volte manca anche il tipo di processo in background e Performance Insights indica solo la classe di attesa, ad esempio `:System I/O`. ### Prime istruzioni SQL Mentre gli eventi di attesa mostrano i colli di bottiglia, il primo SQL mostra quali query stanno contribuendo maggiormente al caricamento del DB. Ad esempio, molte query potrebbero essere attualmente in esecuzione nel database, ma una singola query potrebbe consumare il 99 percento del carico DB. In questo caso, il carico elevato potrebbe indicare un problema con la query. Per impostazione predefinita, la console di Performance Insights visualizza le prime query SQL che contribuiscono al caricamento del database. La console mostra anche le statistiche pertinenti per ogni istruzione. Per diagnosticare problemi di prestazioni per un'istruzione specifica, è possibile esaminarne il piano di esecuzione. ### Piani Un *piano di esecuzione*, chiamato anche semplicemente *piano*, è una sequenza di passaggi che accedono ai dati. Ad esempio, un piano per unire le tabelle `t1` e `t2` potrebbe scorrere in loop tutte le righe in `t1` e confrontare ogni riga con una riga in `t2`. In un database relazionale, un *ottimizzatore* è un codice incorporato che determina il piano più efficiente per una query SQL. Per le istanze database, Approfondimenti sulle prestazioni raccoglie automaticamente i piani di esecuzione. Per diagnosticare i problemi di prestazioni SQL, è possibile esaminare i piani acquisiti per le query SQL con elevato utilizzo di risorse. I piani mostrano come il database ha analizzato ed eseguito le query. Per informazioni su come analizzare il caricamento del database utilizzando i piani, consultare: + Oracle: [Analisi dei piani di esecuzione di Oracle tramite la dashboard di Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md) + SQL Server: [Analisi dei piani di esecuzione di SQL Server utilizzando la dashboard Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md) #### Acquisizione del piano Approfondimenti sulle prestazioni identifica ogni cinque minuti le query che utilizzano più risorse e acquisisce i piani. Pertanto, non devi raccogliere e gestire manualmente un gran numero di piani. Invece, puoi utilizzare la scheda **Top SQL** (Prime istruzioni SQL) per concentrarti sui piani per le query più problematiche. **Nota** Performance Insights non acquisisce piani per le query il cui testo supera il limite massimo di testo della query raccolte. Per ulteriori informazioni, consulta [Accesso a una maggiore quantità di testo SQL nel pannello di controllo di Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md). Il periodo di conservazione per i piani di esecuzione è lo stesso dei dati di Performance Insights. L’impostazione del periodo di conservazione è **Impostazione predefinita (7 giorni)**. Per mantenere i dati sulle prestazioni più a lungo, specifica da 1 a 24 mesi. Per altre informazioni sui periodi di conservazione, consulta [Prezzi e conservazione dei dati per Performance Insights](USER_PerfInsights.Overview.cost.md). #### Query digest La scheda **Top SQL** (Prime istruzioni SQL) mostra le query digest per impostazione predefinita. Una query digest di per sé non ha un piano, ma tutte le query che utilizzano valori letterali hanno piani. Ad esempio, una query digest potrebbe includere il testo `WHERE `email`=?`. Il digest potrebbe contenere due query, una con il testo `WHERE email=user1@example.com` e un'altra con `WHERE email=user2@example.com`. Ognuna di queste query letterali può includere più piani. Quando si seleziona una query digest, la console mostra tutti i piani per le istruzioni secondarie del digest selezionato. Pertanto, non devi esaminare tutte le istruzioni figlio per trovare il piano. Potresti vedere piani che non sono inclusi nell'elenco delle prime 10 istruzioni figlio. La console mostra i piani per tutte le query figlio per le quali sono stati raccolti i piani, indipendentemente dal fatto che le query siano tra le prime 10. # CPU massima 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**. Approfondimenti sulle prestazioni determina il valore **vCPU max** dal numero di core vCPU (CPU virtuale) per l’istanza database. Un processo può essere eseguito su una vCPU alla volta. Se il numero di processi supera il numero di vCPU, i processi vengono messi in coda. Quando la coda aumenta, le prestazioni del database diminuiscono. Se il carico è spesso sopra la linea **vCPU massima** e lo stato di attesa primario è CPU, la CPU è sovraccarica. In questo caso, si potrebbero limitare le connessioni all'istanza, ottimizzare le eventuali query SQL con un elevato carico CPU o valutare la possibilità di una classe istanza di maggiori dimensioni. 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**. # Supporto del motore Amazon RDS di Aurora DB, della regione e della classe di istanza per Performance Insights **Importante** AWS ha annunciato la end-of-life data di Performance Insights: 30 giugno 2026. Dopo questa data, Amazon RDS non supporterà più l’esperienza della console Approfondimenti sulle prestazioni, i periodi di conservazione flessibili (1-24 mesi) e i relativi prezzi. L’API Approfondimenti sulle prestazioni continuerà a esistere senza modifiche ai prezzi. I costi per l'API Performance Insights verranno visualizzati nella AWS fattura insieme al costo di CloudWatch Database Insights. Si consiglia di aggiornare tutte le istanze di database utilizzando il livello a pagamento di Performance Insights alla modalità Advanced di Database Insights prima del 30 giugno 2026. Per informazioni sull’aggiornamento alla modalità avanzata di Database Insights, consulta [Attivazione della modalità avanzata di Database Insights per Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md). Se non si esegue alcuna azione, le istanze database che utilizzano Approfondimenti sulle prestazioni, per impostazione predefinita useranno la modalità standard di Database Insights. Con la modalità standard di Database Insights, è possibile perdere l’accesso alla cronologia dei dati sulle prestazioni di oltre 7 giorni e non essere in grado di utilizzare i piani di esecuzione e le funzionalità di analisi on demand nella console Amazon RDS. Dopo il 30 giugno 2026 solo la modalità Advanced di Database Insights supporterà i piani di esecuzione e l'analisi su richiesta. Con CloudWatch Database Insights, puoi monitorare il carico del database per la tua flotta di database e analizzare e risolvere i problemi delle prestazioni su larga scala. Per ulteriori informazioni su Database Insights, consulta [Monitoraggio dei database Amazon RDS con CloudWatch Database Insights](USER_DatabaseInsights.md). Per informazioni sui prezzi, consulta la pagina [ CloudWatch dei prezzi di Amazon](https://aws.amazon.com/cloudwatch/pricing/). Nella tabella seguente vengono forniti i motori di database Amazon RDS che supportano Performance Insights. **Nota** Per Amazon Aurora, vedere [Supporto del motore Amazon Aurora database per Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.Engines.html) in *Guida per l'utente di Amazon Aurora*. | Motore di database Amazon RDS | Versioni motore e regioni supportate | Restrizioni delle classi di istanza | | --- | --- | --- | | Amazon RDS per MariaDB | Per ulteriori informazioni sulla disponibilità di versioni e regioni di Performance Insights con RDS per MariaDB, consulta [Regioni e motori di database supportati per Approfondimenti sulle prestazioni in Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md). | Performance Insights non è supportato nelle seguenti classi d'istanza: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html) | | RDS per MySQL | Per ulteriori informazioni sulla disponibilità di versione e regioni di Performance Insights con RDS per MySQL, consulta [Regioni e motori di database supportati per Approfondimenti sulle prestazioni in Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md). | Performance Insights non è supportato nelle seguenti classi d'istanza: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html) | | Amazon RDS per Microsoft SQL Server | Per ulteriori informazioni sulla disponibilità di versioni e regioni di Performance Insights con RDS per SQL Server, consulta [Regioni e motori di database supportati per Approfondimenti sulle prestazioni in Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md). | N/D | | Amazon RDS per PostgreSQL | Per ulteriori informazioni sulla disponibilità di versioni e regioni di Performance Insights con RDS per PostgreSQL, consulta [Regioni e motori di database supportati per Approfondimenti sulle prestazioni in Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md). | N/D | | Amazon RDS per Oracle | Per ulteriori informazioni sulla disponibilità di versioni e regioni di Performance Insights con RDS per Oracle, consulta [Regioni e motori di database supportati per Approfondimenti sulle prestazioni in Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md). | N/D | ## Supporto del motore di database Aurora, della regione e della classe di istanza di Amazon Aurora per le funzionalità di Performance Insights Nella tabella seguente vengono forniti i motori di database Amazon RDS che supportano funzionalità Performance Insights. | Funzionalità | [Livello di prezzi](https://aws.amazon.com/rds/performance-insights/pricing/) | [Regioni supportate](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html#Concepts.RegionsAndAvailabilityZones.Regions) | [Motori del database supportati](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html#Welcome.Concepts.DBInstance) | [Classi di istanza supportate](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html#Concepts.DBInstanceClass.Types) | | --- | --- | --- | --- | --- | | [Statistiche SQL per Performance Insights](sql-statistics.md) | Tutti | Tutti | Tutti | Tutti | | [Analisi dei piani di esecuzione di Oracle tramite la dashboard di Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md) | Tutti | Tutti | RDS per Oracle | Tutti | | [Analisi delle prestazioni del database per un periodo di tempo](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md) | Solo livello a pagamento | Tutti | RDS per PostgreSQL | Tutti | | [Visualizzazione delle raccomandazioni proattive di Approfondimenti sulle prestazioni](USER_PerfInsights.InsightsRecommendationViewDetails.md) | Solo livello a pagamento | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html) | Tutti | Tutti | # Prezzi e conservazione dei dati per Performance Insights Per impostazione predefinita, Approfondimenti sulle prestazioni include 7 giorni di cronologia dei dati sulle prestazioni e 1 milione di richieste API al mese. Puoi anche acquistare periodi di conservazione più lunghi. Per informazioni sui prezzi, consulta [Prezzi di Performance Insights](https://aws.amazon.com/rds/performance-insights/pricing/). Nella console RDS, puoi scegliere uno dei seguenti periodi di conservazione per i dati di Performance Insights: + **Default (7 giorni)** + ***n* mesi**, dove ***n*** è un numero compreso tra 1 e 24 ![\[Scelta di un periodo di conservazione per i dati di Performance Insights.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/pi-retention-periods.png) Per informazioni su come impostare un periodo di conservazione utilizzando la AWS CLI, consulta [Attivazione e disattivazione di Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.Enabling.md). **Nota** L’arresto di un’istanza database o un cluster di database Multi-AZ con Approfondimenti sulle prestazioni abilitato non influisce sulla conservazione dei dati. Mentre un’istanza database o un cluster di database Multi-AZ viene arrestato, Approfondimenti sulle prestazioni non raccoglie dati. # Attivazione e disattivazione di Approfondimenti sulle prestazioni per Amazon RDS **Importante** AWS ha annunciato la end-of-life data di Performance Insights: 30 giugno 2026. Dopo questa data, Amazon RDS non supporterà più l’esperienza della console Approfondimenti sulle prestazioni, i periodi di conservazione flessibili (1-24 mesi) e i relativi prezzi. L’API Approfondimenti sulle prestazioni continuerà a esistere senza modifiche ai prezzi. I costi per l'API Performance Insights verranno visualizzati nella AWS fattura insieme al costo di CloudWatch Database Insights. Si consiglia di aggiornare tutte le istanze di database utilizzando il livello a pagamento di Performance Insights alla modalità Advanced di Database Insights prima del 30 giugno 2026. Per informazioni sull’aggiornamento alla modalità avanzata di Database Insights, consulta [Attivazione della modalità avanzata di Database Insights per Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md). Se non si esegue alcuna azione, le istanze database che utilizzano Approfondimenti sulle prestazioni, per impostazione predefinita useranno la modalità standard di Database Insights. Con la modalità standard di Database Insights, è possibile perdere l’accesso alla cronologia dei dati sulle prestazioni di oltre 7 giorni e non essere in grado di utilizzare i piani di esecuzione e le funzionalità di analisi on demand nella console Amazon RDS. Dopo il 30 giugno 2026 solo la modalità Advanced di Database Insights supporterà i piani di esecuzione e l'analisi su richiesta. Con CloudWatch Database Insights, puoi monitorare il carico del database per la tua flotta di database e analizzare e risolvere i problemi delle prestazioni su larga scala. Per ulteriori informazioni su Database Insights, consulta [Monitoraggio dei database Amazon RDS con CloudWatch Database Insights](USER_DatabaseInsights.md). Per informazioni sui prezzi, consulta la pagina [ CloudWatch dei prezzi di Amazon](https://aws.amazon.com/cloudwatch/pricing/). È possibile attivare Approfondimenti sulle prestazioni per l’istanza database o il cluster di database Multi-AZ al momento della creazione. Se necessario, è possibile disattivarlo in un secondo momento modificando l’istanza database dalla console. L'attivazione e la disattivazione di Performance Insights non determina tempi di inattività, riavvio o failover. **Nota** Performance Schema è uno strumento di prestazioni opzionale utilizzato da Amazon RDS for MariaDB o MySQL. Se si attiva o disattiva Performance Schema, è necessario riavviare il sistema. Se si attiva o disattiva Performance Insights, tuttavia, non è necessario riavviare. Per ulteriori informazioni, consulta [Panoramica dello schema di prestazioni per Approfondimenti sulle prestazioni su Amazon RDS per MariaDB o MySQL](USER_PerfInsights.EnableMySQL.md). 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. ------ #### [ Console ] Nella console è possibile attivare o disattivare Approfondimenti sulle prestazioni quando si crea o si modifica un'istanza database o un cluster di database Multi-AZ. **Attivazione o disattivazione di Approfondimenti sulle prestazioni durante la creazione di un’istanza database o un cluster di database Multi-AZ** Dopo aver creato una nuova istanza database o un nuovo cluster di database Multi-AZ, Amazon RDS attiva Approfondimenti sulle prestazioni per impostazione predefinita. Per disattivare Approfondimenti sulle prestazioni, scegliere l’opzione **Informazioni sul database - Standard** e deselezionare l’opzione **Abilita Performance Insights**. Per ulteriori informazioni, consulta i seguenti argomenti. + Per creare un’istanza database, seguire le istruzioni per il proprio motore di database in [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md). + Per creare un cluster di database Multi-AZ, seguire le istruzioni in [Creazione di un cluster di database Multi-AZ per Amazon RDS](create-multi-az-db-cluster.md). L'immagine seguente mostra la sezione **Performance Insights**. ![\[Attivare Approfondimenti sulle prestazioni durante la creazione dell'istanza database o del cluster di database Multi-AZ con la console\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_enabling.png) Quando selezioni **Abilita Performance Insights**, sono disponibili le opzioni seguenti: + **Conservazione** (solo per la modalità Standard di Database Insights): il tempo di conservazione dei dati di Approfondimenti sulle prestazioni. L’impostazione del periodo di conservazione è **Impostazione predefinita (7 giorni)**. Per mantenere i dati sulle prestazioni più a lungo, specifica da 1 a 24 mesi. Per altre informazioni sui periodi di conservazione, consulta [Prezzi e conservazione dei dati per Performance Insights](USER_PerfInsights.Overview.cost.md). + **AWS KMS key**— Specificate il vostro AWS KMS key. Performance Insights crittografa tutti i dati potenzialmente sensibili con la chiave KMS. I dati vengono crittografati mentre sono in transito o inattivi. Per ulteriori informazioni, consulta [Modifica di una AWS KMS politica per Performance Insights](USER_PerfInsights.access-control.cmk-policy.md). **Attivazione o disattivazione di Approfondimenti sulle prestazioni durante la modifica di un’istanza database o un cluster di database Multi-AZ** Nella console è possibile modificare un’istanza database o un cluster di database Multi-AZ per gestire Approfondimenti sulle prestazioni. **Per gestire Approfondimenti sulle prestazioni per un’istanza database o un cluster di database Multi-AZ utilizzando la console** 1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Scegli **Database**. 1. Scegli un’istanza database o un cluster di database Multi-AZ e scegli **Modifica**. 1. Per attivare Approfondimenti sulle prestazioni, seleziona **Abilita Performance Insights**. Per disattivare Approfondimenti sulle prestazioni, scegliere l’opzione **Informazioni sul database - Standard** e deselezionare l’opzione **Abilita Performance Insights**. Quando selezioni **Abilita Performance Insights**, sono disponibili le opzioni seguenti: + **Conservazione** (solo per la modalità Standard di Database Insights): il tempo di conservazione dei dati di Approfondimenti sulle prestazioni. L’impostazione del periodo di conservazione è **Impostazione predefinita (7 giorni)**. Per mantenere i dati sulle prestazioni più a lungo, specifica da 1 a 24 mesi. Per altre informazioni sui periodi di conservazione, consulta [Prezzi e conservazione dei dati per Performance Insights](USER_PerfInsights.Overview.cost.md). + **AWS KMS key**: specificare la chiave KMS. Performance Insights crittografa tutti i dati potenzialmente sensibili con la chiave KMS. I dati vengono crittografati mentre sono in transito o inattivi. Per ulteriori informazioni, consulta [Crittografia delle risorse Amazon RDS](Overview.Encryption.md). 1. Scegli **Continue** (Continua). 1. In **Scheduling of Modifications** (Pianificazione delle modifiche), scegli Apply immediately (Applica immediatamente). Se scegli Apply (Applica) durante la prossima finestra di manutenzione pianificata, l'istanza ignora questa impostazione e attiva immediatamente Performance Insights. 1. Scegli **Modify instance (Modifica istanza)**. ------ #### [ AWS CLI ] Quando usi il [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) AWS CLI comando, attiva Performance Insights specificando `--enable-performance-insights` e impostando `--database-insights-mode` su `advanced` o`standard`. Per disattivare Approfondimenti sulle prestazioni, specifica `--no-enable-performance-insights` e imposta `database-insights-mode` su `standard`. È inoltre possibile specificare questi valori utilizzando i seguenti AWS CLI comandi: + [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) + [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) + [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) + [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) + [restore-db-instance-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-s3.html) Quando attivi Performance Insights nella CLI, puoi specificare, in via facoltativa, il periodo di tempo, in giorni, per cui mantenere i dati di Performance Insights con l'opzione `--performance-insights-retention-period`. È possibile specificare`7`, *month* \$1 31 (dove *month* è un numero compreso tra 1 e 23) o. `731` Ad esempio, se desideri mantenere i dati sulle prestazioni per 3 mesi, specifica `93`, che è 3 \$1 31. L'impostazione di default è `7` giorni. Per altre informazioni sui periodi di conservazione, consulta [Prezzi e conservazione dei dati per Performance Insights](USER_PerfInsights.Overview.cost.md). Il seguente esempio attiva Performance Insights per `sample-db-cluster` e specifica che i dati Performance Insights sono mantenuti per 93 giorni (3 mesi). Per Linux, macOS o Unix: ``` aws rds modify-db-cluster \ --database-insights-mode standard \ --db-cluster-identifier sample-db-instance \ --enable-performance-insights \ --performance-insights-retention-period 93 ``` Per Windows: ``` aws rds modify-db-cluster ^ --database-insights-mode standard ^ --db-cluster-identifier sample-db-instance ^ --enable-performance-insights ^ --performance-insights-retention-period 93 ``` Se il periodo di conservazione specificato, ad esempio 94 giorni, non è un valore valido, RDS genera un errore. ``` An error occurred (InvalidParameterValue) when calling the CreateDBInstance operation: Invalid Performance Insights retention period. Valid values are: [7, 31, 62, 93, 124, 155, 186, 217, 248, 279, 310, 341, 372, 403, 434, 465, 496, 527, 558, 589, 620, 651, 682, 713, 731] ``` **Nota** È possibile attivare/disattivare Approfondimenti sulle prestazioni solo per un’istanza in un cluster di database in cui Approfondimenti sulle prestazioni non è gestito a livello di cluster. ------ #### [ RDS API ] Quando crei una nuova istanza DB utilizzando l'DBInstanceoperazione [Create](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) operation Amazon RDS API, attiva Performance Insights `EnablePerformanceInsights` impostando su. `True` Per disattivare Approfondimenti sulle prestazioni, imposta `EnablePerformanceInsights` su `False` e `DatabaseInsightsMode` su `standard`. Puoi anche specificare il valore `EnablePerformanceInsights` utilizzando le seguenti operazioni API: + [Crea DBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) (cluster DB Multi-AZ) + [Modifica DBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) (cluster DB Multi-AZ) + [ModificaDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) + [CreaDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) + [Ripristina DBInstance da S3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html) Quando si attiva Performance Insights, è possibile specificare, in via facoltativa, il periodo di tempo, in giorni, per cui conservare i dati degli approfondimenti delle prestazioni con il parametro `PerformanceInsightsRetentionPeriod`. È possibile specificare`7`, *month* \$1 31 (dove *month* è un numero compreso tra 1 e 23) o. `731` Ad esempio, se desideri mantenere i dati sulle prestazioni per 3 mesi, specifica `93`, che è 3 \$1 31. L'impostazione di default è `7` giorni. Per altre informazioni sui periodi di conservazione, consulta [Prezzi e conservazione dei dati per Performance Insights](USER_PerfInsights.Overview.cost.md). ------ # Panoramica dello schema di prestazioni per Approfondimenti sulle prestazioni su Amazon RDS per MariaDB o MySQL Performance Schema è una funzionalità facoltativa per il monitoraggio delle prestazioni di runtime di Amazon RDS for MariaDB o MySQL a un dettaglio di basso livello. Performance Schema è progettato per avere un impatto minimo sulle prestazioni del database. Performance Insights è una funzionalità separata che puoi utilizzare con o senza Performance Schema. **Topics** + [Panoramica dello schema di prestazioni](#USER_PerfInsights.EnableMySQL.overview) + [Performance Insights e lo schema di prestazioni](#USER_PerfInsights.effect-of-pfs) + [Gestione automatica di Performance Schema da parte di Performance Insights](#USER_PerfInsights.EnableMySQL.options) + [Effetto di un riavvio su Performance Schema](#USER_PerfInsights.EnableMySQL.reboot) + [Determinazione della gestione dello schema delle prestazioni da parte di Performance Insights](USER_PerfInsights.EnableMySQL.determining-status.md) + [Attivazione dello schema delle prestazioni per Amazon RDS per MariaDB o MySQL](USER_PerfInsights.EnableMySQL.RDS.md) ## Panoramica dello schema di prestazioni Performance Schema monitora gli eventi nei database MariaDB e MySQL. Un *evento* è un'azione del server di database che consuma tempo ed è stata strumentata in modo che possano essere raccolte le informazioni di temporizzazione. Ecco alcuni esempi di eventi: + Chiamate di funzione + Attendi il sistema operativo + Fasi dell'esecuzione SQL + Gruppi di istruzioni SQL Il motore di archiviazione `PERFORMANCE_SCHEMA` è un meccanismo per l'implementazione della funzionalità Performance Schema. Questo motore raccoglie i dati degli eventi utilizzando la strumentazione nel codice sorgente del database. Il motore memorizza gli eventi raccolti nelle tabelle in memoria nel database `performance_schema`. È possibile interrogare `performance_schema` proprio come puoi interrogare qualsiasi altra tabella. Per ulteriori informazioni, consulta [Performance Schema di MySQL](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) nel *Manuale di riferimento di MySQL*. ## Performance Insights e lo schema di prestazioni Performance Insights e Performance Schema sono funzionalità separate, ma sono connesse. Il comportamento di Performance Insights per Amazon RDS per MariaDB o MySQL varia a seconda che lo schema di prestazioni sia attivato e, in questo caso, se Performance Insights gestisce automaticamente lo schema di prestazioni. Il comportamento viene descritto nella tabella seguente. | Schema di prestazioni attivato | Modalità di gestione di Performance Insights | Comportamento di Performance Insights | | --- | --- | --- | | Sì | Automatica | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html) | | Sì | Manuale | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html) | | No | N/D | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html) | ## Gestione automatica di Performance Schema da parte di Performance Insights Quando crei un'istanza database Amazon RDS for MariaDB o MySQL con Performance Insights abilitato, anche la funzionalità Performance Schema viene abilitata. In questo caso, Performance Insights gestisce automaticamente i parametri di Performance Schema. Questa è la configurazione consigliata. Quando Approfondimenti sulle prestazioni gestisce automaticamente lo schema delle prestazioni l’**origine** di `performance_schema` è `System default`. **Nota** La gestione automatica dello schema di prestazioni non è supportata per la classe di istanza t4g.medium. Se modifichi il manualmente il parametro `performance_schema` e in seguito desideri ripristinare la gestione automatica, consulta [Attivazione dello schema delle prestazioni per Amazon RDS per MariaDB o MySQL](USER_PerfInsights.EnableMySQL.RDS.md). **Importante** Quando Performance Insights abilita Performance Schema, non modifica i valori del gruppo di parametri. Tuttavia, i valori vengono modificati sulle istanze database in esecuzione. L'unico modo per vedere i valori modificati è eseguire il comando `SHOW GLOBAL VARIABLES`. ## Effetto di un riavvio su Performance Schema Performance Insights e Performance Schema differiscono per i requisiti relativi al riavvio delle istanze DB: **Performance Schema** Per attivare o disattivare questa funzionalità, è necessario riavviare l'istanza database. **Approfondimenti sulle prestazioni** Per attivare o disattivare questa funzionalità, non è necessario riavviare l'istanza database. Se Performance Schema non è attualmente attivato e si attiva Performance Insights senza riavviare l'istanza database, Performance Schema non verrà attivato. # Determinazione della gestione dello schema delle prestazioni da parte di Performance Insights Per determinare se Approfondimenti sulle prestazioni gestisce lo schema delle prestazioni per tutte le versioni principali del motore, consulta la tabella riportata di seguito. | Impostazione del parametro performance\$1schema | Impostazione della colonna Source | Performance Insights sta gestendo Performance Schema? | | --- | --- | --- | | 0 | System default | Sì | | 0 o 1 | Modified | No | La seguente procedura consente di determinare se Approfondimenti sulle prestazioni gestisce automaticamente lo schema delle prestazioni. **Per determinare se Performance Insights sta gestendo automaticamente Performance Schema** 1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Scegliere **Gruppi di parametri**. 1. Selezionare il nome del gruppo di parametri per l'istanza database. 1. Inserire **performance\$1schema** nella barra di ricerca. 1. Controllare se **Origine** è il valore predefinito di sistema e **Valore** è impostato su **0**. In tal caso, Performance Insights gestisce automaticamente Performance Schema. In questo esempio, Approfondimenti sulle prestazioni non gestisce automaticamente lo schema delle prestazioni. ![\[Indica che le impostazioni per il parametro performance_schema sono state modificate.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_schema_user.png) # Attivazione dello schema delle prestazioni per Amazon RDS per MariaDB o MySQL Supponiamo che Performance Insights sia attivato per l'istanza database o per il cluster di database Multi-AZ ma al momento non stia gestendo Performance Schema. Se desideri consentire a Performance Insights di gestire automaticamente Performance Schema, completa la procedura seguente. **Configurazione di Performance Schema per la gestione automatica** 1. Accedi alla Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Scegliere **Gruppi di parametri**. 1. Selezionare il nome del gruppo di parametri per l'istanza database o il cluster di database Multi-AZ. 1. Scegli **Modifica**. 1. Inserire **performance\$1schema** nella barra di ricerca. 1. Selezionare il parametro `performance_schema`. 1. Scegliere **Imposta sul valore predefinito**. 1. Confermare scegliendo **Imposta i valori sull’impostazione predefinita**. 1. Seleziona **Salva modifiche**. 1. Riavviare l'istanza database o il cluster di database Multi-AZ. **Importante** Ogni volta che si abilita o disabilita Performance Schema, è necessario riavviare l'istanza database o il cluster di database Multi-AZ. Per ulteriori informazioni sulla modifica dei parametri di un'istanza, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md). Per ulteriori informazioni sulle pagine del pannello di controllo, consulta [Analisi delle metriche utilizzando il pannello di controllo Performance Insights](USER_PerfInsights.UsingDashboard.md). Per ulteriori informazioni sullo schema delle prestazioni di MySQL, consulta [Schema delle prestazioni di MySQL](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) (per 8.0) e [Schema delle prestazioni di MySQL](https://dev.mysql.com/doc/refman/8.4/en/performance-schema.html) (per 8.4) nella documentazione MySQL. # Configurazione delle policy di accesso per Performance Insights Per accedere a Performance Insights, un principale deve disporre delle autorizzazioni appropriate di AWS Identity and Access Management (IAM). **Nota** Per utilizzare Performance Insights con una chiave gestita dal cliente, concedi agli utenti le `kms:GenerateDataKey` autorizzazioni `kms:Decrypt` e per la tua chiave. AWS AWS KMS Accedi a Performance Insights utilizzando questi metodi: + [Allega la policy `AmazonRDSPerformanceInsightsReadOnly` gestita per l'accesso in sola lettura](USER_PerfInsights.access-control.managed-policy.md) + [Allega la policy `AmazonRDSPerformanceInsightsFullAccess` gestita per l'accesso a tutte le operazioni dell'API Performance Insights](USER_PerfInsights.access-control.FullAccess-managed-policy.md) + [Crea una policy IAM personalizzata con autorizzazioni specifiche](USER_PerfInsights.access-control.custom-policy.md) + [Configurare le AWS KMS autorizzazioni per i dati crittografati di Performance Insights](USER_PerfInsights.access-control.cmk-policy.md) + [Configura un accesso granulare utilizzando autorizzazioni a livello di risorsa](USER_PerfInsights.access-control.dimensionAccess-policy.md) + [Utilizza il controllo degli accessi basato su tag per gestire le autorizzazioni tramite tag di risorse](USER_PerfInsights.access-control.tag-based-policy.md) # Collegamento della policy AmazonRDSPerformanceInsightsReadOnly a un principale IAM `AmazonRDSPerformanceInsightsReadOnly`è una policy AWS gestita che garantisce l'accesso a tutte le operazioni di sola lettura dell'API Amazon RDS Performance Insights. Se ti colleghi `AmazonRDSPerformanceInsightsReadOnly` a un set di autorizzazioni o a un ruolo, devi allegare anche le seguenti autorizzazioni: CloudWatch + `GetMetricStatistics` + `ListMetrics` + `GetMetricData` Con queste autorizzazioni, il destinatario può utilizzare Performance Insights con altre funzionalità della console. Per ulteriori informazioni sulle CloudWatch autorizzazioni, consulta [Amazon CloudWatch permissions reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html). Per ulteriori informazioni su `AmazonRDSPerformanceInsightsReadOnly`, consultare [AWS politica gestita: Amazon RDSPerformance InsightsReadOnly](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsReadOnly). # Collegamento della policy AmazonRDSPerformanceInsightsFullAccess a un principale IAM `AmazonRDSPerformanceInsightsFullAccess`è una policy AWS gestita che garantisce l'accesso a tutte le operazioni dell'API Amazon RDS Performance Insights. Se ti colleghi `AmazonRDSPerformanceInsightsFullAccess` a un set di autorizzazioni o a un ruolo, devi allegare anche le seguenti CloudWatch autorizzazioni: + `GetMetricStatistics` + `ListMetrics` + `GetMetricData` Con queste autorizzazioni, il destinatario può utilizzare Performance Insights con altre funzionalità della console. Per ulteriori informazioni sulle CloudWatch autorizzazioni, consulta [Amazon CloudWatch permissions reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html). Per ulteriori informazioni su `AmazonRDSPerformanceInsightsFullAccess`, consultare [AWS politica gestita: Amazon RDSPerformance InsightsFullAccess](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsFullAccess). # Creazione di una policy IAM personalizzata per Approfondimenti sulle prestazioni Per gli utenti che non dispongono della policy `AmazonRDSPerformanceInsightsReadOnly` o `AmazonRDSPerformanceInsightsFullAccess`, è possibile fornire l’accesso a Approfondimenti sulle prestazioni creando o modificando una policy IAM gestita dall’utente. Quando si collega la policy a un set di autorizzazioni o 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 **Crea policy**, seleziona l’opzione **JSON**. 1. Copiare e incollare il testo fornito nella sezione del *documento di policy JSON* nella *Guida di riferimento sulle policy gestite da AWS * per la policy [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html) o [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsFullAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsFullAccess.html). 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, l'utente deve avere accesso a Amazon RDS nonché alla policy personalizzata. Ad esempio, la policy predefinita `AmazonRDSPerformanceInsightsReadOnly` concede l'accesso in sola lettura ad Amazon RDS. Per ulteriori informazioni, consulta [Gestione dell’accesso tramite policy](UsingWithRDS.IAM.md#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)**. In **Cerca** digita i primi caratteri del nome della policy, come mostrato nella seguente immagine. ![\[Scelta di una policy\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_attach_iam_policy.png) 1. Scegli la policy e quindi seleziona **Next: Review (Successivo: Rivedi)**. 1. Scegli **Add Permissions (Aggiungi autorizzazioni)**. # Modifica di una AWS KMS politica per Performance Insights Performance Insights utilizza an AWS KMS key per crittografare i dati sensibili. Quando abiliti Performance Insights mediante l'API o la console, sono disponibili le seguenti opzioni: + Scegli l'impostazione predefinita Chiave gestita da AWS. Amazon RDS lo utilizza Chiave gestita da AWS per la tua nuova istanza DB. Amazon RDS crea una Chiave gestita da AWS per il tuo Account AWS. Il tuo Account AWS ha un Amazon RDS diverso Chiave gestita da AWS per ognuno Regione AWS. + 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 [Policy delle chiavi in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) nella *Guida per gli sviluppatori di AWS Key Management Service *. **Example** Il seguente esempio mostra come aggiungere istruzioni alla policy della chiave KMS. Queste istruzioni consentono l'accesso a Performance Insights. A seconda della modalità di utilizzare la chiave KMS, potrebbe essere necessario modificare alcune restrizioni. Prima di aggiungere istruzioni alle policy, ai criteri, rimuovi tutti i commenti. **** ``` { "Version":"2012-10-17", "Id" : "your-policy", "Statement" : [ { "Sid" : "AllowViewingRDSPerformanceInsights", "Effect": "Allow", "Principal": { "AWS": [ "arn:aws:iam::444455556666:role/Role1" ] }, "Action": [ "kms:Decrypt", "kms:GenerateDataKey" ], "Resource": "*", "Condition" : { "StringEquals" : { "kms:ViaService" : "rds.us-east-1.amazonaws.com" }, "ForAnyValue:StringEquals": { "kms:EncryptionContext:aws:pi:service": "rds", "kms:EncryptionContext:service": "pi", "kms:EncryptionContext:aws:rds:db-id": "db-AAAAABBBBBCCCCDDDDDEEEEE" } } } ] } ``` ## In che modo Performance Insights utilizza la chiave gestita dal AWS KMS cliente La funzionalità Performance Insights utilizza una chiave gestita dal cliente per crittografare i dati sensibili. Quando attivi la funzionalità Performance Insights, puoi specificare una chiave AWS KMS tramite l'API. Performance Insights crea AWS KMS autorizzazioni su questa chiave. Utilizza la chiave ed esegue le operazioni necessarie per elaborare i dati sensibili. I dati sensibili includono campi come utente, database, applicazione e testo di query SQL. La funzionalità Performance Insights garantisce che i dati rimangano crittografati mentre sono sia in transito che inattivi. ## Come funziona Performance Insights con IAM AWS KMS IAM concede autorizzazioni a persone specifiche APIs. Performance Insights ha il seguente pubblico APIs, che puoi limitare utilizzando le policy IAM: + `DescribeDimensionKeys` + `GetDimensionKeyDetails` + `GetResourceMetadata` + `GetResourceMetrics` + `ListAvailableResourceDimensions` + `ListAvailableResourceMetrics` Puoi utilizzare le seguenti richieste API per recuperare i dati sensibili. + `DescribeDimensionKeys` + `GetDimensionKeyDetails` + `GetResourceMetrics` Quando utilizzi l'API per recuperare i dati sensibili, la funzionalità Approfondimenti sulle prestazioni usa le credenziali del chiamante. Questo controllo garantisce che l'accesso ai dati sensibili sia limitato a coloro che hanno accesso alla chiave KMS. Quando le chiami APIs, hai bisogno delle autorizzazioni per chiamare l'API tramite la policy IAM e delle autorizzazioni per richiamare l'`kms:decrypt`azione tramite la AWS KMS policy chiave. L'API `GetResourceMetrics` può restituire dati sensibili e non sensibili. I parametri della richiesta determinano se la risposta deve includere dati sensibili. L'API restituisce dati sensibili quando la richiesta include una dimensione sensibile nei parametri del filtro o nei parametri di raggruppamento. Per ulteriori informazioni sulle dimensioni che puoi utilizzare con l'`GetResourceMetrics`API, consulta. [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html) **Example Esempi** L'esempio seguente richiede i dati sensibili per il gruppo `db.user`: ``` POST / HTTP/1.1 Host: Accept-Encoding: identity X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics Content-Type: application/x-amz-json-1.1 User-Agent: X-Amz-Date: Authorization: AWS4-HMAC-SHA256 Credential=, SignedHeaders=, Signature= Content-Length: { "ServiceType": "RDS", "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W", "MetricQueries": [ { "Metric": "db.load.avg", "GroupBy": { "Group": "db.user", "Limit": 2 } } ], "StartTime": 1693872000, "EndTime": 1694044800, "PeriodInSeconds": 86400 } ``` **Example** L'esempio seguente richiede i dati non sensibili per la metrica `db.load.avg`: ``` POST / HTTP/1.1 Host: Accept-Encoding: identity X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics Content-Type: application/x-amz-json-1.1 User-Agent: X-Amz-Date: Authorization: AWS4-HMAC-SHA256 Credential=, SignedHeaders=, Signature= Content-Length: { "ServiceType": "RDS", "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W", "MetricQueries": [ { "Metric": "db.load.avg" } ], "StartTime": 1693872000, "EndTime": 1694044800, "PeriodInSeconds": 86400 } ``` # Concessione dell’accesso granulare per Approfondimenti sulle prestazioni Il controllo granulare dell’accesso offre ulteriori modi per controllare l’accesso a Approfondimenti sulle prestazioni. Questo controllo dell’accesso può consentire o negare l’accesso alle singole dimensioni e alle azioni `GetResourceMetrics`, `DescribeDimensionKeys` e `GetDimensionKeyDetails` di Approfondimenti sulle prestazioni. Per utilizzare l’accesso granulare, specificare le dimensioni nella policy IAM utilizzando le chiavi di condizione. La valutazione dell’accesso segue la logica di valutazione della policy IAM. Per ulteriori informazioni, consulta [Logica di valutazione delle policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html) nella *Guida per l’utente di IAM*. Se l’istruzione della policy IAM non specifica alcuna dimensione, l’istruzione controlla l’accesso a tutte le dimensioni per l’azione specificata. Per l’elenco delle dimensioni disponibili, consulta [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html). Per determinare a quali dimensioni le credenziali sono autorizzate ad accedere, utilizzare il parametro `AuthorizedActions` in `ListAvailableResourceDimensions` e specificare l’azione. I valori consentiti per `AuthorizedActions` sono: + `GetResourceMetrics` + `DescribeDimensionKeys` + `GetDimensionKeyDetails` Ad esempio, se si specifica `GetResourceMetrics` per il parametro `AuthorizedActions`, `ListAvailableResourceDimensions` restituisce l’elenco delle dimensioni a cui l’azione `GetResourceMetrics` è autorizzata ad accedere. Se si specificano più azioni nel parametro `AuthorizedActions`, `ListAvailableResourceDimensions` restituisce un’intersezione di dimensioni a cui tali azioni sono autorizzate ad accedere. **Example** L’esempio seguente fornisce l’accesso alle dimensioni specificate per le azioni `GetResourceMetrics` e `DescribeDimensionKeys`. **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowToDiscoverDimensions", "Effect": "Allow", "Action": [ "pi:ListAvailableResourceDimensions" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ] }, { "Sid": "SingleAllow", "Effect": "Allow", "Action": [ "pi:GetResourceMetrics", "pi:DescribeDimensionKeys" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ], "Condition": { "ForAllValues:StringEquals": { "pi:Dimensions": [ "db.sql_tokenized.id", "db.sql_tokenized.statement" ] } } } ] } ``` Di seguito è riportata la risposta per la dimensione richiesta: ``` // ListAvailableResourceDimensions API // Request { "ServiceType": "RDS", "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W", "Metrics": [ "db.load" ], "AuthorizedActions": ["DescribeDimensionKeys"] } // Response { "MetricDimensions": [ { "Metric": "db.load", "Groups": [ { "Group": "db.sql_tokenized", "Dimensions": [ { "Identifier": "db.sql_tokenized.id" }, // { "Identifier": "db.sql_tokenized.db_id" }, // not included because not allows in the IAM Policy { "Identifier": "db.sql_tokenized.statement" } ] } ] } ] } ``` L’esempio seguente specifica un accesso consentito e due accessi negati per le dimensioni. **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowToDiscoverDimensions", "Effect": "Allow", "Action": [ "pi:ListAvailableResourceDimensions" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ] }, { "Sid": "O01AllowAllWithoutSpecifyingDimensions", "Effect": "Allow", "Action": [ "pi:GetResourceMetrics", "pi:DescribeDimensionKeys" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ] }, { "Sid": "O01DenyAppDimensionForAll", "Effect": "Deny", "Action": [ "pi:GetResourceMetrics", "pi:DescribeDimensionKeys" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ], "Condition": { "ForAnyValue:StringEquals": { "pi:Dimensions": [ "db.application.name" ] } } }, { "Sid": "O01DenySQLForGetResourceMetrics", "Effect": "Deny", "Action": [ "pi:GetResourceMetrics" ], "Resource": [ "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W" ], "Condition": { "ForAnyValue:StringEquals": { "pi:Dimensions": [ "db.sql_tokenized.statement" ] } } } ] } ``` Di seguito sono riportate le risposte per le dimensioni richieste: ``` // ListAvailableResourceDimensions API // Request { "ServiceType": "RDS", "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W", "Metrics": [ "db.load" ], "AuthorizedActions": ["GetResourceMetrics"] } // Response { "MetricDimensions": [ { "Metric": "db.load", "Groups": [ { "Group": "db.application", "Dimensions": [ // removed from response because denied by the IAM Policy // { "Identifier": "db.application.name" } ] }, { "Group": "db.sql_tokenized", "Dimensions": [ { "Identifier": "db.sql_tokenized.id" }, { "Identifier": "db.sql_tokenized.db_id" }, // removed from response because denied by the IAM Policy // { "Identifier": "db.sql_tokenized.statement" } ] }, ... ] } ] } ``` ``` // ListAvailableResourceDimensions API // Request { "ServiceType": "RDS", "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W", "Metrics": [ "db.load" ], "AuthorizedActions": ["DescribeDimensionKeys"] } // Response { "MetricDimensions": [ { "Metric": "db.load", "Groups": [ { "Group": "db.application", "Dimensions": [ // removed from response because denied by the IAM Policy // { "Identifier": "db.application.name" } ] }, { "Group": "db.sql_tokenized", "Dimensions": [ { "Identifier": "db.sql_tokenized.id" }, { "Identifier": "db.sql_tokenized.db_id" }, // allowed for DescribeDimensionKeys because our IAM Policy // denies it only for GetResourceMetrics { "Identifier": "db.sql_tokenized.statement" } ] }, ... ] } ] } ``` # Utilizzo del controllo degli accessi basato su tag per Performance Insights Puoi controllare l'accesso alle metriche di Performance Insights utilizzando tag ereditati dall'istanza DB principale. Per controllare l'accesso alle operazioni di Performance Insights, utilizza le policy IAM. Queste policy possono controllare i tag sull'istanza DB per determinare le autorizzazioni. ## Come funzionano i tag con Performance Insights Performance Insights applica automaticamente i tag dell'istanza DB per autorizzare le metriche di Performance Insights. Quando aggiungi tag alla tua istanza DB, puoi utilizzarli immediatamente per controllare l'accesso ai dati di Performance Insights. + Per aggiungere o aggiornare i tag per le metriche di Performance Insights, modifica i tag sulla tua istanza DB. + Per visualizzare i tag per le metriche di Performance Insights, richiama la `ListTagsForResource` risorsa metrica Performance Insights. Restituirà i tag dall'istanza DB associata alla metrica. **Nota** Le `UntagResource` operazioni `TagResource` and restituiscono un errore se si tenta di utilizzarle direttamente nelle metriche di Performance Insights. ## Creazione di politiche IAM basate su tag Per controllare l'accesso alle operazioni di Performance Insights, utilizza la chiave `aws:ResourceTag` condition nelle tue policy IAM. Queste politiche controllano i tag sulla tua istanza DB. **Example** Questa politica impedisce l'accesso alle metriche di Performance Insights per i database di produzione. La politica nega l'`pi:GetResourceMetrics`operazione in Performance Insights per qualsiasi risorsa del database contrassegnata con`env:prod`. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "pi:GetResourceMetrics", "Resource": "*", "Condition": { "StringEquals": { "aws:ResourceTag/env": "prod" } } } ] } ``` # Analisi delle metriche utilizzando il pannello di controllo Performance Insights **Importante** AWS ha annunciato la end-of-life data di Performance Insights: 30 giugno 2026. Dopo questa data, Amazon RDS non supporterà più l’esperienza della console Approfondimenti sulle prestazioni, i periodi di conservazione flessibili (1-24 mesi) e i relativi prezzi. L’API Approfondimenti sulle prestazioni continuerà a esistere senza modifiche ai prezzi. I costi per l'API Performance Insights verranno visualizzati nella AWS fattura insieme al costo di CloudWatch Database Insights. Si consiglia di aggiornare tutte le istanze di database utilizzando il livello a pagamento di Performance Insights alla modalità Advanced di Database Insights prima del 30 giugno 2026. Per informazioni sull’aggiornamento alla modalità avanzata di Database Insights, consulta [Attivazione della modalità avanzata di Database Insights per Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md). Se non si esegue alcuna azione, le istanze database che utilizzano Approfondimenti sulle prestazioni, per impostazione predefinita useranno la modalità standard di Database Insights. Con la modalità standard di Database Insights, è possibile perdere l’accesso alla cronologia dei dati sulle prestazioni di oltre 7 giorni e non essere in grado di utilizzare i piani di esecuzione e le funzionalità di analisi on demand nella console Amazon RDS. Dopo il 30 giugno 2026 solo la modalità Advanced di Database Insights supporterà i piani di esecuzione e l'analisi su richiesta. Con CloudWatch Database Insights, puoi monitorare il carico del database per la tua flotta di database e analizzare e risolvere i problemi delle prestazioni su larga scala. Per ulteriori informazioni su Database Insights, consulta [Monitoraggio dei database Amazon RDS con CloudWatch Database Insights](USER_DatabaseInsights.md). Per informazioni sui prezzi, consulta la pagina [ CloudWatch dei prezzi di Amazon](https://aws.amazon.com/cloudwatch/pricing/). 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 del pannello di controllo è possibile visualizzare le informazioni relative al carico del database. Puoi "dividere" il carico del database per dimensioni come eventi di attesa o SQL. **Topics** + [Panoramica del pannello di controllo di Performance Insights](USER_PerfInsights.UsingDashboard.Components.md) + [Accesso al pannello di controllo di Performance Insights](USER_PerfInsights.UsingDashboard.Opening.md) + [Analisi del carico del database per eventi di attesa](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.md) + [Analisi delle prestazioni del database per un periodo di tempo](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md) + [Analisi delle query con la scheda SQL principale in Approfondimenti sulle prestazioni](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md) + [Analisi del caricamento di PDB principali Oracle](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB.md) + [Analisi dei piani di esecuzione utilizzando la dashboard di Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.UsingDashboard.AnalyzingPlans.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 la dashboard per un’istanza database PostgreSQL. ![\[Applicazione di filtri ai parametri\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_0b.png) **Topics** + [Filtro intervallo temporale](#USER_PerfInsights.UsingDashboard.Components.time-range) + [Grafico Parametri contatore](#USER_PerfInsights.UsingDashboard.Components.Countermetrics) + [Grafico di carico database](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions) + [Tabella dimensioni superiori](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable) ## Filtro intervallo temporale Di default, il pannello di controllo di Performance Insights mostra il carico del database relativo all’ultima ora. Puoi regolare questo intervallo di tempo da 5 minuti o fino a 2 anni. Puoi inoltre selezionare un intervallo relativo personalizzato. ![\[Tempo relativo per Performance Insights\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-relative-time.png) Puoi selezionare un intervallo assoluto con data e ora di inizio e fine. L’esempio seguente mostra l’intervallo di tempo che inizia a mezzanotte del 25/9/24 e termina alle 23:59 del 28/9/24. ![\[Tempo assoluto per Performance Insights\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-absolute-time.png) Per impostazione predefinita, il fuso orario per la dashboard di Approfondimenti sulle prestazioni è in formato Universal Time Coordinated (UTC). È anche possibile scegliere il fuso orario locale. ![\[Seleziona il fuso orario locale per la dashboard Approfondimenti sulle prestazioni\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-local-time-zone.png) ## 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 decine di parametri prestazionali di sistema operativo e database. 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. I parametri predefiniti dipendono dal motore DB: + MySQL e MariaDB – `db.SQL.Innodb_rows_read.avg` + Oracle – `db.User.user calls.avg` + Microsoft SQL Server – `db.Databases.Active Transactions(_Total).avg` + PostgreSQL – `db.Transactions.xact_commit.avg` ![\[Parametri dei contatori\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/oracle_perf_insights_counters.png) Per modificare i contatori delle prestazioni, scegli **Manage Metrics** (Gestisci parametri). È possibile selezionare più **parametri del sistema operativo** o **metriche del database**, come mostrato nello screenshot seguente. Per visualizzare i dettagli relativi a qualsiasi metrica, passare il mouse sul nome della metrica. ![\[Applicazione di filtri ai parametri\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_select_metrics.png) Per le descrizioni dei parametri contatore che è possibile aggiungere per ciascun motore database, consultare [Metriche contatore di Performance Insights](USER_PerfInsights_Counters.md). ## Grafico di carico database Il grafico **Database load** (Carico database) mostra le differenze dell’attività del database in base alla capacità dell’istanza database, rappresentate dalla riga **Max vCPU (vCPU massima)**. 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. ![\[Carico database\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_2.png) ### Carico del database suddiviso per dimensioni È possibile scegliere di visualizzare il carico sotto forma di sessioni attive raggruppate in base alle dimensioni supportate. La tabella seguente mostra le dimensioni supportate per i diversi motori. | Dimensione | Oracle | SQL Server | PostgreSQL | MySQL | | --- | --- | --- | --- | --- | | Host | Sì | Sì | Sì | Sì | | SQL | Sì | Sì | Sì | Sì | | Utente | Sì | Sì | Sì | Sì | | Stati di attesa | Sì | Sì | Sì | Sì | | Piani | Sì | No | No | No | | Applicazione | No | No | Sì | No | | Database | No | No | Sì | Sì | | Tipo di sessione | No | No | Sì | No | L’immagine seguente mostra le dimensioni di un’istanza database PostgreSQL. ![\[Applicazione di filtri ai parametri\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_2b.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 SQL. ![\[Dettagli elemento di caricamento del database\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_2c.png) Per visualizzare i dettagli relativi a qualsiasi elemento per il periodo di tempo selezionato nella legenda, passa il mouse su tale elemento. ![\[Dettagli del periodo di tempo per il caricamento del DB\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_3.png) ## Tabella dimensioni superiori La tabella delle dimensioni superiori seziona il carico DB in diverse dimensioni. Una dimensione è una categoria o una suddivisione per le diverse caratteristiche del carico del database. Se la dimensione è SQL, **Top SQL** (Prime istruzioni SQL) mostra le istruzioni SQL che contribuiscono maggiormente al carico DB. ![\[Dimensioni top N\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_4c.png) Scegli una delle seguenti schede di dimensione. | Scheda | Description | Motori supportati | | --- | --- | --- | | prime istruzioni SQL | Le istruzioni SQL correntemente in esecuzione | Tutti | | Principali stati d’attesa | L’evento per il quale il back-end del database è in attesa | Tutti | | Host principali | Il nome host del client connesso | Tutti | | Utenti principali | L’utente collegato al database | Tutti | | Database principali | Nome del database a cui è connesso il client | Solo PostgreSQL, MySQL, MariaDB e SQL Server | | Applicazioni principali | Il nome dell’applicazione connessa al database | Solo PostgreSQL e SQL Server | | Tipi di sessione principali | Il tipo di sessione corrente | Solo PostgreSQL | Per informazioni sull’analisi delle query tramite la scheda **Top SQL** (Prime istruzioni SQL), consulta [Panoramica della scheda Prime istruzioni SQL](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL). # Accesso al pannello di controllo di Performance Insights Amazon RDS fornisce una visualizzazione consolidata delle metriche di Performance Insights e CloudWatch nel pannello di controllo di Performance Insights. Per visualizzare il pannello di controllo di Performance Insights, procedi come indicato di seguito. **Per visualizzare il pannello di controllo di Performance Insights nella console di gestione AWS** 1. Apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Performance Insights**. 1. Scegli un'istanza database. Per le istanze database con Approfondimenti sulle prestazioni attivato, è possibile accedere alla dashboard Approfondimenti sulle prestazioni anche scegliendo la voce **Sessioni** nell’elenco delle istanze database. In **Current activity** (Attività corrente) la voce **Sessions** (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 database è inattiva. Con l'aumentare del carico, la barra si riempie ed è di colore blu. Quando il carico supera il numero di CPU virtuali (vCPU) nella classe di istanza database, la barra diventa rossa, a indicare un possibile collo di bottiglia. ![\[Applicazione di filtri ai parametri\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_0a.png) 1. (Facoltativo) Scegliere la data o l'intervallo di ore in alto a destra e specificare un intervallo di tempo relativo o assoluto diverso. È ora possibile specificare un periodo di tempo e generare un report di analisi delle prestazioni del database. Il report fornisce le informazioni e i suggerimenti identificati. Per ulteriori informazioni, consulta [Creazione di un report di analisi delle prestazioni in Approfondimenti sulle prestazioni](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md). ![\[Filtra le metriche per intervallo di tempo\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_0c.png) Nella schermata seguente, l'intervallo di caricamento DB è di 5 ore. ![\[Imposta l'intervallo di tempo su 5 ore\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_1.png) 1. (Facoltativo) Per ingrandire una parte del grafico di carico del database, scegli l'ora di inizio e trascina fino alla fine del periodo di tempo che ti interessa. L'area selezionata viene evidenziata nel grafico del carico del database. ![\[Carico del database per un intervallo di tempo specificato\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_zoom_in.png) Quando rilasci il mouse, la parte selezionata del grafico del carico del database si ingrandisce nella regione AWS selezionata e la tabella **Top *dimensions* (Dimensioni principali)** viene ricalcolata. ![\[Ingrandire il carico del database selezionato\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_zoom_in_b.png) 1. (Facoltativo) Per aggiornare automaticamente i dati, selezionare **Aggiornamento automatico**. ![\[Impostare l'aggiornamento automatico\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_1b.png) Il pannello di controllo di Performance Insights si aggiorna automaticamente in base ai nuovi dati. La frequenza di aggiornamento dipende dalla quantità di dati visualizzati: + Se scegli 5 minuti, l'aggiornamento avviene ogni 10 secondi. + Se scegli 1 ora, l'aggiornamento avviene ogni 5 minuti. + Se scegli 5 ore, l'aggiornamento avviene ogni 5 minuti. + Se scegli 24 ore, l'aggiornamento avviene ogni 30 minuti. + Se scegli 1 settimana, l'aggiornamento avviene ogni giorno. + Se scegli 1 mese, l'aggiornamento avviene ogni giorno. # Analisi del carico del database per eventi di attesa Se il grafico **Database load (Caricamento database)** mostra un collo di bottiglia, puoi identificare l'origine del carico. A questo scopo, osserva la tabella Top Load Items (Elementi con carico) sotto la tabella **Database load (Caricamento database)**. Scegli uno specifico elemento, come una query SQL o un utente, ed effettua il drill-down di tale elemento per vedere i relativi dettagli. Il carico del database raggruppato per attese e principali query SQL è la visualizzazione predefinita del pannello di controllo di Performance Insights. Questa combinazione offre di norma il maggior numero di informazioni 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 **SQL** della tabella Top Load Items (Elementi con carico massimo) mostra quali query fanno aumentare il carico. Il flusso di lavoro tipico per diagnosticare problemi di performance è il seguente: 1. Esaminare il grafico **Database load (Caricamento 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 (Caricamento database)** e individuare lo stato o gli stati di attesa che sono i principali responsabili. 1. Identificare le query digest che provocano il carico individuando quali delle query della scheda **SQL** nella tabella Top Load Items (Elementi con carico massimo) contribuiscono maggiormente agli stati di attesa. È possibile identificarle attraverso la colonna **DB Load by Waits (Carico del database in base alle attese)**. 1. Scegliere una delle query digest nella scheda **SQL** per espanderla e osservare le query figlio da cui è composta. Ad esempio, nel dashboard seguente, la **sincronizzazione file di registro** attende account per la maggior parte del carico DB. Anche l'attesa di **tutti i gruppi di lavoro LGWR** è elevata. Il grafico **Top SQL** mostra ciò che causa le attese di **sincronizzazione del file di registro**: istruzioni `COMMIT` frequenti. In questo caso, il commit meno frequentemente ridurrà il carico del DB. ![\[Errori di sincronizzazione dei file di registro\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_7.png) # Analisi delle prestazioni del database per un periodo di tempo Analizza le prestazioni del database con l’analisi on demand creando un report di analisi delle prestazioni per un periodo di tempo. I report di analisi delle prestazioni consentono di individuare problemi di prestazioni, come colli di bottiglia delle risorse o modifiche in una query nell’istanza database. Il pannello di controllo di Performance Insights consente di selezionare un periodo di tempo e creare un report di analisi delle prestazioni. Puoi anche aggiungere uno o più tag al report. Per utilizzare questa funzionalità, devi utilizzare il periodo di conservazione del piano a pagamento. Per ulteriori informazioni, consulta [Prezzi e conservazione dei dati per Performance Insights](USER_PerfInsights.Overview.cost.md) Il report è disponibile nella scheda **Report di analisi delle prestazioni - nuovi** per la selezione e la visualizzazione. Il report contiene informazioni dettagliate, parametri correlati e suggerimenti per risolvere il problema relativo alle prestazioni. Il report è disponibile per la visualizzazione per tutta la durata del periodo di conservazione di Performance Insights. Il report viene eliminato se l'ora di inizio del periodo di analisi del report è esterna al periodo di conservazione. È anche possibile eliminare il report prima della fine del periodo di conservazione. Per individuare i problemi di prestazioni e generare il report di analisi per l'istanza database, è necessario attivare Performance Insights. Per ulteriori informazioni sull'attivazione di Performance Insights, consultare [Attivazione e disattivazione di Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.Enabling.md). Per informazioni sull'assistenza alla regione, al motore di database e alla classe di istanza per questa funzionalità, consulta [Supporto del motore di database Aurora, della regione e della classe di istanza di Amazon Aurora per le funzionalità di Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport) Nelle sezioni seguenti è possibile creare, visualizzare, aggiungere tag ed eliminare un report di analisi delle prestazioni. **Topics** + [Creazione di un report di analisi delle prestazioni in Approfondimenti sulle prestazioni](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md) + [Visualizzazione di un report di analisi delle prestazioni in Approfondimenti sulle prestazioni](USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport.md) + [Aggiunta di tag a un report di analisi delle prestazioni in Approfondimenti sulle prestazioni](USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.md) + [Eliminazione di un report di analisi delle prestazioni in Approfondimenti sulle prestazioni](USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.md) # Creazione di un report di analisi delle prestazioni in Approfondimenti sulle prestazioni È possibile creare un report di analisi delle prestazioni per un periodo specifico nella pannello di controllo di Performance Insights. È possibile selezionare un periodo di tempo e aggiungere uno o più tag al report di analisi. Il periodo di analisi può variare da 5 minuti a 6 giorni. Occorre disporre di almeno 24 ore di dati di prestazioni prima dell’ora di inizio dell’analisi. Per informazioni sul supporto di Regioni, motori di database e classi di istanza per questa funzionalità, consulta [Supporto del motore di database Aurora, della regione e della classe di istanza di Amazon Aurora per le funzionalità di Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport) **Per creare un report di analisi delle prestazioni per un periodo di tempo** 1. Aprire la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Performance Insights**. 1. Scegli un’istanza database. 1. Scegli **Analizza le prestazioni** nella sezione **Carico del database** nella dashboard di Approfondimenti sulle prestazioni. Vengono visualizzati i campi per impostare il periodo di tempo e aggiungere uno o più tag al report di analisi delle prestazioni. ![\[Pannello di controllo di Performance Insights che mostra i campi per creare il report di analisi\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisReport.png) 1. Scegli il periodo di tempo. Se imposti un periodo di tempo nel campo **Intervallo relativo** o **Intervallo assoluto** nell’angolo in alto a destra, puoi inserire o selezionare la data e l’ora del report di analisi solo entro questo periodo di tempo. Se selezioni il periodo di analisi al di fuori di questo periodo di tempo, viene visualizzato un messaggio di errore. Per impostare il periodo di tempo, puoi effettuare una delle seguenti operazioni: + Premi e trascina uno qualsiasi dei dispositivi di scorrimento sul grafico del carico del database. Nella casella **Periodo di analisi delle prestazioni** viene visualizzato il periodo di tempo selezionato e il grafico del carico del database evidenzia il periodo di tempo selezionato. + Scegli **Data di inizio**, **Ora di inizio**, **Data di fine** e **Ora di fine** nella casella **Periodo di analisi delle prestazioni**. ![\[Pannello di controllo di Performance Insights con periodo di analisi selezionato\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisRep_TimePeriod.png) 1. (Facoltativo) Inserisci **Chiave** e **Valore-*opzionale*** per aggiungere un tag per il report. ![\[Pannello di controllo di Performance Insights con i campi per aggiungere un nuovo tag\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisRep_AddTag.png) 1. Scegli **Analizza le prestazioni**. Un banner mostra un messaggio a prescindere dall’esito della generazione del report. Il messaggio fornisce anche il collegamento per visualizzare il report. L’esempio seguente mostra il banner con il messaggio di creazione del report completata. ![\[Banner del messaggio di creazione del report di analisi\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/PI_CreateAnaysisRep_SuccessMsg.png) Il report è disponibile per la visualizzazione nella scheda **Report di analisi delle prestazioni - nuovi**. Puoi creare un report di analisi delle prestazioni utilizzando la AWS CLI. Per un esempio su come creare un report utilizzando AWS CLI, vedere[Creazione di un report di analisi delle prestazioni per un periodo di tempo](USER_PerfInsights.API.Examples.md#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport). # Visualizzazione di un report di analisi delle prestazioni in Approfondimenti sulle prestazioni Nella scheda **Report di analisi delle prestazioni - nuovi** vengono elencati tutti i report creati per l’istanza database. Per ogni report viene visualizzato quanto segue: + **ID**: identificatore univoco del report. + **Nome**: chiave di tag aggiunta al report. + **Ora di creazione del report**: ora in cui il report è stato creato. + **Ora di inizio dell’analisi**: ora di inizio dell’analisi nel report. + **Ora di fine dell’analisi**: ora di fine dell’analisi nel report. **Per visualizzare un report di analisi delle prestazioni** 1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Performance Insights**. 1. Scegli un’istanza database per la quale desideri visualizzare il report di analisi. 1. Scorri verso il basso e scegli la scheda **Report di analisi delle prestazioni - nuovo** nella dashboard di Approfondimenti sulle prestazioni. Vengono visualizzati tutti i report di analisi per i diversi periodi di tempo. 1. Scegli **ID** del report che desideri visualizzare. Il grafico del carico del database mostra l’intero periodo di analisi per impostazione predefinita se vengono identificati più approfondimenti. Se il report ha identificato un approfondimento, il grafico del carico del database visualizza l’approfondimento per impostazione predefinita. Nel pannello di controllo vengono elencati anche i tag per il report nella sezione **Tag**. L’esempio seguente mostra l’intero periodo di analisi per il report. ![\[Grafico del carico del database che mostra l’intero periodo del report di analisi\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/PI_EntireAnalysisRep.png) 1. Scegli l’approfondimento nell’elenco **Informazioni dettagliate sul carico del database** che desideri visualizzare se nel report vengono identificati più approfondimenti. Il pannello di controllo mostra il messaggio di approfondimento, il grafico del carico del database evidenziando il periodo di tempo dell’approfondimento, l’analisi e i suggerimenti e l’elenco dei tag del report. Nell’esempio seguente viene mostrato l’approfondimento del carico del database nel report. ![\[Grafico del carico del database che mostra l’approfondimento nel report\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/PI_AnalysisRepInsight_chart.png) ![\[Sezione di analisi delle informazioni sul report e suggerimenti\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/PI_AnalysisRepInsight_Recommendations.png) # Aggiunta di tag a un report di analisi delle prestazioni in Approfondimenti sulle prestazioni È possibile aggiungere un tag quando si crea o visualizza un report. È possibile aggiungere fino a 50 tag per un report. Per aggiungere i tag sono richieste autorizzazioni. Per ulteriori informazioni sulle policy di accesso per Performance Insights, consulta [Configurazione delle policy di accesso per Performance Insights](USER_PerfInsights.access-control.md) Per aggiungere uno o più tag durante la creazione di un report, consulta il passaggio 6 della procedura [Creazione di un report di analisi delle prestazioni in Approfondimenti sulle prestazioni](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md). **Per aggiungere uno o più tag durante la visualizzazione di un report** 1. Aprire la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Performance Insights**. 1. Scegli un’istanza database. Viene visualizzato il pannello di controllo di Approfondimenti sulle prestazioni per l’istanza database. 1. Scorri verso il basso e scegli la scheda **Report di analisi delle prestazioni - nuovi**. 1. Scegli il report per il quale desideri aggiungere i tag. Il pannello di controllo visualizza il report. 1. Scorri verso il basso fino a **Tag** e scegli **Gestisci i tag**. 1. Scegli **Aggiungi nuovo tag**. 1. Immetti **Chiave** e **Valore-*facoltativo*** e scegli **Aggiungi nuovo tag**. Nell’esempio seguente viene fornita la possibilità di aggiungere un nuovo tag per il report selezionato. ![\[Finestra Gestisci i tag per aggiungere nuovi tag al report\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/PI_AddTag_ManageTags.png) Viene creato un nuovo tag per il report. L’elenco dei tag per il report viene visualizzato nella sezione **Tag** sul pannello di controllo. Se desideri rimuovere un tag dal report, scegli **Rimuovi** accanto al tag. # Eliminazione di un report di analisi delle prestazioni in Approfondimenti sulle prestazioni È possibile eliminare un report dall’elenco dei report visualizzato nella scheda **Report di analisi delle prestazioni** o durante la visualizzazione di un report. **Per eliminare un report** 1. Aprire la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Performance Insights**. 1. Scegli un’istanza database. Viene visualizzato il pannello di controllo di Approfondimenti sulle prestazioni per l’istanza database. 1. Scorri verso il basso e scegli la scheda **Report di analisi delle prestazioni - nuovi**. 1. Seleziona il report che desideri eliminare e scegli **Elimina** nell’angolo in alto a destra. ![\[Pannello di controllo di Performance Insights da eliminare con un report selezionato per l’eliminazione\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/PI_DeleteAnalysisRep.png) Viene visualizzata una finestra di conferma. Il report viene eliminato dopo aver scelto l’opzione di conferma. 1. (Facoltativo) Scegli **ID** del report che desideri eliminare. Nella pagina del report, scegli **Elimina** nell’angolo in alto a destra. Viene visualizzata una finestra di conferma. Il report viene eliminato dopo aver scelto l’opzione di conferma. # Analisi delle query con la scheda SQL principale in Approfondimenti sulle prestazioni Nel pannello di controllo di Amazon RDS Performance Insights è possibile trovare informazioni relative alle query in esecuzione e recenti nella scheda **Top SQL (Prime istruzioni SQL)** nella tabella **Top dimensions (Dimensioni principali)**. Queste informazioni possono essere utilizzate per ottimizzare le query. **Topics** + [Panoramica della scheda Prime istruzioni SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL) + [Accesso a una maggiore quantità di testo SQL nel pannello di controllo di Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md) + [Visualizzazione delle statistiche SQL nel pannello di controllo di Performance Insights](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel.md) ## Panoramica della scheda Prime istruzioni SQL Per impostazione predefinita, la scheda **Top SQL** (Prime istruzioni SQL) mostra le 25 query che contribuiscono di più al carico del database. Per ottimizzare le query puoi analizzare le informazioni, ad esempio il testo della query e le statistiche SQL. È inoltre possibile scegliere le statistiche che desideri visualizzare nella scheda **Top SQL** (Prime istruzioni SQL). **Topics** + [Testo SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text) + [Statistiche SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics) + [Caricamento per attesa (AAS)](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits) + [Visualizzazione delle informazioni SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information) + [Scelta delle preferenze statistiche](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences) ### Testo SQL Per impostazione predefinita, ciascuna riga nella tabella **Top SQL** (Prime istruzioni SQL) mostra 500 byte di testo per ogni istruzione. ![\[Testo SQL\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/sql-text-oracle.png) Per informazioni su come visualizzare più dei 500 byte di testo SQL di default, consulta [Accesso a una maggiore quantità di testo SQL nel pannello di controllo di Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md). Un *digest SQL* è un composito di più query effettive strutturalmente simili ma potrebbero avere valori letterali diversi. Il digest sostituisce i valori codificati con un punto interrogativo. Ad esempio, un digest potrebbe essere `SELECT * FROM emp WHERE lname= ?`. Questo digest può includere le seguenti query figlio: ``` SELECT * FROM emp WHERE lname = 'Sanchez' SELECT * FROM emp WHERE lname = 'Olagappan' SELECT * FROM emp WHERE lname = 'Wu' ``` Per visualizzare le istruzioni SQL letterali in un digest, selezionare la query, quindi scegliere il simbolo più (\$1). Nell'esempio seguente, la query selezionata è un sunto. ![\[Digest SQL selezionato\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_4b.png) **Nota** Un sunto SQL raggruppa istruzioni SQL simili, ma non oscura le informazioni riservate. Performance Insights può mostrare il testo Oracle SQL come **Unknown (Sconosciuto)**. Il testo ha questo stato nelle seguenti situazioni: + Un utente di database Oracle diverso da `SYS` è attivo ma non esegue al momento SQL. Ad esempio, quando una query parallela viene completata, il coordinatore della query attende che i processi helper inviino le statistiche della sessione. Per tutta la durata dell'attesa, il testo della query risulta **Unknown (Sconosciuto)**. + Per un'istanza RDS per Oracle in Standard Edition 2, Oracle Resource Manager limita il numero di thread paralleli. Il processo in background che esegue questa attività fa sì che il testo della query venga visualizzato come **Unknown (Sconosciuto)**. ### Statistiche SQL *Statistiche SQL* sono parametri relativi alle prestazioni relative alle query SQL. Ad esempio, Performance Insights potrebbe mostrare esecuzioni al secondo o righe elaborate al secondo. Performance Insights raccoglie statistiche solo per le query più comuni. In genere, queste query corrispondono alle prime query per carico mostrate nel dashboard di Performance Insights. Tutte le righe della tabella **Top SQL** (Prime istruzioni SQL) mostra le statistiche rilevanti per l'istruzione SQL o il digest, come illustrato nell'esempio seguente. ![\[Prime istruzioni SQL\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_4.png) Performance Insights può segnalare `0.00` e `-` (sconosciuto) per le statistiche SQL. Questa situazione si verifica nelle seguenti condizioni: + Esiste un solo campione. Ad esempio, Performance Insights calcola i tassi di variazione per le query PostgreSQL di RDS sulla basa di molteplici campioni della vista `pg_stat_statements`. Quando un carico di lavoro viene eseguito per un breve periodo, Performance Insights potrebbe raccogliere solo un campione, il che significa che non è in grado di calcolare un tasso di varaizione. Il valore sconosciuto è rappresentato da un trattino (`-`). + Due campioni hanno gli stessi valori. Performance Insights non è in grado di calcolare un tasso di variazione perché non si è verificata alcuna variazione, quindi riporta il tasso come `0.00`. + Un'istruzione SQL RDS manca di un identificatore valido. PostgreSQL crea un identificatore per un'istruzione solo dopo la parsificazione e l'analisi. Pertanto, può esistere nelle strutture interne in memoria di PostgreSQL un'istruzione senza identificatore. Poiché Performance Insights esegue il campionamento delle strutture interne in memoria una volta al secondo, le query a bassa latenza potrebbero apparire solo in un singolo campione. Se l'identificatore della query non è disponibile per questo campione, Performance Insights non può associare questa istruzione alle relative statistiche. Il valore sconosciuto è rappresentato da un trattino (`-`). Per una descrizione delle statistiche SQL per i motori Amazon RDS, consulta [Statistiche SQL per Performance Insights](sql-statistics.md). ### Caricamento per attesa (AAS) In **Top SQL**, la colonna **Load by waits (AAS)** illustra la percentuale del carico del database associato a ciascun elemento di caricamento superiore. Questa colonna indica il carico per questo elemento in base a qualunque raggruppamento attualmente selezionato nel **grafico DB Load**. Per ulteriori informazioni sulle sessioni attive medie (AAS), consulta [Media delle sessioni attive](USER_PerfInsights.Overview.ActiveSessions.md#USER_PerfInsights.Overview.ActiveSessions.AAS). Ad esempio, è possibile raggruppare il **Carico DB** in base agli stati di attesa. Esaminare le query SQL nella tabella degli elementi di caricamento superiore. 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. ![\[Caricamento DB per attesa\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_6.png) ### Visualizzazione delle informazioni SQL Nella tabella **Top SQL (Prime istruzioni SQL)** è possibile aprire un'istruzione per visualizzarne le informazioni. Le informazioni vengono visualizzate nel riquadro inferiore. ![\[Tabella SQL superiore con query letterale selezionata\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-open.png) Puoi visualizzare i seguenti tipi di identificatori (ID) associati alle istruzioni SQL: + **ID SQL di supporto** –– Un valore hash dell'ID SQL. Questo valore serve solo come riferimento a un ID SQL quando si utilizza AWS Support. AWS Support non dispone dell'accesso agli ID SQL effettivi e al testo SQL. + **ID Digest di supporto** – Un valore hash dell'ID Digest. Questo valore serve solo come riferimento a un ID Digest quando si utilizza AWS Support. AWS Support non dispone dell'accesso agli ID Digest effettivi e al testo SQL. ### Scelta delle preferenze statistiche È possibile controllare le statistiche visualizzate nella scheda **Top SQL** (Prime istruzioni SQL) scegliendo l'icona **Preferenze**. ![\[Preferenze statistiche\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences-icon.png) Quando scegli l'icona **Preferences (Preferenze)**, viene visualizzata la finestra **Preferences (Preferenze)**. La schermata seguente è un esempio della finestra **Preferences** (Preferenze). ![\[Finestra Preferenze\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences.png) Abilitare le statistiche che si desidera visualizzare nella scheda **Top SQL (Prime istruzioni SQL)**, utilizzare il mouse per scorrere fino alla fine della finestra, quindi scegliere **Continua**. Per ulteriori informazioni sulle statistiche per secondo o per chiamata per i motori Amazon RDS, consulta la sezione delle statistiche SQL specifiche del motore in [Statistiche SQL per Performance Insights](sql-statistics.md) # Accesso a una maggiore quantità di testo SQL nel pannello di controllo di Performance Insights Per impostazione predefinita, ciascuna riga nella tabella **Top SQL** (Prime istruzioni SQL) mostra 500 byte di testo SQL per ciascuna istruzione SQL. ![\[500 byte di SQL\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-top-sql-bytes.png) Quando un'istruzione SQL supera i 500 byte, puoi visualizzare più testo nella sezione **SQL text (Testo SQL)** sotto la tabella **Top SQL** (Prime istruzioni SQL). In questo caso, la lunghezza massima per il testo visualizzato in **SQL text (Testo SQL)** è 4 KB. Questo limite viene introdotto dalla console ed è soggetto ai limiti impostati dal motore del database. Per salvare il testo visualizzato in **SQL text** (Testo SQL), scegli **Download** (Scarica). **Topics** + [Limiti delle dimensioni del testo per i motori Amazon RDS](#sql-text-engine-limits) + [Impostazione del limite di testo SQL per le istanze database Amazon RDS per PostgreSQL](USER_PerfInsights.UsingDashboard.SQLTextLimit.md) + [Visualizzazione e download del testo SQL nella dashboard di Approfondimenti sulle prestazioni.](view-download-text.md) ## Limiti delle dimensioni del testo per i motori Amazon RDS Durante il download di testo SQL, il motore del database determina la sua lunghezza massima. Puoi scaricare il testo SQL fino ai seguenti limiti per motore. | Motore database | Lunghezza massima del testo scaricato | | --- | --- | | Amazon RDS per MySQL e MariaDB | La lunghezza è fissata a 4.096 byte quando lo schema delle prestazioni è abilitato. Se lo schema delle prestazioni non è abilitato, la lunghezza è fissata a 65.535 byte. | | Amazon RDS for Microsoft SQL Server | 4,096 caratteri | | Amazon RDS per Oracle | 1.000 byte | La sezione **SQL Text** (Testo SQL) della console Performance Insights visualizza fino al massimo restituito dal motore. Ad esempio, se MySQL restituisce al massimo 1 KB a Performance Insights, può raccogliere e mostrare solo 1 KB, anche se la query originale è più grande. Pertanto, quando la query viene visualizzata in **SQL text** (Testo SQL) o scaricata, Performance Insights restituisce lo stesso numero di byte. Se si utilizza AWS CLI o l’API, Approfondimenti sulle prestazioni non ha il limite di 4 KB applicato dalla console. `DescribeDimensionKeys` e `GetResourceMetrics` restituiscono al massimo 500 byte. **Nota** `GetDimensionKeyDetails` restituisce la query completa, ma la dimensione è soggetta al limite del motore. # Impostazione del limite di testo SQL per le istanze database Amazon RDS per PostgreSQL Amazon RDS per PostgreSQL gestisce il testo in modo diverso. È possibile impostare il limite delle dimensioni del testo con il parametro di istanza database `track_activity_query_size`. Questo parametro presenta le caratteristiche seguenti: Dimensione di default del testo Su Aurora Amazon RDS per PostgreSQL versione 9.6, l’impostazione di default per il parametro `track_activity_query_size` è 1.024 byte. Su Amazon RDS per PostgreSQL versione 10 o successive, l’impostazione di default per il parametro è 4.096 byte. Dimensione massima del testo Il limite per `track_activity_query_size` è 102.400 byte per Amazon RDS per PostgreSQL versione 12 e versioni precedenti. Il massimo è di 1 MB per la versione 13 e quelle successive. Se il motore restituisce 1 MB a Performance Insights, la console visualizza solo i primi 4 KB. Se si scarica la query, si ottiene 1 MB per intero. In questo caso, la visualizzazione e il download restituiscono un numero diverso di byte. Per ulteriori informazioni sul parametro dell’istanza database `track_activity_query_size`, consulta [Run-time Statistics](https://www.postgresql.org/docs/current/runtime-config-statistics.html) nella documentazione di PostgreSQL. Per aumentare la dimensione del testo SQL, aumenta il limite di `track_activity_query_size`. Per modificare il parametro, modifica l’impostazione del parametro nel gruppo di parametri associato all’istanza database Amazon RDS per PostgreSQL. **Modifica dell’impostazione quando l’istanza utilizza il gruppo di parametri di default** 1. Crea un nuovo gruppo di parametri dell’istanza database per il motore del database e la versione del motore del database appropriati. 1. Imposta il parametro nel nuovo gruppo di parametri. 1. Associa il nuovo gruppo di parametri all’istanza database. Per ulteriori informazioni sull’impostazione di un parametro dell’istanza database, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md). # Visualizzazione e download del testo SQL nella dashboard di Approfondimenti sulle prestazioni. Nel pannello di controllo di Performance Insights è possibile visualizzare e scaricare il testo SQL. **Per visualizzare una maggiore quantità di testo SQL nel pannello di controllo di Performance Insights** 1. Aprire la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Approfondimenti sulle prestazioni**. 1. Scegli un'istanza database. 1. Scorri verso il basso fino alla scheda **SQL principale** nella dashboard di Approfondimenti sulle prestazioni. 1. Scegli il segno più per espandere un digest SQL e scegli una delle query secondarie del digest. Le istruzioni SQL con testo superiore a 500 byte sono simili a quelle nell'immagine seguente. ![\[Istruzioni SQL con testo ampio\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-1.png) 1. Scorri verso il basso fino alla scheda **Testo SQL**. ![\[La sezione Informazioni SQL mostra più del testo SQL\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-2.png) Il pannello di controllo di Performance Insights può visualizzare fino a 4.096 byte per ciascuna istruzione SQL. 1. (Facoltativo) Scegliere **Copia** per copiare l'istruzione SQL visualizzata oppure scegliere **Scarica** per scaricare l'istruzione SQL e visualizzare il testo SQL fino al limite del motore database. **Nota** Per copiare o scaricare l'istruzione SQL, disattiva i sistemi di blocco popup. # Visualizzazione delle statistiche SQL nel pannello di controllo di Performance Insights Nel pannello di controllo di Performance Insights, le statistiche SQL sono disponibili nella scheda **Top SQL (Prime istruzioni SQL)** del grafico **Database load (Carico database)**. **Per visualizzare le statistiche SQL** 1. Aprire la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Performance Insights**. 1. Nella parte superiore della pagina, scegli il database di cui desideri visualizzare le statistiche SQL. 1. Scorrere fino alla parte inferiore della pagina e scegli **Top SQL (Prime istruzioni SQL)**. 1. Scegli una specifica istruzione o un sunto di una query. ![\[Visualizzazione dei parametri delle query in esecuzione\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_sql.png) 1. Scegliere le statistiche da visualizzare selezionando l'icona a forma di ingranaggio nell'angolo in alto a destra del grafico. Per le descrizioni delle statistiche SQL per i motori Amazon RDS, consulta [Statistiche SQL per Performance Insights](sql-statistics.md). L'esempio seguente mostra le preferenze per statistiche per le istanze database Oracle. ![\[Preferenze dei parametri per l'esecuzione di query per le istanze database Oracle\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_oracle.png) Il seguente esempio mostra le preferenze per le istanze database MariaDB e MySQL. ![\[Preferenze dei parametri per l'esecuzione di query per le istanze database MariaDB e MySQL.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_ams.png) 1. Per salvare le preferenze, scegli Save (Salva). La tabella **Top SQL (Prime istruzioni SQL)** si aggiorna. L'esempio seguente mostra le statistiche per una query Oracle SQL. ![\[Statistiche per una query SQL\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_stats_oracle.png) # Analisi del caricamento di PDB principali Oracle Quando si analizza il caricamento su un database container Oracle (CDB), è possibile identificare quali database collegabili (PDB) contribuiscono maggiormente al caricamento del database. È anche possibile confrontare le prestazioni di singoli PDB che eseguono query simili per eseguire il fine-tuning delle prestazioni. Per ulteriori informazioni sui CDB Oracle, consulta [Architettura del database RDS per Oracle](oracle-multi-architecture.md). Nella dashboard di Approfondimenti sulle prestazioni di Amazon RDS è possibile trovare informazioni relative ai database collegabili (PDB) nella scheda **PDB principali** della scheda **Dimensioni**. Per informazioni sul supporto di Regioni, motori di database e classi di istanza per questa funzionalità, consulta [Supporto del motore di database Aurora, della regione e della classe di istanza di Amazon Aurora per le funzionalità di Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport). **Per analizzare il caricamento dei PDB principali in un CDB Oracle** 1. Accedi alla Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel riquadro di navigazione a sinistra scegli **Approfondimenti sulle prestazioni**. 1. Scegli un’istanza CDB Oracle. Viene visualizzato il pannello di controllo di Approfondimenti sulle prestazioni per l'istanza database. 1. Nella sezione **Caricamento del database**, scegli **Database collegabile (PDB)** accanto a Suddivisione per. Il grafico Sessioni attive medie mostra il PDB con il caricamento maggiore. Gli identificatori del PDB appaiono a destra dei quadrati con codice colore. Ogni identificatore identifica in modo univoco un PDB. ![\[Grafico Sessioni attive medie per il caricamento del PDB\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_AAS.png) 1. Scorri verso il basso fino alla scheda **Top SQL** (Prime istruzioni SQL). Nell’esempio seguente, è riportata la stessa query SQL e il caricamento che genera su più PDB. ![\[Stessa query SQL di caricamento per più PDB\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex1.png) Nell’esempio seguente, un singolo PDB gestisce un caricamento più elevato rispetto ad altri PDB nel CDB. ![\[Query SQL di caricamento elevato per PDB\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex2.png) Per ulteriori informazioni sui CDB Oracle, consulta [CDBs and PDBs](https://docs.oracle.com/en/database/oracle/oracle-database/21/cncpt/CDBs-and-PDBs.html#GUID-FC2EB562-ED31-49EF-8707-C766B6FE66B8). # Analisi dei piani di esecuzione utilizzando la dashboard di Approfondimenti sulle prestazioni per Amazon RDS Nella dashboard di Approfondimenti sulle prestazioni di Amazon RDS è possibile trovare informazioni relative ai piani di esecuzione per le istanze database Oracle e SQL Server. È possibile utilizzare queste informazioni per sapere quali piani contribuiscono maggiormente al caricamento del database. Per analizzare i piani di esecuzione Oracle o SQL Server, consulta i seguenti argomenti. **Analisi dei piani di esecuzione** + [Analisi dei piani di esecuzione di Oracle tramite la dashboard di Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md) + [Analisi dei piani di esecuzione di SQL Server utilizzando la dashboard Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md) ## Panoramica dell’analisi dei piani di esecuzione per Amazon RDS È possibile utilizzare la dashboard Approfondimenti sulle prestazioni di Amazon RDS per sapere quali piani contribuiscono maggiormente al caricamento del database per le istanze database Oracle e SQL Server. Ad esempio, le istruzioni SQL principali in un determinato momento potrebbero utilizzare i piani mostrati nella tabella seguente. **** | Prime istruzioni SQL | Pianificazione | | --- | --- | | SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 10 | Piano A | | SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 521 | Piano B | | SELECT SUM(s\$1total) FROM sales WHERE region = 10 | Piano A | | SELECT \$1 FROM emp WHERE emp\$1id = 1000 | Piano C | | SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 72 | Piano A | Con la caratteristica di pianificazione di Performance Insights, è possibile effettuare le seguenti operazioni: + Scoprire quali piani vengono utilizzati dalle principali query SQL. Ad esempio, potresti scoprire che la maggior parte del carico del database viene generato da query che utilizzano il piano A e il piano B, con solo una piccola percentuale che utilizza il piano C. + Confrontare piani diversi per la stessa query. Nell'esempio precedente, tre query sono identiche a eccezione dell'ID del prodotto. Due query utilizzano il piano A, ma una query utilizza il piano B. Per vedere la differenza tra i due piani, è possibile utilizzare Performance Insights. + Scoprire quando una query è passata a un nuovo piano. È possibile che una query utilizzasse il piano A e poi è passata al piano B in un determinato momento. Si è verificato un cambiamento nel database a questo punto? Ad esempio, se una tabella è vuota, l'ottimizzatore potrebbe scegliere una scansione completa della tabella. Se la tabella viene caricata con un milione di righe, l'ottimizzatore potrebbe passare a una scansione dell'intervallo su indice. + Esaminare le fasi specifiche di un piano con il costo più alto. Ad esempio, la query di lunga durata potrebbe mostrare una condizione di join mancante in un equi-join. Questa condizione mancante impone un'unione cartesiana, che unisce tutte le righe di due tabelle. È possibile eseguire le attività precedenti utilizzando la caratteristica di acquisizione del piano di Performance Insights. Proprio come è possibile suddividere le query in base agli eventi di attesa e a SQL principale, è possibile suddividerle anche in base alla dimensione del piano. # Analisi dei piani di esecuzione di Oracle tramite la dashboard di Approfondimenti sulle prestazioni per Amazon RDS Quando si analizza il carico del database su un database Oracle, è possibile sapere quali piani contribuiscono maggiormente al carico del database. È possibile determinare quali piani contribuiscono maggiormente al caricamento del database utilizzando la funzionalità di acquisizione del piano di Approfondimenti sulle prestazioni. **Per analizzare i piani di esecuzione di Oracle utilizzando la console** 1. Aprire la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Performance Insights**. 1. Scegli un'istanza database di Oracle. Viene visualizzato il pannello di controllo di Performance Insights per l'istanza database. 1. Nella sezione **Database load (DB load)** (Carico del database (Carico DB)), scegli **Plans** (Piani) accanto a **Slice by** (Dividi per). Il grafico Average active sessions (Media delle sessioni attive) mostra i piani utilizzati dalle istruzioni principali SQL. I valori hash del piano appaiono a destra dei quadrati con codice colore. Ogni valore hash identifica in modo univoco un piano. ![\[Dividi per piani\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans.png) 1. Scorri verso il basso fino alla scheda **Top SQL** (Prime istruzioni SQL). Nell'esempio seguente, il digest delle prime istruzioni SQL ha due piani. Si può dire che è un digest dal punto interrogativo nell'istruzione. ![\[Scegli un piano digest\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected.png) 1. Scegli il digest per espanderlo nelle istruzioni componenti. Nell'esempio seguente, l'istruzione `SELECT` è una query digest. Le query dei componenti nel digest utilizzano due piani diversi. I colori dei piani corrispondono al grafico del carico del database. Il numero totale di piani nel digest è mostrato nella seconda colonna. ![\[Scegli un piano digest\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/pi-digest-plan.png) 1. Scorri in basso e scegli due **Plans** (Piani) per il confronto dall'elenco **Plans for digest query** (Piani per la query digest). È possibile visualizzare uno o due piani per una query alla volta. Lo screenshot seguente confronta i due piani nel digest, con l'hash 2032253151 e l'hash 1117438016. Nell'esempio seguente, il 62% delle sessioni attive medie che eseguono questa query digest utilizza il piano a sinistra, mentre il 38% utilizza il piano a destra. ![\[Confronta i piani affiancati\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/pi-compare-plan.png) In questo esempio, i piani differiscono in modo importante. Il passaggio 2 del piano 2032253151 utilizza una scansione dell'indice, mentre il piano 1117438016 utilizza una scansione completa della tabella. Per una tabella con un numero elevato di righe, una query di una singola riga è quasi sempre più veloce con una scansione dell'indice. ![\[Confronta i piani affiancati\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/pi-table-access.png) 1. (Facoltativo) Scegli **Copy** (Copia) per copiare il piano negli appunti, oppure **Download** (Scarica) per salvare il piano sul disco rigido. # Analisi dei piani di esecuzione di SQL Server utilizzando la dashboard Approfondimenti sulle prestazioni per Amazon RDS Quando si analizza il caricamento del database su un database SQL Server, è possibile sapere quali piani contribuiscono maggiormente al caricamento del database. È possibile determinare quali piani contribuiscono maggiormente al caricamento del database utilizzando la funzionalità di acquisizione del piano di Approfondimenti sulle prestazioni. **Per analizzare i piani di esecuzione di SQL Server utilizzando la console** 1. Apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Performance Insights**. 1. Scegli un’istanza database SQL Server. Viene visualizzato il pannello di controllo di Performance Insights per l'istanza database. 1. Nella sezione **Database load (DB load)** (Carico del database (Carico DB)), scegli **Plans** (Piani) accanto a **Slice by** (Dividi per). Il grafico Average active sessions (Media delle sessioni attive) mostra i piani utilizzati dalle istruzioni principali SQL. I valori hash del piano appaiono a destra dei quadrati con codice colore. Ogni valore hash identifica in modo univoco un piano. ![\[Dividi per piani\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans-sqlserver.png) 1. Scorri verso il basso fino alla scheda **Top SQL** (Prime istruzioni SQL). Nell’esempio seguente, il digest di SQL principale ha tre piani. La presenza di un punto interrogativo nell’istruzione SQL indica che l’istruzione è un digest. Per visualizzare l’istruzione SQL completa, scegli un valore nella colonna **Istruzioni SQL**. ![\[Scegli un piano digest\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected-sqlserver.png) 1. Scegli il digest per espanderlo nelle istruzioni componenti. Nell'esempio seguente, l'istruzione `SELECT` è una query digest. Le query dei componenti nel digest utilizzano tre piani di esecuzione diversi. I colori dei piani corrispondono al grafico del caricamento del database. ![\[Scegli un piano digest\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/pi-digest-plan-sqlserver.png) 1. Scorri in basso e scegli due **Plans** (Piani) per il confronto dall'elenco **Plans for digest query** (Piani per la query digest). È possibile visualizzare uno o due piani per una query alla volta. Lo screenshot seguente confronta i due piani nel digest. Nell'esempio seguente, il 40% delle sessioni attive medie che eseguono questa query digest utilizza il piano a sinistra, mentre il 28% utilizza il piano a destra. ![\[Confronta i piani affiancati\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/pi-compare-plan-sqlserver.png) Nell’esempio precedente, i piani differiscono in modo significativo. Il passaggio 2 del piano a sinistra utilizza una scansione della tabella, mentre il piano sulla destra utilizza una scansione dell’indice cluster. Per una tabella con un numero elevato di righe, una query che recupera una singola riga è quasi sempre più veloce con una scansione dell’indice cluster. 1. (Facoltativo) Scegli l’icona **Impostazioni** nella tabella Dettagli piano per personalizzare la visibilità e l’ordine delle colonne. Lo screenshot seguente mostra la tabella Dettagli piano con la colonna **Elenco di output** come seconda colonna. ![\[Personalizzazione della visibilità e dell’ordine delle colonne nella tabella Dettagli piano\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/pi-plan-fields-sql-server.png) 1. (Facoltativo) Scegli **Copy** (Copia) per copiare il piano negli appunti, oppure **Download** (Scarica) per salvare il piano sul disco rigido. **Nota** Approfondimenti sulle prestazioni visualizza i piani di esecuzione stimati utilizzando una tabella ad albero gerarchico. La tabella include le informazioni di esecuzione parziali per ogni istruzione. Per ulteriori informazioni sulle colonne della tabella Dettagli piano, consulta [SET SHOWPLAN\$1ALL](https://learn.microsoft.com/en-us/sql/t-sql/statements/set-showplan-all-transact-sql) nella documentazione SQL Server. Per visualizzare le informazioni complete sull’esecuzione per un piano di esecuzione stimato, scegli **Scarica** per scaricare il piano, quindi carica il piano in SQL Server Management Studio. Per ulteriori informazioni sulla visualizzazione di un piano di esecuzione stimato utilizzando SQL Server Management Studio, consulta [Display an Estimated Execution Plan](https://learn.microsoft.com/en-us/sql/relational-databases/performance/display-the-estimated-execution-plan) nella documentazione SQL Server. # Visualizzazione delle raccomandazioni proattive di Approfondimenti sulle prestazioni Approfondimenti sulle prestazioni di Amazon RDS monitora metriche specifiche e crea automaticamente soglie analizzando quali livelli potrebbero essere potenzialmente problematici per una specifica risorsa. Quando i nuovi valori delle metriche superano una soglia predefinita in un determinato periodo di tempo, Approfondimenti sulle prestazioni genera una raccomandazione proattiva. Questa raccomandazione aiuta a evitare un impatto sulle prestazioni del database in futuro. Per ricevere queste raccomandazioni proattive, è necessario attivare Approfondimenti sulle prestazioni con un periodo di conservazione del piano a pagamento. Per ulteriori informazioni sull'attivazione di Performance Insights, consultare [Attivazione e disattivazione di Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.Enabling.md). Per informazioni sui prezzi e sulla conservazione dei dati per Approfondimenti sulle prestazioni, consulta [Prezzi e conservazione dei dati per Performance Insights](USER_PerfInsights.Overview.cost.md). Per determinare le Regioni, i motori di database e le classi di istanza supportate per le raccomandazioni proattive, consulta [Supporto del motore di database Aurora, della regione e della classe di istanza di Amazon Aurora per le funzionalità di Performance Insights](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport). È possibile visualizzare l’analisi dettagliata e le indagini consigliate delle raccomandazioni proattive nella pagina Dettagli della raccomandazione. Per ulteriori informazioni sulle raccomandazioni, consulta [Raccomandazioni da Amazon RDS](monitoring-recommendations.md). **Per visualizzare l’analisi dettagliata di una raccomandazione proattiva** 1. Accedi alla Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel riquadro di navigazione, effettuare una delle seguenti operazioni: + Scegliere **Raccomandazioni**. La pagina **Raccomandazioni** mostra un elenco di raccomandazioni ordinate in base alla gravità per tutte le risorse dell’account. + Scegliere **Database**, quindi scegliere **Raccomandazioni** per una risorsa nella pagina Database. La scheda **Raccomandazioni** mostra le raccomandazioni e i relativi dettagli per la risorsa selezionata. 1. Individuare una raccomandazione proattiva e scegliere **Visualizza dettagli**. Viene visualizzata la pagina Dettagli della raccomandazione. Il titolo fornisce il nome della risorsa interessata con il problema rilevato e la gravità. Di seguito sono riportati i componenti della pagina Dettagli della raccomandazione: + **Riepilogo delle raccomandazioni**: il problema rilevato, lo stato della raccomandazione e del problema, l’ora di inizio e di fine del problema, l’ora di modifica della raccomandazione e il tipo di motore. ![\[Pagina Dettagli della raccomandazione per una raccomandazione proattiva che mostra la sezione Riepilogo delle raccomandazioni nella console\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/RecommendationProactive-RecSummary.png) + **Parametri**: i grafici del problema rilevato. Ogni grafico mostra una soglia determinata dal comportamento di base della risorsa e dai dati della metrica indicata dall’ora di inizio del problema. ![\[Pagina Dettagli della raccomandazione per una raccomandazione proattiva che mostra la sezione Parametri nella console\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/RecommedationProactive_Metrics.png) + **Analisi e raccomandazioni**: la raccomandazione e il motivo della raccomandazione suggerita. ![\[Pagina Dettagli della raccomandazione per una raccomandazione proattiva che mostra la sezione Analisi e raccomandazioni nella console\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/ProactiveRecommendation-AnalysisAndRec.png) È possibile esaminare la causa del problema e quindi eseguire le azioni consigliate suggerite per risolvere il problema oppure scegliere **Ignora** in alto a destra per ignorare la raccomandazione. # Recupero delle metriche con l’API Approfondimenti sulle prestazioni per Amazon RDS Quando Performance Insights è attivato, l'API fornisce visibilità sulle prestazioni dell'istanza. Amazon CloudWatch Logs fornisce la fonte autorevole per i parametri di monitoraggio venduti per i servizi 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 `SQL`, `Wait-event`, `User` o `Host`, misurato in corrispondenza di quel punto temporale. Amazon RDS Performance Insights monitora il cluster dell'istanza database Amazon RDS per consentire di analizzare e risolvere i problemi di performance 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 di Performance Insights, abilita Performance Insights su una delle istanze database Amazon RDS. Per informazioni sull'abilitazione di Performance Insights, consulta [Attivazione e disattivazione di Approfondimenti sulle prestazioni per Amazon RDS](USER_PerfInsights.Enabling.md). Per ulteriori informazioni sull'API di Performance Insights, consulta la [Documentazione di riferimento dell'API di Amazon RDS 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 command | Descrizione | | --- | --- | --- | | [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/CreatePerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/CreatePerformanceAnalysisReport.html) | Crea un report di analisi delle prestazioni per un periodo di tempo specifico per l'istanza database. Il risultato è `AnalysisReportId` che è l'identificatore univoco del report. | | [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/DeletePerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/DeletePerformanceAnalysisReport.html) | Elimina un report di analisi delle prestazioni. | | [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 SQL e se i dettagli delle dimensioni sono disponibili, `GetDimensionKeyDetails` recupera il testo completo delle dimensioni `db.sql.statement` associate a questo ID. Questa operazione è utile perché `GetResourceMetrics` e `DescribeDimensionKeys` non supportano il recupero di testi di istruzioni SQL di grandi dimensioni. | | [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/GetPerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/GetPerformanceAnalysisReport.html) | Recupera il report, comprese le informazioni dettagliate relative al report. Il risultato include lo stato del report, l'ID del report, i dettagli sull'ora del report, le informazioni dettagliate e i suggerimenti. | | [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. | | `[ListPerformanceAnalysisReports](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListPerformanceAnalysisReports.html)` | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-performance-analysis-reports.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-performance-analysis-reports.html) | Recupera tutti i report di analisi disponibili per l'istanza database. I report sono elencati in base all'ora di inizio di ciascun report. | | `[ListTagsForResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListTagsForResource.html)` | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-tags-for-resource.html) | Elenca tutti i tag dei metadati aggiunti alla risorsa. L'elenco include il nome e il valore del tag. | | `[TagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_TagResource.html)` | [https://docs.aws.amazon.com/cli/latest/reference/pi/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/tag-resource.html) | Aggiunge tag dei metadati alla risorsa Amazon RDS. Il tag include un nome e un valore. | | `[UntagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_UntagResource.html)` | [https://docs.aws.amazon.com/cli/latest/reference/pi/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/untag-resource.html) | Rimuove tag dei metadati dalla risorsa. | Per ulteriori informazioni sul recupero delle metriche di serie temporali e gli esempi di AWS CLI per Approfondimenti sulle prestazioni, consulta gli argomenti riportati di seguito. **Topics** + [Recupero delle metriche di serie temporali per Approfondimenti sulle prestazioni](USER_PerfInsights.API.TimeSeries.md) + [AWS CLI esempi di Performance Insights](USER_PerfInsights.API.Examples.md) # Recupero delle metriche di serie temporali per Approfondimenti sulle prestazioni 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, la Console di gestione AWS utilizza `GetResourceMetrics` per popolare il grafico **Counter Metrics (Parametri contatore)** e il grafico **Database Load (Carico del database)**, come illustrato nell'immagine seguente. ![\[Grafici Counter Metrics (Parametri contatore) e Database Load (Carico del database)\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/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 [Metriche contatore di Performance Insights](USER_PerfInsights_Counters.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 ulteriori informazioni sull'utilizzo del comando `get-resource-metrics` della AWS CLI, consulta [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 Nelle sezioni seguenti, scopri di più su AWS Command Line Interface (AWS CLI) for Performance Insights ed AWS CLI esempi di utilizzo. **Topics** + [Guida integrata AWS CLI per Performance Insights](#USER_PerfInsights.API.CLI) + [Recupero dei parametri contatore](#USER_PerfInsights.API.Examples.CounterMetrics) + [Recupero della media del carico del database per i principali eventi di attesa](#USER_PerfInsights.API.Examples.DBLoadAverage) + [Recupero della media del carico del database per il principale SQL](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL) + [Recupero della media del carico del database filtrata da SQL](#USER_PerfInsights.API.Examples.DBLoadAverageFilterBySQL) + [Recupero del testo completo di un'istruzione SQL](#USER_PerfInsights.API.Examples.GetDimensionKeyDetails) + [Creazione di un report di analisi delle prestazioni per un periodo di tempo](#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport) + [Recupero di un report di analisi delle prestazioni](#USER_PerfInsights.API.Examples.GetPerfAnalysisReport) + [Elenco di tutti i report di analisi delle prestazioni per l'istanza database](#USER_PerfInsights.API.Examples.ListPerfAnalysisReports) + [Eliminazione di un report di analisi delle prestazioni](#USER_PerfInsights.API.Examples.DeletePerfAnalysisReport) + [Aggiunta di un tag a un report di analisi delle prestazioni](#USER_PerfInsights.API.Examples.TagPerfAnalysisReport) + [Elenco di tutti i tag per un report di analisi delle prestazioni](#USER_PerfInsights.API.Examples.ListTagsPerfAnalysisReport) + [Eliminazione di tag da un report di analisi delle prestazioni](#USER_PerfInsights.API.Examples.UntagPerfAnalysisReport) ## Guida integrata AWS CLI per Performance Insights Puoi visualizzare i dati di Performance Insights utilizzando la AWS CLI. È possibile visualizzare la guida per i AWS CLI comandi di Performance Insights immettendo quanto segue nella riga di comando. ``` aws pi help ``` Se non lo hai AWS CLI installato, consulta [Installazione di AWS CLI nella](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) *Guida per l'AWS CLI utente* per informazioni sull'installazione. ## 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/AmazonRDS/latest/UserGuide/images/perf-insights-api-counters-charts.png) L'esempio seguente mostra come raccogliere gli stessi dati Console di gestione AWS utilizzati per generare i due grafici contimetrici. Per Linux, macOS o Unix: ``` aws pi get-resource-metrics \ --service-type RDS \ --identifier db-ID \ --start-time 2018-10-30T00:00:00Z \ --end-time 2018-10-30T01: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 RDS ^ --identifier db-ID ^ --start-time 2018-10-30T00:00:00Z ^ --end-time 2018-10-30T01: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 RDS \ --identifier db-ID \ --start-time 2018-10-30T00:00:00Z \ --end-time 2018-10-30T01:00:00Z \ --period-in-seconds 60 \ --metric-queries file://query.json ``` Per Windows: ``` aws pi get-resource-metrics ^ --service-type RDS ^ --identifier db-ID ^ --start-time 2018-10-30T00:00:00Z ^ --end-time 2018-10-30T01:00:00Z ^ --period-in-seconds 60 ^ --metric-queries file://query.json ``` L'esempio precedente specifica i seguenti valori per le opzioni: + `--service-type` – `RDS` for Amazon RDS + `--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. ``` { "Identifier": "db-XXX", "AlignedStartTime": 1540857600.0, "AlignedEndTime": 1540861200.0, "MetricList": [ { //A list of key/datapoints "Key": { "Metric": "os.cpuUtilization.user.avg" //Metric1 }, "DataPoints": [ //Each list of datapoints has the same timestamps and same number of items { "Timestamp": 1540857660.0, //Minute1 "Value": 4.0 }, { "Timestamp": 1540857720.0, //Minute2 "Value": 4.0 }, { "Timestamp": 1540857780.0, //Minute 3 "Value": 10.0 } //... 60 datapoints for the os.cpuUtilization.user.avg metric ] }, { "Key": { "Metric": "os.cpuUtilization.idle.avg" //Metric2 }, "DataPoints": [ { "Timestamp": 1540857660.0, //Minute1 "Value": 12.0 }, { "Timestamp": 1540857720.0, //Minute2 "Value": 13.5 }, //... 60 datapoints for the os.cpuUtilization.idle.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 del carico del database per i principali eventi di attesa L'esempio seguente è la stessa query Console di gestione AWS utilizzata per generare un grafico a linee ad area impilata. L'esempio recupera `db.load.avg` per l'ultima ora con carico diviso in base ai sette principali eventi di attesa. Il comando è come quello in [Recupero dei parametri contatore](#USER_PerfInsights.API.Examples.CounterMetrics). Tuttavia, il file query.json presenta i seguenti contenuti. ``` [ { "Metric": "db.load.avg", "GroupBy": { "Group": "db.wait_event", "Limit": 7 } } ] ``` Eseguire il comando riportato qui di seguito. Per Linux, macOS o Unix: ``` aws pi get-resource-metrics \ --service-type RDS \ --identifier db-ID \ --start-time 2018-10-30T00:00:00Z \ --end-time 2018-10-30T01:00:00Z \ --period-in-seconds 60 \ --metric-queries file://query.json ``` Per Windows: ``` aws pi get-resource-metrics ^ --service-type RDS ^ --identifier db-ID ^ --start-time 2018-10-30T00:00:00Z ^ --end-time 2018-10-30T01:00:00Z ^ --period-in-seconds 60 ^ --metric-queries file://query.json ``` L'esempio specifica il parametro di `db.load.avg` e un `GroupBy` dei sette principali eventi 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. ``` { "Identifier": "db-XXX", "AlignedStartTime": 1540857600.0, "AlignedEndTime": 1540861200.0, "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": 1540857660.0, //Minute1 "Value": 0.5166666666666667 }, { "Timestamp": 1540857720.0, //Minute2 "Value": 0.38333333333333336 }, { "Timestamp": 1540857780.0, //Minute 3 "Value": 0.26666666666666666 } //... 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_event.name": "CPU", "db.wait_event.type": "CPU" } }, "DataPoints": [ { "Timestamp": 1540857660.0, //Minute1 "Value": 0.35 }, { "Timestamp": 1540857720.0, //Minute2 "Value": 0.15 }, //... 60 datapoints for the CPU key ] }, //... In total we have 8 key/datapoints entries, 1) total, 2-8) Top Wait Events ] //end of MetricList } //end of response ``` In questa risposta, ci sono otto voci in `MetricList`. C'è una voce per il `db.load.avg` totale e sette voci ciascuno per il `db.load.avg` suddivise secondo uno dei sette principali eventi di attesa. A differenza del primo esempio, poiché era presente una dimensione di raggruppamento, deve esserci una chiave per ciascun raggruppamento del parametro. Può esserci una sola chiave per ciascun parametro, come nel caso d'uso del parametro contatore di base. ## Recupero della media del carico del database per il principale SQL L'esempio seguente raggruppa `db.wait_events` in base alle 10 principali istruzioni SQL. Ci sono due diversi gruppi per le istruzioni SQL: + `db.sql` – L'istruzione SQL completa, come `select * from customers where customer_id = 123` + `db.sql_tokenized` – L'istruzione SQL in formato token, come `select * from customers where customer_id = ?` Quando si analizzano le prestazioni del database, può essere utile considerare le istruzioni SQL che si differenziano solo per i loro parametri come un unico elemento logico. Pertanto, puoi utilizzare `db.sql_tokenized` durante le query. Tuttavia, soprattutto se ti interessano piani explain, a volte è più utile esaminare le istruzioni SQL complete con parametri e raggruppamento di query per `db.sql`. Vi è una relazione padre-figlio tra SQL in formato token e completo, con più SQL completi (figli) raggruppati nello stesso SQL in formato token (padre). Il comando in questo esempio è simile a quello in [Recupero della media del carico del database per i principali eventi di attesa](#USER_PerfInsights.API.Examples.DBLoadAverage). Tuttavia, il file query.json presenta i seguenti contenuti. ``` [ { "Metric": "db.load.avg", "GroupBy": { "Group": "db.sql_tokenized", "Limit": 10 } } ] ``` Nell'esempio seguente viene utilizzato `db.sql_tokenized`. Per Linux, macOS o Unix: ``` aws pi get-resource-metrics \ --service-type RDS \ --identifier db-ID \ --start-time 2018-10-29T00:00:00Z \ --end-time 2018-10-30T00:00:00Z \ --period-in-seconds 3600 \ --metric-queries file://query.json ``` Per Windows: ``` aws pi get-resource-metrics ^ --service-type RDS ^ --identifier db-ID ^ --start-time 2018-10-29T00:00:00Z ^ --end-time 2018-10-30T00:00:00Z ^ --period-in-seconds 3600 ^ --metric-queries file://query.json ``` Questo esempio esegue query nell'arco di 24 ore, di cui un'ora period-in-seconds. L'esempio specifica il parametro di `db.load.avg` e un `GroupBy` dei sette principali eventi 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": 1540771200.0, "AlignedEndTime": 1540857600.0, "Identifier": "db-XXX", "MetricList": [ //11 entries in the MetricList { "Key": { //First key is total "Metric": "db.load.avg" } "DataPoints": [ //Each DataPoints list has 24 per-hour Timestamps and a value { "Value": 1.6964980544747081, "Timestamp": 1540774800.0 }, //... 24 datapoints ] }, { "Key": { //Next key is the top tokenized SQL "Dimensions": { "db.sql_tokenized.statement": "INSERT INTO authors (id,name,email) VALUES\n( nextval(?) ,?,?)", "db.sql_tokenized.db_id": "pi-2372568224", "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }, "Metric": "db.load.avg" }, "DataPoints": [ //... 24 datapoints ] }, // In total 11 entries, 10 Keys of top tokenized SQL, 1 total key ] //End of MetricList } //End of response ``` Questa risposta ha 11 voci in `MetricList` (1 SQL totale, 10 SQL principali in formato token), dove ciascuna ha 24 `DataPoints` ogni ora. Per SQL in formato token, ci sono tre voci in ciascun elenco di dimensioni: + `db.sql_tokenized.statement` – L'istruzione SQL in formato token. + `db.sql_tokenized.db_id ` – L'ID database nativo utilizzato per fare riferimento a SQL o un ID sintetico che Performance Insights genera nel caso in cui l'ID database nativo non sia disponibile. Questo esempio restituisce l'ID sintetico `pi-2372568224`. + `db.sql_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 dati e quasi tutti i dati vengono archiviati crittografati con la AWS KMS chiave dell'utente. 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.sql_tokenized.statement`, è possibile aggiungere l'attributo `Dimensions` al file query.json. ``` [ { "Metric": "db.load.avg", "GroupBy": { "Group": "db.sql_tokenized", "Dimensions":["db.sql_tokenized.statement"], "Limit": 10 } } ] ``` ## Recupero della media del carico del database filtrata da SQL ![\[Grafico Filter by SQL (Filtro per SQL).\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-api-filter-chart.png) L'immagine precedente mostra che è stata selezionata una particolare query e che il grafico a linee ad area in pila con sessioni attive della media in alto è definito in base a tale query. Sebbene la query sia ancora per i sette principali eventi di attesa complessivi, il valore della risposta è filtrato. Il filtro fa sì che vengano prese in considerazione solo le sessioni che corrispondono al filtro specifico. La query dell'API corrispondente in questo esempio è simile al comando in [Recupero della media del carico del database per il principale SQL](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL). Tuttavia, il file query.json presenta i seguenti contenuti. ``` [ { "Metric": "db.load.avg", "GroupBy": { "Group": "db.wait_event", "Limit": 5 }, "Filter": { "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE" } } ] ``` Per Linux, macOS o Unix: ``` aws pi get-resource-metrics \ --service-type RDS \ --identifier db-ID \ --start-time 2018-10-30T00:00:00Z \ --end-time 2018-10-30T01:00:00Z \ --period-in-seconds 60 \ --metric-queries file://query.json ``` Per Windows: ``` aws pi get-resource-metrics ^ --service-type RDS ^ --identifier db-ID ^ --start-time 2018-10-30T00:00:00Z ^ --end-time 2018-10-30T01:00:00Z ^ --period-in-seconds 60 ^ --metric-queries file://query.json ``` La risposta è simile a quella riportata di seguito. ``` { "Identifier": "db-XXX", "AlignedStartTime": 1556215200.0, "MetricList": [ { "Key": { "Metric": "db.load.avg" }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 1.4878117913832196 }, { "Timestamp": 1556222400.0, "Value": 1.192823803967328 } ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.type": "io", "db.wait_event.name": "wait/io/aurora_redo_log_flush" } }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 1.1360544217687074 }, { "Timestamp": 1556222400.0, "Value": 1.058051341890315 } ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.type": "io", "db.wait_event.name": "wait/io/table/sql/handler" } }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 0.16241496598639457 }, { "Timestamp": 1556222400.0, "Value": 0.05163360560093349 } ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.type": "synch", "db.wait_event.name": "wait/synch/mutex/innodb/aurora_lock_thread_slot_futex" } }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 0.11479591836734694 }, { "Timestamp": 1556222400.0, "Value": 0.013127187864644107 } ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.type": "CPU", "db.wait_event.name": "CPU" } }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 0.05215419501133787 }, { "Timestamp": 1556222400.0, "Value": 0.05805134189031505 } ] }, { "Key": { "Metric": "db.load.avg", "Dimensions": { "db.wait_event.type": "synch", "db.wait_event.name": "wait/synch/mutex/innodb/lock_wait_mutex" } }, "DataPoints": [ { "Timestamp": 1556218800.0, "Value": 0.017573696145124718 }, { "Timestamp": 1556222400.0, "Value": 0.002333722287047841 } ] } ], "AlignedEndTime": 1556222400.0 } //end of response ``` In questa risposta, tutti i valori vengono filtrati in base al contributo dell'AKIAIOSFODNN7esempio SQL tokenizzato specificato nel file query.json. Le chiavi potrebbero inoltre seguire un ordine diverso rispetto a una query senza filtro, in quanto sono i cinque principali eventi di attesa che influenzano l'SQL filtrato. ## Recupero del testo completo di un'istruzione SQL L'esempio seguente recupera il testo completo di un'istruzione SQL per l'istanza database `db-10BCD2EFGHIJ3KL4M5NO6PQRS5`. `--group` è `db.sql`, e `--group-identifier` è `db.sql.id`. In questo esempio, *my-sql-id* rappresenta un ID SQL recuperato richiamando o. `pi get-resource-metrics` `pi describe-dimension-keys` Eseguire il seguente comando seguente. Per Linux, macOS o Unix: ``` aws pi get-dimension-key-details \ --service-type RDS \ --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 \ --group db.sql \ --group-identifier my-sql-id \ --requested-dimensions statement ``` Per Windows: ``` aws pi get-dimension-key-details ^ --service-type RDS ^ --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 ^ --group db.sql ^ --group-identifier my-sql-id ^ --requested-dimensions statement ``` In questo esempio, sono disponibili i dettagli delle dimensioni. Pertanto, Performance Insights recupera il testo completo dell’istruzione SQL, senza troncarla. ``` { "Dimensions":[ { "Value": "SELECT e.last_name, d.department_name FROM employees e, departments d WHERE e.department_id=d.department_id", "Dimension": "db.sql.statement", "Status": "AVAILABLE" }, ... ] } ``` ## Creazione di un report di analisi delle prestazioni per un periodo di tempo L'esempio seguente crea un report di analisi delle prestazioni con l'ora di inizio `1682969503` e l'ora di fine `1682979503` per il database `db-loadtest-0`. ``` aws pi create-performance-analysis-report \ --service-type RDS \ --identifier db-loadtest-0 \ --start-time 1682969503 \ --end-time 1682979503 \ --region us-west-2 ``` La risposta è l'identificatore univoco `report-0234d3ed98e28fb17` per il report. ``` { "AnalysisReportId": "report-0234d3ed98e28fb17" } ``` ## Recupero di un report di analisi delle prestazioni L'esempio seguente recupera i dettagli del report di analisi per il report `report-0d99cc91c4422ee61`. ``` aws pi get-performance-analysis-report \ --service-type RDS \ --identifier db-loadtest-0 \ --analysis-report-id report-0d99cc91c4422ee61 \ --region us-west-2 ``` La risposta fornisce lo stato, l’ID, i dettagli temporali e gli approfondimenti del report. ``` { "AnalysisReport": { "Status": "Succeeded", "ServiceType": "RDS", "Identifier": "db-loadtest-0", "StartTime": 1680583486.584, "AnalysisReportId": "report-0d99cc91c4422ee61", "EndTime": 1680587086.584, "CreateTime": 1680587087.139, "Insights": [ ... (Condensed for space) ] } } ``` ## Elenco di tutti i report di analisi delle prestazioni per l'istanza database L'esempio seguente elenca tutti i report di analisi delle prestazioni disponibili per il database `db-loadtest-0`. ``` aws pi list-performance-analysis-reports \ --service-type RDS \ --identifier db-loadtest-0 \ --region us-west-2 ``` La risposta elenca tutti i report con i dettagli relativi all'ID, allo stato e al periodo di tempo del report. ``` { "AnalysisReports": [ { "Status": "Succeeded", "EndTime": 1680587086.584, "CreationTime": 1680587087.139, "StartTime": 1680583486.584, "AnalysisReportId": "report-0d99cc91c4422ee61" }, { "Status": "Succeeded", "EndTime": 1681491137.914, "CreationTime": 1681491145.973, "StartTime": 1681487537.914, "AnalysisReportId": "report-002633115cc002233" }, { "Status": "Succeeded", "EndTime": 1681493499.849, "CreationTime": 1681493507.762, "StartTime": 1681489899.849, "AnalysisReportId": "report-043b1e006b47246f9" }, { "Status": "InProgress", "EndTime": 1682979503.0, "CreationTime": 1682979618.994, "StartTime": 1682969503.0, "AnalysisReportId": "report-01ad15f9b88bcbd56" } ] } ``` ## Eliminazione di un report di analisi delle prestazioni L'esempio seguente elimina il report di analisi per il database `db-loadtest-0`. ``` aws pi delete-performance-analysis-report \ --service-type RDS \ --identifier db-loadtest-0 \ --analysis-report-id report-0d99cc91c4422ee61 \ --region us-west-2 ``` ## Aggiunta di un tag a un report di analisi delle prestazioni L'esempio seguente aggiunge un tag con una chiave `name` e un valore `test-tag` al report `report-01ad15f9b88bcbd56`. ``` aws pi tag-resource \ --service-type RDS \ --resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \ --tags Key=name,Value=test-tag \ --region us-west-2 ``` ## Elenco di tutti i tag per un report di analisi delle prestazioni Nell'esempio seguente vengono elencati tutti i tag per il report `report-01ad15f9b88bcbd56`. ``` aws pi list-tags-for-resource \ --service-type RDS \ --resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \ --region us-west-2 ``` La risposta elenca il valore e la chiave per tutti i tag aggiunti al report: ``` { "Tags": [ { "Value": "test-tag", "Key": "name" } ] } ``` ## Eliminazione di tag da un report di analisi delle prestazioni Nell'esempio seguente viene eliminato il tag `name` dal report `report-01ad15f9b88bcbd56`. ``` aws pi untag-resource \ --service-type RDS \ --resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \ --tag-keys name \ --region us-west-2 ``` Dopo che il tag è stato eliminato, se si chiama l'API `list-tags-for-resource` questo tag non viene elencato. # Registrazione delle chiamate Performance Insights utilizzando AWS CloudTrail Performance Insights viene eseguito con AWS CloudTrail, un servizio che fornisce un record delle azioni intraprese da un utente, un ruolo o un servizio AWS in Performance Insights. CloudTrail acquisisce tutte le chiamate API per Performance Insights come eventi. Questa acquisizione include chiamate dalla console Amazon RDS e dalle chiamate di codice alle operazioni API di Performance Insights. Se viene creato un trail, è possibile abilitare la distribuzione continua di eventi CloudTrail in un bucket Simple Storage Service (Amazon S3), inclusi gli eventi per Performance Insights. Se non configuri un trail, è comunque possibile visualizzare gli eventi più recenti nella console di CloudTrail in **Event history (Cronologia eventi)**. Utilizzando le informazioni raccolte da CloudTrail è possibile determinare specifici dettagli. Queste informazioni includono la richiesta effettuata a Performance Insights, l'indirizzo IP da cui è stata eseguita la richiesta, l'autore della richiesta e il momento in cui è stata eseguita. Include anche dettagli aggiuntivi. Per ulteriori informazioni su CloudTrail, consulta la [Guida per l'utente di AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). ## Utilizzo delle informazioni di Performance Insights in CloudTrail CloudTrail è abilitato sull'account AWS al momento della sua creazione. Quando si verifica un'attività in Performance Insights, tale attività viene registrata in un evento CloudTrail insieme ad altri eventi del servizio AWS nella console CloudTrail in **Cronologia eventi**. È possibile visualizzare, cercare e scaricare gli eventi recenti nell'account AWS. Per ulteriori informazioni, consulta [Visualizzazione di eventi nella cronologia degli eventi di CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) nella *Guida per l'utente di AWS CloudTrail*. Per una registrazione di eventi nell'account AWS che includa eventi per Performance Insights, crea un trail. Un *trail* consente a CloudTrail di distribuire i file di log in un bucket Simple Storage Service (Amazon S3). Per impostazione predefinita, quando si crea un trail nella console, il trail sarà valido in tutte le Regioni AWS. Il percorso registra gli eventi da tutte le regioni AWSnella partizione AWS e distribuisce i file di log nel bucket Simple Storage Service (Amazon S3) specificato. Inoltre, è possibile configurare altri servizi AWS per analizzare con maggiore dettaglio e usare i dati evento raccolti nei log CloudTrail. 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) + [Servizi e integrazioni CloudTrail 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/getting_notifications_top_level.html) + [Ricezione di file di log CloudTrail da più Regioni](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [Ricezione di file di log CloudTrail da più account](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Tutte le operazioni di Performance Insights vengono registrate da CloudTrail e documentate nella [Documentazione di riferimento dell'API di Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html). Ad esempio, tutte le chiamate alle operazioni `DescribeDimensionKeys` e `GetResourceMetrics` generano voci nei file di log di CloudTrail. Ogni evento o voce di log contiene informazioni sull'utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue: + Se la richiesta è stata effettuata con le credenziali dell'utente IAM 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 servizio AWS. Per ulteriori informazioni, vedi [Elemento userIdentity di CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). ## Voci del file di registro Performance Insights Un *percorso* è una configurazione che consente la distribuzione di eventi come i file di log in un bucket Simple Storage Service (Amazon S3) specificato. I file di log di CloudTrail possono contenere una o più voci di log. Un *evento* rappresenta una singola richiesta da un'origine. Ogni evento include informazioni sull'operazione richiesta, la data e l'ora dell'azione, i parametri della richiesta e così via. I file di log CloudTrail non sono una traccia di stack ordinata delle chiamate API pubbliche e di conseguenza non devono apparire in base a un ordine specifico. L'esempio seguente mostra una voce di log di CloudTrail che illustra l'operazione `GetResourceMetrics`: ``` { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AKIAIOSFODNN7EXAMPLE", "arn": "arn:aws:iam::123456789012:user/johndoe", "accountId": "123456789012", "accessKeyId": "AKIAI44QH8DHBEXAMPLE", "userName": "johndoe" }, "eventTime": "2019-12-18T19:28:46Z", "eventSource": "pi.amazonaws.com", "eventName": "GetResourceMetrics", "awsRegion": "us-east-1", "sourceIPAddress": "72.21.198.67", "userAgent": "aws-cli/1.16.240 Python/3.7.4 Darwin/18.7.0 botocore/1.12.230", "requestParameters": { "identifier": "db-YTDU5J5V66X7CXSCVDFD2V3SZM", "metricQueries": [ { "metric": "os.cpuUtilization.user.avg" }, { "metric": "os.cpuUtilization.idle.avg" } ], "startTime": "Dec 18, 2019 5:28:46 PM", "periodInSeconds": 60, "endTime": "Dec 18, 2019 7:28:46 PM", "serviceType": "RDS" }, "responseElements": null, "requestID": "9ffbe15c-96b5-4fe6-bed9-9fccff1a0525", "eventID": "08908de0-2431-4e2e-ba7b-f5424f908433", "eventType": "AwsApiCall", "recipientAccountId": "123456789012" } ``` # API Approfondimenti sulle prestazioni ed endpoint VPC di interfaccia (AWS PrivateLink) Puoi utilizzarlo AWS PrivateLink per creare una connessione privata tra il tuo VPC e Amazon RDS Performance Insights. Puoi accedere a Performance Insights come se fosse nel tuo VPC, senza l'uso di un gateway Internet, un dispositivo NAT, una connessione VPN o una connessione. Direct Connect Le istanze nel VPC non richiedono indirizzi IP pubblici per l’accesso ad Approfondimenti sulle prestazioni. Stabilisci questa connessione privata creando un *endpoint di interfaccia* attivato da AWS PrivateLink. In ciascuna sottorete viene creata un'interfaccia di rete endpoint da abilitare per l'endpoint di interfaccia. Queste sono interfacce di rete gestite dal richiedente che fungono da punto di ingresso per il traffico destinato ad Approfondimenti sulle prestazioni. *Per ulteriori informazioni, consulta [Access Servizi AWS through AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-access-aws-services.html) nella AWS PrivateLink Guida.* ## Considerazioni su Approfondimenti sulle prestazioni Prima di configurare un endpoint VPC di interfaccia per Approfondimenti sulle prestazioni, consulta [Considerations](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#considerations-interface-endpoints) nella *Guida di AWS PrivateLink *. Approfondimenti sulle prestazioni supporta l’esecuzione di chiamate a tutte le azioni API tramite l’endpoint dell’interfaccia. Per impostazione predefinita, l’accesso completo ad Approfondimenti sulle prestazioni è consentito attraverso l’endpoint dell’interfaccia. Per controllare il traffico verso Approfondimenti sulle prestazioni tramite l’endpoint dell’interfaccia, associare un gruppo di sicurezza alle interfacce di rete dell’endpoint. ## Disponibilità L'API Performance Insights attualmente supporta gli endpoint VPC Regioni AWS che supportano Performance Insights. Per informazioni su Approfondimenti sulle prestazioni, consulta [Regioni e motori di database supportati per Approfondimenti sulle prestazioni in Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md) . ## Creare un endpoint dell’interfaccia per Approfondimenti sulle prestazioni Puoi creare un endpoint di interfaccia per Performance Insights utilizzando la console Amazon VPC o AWS Command Line Interface ().AWS CLI Per ulteriori informazioni, consulta la sezione [Creazione di un endpoint di interfaccia](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#create-interface-endpoint-aws) nella *Guida per l'utente di AWS PrivateLink *. Creare un endpoint dell’interfaccia per Approfondimenti sulle prestazioni utilizzando il seguente nome servizio: Se si abilita il DNS privato per l’endpoint dell’interfaccia, è possibile effettuare richieste API ad Approfondimenti sulle prestazioni utilizzando il nome DNS predefinito per la Regione. Ad esempio, `pi.us-east-1.amazonaws.com`. ## Creazione di una policy di endpoint VPC per l’API Approfondimenti sulle prestazioni Una policy dell’endpoint è una risorsa IAM che è possibile allegare all’endpoint dell’interfaccia. La policy di endpoint predefinita permette l’accesso completo ad Approfondimenti sulle prestazioni tramite l’endpoint dell’interfaccia. Per controllare l’accesso consentito ad Approfondimenti sulle prestazioni dal VPC, associare una policy dell’endpoint personalizzata all’endpoint dell’interfaccia. Una policy di endpoint specifica le informazioni riportate di seguito: + I principali che possono eseguire azioni (Account AWS, utenti IAM e ruoli IAM). + Le azioni che possono essere eseguite. + Le risorse in cui è possibile eseguire le operazioni. Per ulteriori informazioni, consulta la sezione [Controllo dell'accesso ai servizi con policy di endpoint](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-access.html) nella *Guida di AWS PrivateLink *. **Esempio: policy di endpoint VPC per le azioni di Approfondimenti sulle prestazioni** Di seguito è riportato l'esempio di una policy dell'endpoint personalizzata. Se associata a un endpoint dell’interfaccia, questa policy concede l’accesso alle azioni di Approfondimenti sulle prestazioni elencate per tutti i principali su tutte le risorse. ``` { "Statement":[ { "Principal":"*", "Effect":"Allow", "Action":[ "rds:CreatePerformanceAnalysisReport", "rds:DeletePerformanceAnalysisReport", "rds:GetPerformanceAnalysisReport" ], "Resource":"*" } ] } ``` **Esempio: policy degli endpoint VPC che nega tutti gli accessi da un account specificato AWS** La seguente politica degli endpoint VPC nega all' AWS account `123456789012` tutti gli accessi alle risorse che utilizzano l'endpoint. La policy consente tutte le operazioni da altri account. ``` { "Statement": [ { "Action": "*", "Effect": "Allow", "Resource": "*", "Principal": "*" }, { "Action": "*", "Effect": "Deny", "Resource": "*", "Principal": { "AWS": [ "123456789012" ] } } ] } ``` ## Indirizzamento IP per Approfondimenti sulle prestazioni Gli indirizzi IP permettono alle risorse nel VPC di comunicare tra loro e con le risorse su Internet. Performance Insights supporta entrambi IPv4 i protocolli di IPv6 indirizzamento. Per impostazione predefinita, Performance Insights e Amazon VPC utilizzano il protocollo di IPv4 indirizzamento. Non puoi disattivare questo comportamento. Quando crei un VPC, assicurati di specificare un blocco IPv4 CIDR (un intervallo di indirizzi privati IPv4 ). Facoltativamente, puoi assegnare un blocco IPv6 CIDR al tuo VPC e alle sottoreti e assegnare IPv6 gli indirizzi di quel blocco alle risorse RDS nella tua sottorete. Il supporto per il IPv6 protocollo amplia il numero di indirizzi IP supportati. Utilizzando il IPv6 protocollo, ti assicuri di disporre di indirizzi disponibili sufficienti per la crescita futura di Internet. Le risorse RDS nuove ed esistenti possono utilizzare IPv4 e IPv6 indirizzare all'interno del tuo VPC. La configurazione, la protezione e la traduzione del traffico di rete tra i due protocolli utilizzati in diverse parti di un’applicazione può causare sovraccarico operativo. Puoi standardizzare il IPv6 protocollo per le risorse Amazon RDS per semplificare la configurazione della rete. Per ulteriori informazioni sugli endpoint e sulle quote del servizio, consulta [Endpoint e quote di Amazon Relational Database Service](https://docs.aws.amazon.com/general/latest/gr/rds-service.html). Per ulteriori informazioni sull’indirizzamento IP di Amazon RDS , consulta [Indirizzamento IP Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.IP_addressing).