As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Análise de métricas usando o painel do Performance Insights
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 do painel principal, você pode visualizar informações sobre a carga do banco de dados (DB load). É possível “fatiar” a carga de banco de dados por dimensões como eventos de espera ou consulta.
**Topics**
+ [Visão geral do painel do Performance Insights](performance-insights-dashboard-overview.md)
+ [Abrir o painel do Performance Insights](performance-insights-dashboard-opening.md)
+ [Analisar a carga do banco de dados por estados de espera](performance-insights-analyzing-db-load.md)
+ [Visão geral da guia Principais consultas](performance-insights-top-queries.md)
+ [Ampliar o gráfico de carga de banco de dados](performance-insights-zoom-db-load.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 Amazon DocumentDB. Por padrão, o painel do Performance Insights exibe dados da última hora.
![\[Painel dos Insights de performance, mostrando a utilização da CPU e a carga do banco de dados ao longo do tempo para uma instância do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/overview-dashboard.png)
O painel é dividido nas seguintes partes:
1. **Counter metrics**: mostra dados das métricas de contador de performance específicas.
1. **Database load**: mostra como a carga de banco de dados se compara à capacidade da instância de banco de dados conforme representada pela linha **Máx. vCPU**.
1. **Dimensões principais** – Mostra as principais dimensões que contribuem para a carga do banco de dados. Essas dimensões incluem `waits`, `queries`, `hosts`, `databases` e `applications`.
**Topics**
+ [Gráfico de métricas de contador](#performance-insights-overview-metrics)
+ [Gráfico de carga do banco de dados](#performance-insights-overview-db-load-chart)
+ [Tabela Top dimensions (Principais dimensões)](#performance-insights-overview-top-dimensions)
## 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. É possível correlacionar essas informações à carga do banco de dados para ajudar a identificar e analisar problemas de performance.
O gráfico **Métricas de contador** exibe dados dos contadores de performance.
![\[Gráfico Métricas de contadores mostrando a utilização da CPU ao longo do tempo.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/counter-metrics.png)
Para alterar os contadores de performance, escolha **Gerenciar métricas**. É possível selecionar várias **Métricas de SO**, conforme mostrado na captura de tela a seguir. Para ver detalhes de qualquer métrica, passe o mouse sobre o nome da métrica.
![\[Interface de seleção de métricas do painel dos Insights de performance com opções de métricas do sistema operacional.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/overview-os-metrics.png)
## Gráfico de carga do banco de dados
O gráfico **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 **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.
![\[Gráfico Carga do banco de dados, mostrando a média de sessões ativas ao longo do tempo, com o aumento do uso da CPU próximo ao fim.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/database-load.png)
**Carga de banco de dados separada por dimensões**
É possível optar por exibir a carga como sessões ativas agrupadas por quaisquer dimensões aceitas. A imagem a seguir mostra as dimensões de uma instância de banco de dados do Amazon DocumentDB.
![\[Gráfico mostrando a carga do banco de dados com várias opções “Fatiar por” exibidas em uma lista suspensa.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/database-load-sliced.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 de consulta.
![\[Gráfico de barras mostrando a carga do banco de dados com detalhes adicionais exibidos ao passar o mouse sobre o nome de um item.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/database-load-details.png)
Para ver detalhes de qualquer item do período selecionado na legenda, passe o mouse sobre esse item.
![\[Gráfico de barras mostrando a carga do banco de dados com detalhes adicionais exibidos ao passar o mouse sobre uma barra.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/database-load-hover.png)
## Tabela Top dimensions
A tabela **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 consulta, **Principais consultas** mostrará as instruções SQL que mais contribuem para a carga do banco de dados.
Escolha qualquer uma das guias de dimensão a seguir.
![\[A guia Dimensões das consultas principais, mostrando as duas consultas principais.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/top-dimensions.png)
A tabela a seguir fornece uma breve descrição de cada guia.
| Tab | Description |
| --- | --- |
| Esperas principais | O evento para o qual o backend do banco de dados está aguardando |
| Principais consultas | As instruções de consulta que estão sendo executadas no momento |
| Hosts principais | O host IP e porta do cliente conectado |
| Principais bancos de dados | O nome do banco de dados ao qual o cliente está conectado |
| Principais aplicações | O nome da aplicação que está conectada ao banco de dados |
Para aprender a analisar consultas utilizando a guia **Principais consultas**, consulte [Visão geral da guia Principais consultas](performance-insights-top-queries.md).
# Abrir o painel do Performance Insights
**Para visualizar o painel do Performance Insights no AWS Management Console, use as seguintes etapas:**
1. Abra o console do Performance Insights em [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/home#performance-insights).
1. Escolha uma instância de banco de dados. O painel do Performance Insights é exibido para essa instância dp Amazon DocumentDB.
Para as instâncias do Amazon DocumentDB com o Performance Insights habilitado, você também pode acessar o painel escolhendo o item **Sessões** na lista de instâncias. 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 está ociosa. À medida que a carga aumenta, a barra é preenchida com a cor azul. Quando a carga ultrapassa o número de virtual CPUs (vCPUs) na classe da instância, a barra fica vermelha, indicando um possível gargalo.
![\[A página Clusters, mostrando um cluster regional do Amazon DocumentDB e a CPU e a atividade atual de cada instância do cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/opening-clusters.png)
1. (Opcional) Escolha um intervalo de tempo diferente selecionando um botão no canto superior direito. Por exemplo, para alterar o intervalo para 1 hora, selecione **1h**.
![\[Botões de intervalo de tempo, variando de cinco minutos a uma semana.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/opening-time.png)
Na captura de tela a seguir, o intervalo da carga do banco de dados é de 1 hora.
![\[Gráfico de barras mostrando a carga do banco de dados medida na média de sessões ativas.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/opening-db-load.png)
1. Para atualizar seus dados automaticamente, habilite a **Atualização automática**.
![\[O botão de atualização automática habilitado, aparecendo ao lado dos botões de intervalo de tempo.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/opening-auto-refresh.png)
O painel do Performance Insights é atualizado automaticamente com novos dados. A taxa de atualização depende da quantidade de dados exibida:
+ 5 minutos atualiza a cada 5 segundos.
+ 1 hora atualiza a cada minuto.
+ 5 horas atualiza a cada minuto.
+ 24 horas atualiza a cada 5 minutos.
+ Uma semana atualiza a cada hora.
# Analisar a carga do banco de dados por estados de espera
Se o gráfico **Carregamento do banco de dados** mostrar um gargalo, será possível descobrir de onde vem essa carga. Para fazer isso, examine a tabela de principais itens de carga abaixo do gráfico **Carregamento do banco de dados**. Escolha um item específico, como uma consulta ou uma aplicação, para aprofundar neste item e ver detalhes sobre ele.
A carga do banco de dados agrupada por espera e as principais consultas normalmente fornecem mais informações 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 **Principais consultas** da tabela Top Load Items 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 **Carregamento 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 **Top queries** da tabela Top Load Items estão contribuindo mais para aqueles estados de espera. É possível identificar essas consultas na coluna **Carga por espera (AAS)**.
1. Escolha uma dessas consultas resumidas na guia **Top queries** para expandi-la e exibir as consultas secundárias que a compõem.
Você também pode ver quais hosts ou aplicações estão contribuindo com a maior carga selecionando **Principais hosts** ou **Principais aplicações**, respectivamente. Os nomes das aplicações são especificados na cadeia de conexão com a instância Amazon DocumentDB. `Unknown` indica que o campo da aplicação não foi especificado.
Por exemplo, no painel a seguir, as esperas de **CPU** compõem a maior parte da carga de banco de dados. Selecionar a consulta principal em **Principais consultas** definirá o gráfico de carga do banco de dados para se concentrar na maior carga que está sendo contribuída pela consulta selecionada.
![\[Gráfico de carga do banco de dados, mostrando o pico de uso da CPU. Uma guia Principais consultas correspondente mostra as consultas que mais contribuem para os estados de espera.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/db-load-1.png)
![\[Gráfico Carga do banco de dados, mostrando o pico de uso da CPU para a consulta que mais contribui para os estados de espera. Uma guia Principais consultas correspondente mostra as consultas secundárias dessa consulta.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/db-load-2.png)
# Visão geral da guia Principais consultas
Por padrão, a guia **Principais consultas** mostra as consultas que mais estão contribuindo para a carga do banco de dados. É possível analisar o texto da consulta para ajudar a ajustar suas consultas.
**Topics**
+ [Resumos de consultas](#performance-insights-top-queries-digests)
+ [Load by waits (AAS) (Carga por esperas)](#performance-insights-top-queries-aas)
+ [Visualizando informações detalhadas da consulta](#performance-insights-top-queries-query-info)
+ [Acessando o texto da consulta da instrução](#performance-insights-top-queries-accessing-text)
+ [Visualizando e baixando o texto da consulta de instrução](#performance-insights-top-queries-viewing-downloading)
## Resumos de consultas
Um *resumo de consulta* é 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 de consulta pode ser semelhante a este:
```
{"find":"customerscollection","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}
```
Esse resumo pode incluir as seguintes consultas subordinadas:
```
{"find":"customerscollection","filter":{"FirstName":"Karrie"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Met"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Rashin"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
```
Para ver as instruções consultas literais em um resumo, escolha a consulta e depois o sinal de mais (`+`). Na captura de tela a seguir, a consulta selecionada é um resumo.
![\[A tabela Principais consultas, mostrando um resumo de consultas expandido com uma consulta secundária selecionada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/top-queries-literal.png)
**nota**
Um resumo de consulta agrupa instruções de consulta semelhantes, mas não edita informações confidenciais.
## Carga por esperas (AAS)
Em **Consultas principais**, a coluna **Carga por esperas (AAS)** mostra o percentual 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**. Por exemplo, é possível agrupar o gráfico **Carregamento do banco de dados** com base em estados de espera. Nesse caso, a barra **Carregamento do banco de dados por esperas** é 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.
![\[Gráfico de barras mostrando a carga do banco de dados agrupada por CPU, IO e estados de espera por trava. A tabela correspondente mostra as principais consultas com base na carga por espera.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/top-queries-aas.png)
## Visualizando informações detalhadas da consulta
Na tabela **Principais consultas**, é possível abrir uma *instrução de resumo* para visualizar suas informações. As informações são exibidas no painel inferior.
![\[A tabela Principais consultas, mostrando uma instrução de consulta selecionada e suas informações de consulta abaixo.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/top-queries-detailed.png)
Os seguintes tipos de identificadores (IDs) estão associados às instruções de consulta:
1. **ID da consulta de suporte** — Um valor de hash do ID da consulta. Esse valor serve apenas para fazer referência a um ID de consulta quando você está trabalhando com o AWS Support. AWS O Support não tem acesso à sua consulta real IDs e ao texto da consulta.
1. **ID de arquivo de resumo de suporte**: um valor de hash do ID de arquivo de resumo. Esse valor serve apenas para fazer referência a uma ID de resumo quando você está trabalhando com o Support AWS . AWS O Support não tem acesso ao texto real do resumo IDs e da consulta.
## Acessando o texto da consulta da instrução
Por padrão, cada linha na tabela **Principais consultas** mostra 500 bytes de texto para cada instrução. Quando uma instrução de resumo é maior que 500 bytes, você pode visualizar uma parte maior dela abrindo-a no painel do Performance Insights. Nesse caso, o comprimento máximo para a consulta mostrada é de 1 KB. Se você vir uma instrução de consulta completa, também poderá escolher **Download**.
## Visualizando e baixando o texto da consulta de instrução
No painel do Performance Insights, é possível visualizar ou baixar o texto da consulta.
**Para visualizar mais texto de consulta no painel do Performance Insights**
1. Abra o console do Amazon DocumentDB em: [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/)
1. No painel de navegação, escolha **Performance Insights**.
1. Escolha uma instância de banco de dados. O painel do Performance Insights será exibido nessa instância de banco de dados.
Instruções de consulta com texto maior que 500 bytes serão semelhantes à imagem a seguir.
![\[A tabela Principais consultas com uma consulta secundária selecionada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/top-queries-statement.png)
1. Examine a seção de informações de consulta para visualizar mais do texto da consulta.
![\[A seção Informações da consulta, mostrando o texto completo da consulta selecionada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/top-queries-query-text.png)
O painel do Performance Insights pode exibir até 1 KB para cada instrução completa de consulta.
**nota**
Para copiar ou baixar a instrução de consulta, desabilite bloqueadores de pop-up.
# Ampliar o gráfico de carga de banco de dados
Há outros recursos da interface do usuário do Performance Insights para ajudar você a analisar dados de performance.
**Click-and-Drag Ampliar**
Na interface do Performance Insights, escolha uma pequena parte do gráfico de carga e amplie os detalhes.
![\[Gráfico de barras mostrando a carga do banco de dados, com uma parte destacada para ampliação.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/pi-zoom-1.png)
Para ampliar uma parte do gráfico de carga, escolha a hora de início e arraste até o final do período desejado. Quando você faz isso, a área selecionada fica destacada. Ao soltar o mouse, o gráfico de carga amplia a área selecionada e a tabela ***Itens *principais** é recalculada.
![\[Gráfico de barras de carregamento do banco de dados, mostrando a parte ampliada e com a tabela de principais esperas correspondente abaixo.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/performance-insights/pi-zoom-2.png)