# Análise de métricas usando o painel do Performance Insights
**Importante**
A AWS anunciou a data de fim da vida útil do Insights de Performance: 30 de junho de 2026. Após essa data, o Amazon RDS não oferecerá mais suporte à experiência do console, aos períodos de retenção flexíveis (de 1 a 24 meses) e aos preços associados do Insights de Performance. A API do Insights de Performance continuará existindo sem alterações de preço. Os custos da API do Insights de Performance aparecerão em sua fatura da com o custo do CloudWatch Database Insights.
Recomendamos que você atualize todos os clusters de banco de dados usando o nível pago do Insights de Performance para o modo avançado do Database Insights antes de 30 de junho de 2026. Para ter informações sobre como atualizar para o modo avançado do Database Insights, consulte [Ativação do modo Avançado do Database Insights para Amazon Aurora](USER_DatabaseInsights.TurningOnAdvanced.md).
Se você não tomar nenhuma medida, os clusters de banco de dados que estão usando o Insights de Performance usarão como padrão o modo padrão do Database Insights. Com o modo padrão do Database Insights, você pode perder o acesso ao histórico de dados de desempenho após sete dias e talvez não consiga usar planos de execução e recursos de análise sob demanda no console do Amazon RDS. Após 30 de junho de 2026, somente o modo avançado do Database Insights aceitará planos de execução e análise sob demanda.
Com o CloudWatch Database Insights, você pode monitorar a carga do banco de dados para sua frota de bancos de dados e analisar e solucionar problemas de desempenho em grande escala. Para ter mais informações sobre o Database Insights, consulte [Monitoramento de bancos de dados do Amazon Aurora com o CloudWatch Database Insights](USER_DatabaseInsights.md). Para obter informações de definição de preço, consulte [Definição de preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).
O painel do Performance Insights contém informações de performance do banco de dados para ajudar você a analisar e solucionar problemas de performance. Na página principal do painel, você pode visualizar informações sobre a carga do banco de dados. Você pode separar a carga de banco de dados por dimensões como eventos de espera ou SQL.
**Topics**
+ [Visão geral do painel do Performance Insights](USER_PerfInsights.UsingDashboard.Components.md)
+ [Acessar o painel do Performance Insights.](USER_PerfInsights.UsingDashboard.Opening.md)
+ [Analisar a carga do banco de dados por eventos de espera](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.md)
+ [Analisar a performance do banco de dados por um período](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md)
+ [Analisar consultas com a guia SQL principal no Insights de Performance](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md)
# Visão geral do painel do Performance Insights
O painel é a maneira mais fácil de interagir com o Performance Insights. O exemplo a seguir mostra o painel de uma instância de banco de dados do PostgreSQL.
![\[Habilitar o Performance Insights durante a criação de uma instância de banco de dados com o console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/aurora_perf_insights_enabling.png)
**Topics**
+ [Filtro de intervalo de tempo](#USER_PerfInsights.UsingDashboard.Components.time-range)
+ [Gráfico de métricas de contador](#USER_PerfInsights.UsingDashboard.Components.Countermetrics)
+ [Gráfico de carga do banco de dados](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions)
+ [Tabela Top dimensions (Principais dimensões)](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable)
## Filtro de intervalo de tempo
Por padrão, o painel do Performance Insights exibe a carga de banco de dados da última hora. Você pode ajustar esse intervalo para cinco minutos ou dois anos. Também é possível selecionar um intervalo relativo personalizado.
Você pode selecionar um intervalo absoluto com data e hora de início e término. O exemplo a seguir mostra o intervalo de tempo que começa à meia-noite de 25/9/24 e termina às 23h59 de 28/9/24.
Por padrão, o fuso horário do painel do Insights de Performance é o Tempo Universal Coordenado (UTC). Também é possível escolher o fuso horário local.
## Gráfico de métricas de contador
Com métricas de contador, você pode personalizar o painel do Performance Insights para incluir até 10 gráficos adicionais. Esses gráficos mostram uma seleção de dezenas de métricas de performance do sistema operacional e do banco de dados. É possível correlacionar essas informações à carga do banco de dados para ajudar a identificar e analisar problemas de performance.
O gráfico **Counter Metrics** (Métricas de contador) exibe dados dos contadores de performance. As métricas padrão dependem do mecanismo de banco de dados:
+ Aurora MySQL– `db.SQL.Innodb_rows_read.avg`
+ Aurora PostgreSQL – `db.Transactions.xact_commit.avg`
![\[Métricas de contador\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/oracle_perf_insights_counters.png)
Para alterar os contadores de performance, escolha **Manage Metrics** (Gerenciar métricas). É possível selecionar várias **Métricas de SO** ou **Métricas de banco de dados**, conforme mostrado na captura de tela a seguir. Para ver detalhes de qualquer métrica, passe o mouse sobre o nome da métrica.
![\[Filtrar métricas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_select_metrics.png)
Para obter descrições das métricas de contador que você pode adicionar a cada mecanismo de banco de dados, consulte [Métricas de contadores do Performance Insights](USER_PerfInsights_Counters.md).
## Gráfico de carga do banco de dados
O gráfico **Database load** (Carga do banco de dados) mostra como a atividade do banco de dados se compara à capacidade da instância de banco de dados representada pela linha **Max vCPU** (Máximo de vCPU). Por padrão, o gráfico de linhas empilhadas representa a carga do banco de dados como sessões ativas médias por unidade de tempo. A carga do banco de dados é separada (agrupada) por estados de espera.
![\[Carga de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_2.png)
### Carga de banco de dados separada por dimensões
Você pode optar por exibir a carga como sessões ativas agrupadas por quaisquer dimensões aceitas. A tabela a seguir mostra quais dimensões são aceitas pelos diferentes mecanismos.
| Dimensão | Aurora PostgreSQL | Aurora MySQL |
| --- | --- | --- |
| Host | Sim | Sim |
| SQL | Sim | Sim |
| Usuário | Sim | Sim |
| Espera | Sim | Sim |
| Aplicação | Sim | Não |
| Banco de dados | Sim | Sim |
| Tipo de sessão | Sim | Não |
A imagem a seguir mostra as dimensões de uma instância de banco de dados do PostgreSQL.
![\[Filtrar métricas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_2b.png)
### Detalhes de carga de banco de dados para um item de dimensão
Para ver detalhes sobre um item de carga de banco de dados dentro de uma dimensão, passe o mouse sobre o nome do item. A imagem a seguir mostra detalhes de uma instrução SQL.
![\[Detalhes do item da carga de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_2c.png)
Para ver detalhes de qualquer item do período selecionado na legenda, passe o mouse sobre esse item.
![\[Detalhes do período para a carga de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_3.png)
## Tabela Top dimensions (Principais dimensões)
A tabela Top dimensions (Principais dimensões) separa a carga do banco de dados com base em diferentes dimensões. Uma dimensão é uma categoria ou “pedaços” de diferentes características de uma carga de banco de dados. Se a dimensão for SQL, **Top SQL** (SQL principal) mostrará as instruções SQL que mais contribuem para a carga do banco de dados.
![\[Principais N dimensões\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_4c.png)
Escolha qualquer uma das guias de dimensão a seguir.
| Tab | Descrição | Mecanismos com suporte |
| --- | --- | --- |
| SQL principal | As instruções SQL que estão sendo executadas no momento | Todos |
| Esperas principais | O evento para o qual o backend do banco de dados está aguardando | Todos |
| Hosts principais | O nome do host do cliente conectado | Todos |
| Principais usuários | O usuário conectado ao banco de dados | Todos |
| Principais aplicações | O nome da aplicação que está conectada ao banco de dados | Somente Aurora PostgreSQL |
| Principais tipos de sessão | O tipo da sessão atual | Apenas Aurora PostgreSQL |
Para aprender a analisar consultas utilizando a guia **Top SQL** (SQL principal), consulte [Visão geral da guia Top SQL (SQL principal)](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL).
# Acessar o painel do Performance Insights.
O Amazon RDS fornece uma visão consolidada das métricas do Insights de Performance e do CloudWatch no painel do Insights de Performance.
Para acessar o painel do Performance Insights, use o procedimento a seguir.
**Para visualizar o painel do Performance Insights no Console de gerenciamento da AWS**
1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Performance Insights**.
1. Escolha uma instância de banco de dados.
Para as instâncias de banco de dados com o Insights de Performance ativado, você também pode acessar o painel do Insights de Performance escolhendo o item **Sessões** na lista de instâncias de banco de dados. Em **Atividade atual**, o item **Sessões** mostra a carga de banco de dados em sessões ativas médias nos últimos cinco minutos. A carga é mostrada graficamente por meio de barras. Quando a barra está vazia, a instância de banco de dados está ociosa. À medida que a carga aumenta, a barra é preenchida com a cor azul. Quando a carga ultrapassa o número de CPUs virtuais (vCPUs) na classe da instância de banco de dados, a barra se torna vermelha, indicando um possível gargalo.
![\[Filtrar métricas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_0a.png)
1. (Opcional) Escolha a data ou o intervalo de tempo no canto superior direito e especifique um intervalo de tempo relativo ou absoluto diferente. Agora você pode especificar um período e gerar um relatório de análise de performance do banco de dados. O relatório fornece as recomendações e os insights identificados. Para ter mais informações, consulte [Criar um relatório de análise de performance no Insights de Performance](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md).
![\[Filtrar métricas por intervalo de tempo\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_0c.png)
Na captura de tela a seguir, o intervalo da carga do banco de dados é de 5 horas.
![\[Definir o intervalo de tempo como cinco horas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_1.png)
1. (Opcional) Para ampliar uma parte do grafo de carga de banco de dados, escolha a hora de início e arraste até o final do período desejado.
A área selecionada é destacada no grafo de carga de banco de dados.
![\[Carga de banco de dados para um intervalo de tempo especificado\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_zoom_in.png)
Ao soltar o mouse, o grafo de carga de banco de dados amplia a Região da AWS selecionada e a tabela **Top *dimensions*** (Dimensões principais) é recalculada.
![\[Aplicar zoom na carga de banco de dados selecionada\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_zoom_in_b.png)
1. (Opcional) Para atualizar seus dados automaticamente, selecione **Atualização automática**.
![\[Definir atualização automática\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_1b.png)
O painel de Insights de Performance é atualizado automaticamente com novos dados. A taxa de atualização depende da quantidade de dados exibida:
+ 5 minutos atualiza a cada 10 segundos.
+ 1 hora atualiza a cada 5 minutos.
+ 5 horas atualiza a cada 5 minutos.
+ 24 horas atualiza a cada 30 minutos.
+ 1 semana atualiza a cada hora.
+ 1 mês atualiza todos os dias.
# Analisar a carga do banco de dados por eventos de espera
Se o gráfico **Database load** (Carga do banco de dados) mostrar um gargalo, você poderá descobrir de onde vem essa carga. Para fazer isso, examine a tabela de principais itens de carga abaixo do gráfico **Database load** (Carga do banco de dados). Escolha um item específico, como uma consulta SQL ou um usuário, para ver detalhes sobre ele.
A carga de banco de dados agrupada por espera e as principais consultas SQL compõem a visualização padrão do painel do Performance Insights. Em geral, essa combinação fornece os melhores insights sobre problemas de performance. A carga de banco de dados agrupada por espera mostra se há algum gargalo de recursos ou de concorrências no banco de dados. Nesse caso, a guia **SQL** da tabela Top Load Items (Principais itens de carga) mostra quais consultas estão gerando essa carga.
Seu fluxo de trabalho típico para diagnosticar problemas de performance é o seguinte:
1. Analise o gráfico **Carregamento do banco de dados** e veja se há casos de cargas de banco de dados que estejam ultrapassando a linha **Máximo de CPU**.
1. Se houver, examine o gráfico **Database load** (Carga do banco de dados) e identifique quais estados de espera são os principais responsáveis por isso.
1. Identifique as consultas resumidas que estão gerando a carga examinando quais consultas na guia **SQL** da tabela Top Load Items (Principais itens de carga) estão contribuindo mais para aqueles estados de espera. Você pode identificar essas consultas na coluna **DB Load by Wait (Carga de banco de dados por espera)**.
1. Escolha uma dessas consultas resumidas na guia **SQL** para expandi-la e exibir as consultas secundárias que a compõem.
Por exemplo, no painel a seguir, as esperas de **sincronização de arquivos de log** compõem a maior parte da carga de banco de dados. A espera de **Todos os grupos de operador de LGWR** também é alta. O gráfico **Top SQL** (SQL principal) exibe o que está provocando as esperas de **sincronização de arquivos de log**: instruções `COMMIT` frequentes. Nesse caso, a confirmação com menos frequência reduzirá a carga de banco de dados.
![\[erros de sincronização de arquivos de log\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_7.png)
# Analisar a performance do banco de dados por um período
Analise a performance do banco de dados com análise sob demanda criando um relatório de análise de performance por um período. Visualize os relatórios de análise de performance para descobrir problemas de performance, como gargalos de recursos ou alterações em uma consulta na instância de banco de dados. O painel do Insights de Performance permite que você selecione um período e crie um relatório de análise de performance. Também é possível adicionar uma ou mais tags ao relatório.
Para usar esse atributo, você deve usar o período de retenção do nível pago. Para ter mais informações, consulte [Preços e retenção de dados para o Performance Insights](USER_PerfInsights.Overview.cost.md).
O relatório está disponível na guia **Relatórios de análise de performance: novo** para selecionar e visualizar. O relatório contém os insights, as métricas relacionadas e as recomendações para resolver o problema de performance. O relatório fica disponível para visualização durante o período de retenção do Insights de Performance.
O relatório será excluído se a hora de início do período de análise do relatório estiver fora do período de retenção. Você também pode excluir o relatório antes que o período de retenção termine.
Para detectar os problemas de performance e gerar o relatório de análise para sua instância de banco de dados, você deve ativar o Insights de Performance. Para obter mais informações sobre como ativar o Insights de Performance, consulte [Ativar e desativar o Insights de Performance para o Aurora](USER_PerfInsights.Enabling.md).
Para ter informações sobre compatibilidade de regiões, mecanismos de banco de dados e classes de instância com esse recurso, consulte [Mecanismo de banco de dados do Amazon Aurora, região e classe de instância compatíveis com recursos do Insights de Performance](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport).
Nas seções a seguir, é possível criar, visualizar, adicionar tags e excluir um relatório de análise de performance.
**Topics**
+ [Criar um relatório de análise de performance no Insights de Performance](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md)
+ [Visualizar um relatório de análise de performance no Insights de Performance](USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport.md)
+ [Adicionar tags a um relatório de análise de performance no Insights de Performance](USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.md)
+ [Excluir um relatório de análise de performance no Insights de Performance](USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.md)
# Criar um relatório de análise de performance no Insights de Performance
Você pode criar um relatório de análise de performance para um período específico no painel do Insights de Performance. Você pode selecionar um período e adicionar uma ou mais tags ao relatório de análise.
O período de análise pode variar de cinco minutos a seis dias. Deve haver pelo menos 24 horas de dados de performance antes do horário de início da análise.
Para ter informações sobre compatibilidade de regiões, mecanismos de banco de dados e classes de instância com esse recurso, consulte [Mecanismo de banco de dados do Amazon Aurora, região e classe de instância compatíveis com recursos do Insights de Performance](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport).
**Como criar um relatório de análise de performance para um período**
1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Performance Insights**.
1. Escolha uma instância de banco de dados.
1. Selecione **Analisar performance** na seção **Carga do banco de dados** no painel do Insights de Performance.
Os campos para definir o período e adicionar uma ou mais tags ao relatório de análise de performance são exibidos.
![\[Painel do Insights de Performance mostrando campos para criar um relatório de análise\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/PI_CreateAnalysisReport.png)
1. Escolha um período. Se definir um período no **Intervalo relativo** ou no **Intervalo absoluto** no canto superior direito, você poderá inserir ou selecionar a data e a hora do relatório de análise somente nesse período. Se você selecionar o período de análise fora desse período, uma mensagem de erro será exibida.
Para definir o período, você pode fazer o seguinte:
+ Pressione e arraste qualquer um dos controles deslizantes no gráfico de carga do banco de dados.
A caixa **Período de análise de performance** exibe o período selecionado, e o gráfico de carga do banco de dados destaca o período selecionado.
+ Selecione a **data de início**, a **hora de início**, a **data de término** e a **hora de término** na caixa **Período de análise de performance**.
![\[Painel do Insights de Performance com período de análise selecionado\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/PI_CreateAnalysisRep_TimePeriod.png)
1. (Opcional) Digite **Chave** e **Valor*opcionais*** para adicionar uma tag para o relatório.
![\[Painel do Insights de Performance com campos para adicionar uma nova tag\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/PI_CreateAnalysisRep_AddTag.png)
1. Selecione **Analisar performance**.
Um banner exibe uma mensagem se a geração do relatório foi bem-sucedida ou falhou. A mensagem também fornece o link para visualizar o relatório.
O exemplo a seguir mostra o banner com a mensagem de sucesso na criação do relatório.
![\[Banner de mensagem de criação de relatório de análise bem-sucedida\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/PI_CreateAnaysisRep_SuccessMsg.png)
O relatório está disponível na guia **Relatórios de análise de performance: novo**.
Você pode criar um relatório de análise de desempenho usando a AWS CLI. Para obter um exemplo de como criar um relatório usando a AWS CLI, consulte [Criar um relatório de análise de performance para um período](USER_PerfInsights.API.Examples.md#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport).
# Visualizar um relatório de análise de performance no Insights de Performance
A guia **Relatórios de análise de performance: novo** lista todos os relatórios criados para a instância de banco de dados. Os itens a seguir são exibidos para cada relatório:
+ **ID**: identificador exclusivo do relatório.
+ **Nome**: chave de tag adicionada ao relatório.
+ **Hora da criação do relatório**: hora em que você criou o relatório.
+ **Hora de início da análise**: hora de início da análise no relatório.
+ **Hora de término da análise**: hora de término da análise no relatório.
**Como visualizar um relatório de análise de performance**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Performance Insights**.
1. Selecione uma instância de banco de dados para a qual você deseja visualizar o relatório de análise.
1. Role para baixo e selecione a guia **Relatórios de análises de performance: novo** no painel do Insights de Performance.
Todos os relatórios de análise para os diferentes períodos são exibidos.
1. Selecione **ID** do relatório que você deseja visualizar.
O gráfico de carga do banco de dados exibirá todo o período de análise por padrão se mais de um insight for identificado. Se o relatório tiver identificado um insight, o gráfico de carga do banco de dados exibirá o insight por padrão.
O painel também lista as tags do relatório na seção **Tags**.
O exemplo a seguir mostra todo o período de análise do relatório.
![\[Gráfico de carga do banco de dados mostrando todo o período do relatório de análise\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/PI_EntireAnalysisRep.png)
1. Selecione o insight na lista **Insights da carga do banco de dados** que você deseja visualizar se mais de um insight for identificado no relatório.
O painel exibe a mensagem de insight, o gráfico de carga do banco de dados destacando o período do insight, a análise e as recomendações, bem como a lista de tags do relatório.
O exemplo a seguir mostra o insight da carga do banco de dados no relatório.
![\[Gráfico de carga do banco de dados mostrando insight no relatório\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/PI_AnalysisRepInsight_chart.png)
![\[Seção “Análise e recomendação de insights de relatórios”\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/PI_AnalysisRepInsight_Recommendations.png)
# Adicionar tags a um relatório de análise de performance no Insights de Performance
Você pode adicionar uma tag ao criar ou visualizar um relatório. Você pode adicionar até 50 tags a um relatório.
Você precisa de permissões para adicionar as tags. Para receber mais informações sobre as políticas de acesso para o Insights de Performance, consulte [Configurar políticas de acesso para o Performance Insights](USER_PerfInsights.access-control.md).
Para adicionar uma ou mais tags ao criar um relatório, consulte a etapa 6 do procedimento [Criar um relatório de análise de performance no Insights de Performance](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md).
**Como adicionar uma ou mais tags ao visualizar um relatório**
1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Performance Insights**.
1. Escolha uma instância de banco de dados.
O painel do Insights de Performance é exibido para a instância de banco de dados.
1. Role para baixo e selecione a guia **Relatórios de análise de performance: novo**.
1. Escolha o relatório ao qual você deseja adicionar as tags.
O painel exibe o relatório.
1. Role para baixo até **Tags** e selecione **Gerenciar tags**.
1. Selecione **Adicionar nova tag**.
1. Insira a **Chave** e o **Valor: *opcional*** e selecione **Adicionar nova tag**.
O exemplo a seguir fornece a opção de adicionar uma nova tag ao relatório selecionado.
![\[Janela “Gerenciar tags” para adicionar novas tags ao relatório\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/PI_AddTag_ManageTags.png)
Uma nova tag é criada para o relatório.
A lista de tags do relatório é exibida na seção **Tags** no painel. Se você quiser remover uma tag do relatório, selecione **Remover** ao lado da tag.
# Excluir um relatório de análise de performance no Insights de Performance
Você pode excluir um relatório da lista de relatórios exibida na guia **Relatórios de análise de performance** ou ao visualizar um relatório.
**Para excluir um relatório**
1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Performance Insights**.
1. Escolha uma instância de banco de dados.
O painel do Insights de Performance é exibido para a instância de banco de dados.
1. Role para baixo e selecione a guia **Relatórios de análises de performance: novo**.
1. Selecione o relatório que você deseja excluir e escolha **Excluir** no canto superior direito.
![\[Painel do Insights de Performance para excluir quando um relatório está selecionado para exclusão\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/PI_DeleteAnalysisRep.png)
Uma janela de confirmação é exibida. O relatório é excluído depois que você escolhe confirmar.
1. (Opcional) Selecione **ID** do relatório que você deseja excluir.
Na página de relatório, selecione **Excluir** no canto superior direito.
Uma janela de confirmação é exibida. O relatório é excluído depois que você escolhe confirmar.
# Analisar consultas com a guia SQL principal no Insights de Performance
No painel do Amazon RDS Performance Insights, é possível encontrar informações sobre consultas recentes em execução na guia **Top SQL** (SQL principal), na tabela **Top dimensions** (Principais dimensões). É possível utilizar essas informações para ajustar suas consultas.
**Topics**
+ [Visão geral da guia Top SQL (SQL principal)](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL)
+ [Acessar mais texto SQL no painel do Performance Insights.](USER_PerfInsights.UsingDashboard.SQLTextSize.md)
+ [Visualizar estatísticas SQL no painel do Performance Insights](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel.md)
## Visão geral da guia Top SQL (SQL principal)
Por padrão, a guia **Top SQL** (SQL principal) mostra as 25 consultas que mais estão contribuindo para a carga do banco de dados. Para ajudar a ajustar as consultas, é possível analisar informações como o texto da consulta e as estatísticas de SQL. Você também pode escolher as estatísticas que deseja tornar visíveis na guia **Top SQL** (SQL principal).
**Topics**
+ [Texto SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text)
+ [Estatísticas SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics)
+ [Load by waits (AAS) (Carga por esperas)](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits)
+ [Visualizar informações do SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information)
+ [Escolher preferências de estatísticas](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences)
### Texto SQL
Por padrão, cada linha na tabela **Top SQL** (SQL principal) mostra 500 bytes de texto para cada declaração.
![\[Texto SQL\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/sql-text-apg.png)
Para saber como ver mais do que os 500 bytes padrão de texto SQL, consulte [Acessar mais texto SQL no painel do Performance Insights.](USER_PerfInsights.UsingDashboard.SQLTextSize.md).
Um *resumo SQL* é formado por várias consultas reais com estruturas semelhantes, mas que possivelmente apresentam valores literais diferentes. O resumo substitui valores codificados por um ponto de interrogação. Por exemplo, um resumo pode ser `SELECT * FROM emp WHERE lname= ?`. Esse resumo pode incluir as seguintes consultas subordinadas:
```
SELECT * FROM emp WHERE lname = 'Sanchez'
SELECT * FROM emp WHERE lname = 'Olagappan'
SELECT * FROM emp WHERE lname = 'Wu'
```
Para ver as instruções SQL literais em um resumo, escolha a consulta e depois o sinal de mais (\$1). No exemplo a seguir, a consulta selecionada é de resumo.
![\[Resumo SQL selecionado\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_4b.png)
**nota**
Um resumo SQL agrupa instruções SQL semelhantes, mas não edita informações confidenciais.
### Estatísticas SQL
*Estatísticas SQL* são métricas de performance sobre consultas SQL. Por exemplo, o Performance Insights pode exibir execuções por segundo ou linhas processadas por segundo. O Performance Insights apenas coleta estatísticas para as consultas mais comuns. Normalmente, elas correspondem às principais consultas por carga mostradas no painel do Performance Insights.
Todas as linhas da tabela **Top SQL** (SQL principal) mostram estatísticas relevantes para a instrução ou o resumo SQL, como mostra exemplo a seguir.
![\[SQL principal\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_4.png)
O Performance Insights pode relatar `0.00` e `-` (unknown) (desconhecido) para estatísticas SQL. Essa situação ocorre nas seguintes condições:
+ Existe apenas uma amostra. Por exemplo, o Performance Insights calcula as taxas de alteração para consultas do Aurora PostgreSQL com base em várias amostras da visualização `pg_stat_statements`. Quando uma workload é executada por um curto período, o Performance Insights consegue coletar apenas uma amostra, o que significa que ele não consegue calcular uma taxa de alteração. O valor desconhecido é representado com um traço (`-`).
+ Duas amostras têm os mesmos valores. O Performance Insights não consegue calcular uma taxa de alteração porque não ocorreu nenhuma alteração, portanto, ele relata a taxa como `0.00`.
+ Uma instrução do Aurora PostgreSQL não tem um identificador válido. O PostgreSQL cria um identificador para uma instrução somente após a análise. Assim, pode existir uma instrução nas estruturas internas na memória do PostgreSQL sem identificador. Como o Performance Insights cria amostras de estruturas internas na memória uma vez por segundo, consultas de baixa latência podem aparecer apenas para uma única amostra. Se o identificador de consultas não estiver disponível para essa amostra, o Performance Insights não conseguirá associar essa instrução às suas estatísticas. O valor desconhecido é representado com um traço (`-`).
Para obter uma descrição das estatísticas SQL para o mecanismos do Aurora, consulte [Estatísticas SQL para Performance Insights](sql-statistics.md).
### Load by waits (AAS) (Carga por esperas)
Em **Top SQL** (SQL principal), a coluna **Load by waits (AAS)** (Carga por esperas) mostra a porcentagem da carga do banco de dados associada a cada item de carga principal. Essa coluna reflete a carga desse item por qualquer agrupamento atualmente selecionado no **Gráfico de carga de banco de dados**. Para obter mais informações sobre média de sessões ativas (AAS), consulte [Média de sessões ativas](USER_PerfInsights.Overview.ActiveSessions.md#USER_PerfInsights.Overview.ActiveSessions.AAS).
Por exemplo, é possível agrupar o gráfico **DB load** (Carga do banco de dados) com base em estados de espera. Examine consultas SQL na tabela de itens de carga principal. Nesse caso, a barra **DB Load by Waits (Carga de banco de dados por espera)** é dimensionada, segmentada e codificada por cores para mostrar com quanto de um determinado estado de espera a consulta está contribuindo. Ela também mostra quais estados de espera estão afetando a consulta selecionada.
![\[Carga de banco de dados por esperas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_6.png)
### Visualizar informações do SQL
Na tabela **Top SQL** (SQL principal), é possível abrir uma instrução para visualizar suas informações. As informações são exibidas no painel inferior.
![\[Tabela SQL principal com consulta literal selecionada\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf-insights-sql-ids-open.png)
Os seguintes tipos de identificadores (IDs) associados a instruções SQL:
+ **ID SQL de suporte**: Um valor de hash do ID SQL. Esse valor só se destina a referenciar um ID SQL quando você está trabalhando com o AWS Support. AWS O Support não tem acesso a IDs SQL reais e ao texto SQL.
+ **ID de arquivo de resumo de suporte**: um valor de hash do ID de arquivo de resumo. Esse valor apenas se destina como referência a um ID de arquivo de resumo quando você está trabalhando com o AWS Support. AWS O Support não tem acesso a IDs de arquivo de resumo reais e ao texto SQL.
### Escolher preferências de estatísticas
É possível controlar as estatísticas exibidas na guia **Top SQL** (SQL principal) selecionando o ícone **Preferences** (Preferências).
![\[Preferências de estatísticas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf-insights-sql-ids-preferences-icon.png)
Quando você escolhe o ícone **Preferences (Preferências)**, a janela **Preferences (Preferências)** abre. O screenshot a seguir é um exemplo da janela **Preferences** (Preferências).
![\[Janela de preferências\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf-insights-sql-ids-preferences.png)
Para habilitar as estatísticas que você deseja tornar visíveis na guia **Top SQL** (SQL principal), use o mouse para rolar até o final da janela e depois escolha **Continue** (Continuar).
Para obter mais informações sobre estatísticas por segundo ou por chamada para os mecanismos do Aurora, consulte a seção de estatísticas SQL específicas do mecanismo em[Estatísticas SQL para Performance Insights](sql-statistics.md)
# Acessar mais texto SQL no painel do Performance Insights.
Por padrão, cada linha na tabela **Top SQL** (SQL principal) mostra 500 bytes de texto SQL para cada instrução SQL.
![\[500 bytes de SQL\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf-insights-top-sql-bytes.png)
Quando uma instrução SQL excede 500 bytes, você pode visualizar mais texto na seção **SQL text** (Texto SQL) abaixo da tabela **Top SQL** (SQL principal). Nesse caso, o comprimento máximo para o texto exibido em **SQL text** (Texto SQL) é de 4 KB. Esse limite é introduzido pelo console e está sujeito aos limites definidos pelo mecanismo de banco de dados. Para salvar o texto mostrado em **SQL text** (Texto SQL), escolha **Download**.
**Topics**
+ [Limites de tamanho de texto para Aurora MySQL](#sql-text-engine-limits)
+ [Definir o limite do texto SQL para instâncias de banco de dados do Aurora PostgreSQL](USER_PerfInsights.UsingDashboard.SQLTextLimit.md)
+ [Visualizar e baixar texto SQL no painel do Performance Insights](view-download-text.md)
## Limites de tamanho de texto para Aurora MySQL
Quando você baixa um texto SQL, o mecanismo de banco de dados determina o tamanho máximo dele. Você pode baixar texto SQL até os seguintes limites por mecanismo.
| Mecanismo de banco de dados | Tamanho máximo do texto para download |
| --- | --- |
| Aurora MySQL | O tamanho é fixado em 4.096 bytes. |
A seção **SQL text** (Texto SQL) do console do Performance Insights mostra até o máximo que o mecanismo retorna. Por exemplo, se o Aurora MySQL retorna no máximo 1 KB para o Performance Insights, ele só pode coletar e mostrar 1 KB, mesmo que a consulta original seja maior. Assim, quando você visualiza ou baixa a consulta em **SQL text** (Texto SQL), o Performance Insights retorna o mesmo número de bytes.
Se você usar a AWS CLI ou a API, o Insights de Performance não terá o limite de 4 KB aplicado pelo console. `DescribeDimensionKeys` e `GetResourceMetrics` exibem no máximo 500 bytes.
**nota**
`GetDimensionKeyDetails` exibe a consulta completa, mas o tamanho está sujeito ao limite do mecanismo.
# Definir o limite do texto SQL para instâncias de banco de dados do Aurora PostgreSQL
Aurora PostgreSQL lida com texto de forma diferente. Você pode definir o limite de tamanho de texto com o parâmetro de instância de banco de dados `track_activity_query_size`. Esse parâmetro tem as seguintes características:
Tamanho de texto padrão
No Aurora PostgreSQL versão 9.6, a configuração padrão do parâmetro `track_activity_query_size` é 1.024 bytes. No Aurora PostgreSQL versão 10 ou superior, o padrão é 4.096 bytes.
Tamanho máximo do texto
O limite para `track_activity_query_size` é de 102.400 bytes para Aurora PostgreSQL versão 12 e inferiores. O máximo é de 1 MB para a versão 13 e posterior.
Se o mecanismo retornar 1 MB ao Performance Insights, o console exibirá somente os primeiros 4 KB. Se você baixar a consulta, você obtém o total de 1 MB. Nesse caso, a visualização e o download retornam números diferentes de bytes. Para obter mais informações sobre o parâmetro de instância de banco de dados `track_activity_query_size`, consulte [Estatísticas de tempo de execução](https://www.postgresql.org/docs/current/runtime-config-statistics.html) na documentação do PostgreSQL.
Para aumentar o tamanho do texto SQL, aumente o limite `track_activity_query_size`. Para modificar o parâmetro, altere a configuração dele no grupo de parâmetros que está associado à instância de banco de dados do Aurora PostgreSQL.
**Para alterar a configuração quando a instância usa o grupo de parâmetros padrão**
1. Crie um novo grupo de parâmetros de instância de banco de dados para o mecanismo de banco de dados apropriado e sua respectiva versão.
1. Defina o parâmetro no novo grupo de parâmetros.
1. Associe o novo grupo de parâmetros à instância de banco de dados.
Para obter informações sobre como configurar um parâmetro de instância de banco de dados, consulte [Modificar parâmetros em um grupo de parâmetros de banco de dados no Amazon Aurora](USER_WorkingWithParamGroups.Modifying.md).
# Visualizar e baixar texto SQL no painel do Performance Insights
No painel do Performance Insights, é possível visualizar ou baixar o texto SQL.
**Para visualizar mais texto SQL no painel do Performance Insights**
1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Performance Insights**.
1. Escolha uma instância de banco de dados.
1. Role para baixo até a guia **SQL principal** no painel do Insights de Performance.
1. Escolha o sinal de adição para expandir um resumo SQL e selecione uma das consultas secundárias do resumo.
Instruções SQL com texto maior que 500 bytes são semelhantes à imagem a seguir.
![\[Instruções SQL com texto grande\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf-insights-large-text-aurora-1.png)
1. Role para baixo até a guia **SQL text** (texto SQL).
![\[Seção de informações SQL mostra mais do texto SQL\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf-insights-large-text-aurora-2.png)
O painel do Performance Insights pode exibir até 4.096 bytes para cada instrução SQL.
1. (Opcional) Escolha **Copy** (Copiar) para copiar a instrução SQL exibida ou escolha **Download** (Baixar) para baixar a instrução SQL a fim de visualizar o texto SQL até o limite do mecanismo de banco de dados.
**nota**
Para copiar ou baixar a instrução SQL, desabilite bloqueadores de pop-up.
# Visualizar estatísticas SQL no painel do Performance Insights
No painel do Performance Insights, as estatísticas SQL estão disponíveis na guia **Top SQL** (SQL principal) do grafo **Database load** (Carga do banco de dados).
**Como visualizar estatísticas SQL**
1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Performance Insights**.
1. Na parte posterior da página, escolha o banco de dados cujas estatísticas SQL você deseja ver.
1. Navegue até o final da página e escolha a guia **Top SQL** (SQL principal).
1. Escolha uma instrução individual (Somente Aurora MySQL)ou consulta de resumo.
![\[Visualizar métricas de consultas em execução\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_per_sql_digest.png)
1. Escolha quais estatísticas exibir, escolhendo o ícone de engrenagem no canto superior direito do gráfico. Para obter as descrições das estatísticas SQL para o mecanismos do Amazon RDSAurora, consulte [Estatísticas SQL para Performance Insights](sql-statistics.md).
O exemplo a seguir mostra as preferências do Aurora PostgreSQL.
![\[Preferências de métricas para consultas em execução de instâncias de banco de dados Aurora PostgreSQL\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_per_sql_pref_apg.png)
O exemplo a seguir mostra as preferências para instâncias de banco de dados do Aurora MySQL.
![\[Preferências de métricas para consultas em execução de instâncias de banco de dados Aurora MySQL.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/perf_insights_per_sql_pref_ams.png)
1. Escolha Save (Salvar) para salvar suas preferências.
A tabela **Top SQL** (SQL principal) é atualizada.