

# Métricas de monitoramento em uma instância do Amazon RDS
<a name="CHAP_Monitoring"></a>

Nas seções a seguir, você encontra uma visão geral do monitoramento do Amazon RDS e uma explicação sobre como acessar métricas. Para saber como monitorar eventos, logs e transmissões de atividades de banco de dados, consulte [Monitorar eventos, logs e fluxos em uma instância de banco de dados do Amazon RDS](CHAP_Monitor_Logs_Events.md).

**Topics**
+ [Plano de monitoramento](#MonitoringOverview.plan)
+ [Linha de base de performance](#MonitoringOverview.baseline)
+ [Orientações de performance](#MonitoringOverview.guidelines)
+ [Ferramentas de monitoramento do Amazon RDS](MonitoringOverview.md)
+ [Visualizar o status do cluster](accessing-monitoring.md)
+ [Recomendações do Amazon RDS](monitoring-recommendations.md)
+ [Visualizar métricas no console do Amazon RDS](USER_Monitoring.md)
+ [Visualizar métricas combinadas com o painel do Insights de Performance](Viewing_Unifiedmetrics.md)
+ [Monitorar métricas do Amazon RDS com o Amazon CloudWatch](monitoring-cloudwatch.md)
+ [Monitoramento de bancos de dados do Amazon RDS com o CloudWatch Database Insights](USER_DatabaseInsights.md)
+ [Monitorar a carga de banco de dados com o Performance Insights no Amazon RDS](USER_PerfInsights.md)
+ [Analisar anomalias de performance com o DevOps Guru para Amazon RDS](devops-guru-for-rds.md)
+ [Monitorar métricas do SO com o monitoramento avançado](USER_Monitoring.OS.md)
+ [Referência de métricas do Amazon RDS](metrics-reference.md)

## Plano de monitoramento
<a name="MonitoringOverview.plan"></a>

Antes de iniciar o monitoramento Amazon RDS, crie um plano de monitoramento. Esse plano deve responder às seguintes perguntas:
+ Quais são seus objetivos de monitoramento?
+ Quais recursos você vai monitorar?
+ Com que frequência você vai monitorar esses recursos?
+ Quais ferramentas de monitoramento você usará?
+ Quem realizará o monitoramento das tarefas?
+ Quem deve ser notificado quando algo der errado?

## Linha de base de performance
<a name="MonitoringOverview.baseline"></a>

Para atingir suas metas de monitoramento, é necessário estabelecer uma linha de base. Para fazer isso, meça a performance em diferentes condições de carga em vários momentos em seu ambiente do Amazon RDS. É possível monitorar métricas como as seguintes:
+ Taxa de transferência na rede
+ Conexões de cliente
+ E/S para operações de leitura, gravação ou metadados
+ Saldos de crédito intermitentes para suas instâncias de banco de dados

Recomendamos armazenar dados históricos de performance para o Amazon RDS. Usando os dados armazenados, é possível comparar a performance atual com as tendências anteriores. Também é possível distinguir padrões de performance normais de anomalias e criar técnicas para resolver problemas.

## Orientações de performance
<a name="MonitoringOverview.guidelines"></a>

Em geral, os valores aceitáveis para as métricas de performance dependem do que a aplicação está fazendo em relação à sua linha de base. Investigue variações consistentes ou tendenciais de sua linha de base. Muitas vezes, as métricas a seguir são a origem dos problemas de performance:
+  **Alto consumo de CPU ou RAM** – valores altos para o consumo de CPU ou RAM podem ser adequados, se estiverem de acordo com seus objetivos em relação ao aplicativo (como taxa de transferência ou concorrência). 
+  **Consumo de espaço em disco –** inspecione o consumo de espaço em disco caso o espaço usado seja consistentemente igual ou superior a 85% do espaço total no disco. Veja se é possível excluir dados da instância ou arquivar dados em um sistema diferente para liberar mais espaço. 
+  **Tráfego de rede** – em relação ao tráfego de rede, fale com o administrador do sistema para entender qual taxa de transferência é esperada para sua rede de domínio e conexão com a Internet. Inspecione o tráfego de rede caso a taxa de transferência seja consistentemente menor do que a esperada. 
+  **Conexões do banco de dados**: se você observar números elevados de conexões de usuários e também diminuições na performance da instância e no tempo de resposta, considere restringir as conexões do banco de dados. O melhor número de conexões de usuários para sua instância de banco de dados varia conforme a classe da instância e a complexidade das operações em execução. Para determinar o número de conexões de banco de dados, associe sua instância de banco de dados a um grupo de parâmetros cujo parâmetro `User Connections` esteja definido como um valor diferente de 0 (ilimitado). Você pode usar um parameter group existente ou criar um novo. Para obter mais informações, consulte [Grupos de parâmetros para Amazon RDS](USER_WorkingWithParamGroups.md). 
+  **Métricas de IOPS –** os valores esperados para as métricas de IOPS dependem da especificação do disco e da configuração do servidor, por isso, use sua linha de base para saber os valores típicos. Inspecione caso os valores sejam consistentemente diferentes da sua linha de base. Para obter a melhor performance de IOPS, confira se o seu conjunto de trabalho típico se adéqua à memória para minimizar as operações de leitura e gravação. 

Quando a performance estiver fora da linha de base estabelecida, talvez seja necessário fazer alterações para otimizar a disponibilidade do banco de dados para sua workload. Por exemplo, talvez você precise alterar a classe de sua instância de banco de dados. Ou talvez seja necessário alterar o número de instâncias de banco de dados e réplicas de leitura disponíveis para clientes. 

# Ferramentas de monitoramento do Amazon RDS
<a name="MonitoringOverview"></a>

O monitoramento é uma parte importante para manter a confiabilidade, a disponibilidade e o desempenho do Amazon RDS e suas outras soluções da AWS. A AWS fornece várias ferramentas de monitoramento para observar o Amazon RDS, gerar relatórios quando algo estiver errado e executar ações automáticas quando for apropriado.

**Topics**
+ [Ferramentas de monitoramento automatizadas](#MonitoringOverview.tools.automated)
+ [Ferramentas de monitoramento manual](#monitoring_manual_tools)

## Ferramentas de monitoramento automatizadas
<a name="MonitoringOverview.tools.automated"></a>

Recomendamos que as tarefas de monitoramento sejam automatizadas ao máximo possível.

**Topics**
+ [Status e recomendações de instância do Amazon RDS](#MonitoringOverview.tools.automated.rds)
+ [Métricas do Amazon CloudWatch para Amazon RDS](#MonitoringOverview.tools.automated.integrated)
+ [Insights de Performance do Amazon RDS e monitoramento do sistema operacional](#MonitoringOverview.tools.automated.metrics.rds)
+ [Serviços integrados](#MonitoringOverview.tools.automated.integrated.events-logs-streams)

### Status e recomendações de instância do Amazon RDS
<a name="MonitoringOverview.tools.automated.rds"></a>

É possível usar as seguintes ferramentas automatizadas para supervisionar o Amazon RDS e gerar relatórios quando algo estiver errado:
+ **Status da instância do Amazon RDS**: exibe detalhes sobre o status atual da instância usando o console do Amazon RDS, a AWS CLI ou a API do RDS.
+ **Amazon RDS recomendações** — responda a recomendações automatizadas para recursos de banco de dados, como instâncias de banco de dados, réplicas de leitura e grupo de parâmetros de banco de dados. Para obter mais informações, consulte [Recomendações do Amazon RDS](monitoring-recommendations.md).

### Métricas do Amazon CloudWatch para Amazon RDS
<a name="MonitoringOverview.tools.automated.integrated"></a>

O Amazon RDS integra-se ao Amazon CloudWatch para oferecer recursos adicionais de monitoramento.
+ **Amazon CloudWatch**: esse serviço monitora seus recursos da AWS e as e aplicações executadas na AWS em tempo real. É possível usar os seguintes recursos do Amazon CloudWatch com o Amazon RDS:
  + **Métricas do Amazon CloudWatch**: o Amazon RDS envia métricas automaticamente para o CloudWatch a cada minuto, para cada banco de dados ativo. Você não recebe cobranças adicionais para métricas do Amazon RDS no CloudWatch. Para obter mais informações, consulte [Monitorar métricas do Amazon RDS com o Amazon CloudWatch](monitoring-cloudwatch.md).
  + **Alarmes do Amazon CloudWatch**– Você pode assistir a uma única métrica do Amazon RDS em um período de tempo específico. Depois, você pode realizar uma ou mais ações com base no valor da métrica em relação a um limite definido. Para obter mais informações, consulte [Monitorar métricas do Amazon RDS com o Amazon CloudWatch](monitoring-cloudwatch.md).

### Insights de Performance do Amazon RDS e monitoramento do sistema operacional
<a name="MonitoringOverview.tools.automated.metrics.rds"></a>

É possível usar as seguintes ferramentas automatizadas para monitorar a performance do Amazon RDS:
+ **Amazon RDS Performance Insights**: avalie a carga no banco de dados e determine quando e onde tomar medidas. Para obter mais informações, consulte [Monitorar a carga de banco de dados com o Performance Insights no Amazon RDS](USER_PerfInsights.md).
+ **Monitoramento avançado do Amazon RDS**: observe as métricas em tempo real para o sistema operacional. Para obter mais informações, consulte [Monitorar métricas do SO com o monitoramento avançado](USER_Monitoring.OS.md).

### Serviços integrados
<a name="MonitoringOverview.tools.automated.integrated.events-logs-streams"></a>

Os seguintes serviços da AWS estão integrados ao Amazon RDS:
+ O *Amazon EventBridge* é um serviço de barramento de eventos sem servidor que facilita a conexão de aplicações a dados de diversas origens. Para obter mais informações, consulte [Monitorar eventos do Amazon RDS](working-with-events.md).
+ O *Amazon CloudWatch Logs* permite monitorar, armazenar e acessar os arquivos de log de instâncias do Amazon RDS, do CloudTrail e de outras fontes. Para obter mais informações, consulte [Monitorar arquivos de log do Amazon RDS](USER_LogAccess.md).
+ O *AWS CloudTrail* captura chamadas de API e eventos relacionados feitos por sua conta da Conta da AWS ou em nome dela e entrega os arquivos de log a um bucket do Amazon S3 que você especificar. Para obter mais informações, consulte [Monitorar chamadas de API do Amazon RDSno AWS CloudTrail](logging-using-cloudtrail.md).
+ O *Database Activity Streams* é um recurso do Amazon RDS que fornece uma transmissão quase em tempo real da atividade em sua instância de banco de dados Oracle. Para obter mais informações, consulte [Monitorar o Amazon RDS com o recurso Database Activity Streams](DBActivityStreams.md).

## Ferramentas de monitoramento manual
<a name="monitoring_manual_tools"></a>

É necessário monitorar manualmente os itens que os alarmes do CloudWatch não cobrem. Os painéis do console do Amazon RDS, do CloudWatch do AWS Trusted Advisor e outros painéis do console AWS apresentam uma visão rápida do estado do ambiente da AWS. Recomendamos que você também verifique os arquivos de log de sua instância de banco de dados.
+ Na console do Amazon RDS, é possível monitorar os seguintes itens de seus recursos:
  + O número de conexões a uma instância de banco de dados
  + A quantidade de operações de leitura e gravação em uma instância de banco de dados
  + A quantidade de armazenamento que uma instância de banco de dados está utilizando
  + A quantidade de memória e CPU em uso para uma instância de banco de dados
  + A quantidade de tráfego de rede de e para uma instância de banco de dados
+ No painel do Trusted Advisor, você pode rever as seguintes verificações de otimização de custos, segurança, tolerância a falhas e melhoria de performance:
  + Amazon RDS Idle DB Instances
  + Amazon RDS Security Group Access Risk
  + Amazon RDS Backups
  + Amazon RDS Multi-AZ

  Para obter mais informações sobre essas verificações, consulte [Melhores práticas do Trusted Advisor (verificações)](https://aws.amazon.com/premiumsupport/trustedadvisor/best-practices/).
+ A página inicial do CloudWatch mostra:
  + Alertas e status atual
  + Gráficos de alertas e recursos
  + Estado de integridade do serviço

  Além disso, é possível usar o CloudWatch para fazer o seguinte: 
  + Criar [painéis personalizados](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CloudWatch_Dashboards.html) para monitorar os serviços de seu interesse.
  + Colocar em gráfico dados de métrica para solucionar problemas e descobrir tendências.
  + Pesquise e procure todas as métricas de recursos da AWS.
  + Criar e editar alertas para ser notificado sobre problemas.

# Visualizar o status do cluster
<a name="accessing-monitoring"></a>

Usando o console do Amazon RDS, é possível acessar rapidamente o status da instância do banco de dados.

**Topics**
+ [Visualizar o status de uma instância de banco de dados do Amazon RDS](#Overview.DBInstance.Status)

## Visualizar o status de uma instância de banco de dados do Amazon RDS
<a name="Overview.DBInstance.Status"></a>

O status de uma instância de banco de dados indica o estado operacional atual. É possível usar os procedimentos a seguir para visualizar o status de uma instância de banco de dados no console do Amazon RDS, o comando AWS CLI ou a operação de API.

**nota**  
O Amazon RDS também usa outro status chamado *status de manutenção*, que é mostrado na coluna **Maintenance (Manutenção)** do console do Amazon RDS. Este valor indica o status de todos os patches de manutenção que precisarem ser aplicados a uma instância de banco de dados. O status de manutenção é independente do status da instância do banco de dados. Para ter mais informações sobre o status de manutenção, consulte [Aplicar atualizações para uma instânciade banco de dados](USER_UpgradeDBInstance.Maintenance.md#USER_UpgradeDBInstance.OSUpgrades). 

Encontre os valores possíveis do status de instâncias de banco de dados na tabela a seguir. Essa tabela mostra se você será cobrado pela instância de banco de dados e pelo armazenamento, apenas pelo armazenamento ou se não será cobrado. Para todos os status de instância de banco de dados, você sempre será cobrado pelo uso de backup.


| Status da instância de banco de dados | Faturado  | Descrição | 
| --- | --- | --- | 
|  **available**  |  Faturado  |  A instância de banco de dados está disponível para modificações.  | 
|  **backing-up**  |  Faturado  |  No momento, está sendo feito o backup da instância de banco de dados.  | 
|  **configuring-enhanced-monitoring**  |  Faturado  |  O monitoramento avançado está sendo habilitado ou desabilitado para essa instância de banco de dados.  | 
|  **configuring-iam-database-auth**  |  Faturado  |  AWS Identity and Access Management A autenticação do banco de dados do (IAM) está sendo habilitada ou desabilitada para essa instância de banco de dados.  | 
|  **configuring-log-exports**  |  Faturado  |  A publicação dos arquivos de log no Amazon CloudWatch Logs está sendo habilitada ou desabilitada para essa instância de banco de dados.  | 
|  **converting-to-vpc**  |  Faturado  |  A instância de banco de dados está sendo convertida de uma instância de banco de dados que não esteja em uma Amazon Virtual Private Cloud (Amazon VPC) em uma instância de banco de dados que esteja em uma Amazon VPC.  | 
|  **creating**  |  Não faturado (sem PITR) Faturado (somente PITR)  |  A instância de banco de dados está sendo criada. A instância de banco de dados permanece inacessível enquanto é criada.  Se você restaurar um banco de dados durante a recuperação para um ponto no tempo (PITR), a cobrança será feita enquanto o banco de dados estiver no estado **criando**. Esse é o único cenário em que o estado **criando** incorre em cobranças.  | 
|  **delete-precheck**  |  Não faturado  |  O Amazon RDS está validando que as réplicas de leitura podem ser excluídas com segurança.  | 
|  **deleting**  |  Não faturado  |  A instância de banco de dados está sendo excluída.  | 
|  **com falha**  |  Não faturado  |  A instância de banco de dados falhou e o Amazon RDS não pode recuperá-la. Execute uma restauração point-in-time no último momento restaurável da instância de banco de dados para recuperar os dados.   | 
|  **inaccessible-encryption-credentials**  |  Não faturado  |  A AWS KMS key usada para criptografar ou descriptografar a instância de banco de dados não pode ser acessada nem recuperada.   | 
|  **inaccessible-encryption-credentials-recoverable**  |  Faturado para armazenamento  |  A chave do KMS usada para criptografar ou descriptografar a instância de banco de dados não pode ser acessada. No entanto, se a chave do KMS estiver ativa, ela pode ser recuperada reiniciando a instância de banco de dados. Para obter mais informações, consulte [Criptografar uma instância de banco de dados](Overview.Encryption.md#Overview.Encryption.Enabling).  | 
|  **incompatible-create**  |  Não faturado  |  O Amazon RDS está tentando criar uma instância de banco de dados, mas não pode fazer isso porque os recursos são incompatíveis com sua instância de banco de dados. Esse status poderá ocorrer se, por exemplo, o perfil de instância do seu banco de dados não tiver as permissões corretas.  | 
|  **incompatible-network**  |  Não faturado  |  O Amazon RDS está tentando realizar uma ação de recuperação em uma instância de banco de dados, mas não pode fazer isso porque a VPC está em um estado que impede a conclusão da ação. Este status pode ocorrer se, por exemplo, todos os endereços IP disponíveis em uma sub-rede estiverem em uso e o Amazon RDS não puder obter um endereço IP para a instância de banco de dados.   | 
|  **incompatible-option-group**  |  Faturado  |  O Amazon RDS tentou aplicar uma alteração de grupo de opções, mas não pôde fazê-lo. O Amazon RDS não poderá reverter para o estado anterior do grupo de opções. Para ter mais informações, confira a lista **Recent Events (Eventos recentes)** da instância de banco de dados. Este status pode ocorrer se, por exemplo, o grupo de opções contém uma opção como TDE e a instância de banco de dados não contém informações criptografadas.   | 
|  **incompatible-parameters**  |  Faturado  |  O Amazon RDS não pode iniciar a instância de banco de dados porque os parâmetros especificados no parameter group de banco de dados da instância de banco de dados não são compatíveis com a instância. Reverta as alterações de parâmetro ou as torne compatíveis com a instância de banco de dados para retomar o acesso à instância de banco de dados. Para ter mais informações sobre parâmetros incompatíveis, confira a lista **Recent Events (Eventos recentes)** da instância de banco de dados.   | 
|  **incompatible-restore**  |  Não faturado  |  O Amazon RDS não pode fazer uma restauração point-in-time. As causas comuns para esse status incluem o uso de tabelas temporárias, MyISAM com MySQL ou tabelas Aria com MariaDB.  | 
| insuficiência de capacidade |  Não faturado  |  O Amazon RDS não consegue criar a instância porque não há capacidade suficiente disponível no momento. Para criar sua instância de banco de dados na mesma AZ com o mesmo tipo de instância, exclua a instância de banco de dados, aguarde algumas horas e tente criá-la novamente. Como alternativa, crie uma nova instância usando uma classe de instância diferente ou AZ.  | 
|  **manutenção**  |  Faturado  |  O Amazon RDS está aplicando uma atualização de manutenção na instância de banco de dados. Este status é usado para a manutenção de nível de instância que o RDS agenda com antecedência.   | 
|  **modifying**  |  Faturado  |  A instância de banco de dados está sendo modificada por causa de uma solicitação do cliente.   | 
|  **moving-to-vpc**  |  Faturado  |  A instância de banco de dados está sendo movida para uma nova Amazon Virtual Private Cloud (Amazon VPC).  | 
|  **reinicialização**  |  Faturado  |  A instância de banco de dados está sendo reinicializada por causa de uma solicitação do cliente ou de um processo do Amazon RDS que exige a reinicialização da instância.  | 
|  **resetting-master-credentials**  |  Faturado  |  As credenciais principais da instância de banco de dados estão sendo redefinidas por causa de uma solicitação do cliente.  | 
|  **renaming**  |  Faturado  |  A instância de banco de dados está sendo renomeada por causa de uma solicitação do cliente.   | 
|  **restore-error**  |  Faturado  |  A instância de banco de dados encontrou um erro ao tentar restaurar para um determinado point-in-time ou de um snapshot.  | 
|  **starting**  |  Faturado para armazenamento  |  A instância do banco de dados está iniciando.  | 
|  **interrompido**  |  Faturado para armazenamento  |  A instância do banco de dados está interrompida.  | 
|  **interromper**  |  Faturado para armazenamento  |  A instância do banco de dados está sendo interrompida.  | 
|  **storage-config-upgrade**  |  Faturado  |  A configuração do sistema de arquivos de armazenamento da instância de banco de dados está sendo atualizada. Esse status só se aplica a bancos de dados verdes em uma implantação azul/verde ou a réplicas de leitura de instâncias de banco de dados.  | 
|  **storage-full**  |  Faturado  |  A instância de banco de dados alcançou a alocação da capacidade de armazenamento. Esse é um status crítico e recomendamos que você corrija esse problema imediatamente. Para fazer isso, aumente seu armazenamento modificando a instância de banco de dados. Para evitar essa situação, configure os alarmes do Amazon CloudWatch para adverti-lo quando o espaço de armazenamento estiver ficando baixo.   | 
| storage-initialization |  Faturado  |  A instância de banco de dados está carregando blocos de dados do Amazon S3 para otimizar o desempenho do volume após a restauração de um snapshot. Ela permanece disponível para operações, mas o desempenho pode não estar na capacidade máxima até que a inicialização seja concluída.  | 
|  **storage-optimization**  |  Faturado  |  O Amazon RDS está otimizando o armazenamento de sua instância de banco de dados. O processo de otimização de armazenamento geralmente é curto, mas, às vezes, pode levar até 24 horas ou mais. Durante a otimização do armazenamento, a instância de banco de dados permanece disponível. A otimização do armazenamento é um processo em segundo plano que não afeta a disponibilidade da instância.  | 
|  **upgrading**  |  Faturado  |  A versão do mecanismo do banco de dados ou sistema operacional está sendo atualizada.  | 
|  **upgrade\$1failed**  |  Não faturado  |  A instância de banco de dados não foi atualizada para uma versão aceita. O Aurora cria um snapshot final com o prefixo `rds-final`.   | 

### Console
<a name="DBinstance.Status.Console"></a>

**Como visualizar o status de uma instância de banco de dados**

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 **Bancos de dados**.

   A página **Databases** (Bancos de dados) aparece com a lista de instâncias de banco de dados. Para cada instância de banco de dados , o valor do status é exibido.   
![\[Visualizar o status de uma instância de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/RDS_instance_status.png)

### CLI
<a name="DBinstance.Status.Cli"></a>

Para visualizar a instância de banco de dados e suas informações de status usando a AWS CLI, utilize o comando [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html). Por exemplo, o comando AWS CLI a seguir lista todas as informações de instâncias de banco de dados.

```
aws rds describe-db-instances
```

Para visualizar uma instância de banco de dados específica e seu status, chame o comando [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) com a seguinte opção:
+ `DBInstanceIdentifier`: o nome da instância de banco de dados. 

```
aws rds describe-db-instances --db-instance-identifier mydbinstance
```

Para visualizar apenas o status de todas as instâncias de banco de dados, utilize a consulta a seguir na AWS CLI.

```
aws rds describe-db-instances --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]' --output table
```

### solicitações de
<a name="DBinstance.Status.Api"></a>

Para visualizar o status da instância de banco de dados usando a API do Amazon RDS, chame a operação [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html).

# Recomendações do Amazon RDS
<a name="monitoring-recommendations"></a>

O Amazon RDS fornece recomendações automatizadas para recursos de banco de dados, como instâncias de banco de dados, réplicas de leitura e grupo de parâmetros de cluster de banco de dados. Essas recomendações fornecem orientações de práticas recomendadas, analisando a configuração, o uso e os dados de performance da instância de banco de dados.

O Insights de Performance do Amazon RDS monitora métricas específicas e cria limites automaticamente analisando quais níveis são considerados possivelmente problemáticos para um recurso específico. Quando novos valores de métricas ultrapassam um limite predefinido em um período específico, o Performance Insights gera uma recomendação proativa. Essa recomendação ajuda a evitar um impacto futuro na performance do banco de dados. Por exemplo, a recomendação “Ocioso na transação” é gerada para instâncias do RDS para PostgreSQL quando as sessões conectadas ao banco de dados não estão realizando trabalho ativo, mas podem manter os recursos do banco de dados bloqueados. Para receber recomendações proativas, é necessário ativar o Performance Insights com um período de retenção de nível pago. Para ter informações sobre como ativar o Performance Insights, consulte [Ativar e desativar o Insights de Performance do Amazon RDS](USER_PerfInsights.Enabling.md). Para ter informações sobre preços e retenção de dados para o Performance Insights, consulte [Preços e retenção de dados para o Performance Insights](USER_PerfInsights.Overview.cost.md).

O DevOps Guru para RDS monitora determinadas métricas para detectar quando o comportamento de uma métrica se torna altamente incomum ou anômalo. Essas anomalias são relatadas como insights reativos com recomendações. Por exemplo, o DevOps Guru para RDS pode recomendar que você aumente a capacidade da CPU ou investigue eventos de espera que estão contribuindo para a carga do banco de dados. O DevOps Guru para RDS também fornece recomendações proativas baseadas em limites. Para essas recomendações, é necessário ativar o DevOps Guru para RDS. Para ter informações sobre como ativar o DevOps Guru para RDS, consulte [Ativar o DevOps Guru e especificar a cobertura de recursos](devops-guru-for-rds.md#devops-guru-for-rds.configuring.coverage). 

As recomendações estarão em qualquer um dos seguintes status: ativas, rejeitadas, pendentes ou resolvidas. As recomendações resolvidas ficam disponíveis por 365 dias.

É possível ver ou ignorar as recomendações. É possível aplicar uma recomendação ativa baseada em configuração imediatamente, programá-la para a próxima janela de manutenção ou descartá-la. Para recomendações proativas baseadas em limites e baseadas em machine learning, é necessário analisar a causa sugerida do problema e, depois, realizar as ações recomendadas para corrigir o problema. 

As recomendações são aceitas nas seguintes Regiões da AWS:
+ Leste dos EUA (Ohio)
+ Leste dos EUA (Norte da Virgínia)
+ Oeste dos EUA (Norte da Califórnia)
+ Oeste dos EUA (Oregon)
+ Ásia-Pacífico (Mumbai)
+ Ásia-Pacífico (Seul)
+ Ásia-Pacífico (Singapura)
+ Ásia-Pacífico (Sydney)
+ Ásia-Pacífico (Tóquio)
+ Canadá (Central)
+ Europa (Frankfurt)
+ Europa (Irlanda)
+ Europa (Londres)
+ Europa (Paris)
+ Europa (Estocolmo)
+ América do Sul (São Paulo)

Aprenda a visualizar, aplicar, ignorar e modificar recomendações do Amazon RDS nas seções a seguir.

**Topics**
+ [Visualizar as recomendações Amazon RDS](UserRecommendationsView.md)
+ [Aplicar as recomendações do Amazon RDS](USERRecommendationsManage.ApplyRecommendation.md)
+ [Ignorar as recomendações do Amazon RDS](USERRecommendationsManage.DismissRecommendation.md)
+ [Modificar as recomendações ignoradas do Amazon RDS para recomendações ativas](USERRecommendationsManage.DismissToActiveRecommendation.md)
+ [Recomendações da referência do Amazon RDS](USERRecommendationsManage.RecommendationReference.md)

# Visualizar as recomendações Amazon RDS
<a name="UserRecommendationsView"></a>

Usando o console do Amazon RDS, é possível visualizar as recomendações do Amazon RDS para os recursos de banco de dados.

## Console
<a name="UserRecommendationsView.Con"></a>

**Como visualizar recomendações do Amazon RDS**

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, execute qualquer uma das seguintes opções:
   + Selecione **Recomendações**. O número de recomendações ativas para os recursos e o número de recomendações com maior gravidade geradas no último mês estão disponíveis ao lado de **Recomendações**. Para encontrar o número de recomendações ativas para cada gravidade, selecione o número que mostra a maior gravidade.   
![\[Selecione Recommendations (Recomendações) no console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/recommendations-select.png)

     Por padrão, a página **Recomendações** exibe uma lista de novas recomendações no último mês. O Amazon RDS fornece recomendações para todos os recursos na conta e as classifica de acordo com a gravidade.  
![\[Página de recomendações principais no console que contém todas as recomendações\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_List.png)

     É possível selecionar uma recomendação para ver uma seção na parte inferior da página que contém os recursos afetados e detalhes de como a recomendação será aplicada.
   + Na página **Bancos de dados**, selecione **Recomendações** para um recurso.  
![\[Opção de recomendação selecionada na página Bancos de dados no console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_DBpage.png)

     A guia **Recomendações** exibe as recomendações e os detalhes do recurso selecionado.  
![\[Guia Recomendações na página Bancos de dados no console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/RecommendationsTab_DBpage.png)

   Os detalhes a seguir estão disponíveis para as recomendações:
   + **Gravidade**: o nível de implicação do problema. Os níveis de gravidade são **Alto**, **Médio**, **Baixo** e **Informativo**.
   + **Detecção**: o número de recursos afetados e uma breve descrição do problema. Selecione este link para ver a recomendação e os detalhes da análise.
   + **Recomendação**: uma breve descrição da ação recomendada a ser aplicada.
   + **Impacto**: uma breve descrição do possível impacto quando a recomendação não é aplicada.
   + **Categoria**: o tipo de recomendação. As categorias são **Eficiência de performance**, **Segurança**, **Confiabilidade**, **Otimização de custos**, **Excelência operacional** e **Sustentabilidade**.
   + **Status**: o status atual da recomendação. Os status possíveis são **Todos**, **Ativo**, **Dispensado**, **Resolvido** e **Pendente**.
   + **Horário de início**: a hora em que o problema começou. Por exemplo, **18 horas atrás**.
   + **Última modificação**: a hora em que a recomendação foi atualizada pela última vez pelo sistema devido a uma alteração na **Gravidade** ou a hora em que você respondeu à recomendação. Por exemplo, **10 horas atrás**.
   + **Horário de término**: a hora em que o problema terminou. A hora não será exibida para nenhum problema contínuo.
   + **Identificador do recurso**: o nome de um ou mais recursos.

1. (Opcional) Selecione os operadores de **Gravidade** ou **Categoria** no campo para filtrar a lista de recomendações.  
![\[Página de recomendações com operação de gravidade no console.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_Severity.png)

   As recomendações para a operação selecionada são exibidas.

1. (Opcional) Selecione qualquer um dos seguintes status de recomendação:
   + **Ativo** (padrão): mostra as recomendações atuais que você pode aplicar, programar para a próxima janela de manutenção ou dispensar. 
   + **Todos**: mostra todas as recomendações com o status atual.
   + **Dispensado**: mostra as recomendações dispensadas.
   + **Resolvido**: mostra as recomendações resolvidas.
   + **Pendente**: mostra as recomendações cujas ações recomendadas estão em andamento ou programadas para a próxima janela de manutenção.   
![\[Recomendações filtradas por status no console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_Status.png)

1. (Opcional) Selecione **Modo relativo** ou **Modo absoluto** em **Última modificação** para modificar o período. A página **Recomendações** exibe as recomendações geradas no período. O período padrão é o último mês. No **Modo absoluto**, é possível escolher o período ou inserir a hora nos campos **Data de início** e **Data de término**.  
![\[Recomendações filtradas por período no console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_TimeMode.png)

   As recomendações para o período definido são exibidas.

   Observe que é possível ver todas as recomendações de recursos na conta definindo o intervalo como **Todos**.

1. (Opcional) Selecione **Preferências** à direita para personalizar os detalhes a serem exibidos. É possível escolher um tamanho de página, quebrar as linhas do texto e exibir ou ocultar as colunas.

1. (Opcional) Selecione uma recomendação e, depois, escolha **Visualizar detalhes**.  
![\[Página de recomendações no console com um botão Recomendação selecionada e Visualizar detalhes escolhido.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_viewDetailsSelect.png)

   A página de detalhes da recomendação é exibida. O título fornece a contagem total dos recursos com o problema detectado e a gravidade.

   Para ter informações sobre os componentes na página de detalhes de uma recomendação reativa baseada em anomalias, consulte [Viewing reactive anomalies](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-rds.analyzing.metrics.html) no *Guia do usuário do Amazon DevOps Guru*.

   Para ter informações sobre os componentes na página de detalhes de uma recomendação proativa baseada em limites, consulte [Visualizar as recomendações proativas do Performance Insights](USER_PerfInsights.InsightsRecommendationViewDetails.md).

   As outras recomendações automatizadas exibem os seguintes componentes na página de detalhes da recomendação:
   + **Recomendação**: um resumo da recomendação e se é necessário tempo de inatividade para aplicar a recomendação.  
![\[Página de detalhes das recomendações mostrando a seção Recomendação no console.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/RecommendationSummary.png)
   + **Recursos afetados**: detalhes dos recursos afetados.  
![\[Página de detalhes das recomendações mostrando a seção Recursos afetados no console.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_AffectedResources.png)
   + **Detalhes da recomendação**: informações do mecanismo compatível, qualquer custo associado necessário para aplicar a recomendação e link da documentação para saber mais.  
![\[Página de detalhes das recomendações mostrando a seção Detalhes da recomendação no console.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/RecommendationDetails.png)

## CLI
<a name="UserRecommendationsView.Cli"></a>

Para visualizar as recomendações do Amazon RDS das instâncias de banco de dados, use o comando a seguir em AWS CLI.

```
aws rds describe-db-recommendations
```

## API do RDS
<a name="UserRecommendationsView.API"></a>

Para visualizar as recomendações do Amazon RDS usando a API do Amazon RDS, use a operação [DescribeDBRecommendations](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBRecommendations.html).

# Aplicar as recomendações do Amazon RDS
<a name="USERRecommendationsManage.ApplyRecommendation"></a>

Para aplicar as recomendações do Amazon RDS usando o console do Amazon RDS, selecione uma recomendação baseada na configuração ou um recurso afetado na página de detalhes. Depois, opte por aplicar a recomendação imediatamente ou programá-la para a próxima janela de manutenção. Talvez seja necessário que o recurso seja reiniciado para que a alteração tenha efeito. Para algumas recomendações de grupos de parâmetros de banco de dados, talvez seja necessário reiniciar os recursos.

As recomendações proativas baseadas em limites ou reativas baseadas em anomalias não terão a opção de aplicação e poderão precisar de análise adicional.

## Console
<a name="USERRecommendationsManage.ApplyRecommendation-Console"></a>

**Como aplicar uma recomendação baseada em configuração**

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, execute qualquer uma das seguintes opções:
   + Selecione **Recomendações**.

     A página **Recomendações** aparece com a lista de todas as recomendações.
   + Selecione **Bancos de dados** e, depois, escolha **Recomendações** para um recurso na página de bancos de dados.

     Os detalhes são exibidos na guia **Recomendações** da recomendação selecionada.
   + Selecione **Detecção** para receber uma recomendação ativa na página **Recomendações** ou na guia **Recomendações** na página **Bancos de dados**.

     A página de detalhes da recomendação é exibida.

1. Selecione uma recomendação ou um ou mais recursos afetados na página de detalhes da recomendação e faça o seguinte:
   + Selecione **Aplicar** e, depois, escolha **Aplicar imediatamente** para aplicar a recomendação imediatamente.
   + Selecione **Aplicar** e, depois, escolha **Aplicar durante a próxima janela de manutenção programada** para programar na próxima janela de manutenção.

     O status da recomendação selecionada é atualizado para pendente até a próxima janela de manutenção.  
![\[Uma recomendação ativa selecionada e o botão Aplicar com suas opções realçadas no console.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_Apply_Defer.png)

   Uma janela de confirmação é exibida.

1. Selecione **Confirmar aplicação** para aplicar a recomendação. Essa janela confirma se os recursos precisam de uma reinicialização automática ou manual para que as alterações tenham efeito.

   O exemplo a seguir mostra a janela de confirmação para aplicar a recomendação imediatamente.  
![\[A janela de confirmação no console para aplicar a recomendação imediatamente\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_ApplyImmediately.png)

   O exemplo a seguir mostra a janela de confirmação para programar a aplicação da recomendação na próxima janela de manutenção.  
![\[A janela de confirmação no console para programar a aplicação da recomendação na próxima janela de manutenção.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_Defer.png)

   Um banner exibe uma mensagem quando a recomendação aplicada é bem-sucedida ou falhou.

   O exemplo a seguir mostra o banner com a mensagem de êxito.   
![\[Um banner no console mostrando a mensagem com o número de recursos que aplicarão a recomendação\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendation-Apply-Banner.png)

   O exemplo a seguir mostra o banner com a mensagem de falha.   
![\[Um banner no console mostrando a mensagem com o recurso que não aplicou a recomendação e o motivo da falha\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendation-Apply-Banner-failure.png)

## API do RDS
<a name="USERRecommendationsManage.ApplyRecommendation-API"></a>

**Para aplicar uma recomendação do RDS baseada em configuração usando a API do Amazon RDS**

1. Use a operação [DescribeDBRecommendations](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBRecommendations.html). `RecommendedActions` na saída pode ter uma ou mais ações recomendadas.

1. Use o objeto [RecommendedAction](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RecommendedAction.html) para cada ação recomendada da etapa 1. A saída contém `Operation` e `Parameters`.

   O exemplo a seguir mostra a saída com uma ação recomendada.

   ```
       "RecommendedActions": [
           {
               "ActionId": "0b19ed15-840f-463c-a200-b10af1b552e3",
               "Title": "Turn on auto backup", // localized
               "Description": "Turn on auto backup for my-mysql-instance-1", // localized
               "Operation": "ModifyDbInstance",
               "Parameters": [
                   {
                       "Key": "DbInstanceIdentifier",
                       "Value": "my-mysql-instance-1"
                   },
                   {
                       "Key": "BackupRetentionPeriod",
                       "Value": "7"
                   }
               ],
               "ApplyModes": ["immediately", "next-maintenance-window"],
               "Status": "applied"
           },
           ... // several others
       ],
   ```

1. Use `operation` para cada ação recomendada da saída na etapa 2 e insira os valores `Parameters`.

1. Depois que a operação na etapa 2 for bem-sucedida, use a operação [ModifyDBRecommendation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBRecommendation.html) para modificar o status da recomendação.

# Ignorar as recomendações do Amazon RDS
<a name="USERRecommendationsManage.DismissRecommendation"></a>

É possível ignorar uma ou mais recomendações do Amazon RDS usando o console do Amazon RDS, a AWS CLI ou a API do Amazon RDS.

## Console
<a name="USERRecommendationsManage.DismissRecommendation-Console"></a>

**Como dispensar uma ou mais recomendações**

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, execute qualquer uma das seguintes opções:
   + Selecione **Recomendações**.

     A página **Recomendações** aparece com a lista de todas as recomendações.
   + Selecione **Bancos de dados** e, depois, escolha **Recomendações** para um recurso na página de bancos de dados.

     Os detalhes são exibidos na guia **Recomendações** da recomendação selecionada.
   + Selecione **Detecção** para receber uma recomendação ativa na página **Recomendações** ou na guia **Recomendações** na página **Bancos de dados**.

     A página de detalhes da recomendação exibe a lista dos recursos afetados.

1. Escolha uma ou mais recomendações ou um ou mais recursos afetados na página de detalhes da recomendação e selecione **Dispensar**.

   O exemplo a seguir mostra a página **Recomendações** com várias recomendações ativas selecionadas para serem dispensadas.  
![\[Algumas recomendações ativas selecionadas e o botão Dispensar destacado no console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_Dismiss.png)

   Um banner exibe uma mensagem quando uma ou mais recomendações selecionadas são dispensadas.

   O exemplo a seguir mostra o banner com a mensagem de êxito.   
![\[Um banner no console mostrando a mensagem com o número de recursos que dispensaram com êxito a recomendação\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendation-Dismiss-Banner.png)

   O exemplo a seguir mostra o banner com a mensagem de falha.  
![\[Um banner no console mostrando a mensagem com o recurso que não dispensou a recomendação\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendation-Dismiss-Banner-failure.png)

## CLI
<a name="USERRecommendationsManage.DismissRecommendation-Cli"></a>

**Como dispensar uma recomendação do RDS usando a AWS CLI**

1. Execute o comando `aws rds describe-db-recommendations --filters "Name=status,Values=active"`.

   A saída fornece uma lista de recomendações no status `active`.

1. Encontre o `recommendationId` para a recomendação que você deseja dispensar na etapa 1.

1. Execute o comando `>aws rds modify-db-recommendation --status dismissed --recommendationId <ID>` com o `recommendationId` da etapa 2 para dispensar a recomendação.

## API do RDS
<a name="USERRecommendationsManage.DismissRecommendation-API"></a>

Para dispensar uma recomendação do RDS usando a API do Amazon RDS, use a operação [ModifyDBRecommendation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBRecommendation.html).

# Modificar as recomendações ignoradas do Amazon RDS para recomendações ativas
<a name="USERRecommendationsManage.DismissToActiveRecommendation"></a>

É possível modificar uma ou mais recomendações ignoradas do Amazon RDS para recomendações ativas usando o console do Amazon RDS, a AWS CLI ou a API do Amazon RDS.

## Console
<a name="USERRecommendationsManage.DismissToActiveRecommendation-Console"></a>

**Como mover uma ou mais recomendações dispensadas para recomendações ativas**

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, execute qualquer uma das seguintes opções:
   + Selecione **Recomendações**.

     A página **Recomendações** exibe uma lista de recomendações classificadas pela gravidade de todos os recursos da conta.
   + Selecione **Bancos de dados** e, depois, escolha **Recomendações** para um recurso na página de bancos de dados.

     A guia **Recomendações** exibe as recomendações e os detalhes do recurso selecionado.

1. Escolha uma ou mais recomendações dispensadas na lista e selecione **Mover para ativo**.  
![\[Algumas recomendações dispensadas selecionadas e o botão Mover para ativo destacado no console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendations_DismissToActive.png)

   Um banner exibe uma mensagem de êxito ou falha ao mover as recomendações selecionadas do status dispensado para ativo.

   O exemplo a seguir mostra o banner com a mensagem de êxito.  
![\[Um banner no console mostrando a mensagem com o número de recursos que foram movidos de recomendações dispensadas para ativas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendation-DismissToActive-Banner.png)

   O exemplo a seguir mostra o banner com a mensagem de falha.  
![\[Um banner no console mostrando a mensagem com o recurso que foi movido de recomendações dispensadas para ativas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Recommendation-DismissToActive-Banner-Failure.png)

## CLI
<a name="USERRecommendationsManage.DismissToActiveRecommendation-Cli"></a>

**Como alterar uma recomendação dispensada do RDS para uma recomendação ativa usando a AWS CLI**

1. Execute o comando `aws rds describe-db-recommendations --filters "Name=status,Values=dismissed"`.

   A saída fornece uma lista de recomendações no status `dismissed`.

1. Encontre `recommendationId` para a recomendação cujo status você deseja alterar da etapa 1.

1. Execute o comando `>aws rds modify-db-recommendation --status active --recommendationId <ID>` com o `recommendationId` da etapa 2 para alterar para a recomendação ativa.

## API do RDS
<a name="USERRecommendationsManage.DismissToActiveRecommendation-API"></a>

Para alterar uma recomendação do RDS para uma recomendação ativa usando a API do Amazon RDS, use a operação [ModifyDBRecommendation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBRecommendation.html).

# Recomendações da referência do Amazon RDS
<a name="USERRecommendationsManage.RecommendationReference"></a>

O Amazon RDS gera recomendações para um recurso quando esse recurso é criado ou modificado. É possível encontrar exemplos de recomendações do Amazon RDS na tabela a seguir. 


| Tipo | Descrição | Recomendação | Tempo de inatividade necessário | Mais informações | 
| --- | --- | --- | --- | --- | 
|  O volume magnético está em uso.  |  As instâncias de banco de dados estão usando armazenamento magnético. O armazenamento magnético não é recomendado para a maioria das instâncias de banco de dados. Escolha um tipo de armazenamento diferente: de uso geral (SSD) ou IOPS provisionadas.  |  Selecione um tipo de armazenamento diferente: de uso geral (SSD) ou IOPS provisionadas.  |  Sim  |  [Volumes da geração anterior](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html#vol-type-prev) na documentação do Amazon EC2.  | 
|  Os backups automatizados do recurso estão desativados  |  Os backups automatizados não estão ativados para as instâncias de banco de dados. Backups automatizados são recomendados porque permitem a recuperação para um ponto no tempo de instâncias de banco de dados.  |  Ative os backups automatizados com um período de retenção de até 14 dias.  |  Sim  |  [Ativar backups automáticos](USER_WorkingWithAutomatedBackups.Enabling.md) [ Desmistificar os custos de armazenamento de backup do Amazon RDS](https://aws.amazon.com/blogs/database/demystifying-amazon-rds-backup-storage-costs/) no blog de bancos de dados da AWS   | 
|  A atualização da versão secundária do mecanismo é necessária.  |  Os recursos de banco de dados não estão executando a versão secundária mais recente do mecanismo de banco de dados. A versão secundária mais recente contém as correções de segurança mais recentes e outras melhorias.  |  Atualize para a versão mais recente do mecanismo.  |  Sim  |  [Atualizar a versão de mecanismo de uma instância de banco de dados ](USER_UpgradeDBInstance.Upgrading.md)  | 
|  O monitoramento aprimorado está desativado.  |  Os recursos de banco de dados não têm o monitoramento aprimorado ativado. O monitoramento avançado fornece métricas do sistema operacional em tempo real para monitoramento e solução de problemas.  |  Ative o monitoramento aprimorado.  |  Não  |  [Monitorar métricas do SO com o monitoramento avançado](USER_Monitoring.OS.md)  | 
|  A criptografia de armazenamento está desativada.  |  O Amazon RDS é compatível com a criptografia em repouso para todos os mecanismos de banco de dados usando as chaves gerenciadas no AWS Key Management Service (AWS KMS). Em uma instância de banco de dados ativa com criptografia do Amazon RDS, os dados armazenados em repouso no armazenamento são criptografados, de forma semelhante aos backups automatizados, réplicas de leitura e snapshots. Se a criptografia não estiver ativada durante a criação de uma instância de banco de dados, será necessário criar e restaurar uma cópia criptografada do snapshot descriptografado da instância de banco de dados antes de ativar a criptografia.  |  Ative a criptografia de dados em repouso para a instância de banco de dados.  |  Sim  |  [Segurança no Amazon RDS](UsingWithRDS.md) [Copiar um snapshot de banco de dados para o Amazon RDS](USER_CopySnapshot.md)  | 
| O Performance Insights está desativado | O Performance Insights monitora a carga da instância de banco de dados para ajudar a analisar e solucionar problemas de performance do banco de dados. Recomendamos ativar o Performance Insights. | Ative o Performance Insights. | Não |  [Monitorar a carga de banco de dados com o Performance Insights no Amazon RDS](USER_PerfInsights.md)  | 
| As instâncias de banco de dados têm o ajuste de escala automático do armazenamento desativado. | O ajuste de escala automático do armazenamento não está ativado para a instância de banco de dados. Quando há um aumento na workload, o ajuste de escala automático do armazenamento do RDS escala automaticamente a capacidade de armazenamento, sem tempo de inatividade. | Ative o ajuste de escala automático do armazenamento do Amazon RDS com um limite máximo de armazenamento especificado. | Não |  [Gerenciar a capacidade automaticamente com a escalabilidade automática de armazenamento do Amazon RDS](USER_PIOPS.Autoscaling.md)  | 
|  A atualização das versões principais dos recursos do RDS é necessária. | Bancos de dados com a versão principal atual do mecanismo de banco de dados não serão aceitos. Recomendamos atualizar para a versão principal mais recente, que inclui novas funcionalidades e aprimoramentos. | Atualize para a versão principal mais recente do mecanismo de banco de dados. | Sim | [Atualizar a versão de mecanismo de uma instância de banco de dados ](USER_UpgradeDBInstance.Upgrading.md) [Usar implantações azul/verde do Amazon RDS para atualizações de banco de dados](blue-green-deployments.md)  | 
| A atualização da classe de instância de recursos do RDS é necessária. | A instância de banco de dados está executando uma classe de instância de banco de dados de uma geração anterior. Substituímos as classes de instância de banco de dados de uma geração anterior por classes de instância de banco de dados com melhor custo, performance ou ambos. Recomendamos executar a instância de banco de dados com uma classe de instância de banco de dados de uma geração mais recente. | Atualize a classe de instância de banco de dados. | Sim |  [Mecanismos de banco de dados compatíveis para classes de instância de banco de dados](Concepts.DBInstanceClass.Support.md)  | 
| Recursos do RDS usando a edição final do suporte do mecanismo sob licença incluída | Recomendamos atualizar a versão principal para a versão mais recente do mecanismo aceita pelo Amazon RDS para continuar com o suporte de licença atual. A versão do mecanismo do banco de dados não será compatível com a licença atual. | Recomendamos atualizar o banco de dados para a versão mais recente compatível com o Amazon RDS para continuar usando o modelo licenciado. | Sim |  [Atualizações da versão principal do Oracle](USER_UpgradeDBInstance.Oracle.Major.md)  | 
| Instâncias de banco de dados que não usam a implantação multi-AZ | Recomendamos que você use a implantação multi-AZ. As implantações multi-AZ aumentam a disponibilidade e a durabilidade da instância de banco de dados. | Configurar multi-AZ para instâncias de banco de dados afetadas | Não Não ocorre uma inatividade durante esta alteração. No entanto, há um possível impacto na performance. Para obter mais informações, consulte . [Converter uma instância de banco de dados em uma implantação multi-AZ para o Amazon RDS](Concepts.MultiAZ.Migrating.md)  |  [Preços do multi-AZ do Amazon RDS](https://aws.amazon.com/rds/features/multi-az/#Pricing)  | 
| Os parâmetros de memória do banco de dados estão divergindo do padrão. | Os parâmetros de memória das instâncias de banco de dados são significativamente diferentes dos valores padrão. Essas configurações podem afetar a performance e causar erros. Recomendamos definir os parâmetros de memória personalizados da instância de banco de dados como os valores padrão no grupo de parâmetros de banco de dados.  | Redefina os parâmetros de memória para os valores padrão. | Não |   [ Best practices for configuring performance parameters for Amazon RDS for MySQL](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) no Blog de bancos de dados da AWS  | 
| O parâmetro `InnoDB_Change_Buffering` usando menos do que o valor ideal | O buffer de alterações permite que uma instância de banco de dados do MySQL adie algumas gravações necessárias para manter índices secundários. Esse recurso foi útil em ambientes com discos lentos. A alteração na configuração do buffer melhorou um pouco a performance do banco de dados, mas causou um atraso na recuperação de falhas e longos tempos de desligamento durante a atualização. Definido como `OFF` por padrão na versão 8.4 do MySQL. | Defina o valor do parâmetro `InnoDB_Change_Buffering` como `NONE` nos grupos de parâmetros do banco de dados. | Não | [ Best practices for configuring performance parameters for Amazon RDS for MySQL](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) no Blog de bancos de dados da AWS  | 
| O parâmetro de cache de consulta está ativado. | Quando as alterações exigirem que o cache de consultas seja limpo, a instância de banco de dados parecerá paralisada. A maioria das workloads não se beneficia de um cache de consultas. O cache de consultas foi removido do MySQL versão 8.0 e posterior. Recomendamos definir o parâmetro query\$1cache\$1type como 0. | Defina o valor do parâmetro `query_cache_type` como `0` nos grupos de parâmetros do banco de dados. | Sim |  [ Best practices for configuring performance parameters for Amazon RDS for MySQL](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) no Blog de bancos de dados da AWS  | 
| O parâmetro `log_output` está definido como tabela. | Quando `log_output` está definido como `TABLE`, mais armazenamento é usado do que quando `log_output` está definido como `FILE`. Recomendamos definir o parâmetro como `FILE` para não atingir o limite de tamanho do armazenamento. Definido como `FILE` por padrão no MySQL 8.4 e versões posteriores. | Defina o valor do parâmetro `log_output` como `FILE` nos grupos de parâmetros do banco de dados. | Não |  [Arquivos de log do banco de dados MySQL](USER_LogAccess.Concepts.MySQL.md)  | 
| Grupos de parâmetros que não usam páginas grandes. | Páginas grandes podem aumentar a escalabilidade do banco de dados, mas a instância de banco de dados não está usando páginas grandes. Recomendamos definir o valor do parâmetro `use_large_pages` como `ONLY` no grupo de parâmetros de banco de dados para a instância de banco de dados. | Defina o valor do parâmetro `use_large_pages` como `ONLY` nos grupos de parâmetros do banco de dados. | Sim | [Ativar o HugePages para uma instância do RDS para Oracle](Oracle.Concepts.HugePages.md)  | 
| O parâmetro `autovacuum` está desativado. | O parâmetro autovacuum está desativado para instâncias de banco de dados. Desativar o autovacuum aumenta o inchaço da tabela e do índice e afeta a performance. Recomendamos que você ative o autovacuum nos grupos de parâmetros de banco de dados.  | Ative o parâmetro autovacuum nos grupos de parâmetros do de banco de dados. | Não |  [ Understanding autovacuum in Amazon RDS for PostgreSQL environments](https://aws.amazon.com/blogs/database/understanding-autovacuum-in-amazon-rds-for-postgresql-environments/) no Blog de bancos de dados da AWS  | 
| O parâmetro `synchronous_commit` está desativado. | Quando o `synchronous_commit` parâmetro é desativado, os dados podem ser perdidos em uma falha no banco de dados. A durabilidade do banco de dados está em risco. Recomendamos que você ative o parâmetro `synchronous_commit`.  | Ative o parâmetro `synchronous_commit` nos grupos de parâmetros do banco de dados. | Sim |  [Parâmetros do Amazon Aurora PostgreSQL: replicação, segurança e registro em log](https://aws.amazon.com/blogs/database/amazon-aurora-postgresql-parameters-part-2-replication-security-and-logging/) no blog de banco de dados da AWS  | 
| O parâmetro `track_counts` está desativado. | Quando o parâmetro `track_counts` estiver desativado, o banco de dados não coletará as estatísticas de atividade do banco de dados. O autovacuum exige que essas estatísticas funcionem corretamente. Recomendamos que você defina o parâmetro `track_counts` como `1`. | Defina o parâmetro `track_counts` como `1`. | Não |  [Estatísticas de tempo de execução do PostgreSQL](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-COUNTS)   | 
| O parâmetro `enable_indexonlyscan` está desativado. | O planejador ou o otimizador de consultas não pode usar o plano de analisar somente o índice quando ele está desativado. Recomendamos definir o valor do parâmetro `enable_indexonlyscan` como `1`. | Defina o valor do parâmetro `enable_indexonlyscan` como `1`. | Não |  [Configuração do método Planner para PostgreSQL](https://www.postgresql.org/docs/current/runtime-config-query.html#GUC-ENABLE-INDEXONLYSCAN)  | 
| O parâmetro `enable_indexscan` está desativado. | O planejador ou o otimizador de consultas não pode usar o plano de analisar o índice quando ele está desativado. Recomendamos que você defina o valor `enable_indexscan` como `1`. | Defina o valor do parâmetro `enable_indexscan` como `1`. | Não |  [Configuração do método Planner para PostgreSQL](https://www.postgresql.org/docs/current/runtime-config-query.html#GUC-ENABLE-INDEXONLYSCAN)  | 
| O parâmetro `innodb_flush_log_at_trx` está desativado. | O valor do parâmetro `innodb_flush_log_at_trx` da instância de banco de dados não é um valor seguro. Esse parâmetro controla a persistência das operações de confirmação no disco. Recomendamos que você defina o parâmetro `innodb_flush_log_at_trx` como `1`. | Defina o valor do parâmetro `innodb_flush_log_at_trx` como `1`. | Não |  [ Best practices for configuring performance parameters for Amazon RDS for MySQL](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) no Blog de bancos de dados da AWS  | 
| O parâmetro `sync_binlog` está desativado. | A sincronização do log binário com o disco não é aplicada antes que as confirmações das transações sejam reconhecidas na instância de banco de dados. Recomendamos definir o valor do parâmetro `sync_binlog` como `1`. | Defina o valor do parâmetro `sync_binlog` como `1`. | Não | [Best practices for configuring replication parameters for Amazon RDS for MySQL](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) no Blog de bancos de dados da AWS | 
| O parâmetro `innodb_stats_persistent` está desativado. | Sua instância de banco de dados não está configurada para manter as estatísticas do InnoDB no disco. Quando as estatísticas não são armazenadas, elas são recalculadas sempre que a instância é reiniciada e a tabela é acessada. Isso causa variações no plano de execução da consulta. Você pode modificar o valor desse parâmetro global no nível da tabela. Recomendamos definir o valor do parâmetro `innodb_stats_persistent` como `ON`. | Defina o valor do parâmetro `innodb_stats_persistent` como `ON`. | Não | [ Best practices for configuring performance parameters for Amazon RDS for MySQL](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) no Blog de bancos de dados da AWS  | 
| O parâmetro `innodb_open_files` é baixo. | O parâmetro `innodb_open_files` controla o número de arquivos que o InnoDB pode abrir ao mesmo tempo. O InnoDB abre todos os arquivos de log e tablespace do sistema quando o mysqld está em execução. Sua instância de banco de dados tem um valor baixo para o número máximo de arquivos que o InnoDB pode abrir ao mesmo tempo. Recomendamos que você defina o parâmetro `innodb_open_files` com um valor mínimo de `65`. | Defina o parâmetro `innodb_open_files` como um valor mínimo de `65`. | Sim | [Arquivos abertos do InnoDB para MySQL](https://dev.mysql.com/doc/refman/5.7/en/innodb-parameters.html#sysvar_innodb_open_files)  | 
| O parâmetro `max_user_connections` é baixo. | Sua instância de banco de dados tem um valor baixo para o número máximo de conexões simultâneas para cada conta de banco de dados. Recomendamos definir o parâmetro `max_user_connections` como um número maior que `5`. | Aumente o valor do parâmetro `max_user_connections` para um número maior que `5`. | Sim | [Definir limites de recursos da conta para MySQL](https://dev.mysql.com/doc/refman/8.0/en/user-resources.html) | 
| As réplicas de leitura são abertas no modo gravável. | A instância de banco de dados tem uma réplica de leitura no modo de gravação, que permite que os clientes realizem atualizações. Recomendamos que você defina o parâmetro `read_only` como `TrueIfReplica` para que as réplicas de leitura não estejam no modo gravável. | Defina o valor do parâmetro `read_only` como `TrueIfReplica`. | Não | [Best practices for configuring replication parameters for Amazon RDS for MySQL](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-2-parameters-related-to-replication/) no Blog de bancos de dados da AWS  | 
| A configuração do parâmetro `innodb_default_row_format` não é segura. | A instância de banco de dados encontra um problema conhecido: uma tabela criada em uma versão do MySQL inferior à 8.0.26 com o valor `row_format` definido como `COMPACT` ou `REDUNDANT` ficará inacessível e irrecuperável se o índice exceder 767 bytes. Recomendamos definir o valor do parâmetro `innodb_default_row_format` como `DYNAMIC`. | Defina o valor do parâmetro `innodb_default_row_format` como `DYNAMIC`. | Não | [ Alterações feitas no MySQL 8.0.26](https://dev.mysql.com/doc/relnotes/mysql/8.0/en/news-8-0-26.html#mysqld-8-0-26-bug) | 
| O parâmetro `general_logging` está ativado. | O registro em log geral é ativado para a instância de banco de dados. Essa configuração é útil para solucionar problemas no banco de dados. No entanto, ativar o registro em log geral aumenta a quantidade de operações de E/S e o espaço de armazenamento alocado, o que pode causar contenção e degradação da performance. Confira os requisitos para uso do registro em log geral. Recomendamos definir o valor do parâmetro `general_logging` como `0`. | Confira os requisitos para uso do registro em log geral. Se não for obrigatório, recomendamos definir o valor do parâmetro `general_logging` como `0`. | Não |  [Visão geral dos logs de banco de dados do RDS para MySQL](USER_LogAccess.MySQL.LogFileSize.md)  | 
| Instância do RDS subprovisionada para a capacidade de memória do sistema | Recomendamos ajustar as consultas para usar menos memória ou usar um tipo de instância de banco de dados com maior memória alocada. Quando a instância está com pouca memória, a performance do banco de dados é afetada.  | Usar uma instância de banco de dados com maior capacidade de memória | Sim |  [ Escalar a instância do Amazon RDS vertical e horizontalmente](https://aws.amazon.com/blogs/database/scaling-your-amazon-rds-instance-vertically-and-horizontally/) no blog de bancos de dados da AWS [Tipos de instância do Amazon RDS](https://aws.amazon.com/rds/instance-types/) [Preços do Amazon RDS](https://aws.amazon.com/rds/pricing/)  | 
| Instância do RDS subprovisionada para a capacidade de CPU do sistema | Recomendamos ajustar as consultas para utilizar menos CPU ou modificar a instância de banco de dados para utilizar uma classe de instância de banco de dados com mais vCPUs alocadas. A performance do banco de dados pode diminuir quando uma instância de banco de dados está com pouca CPU. | Usar uma instância de banco de dados com maior capacidade de CPU | Sim |  [ Escalar a instância do Amazon RDS vertical e horizontalmente](https://aws.amazon.com/blogs/database/scaling-your-amazon-rds-instance-vertically-and-horizontally/) no blog de bancos de dados da AWS [Tipos de instância do Amazon RDS](https://aws.amazon.com/rds/instance-types/) [Preços do Amazon RDS](https://aws.amazon.com/rds/pricing/)  | 
| Os recursos do RDS não estão utilizando o grupo de conexões corretamente | Recomendamos habilitar o Amazon RDS Proxy para agrupar e compartilhar com eficiência as conexões de banco de dados existentes. Se você já estiver usando um proxy para o banco de dados, configure-o corretamente para melhorar o grupo de conexões e o balanceamento de carga em várias instâncias de banco de dados. O RDS Proxy pode ajudar a reduzir o risco de esgotamento da conexão e o tempo de inatividade, enquanto melhora a disponibilidade e a escalabilidade. | Habilitar o RDS Proxy ou modificar a configuração de proxy existente | Não |  [ Escalar a instância do Amazon RDS vertical e horizontalmente](https://aws.amazon.com/blogs/database/scaling-your-amazon-rds-instance-vertically-and-horizontally/) no blog de bancos de dados da AWS [Amazon RDS Proxy](rds-proxy.md) [Preços do Amazon RDS Proxy](https://aws.amazon.com/rds/proxy/pricing/)  | 
| As instâncias do RDS estão criando objetos temporários excessivos | Recomendamos que você ajuste a workload para evitar a criação excessiva de objetos temporários ou alterne para classes de instância do RDS que comportem leituras otimizadas. As Leituras otimizadas pelo RDS melhoram a performance do banco de dados para workloads que envolvem grande número de objetos temporários e/ou grandes objetos temporários. Avalie a workload para determinar se o uso de uma instância com Leituras otimizadas pelo RDS beneficia a workload de banco de dados. | Usar um tipo de instância de banco de dados com Leituras otimizadas pelo RDS | Sim |  [Tipos de instância do Amazon RDS](https://aws.amazon.com/rds/instance-types/) [Melhorar a performance das consultas para o RDS para MySQL com Leituras otimizadas pelo Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-optimized-reads.html) [Melhorar a performance das consultas para o RDS para MariaDB com Leituras otimizadas pelo Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-optimized-reads-mariadb.html) [Melhorar a performance das consultas para o RDS para PostgreSQL com Leituras otimizadas pelo Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PostgreSQL.optimizedreads.html)  | 
| As instâncias do RDS são subprovisionadas para a capacidade de IOPS | Recomendamos ajustar a workload do banco de dados para reduzir as IOPS ou aumentar a escala verticalmente da instância de banco de dados para um tipo com um limite de IOPS padrão mais alto. A instância de banco de dados atual não é compatível com IOPS provisionadas ou a workload do banco de dados tem alta utilização de IOPS. | Usar um tipo de instância de banco de dados com limites de IOPS padrão mais altos | Sim |  [Tipos de instância do Amazon RDS](https://aws.amazon.com/rds/instance-types/) [Armazenamento de instâncias de banco de dados do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html) [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)  | 
| Instâncias do RDS têm volumes subprovisionados do Amazon EBS | Recomendamos ajustar a workload do banco de dados para reduzir as IOPS ou aumentar as IOPS provisionadas do banco de dados. Quando a utilização das IOPS se aproxima das IOPS provisionadas, o desempenho do banco de dados pode diminuir. | Provisionar mais IOPS para a instância de banco de dados | Sim |  [Tipos de instância do Amazon RDS](https://aws.amazon.com/rds/instance-types/) [Armazenamento de instâncias de banco de dados do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html) [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)  | 
| As instâncias do RDS são subprovisionadas para a capacidade de throughput | Recomendamos ajustar a workload do banco de dados para reduzir o throughput ou aumentar o throughput provisionado para o banco de dados. Quando a utilização do throughput se aproxima do throughput provisionado, o desempenho do banco de dados pode ser afetado. | Provisionar mais throughput para a instância de banco de dados | Sim |  [Tipos de instância do Amazon RDS](https://aws.amazon.com/rds/instance-types/) [Armazenamento de instâncias de banco de dados do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html) [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)  | 
| As instâncias do RDS são subprovisionadas para E/S do EBS | Recomendamos ajustar a workload de banco de dados para reduzir as operações de E/S ou modificar a instância de banco de dados para usar os volumes io2 Block Express do Amazon RDS, projetados para workloads de banco de dados que exigem alta performance, alto throughput e baixa latência. Com a workload atual, o banco de dados pode não conseguir processar as operações de E/S na taxa necessária, o que pode levar à degradação da performance. | Usar os volumes io2 Block Express do Amazon RDS para a instância do RDS | Não |  [Armazenamento de instância de banco de dados do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html) [Métricas do Amazon CloudWatch para o Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-metrics.html) [Provisioned IOPS SSD volumes](https://docs.aws.amazon.com/ebs/latest/userguide/provisioned-iops.html) no Guia do usuário do Amazon EBS  | 

# Visualizar métricas no console do Amazon RDS
<a name="USER_Monitoring"></a>

O Amazon RDS se integra ao Amazon CloudWatch para exibir várias métricas de instância de banco de dados do RDS no console do RDS. As descrições dessas métricas estão disponíveis em [Referência de métricas do Amazon RDS](metrics-reference.md).

Para a instância de banco de dados, as seguintes categorias de métricas são monitoradas:
+ **CloudWatch**: mostra as métricas do Amazon CloudWatch relacionadas ao  RDS disponíveis no console do RDS. Também é possível visualizá-las no console do CloudWatch. Cada métrica inclui um gráfico que mostra a métrica monitorada durante um período específico. Veja uma lista completa de métricas do CloudWatch em [Métricas do Amazon CloudWatch para o Amazon RDS](rds-metrics.md).
+ **Monitoramento avançado**: mostra um resumo das métricas do sistema operacional quando o monitoramento avançado de sua instância de banco de dados do RDS está ativado. O RDS fornece as métricas do monitoramento avançado à sua conta do Amazon CloudWatch Logs. Cada métrica de sistema operacional inclui um gráfico que mostra a métrica monitorada durante um período específico. Para obter uma visão geral, consulte [Monitorar métricas do SO com o monitoramento avançado](USER_Monitoring.OS.md). Veja uma lista das métricas do monitoramento avançado em [Métricas do sistema operacional no monitoramento avançado](USER_Monitoring-Available-OS-Metrics.md).
+ **OS Process list** (Lista de processos de SO): mostra os detalhes de cada processo em execução na instância de banco de dados selecionada.
+ **Performance Insights**: abre o painel do Amazon RDS Performance Insights relacionado a uma instância de banco de dados. Para ter uma visão geral do Performance Insights, consulte [Monitorar a carga de banco de dados com o Performance Insights no Amazon RDS](USER_PerfInsights.md). Veja uma lista das métricas do Performance Insights em [Métricas do Amazon CloudWatch para Insights de Performance do Amazon RDS](USER_PerfInsights.Cloudwatch.md).

O Amazon RDS agora fornece uma visão consolidada das métricas do Insights de Performance e do CloudWatch no painel do Insights de Performance. O Insights de Performance deve estar ativado para que a instância de banco de dados use essa visualização. Você pode escolher a nova visualização de monitoramento na guia **Monitoramento** ou **Insights de Performance** no painel de navegação. Para ver as instruções para escolher essa visualização, consulte [Visualizar métricas combinadas com o painel do Insights de Performance](Viewing_Unifiedmetrics.md).

# Visualizar métricas combinadas com o painel do Insights de Performance
<a name="Viewing_Unifiedmetrics"></a>

**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 todas as instâncias 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 RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Se você não tomar nenhuma medida, as instâncias 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 RDS 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 Amazon RDS fornece uma visão consolidada das métricas do Insights de Performance e do CloudWatch para sua instância de banco de dados no painel do Insights de Performance. É possível usar o painel pré-configurado ou criar um painel personalizado. O painel pré-configurado fornece as métricas mais usadas para ajudar a diagnosticar problemas de performance em um mecanismo de banco de dados. Como alternativa, é possível criar um painel do personalizado com as métricas de um mecanismo de banco de dados que atenda aos seus requisitos de análise. Depois, use esse painel para todas as instâncias de banco de dados desse tipo de mecanismo de banco de dados em sua conta da AWS. 

Você pode escolher a visualização de monitoramento na guia **Monitoramento** ou **Insights de Performance** no painel de navegação.

O Insights de Performance deve estar ativado para que a instância de banco de dados visualize as métricas combinadas no painel do Insights de Performance. Para obter mais informações sobre como ativar o Insights de Performance, consulte [Ativar e desativar o Insights de Performance do Amazon RDS](USER_PerfInsights.Enabling.md). 

Nas seções a seguir, é possível aprender a exibir as métricas do Insights de Performance e do CloudWatch.

**Topics**
+ [Escolher a nova visualização de monitoramento na guia Monitoramento](Viewing_Unifiedmetrics.MonitoringTab.md)
+ [Escolher a nova visualização de monitoramento na página do Insights de Performance](Viewing_Unifiedmetrics.PInavigationPane.md)
+ [Criar um painel personalizado com o Insights de Performance](Viewing_Unifiedmetrics.PIcustomizeMetricslist.md)
+ [Escolher o painel predefinido com o Insights de Performance](Viewing_Unifiedmetrics.PI-preconfigured-dashboard.md)

# Escolher a nova visualização de monitoramento na guia Monitoramento
<a name="Viewing_Unifiedmetrics.MonitoringTab"></a>

**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 todas as instâncias 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 RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Se você não tomar nenhuma medida, as instâncias 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 RDS 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/). 

No console do Amazon RDS, é possível escolher a nova visualização de monitoramento para visualizar as métricas do Insights de Performance e do CloudWatch para sua instância de banco de dados.

**Como escolher a nova visualização de monitoramento na guia Monitoramento**

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 à esquerda, selecione **Bancos de dados**.

1. Escolha a instância de banco de dados que você deseja monitorar.

1. Role para baixo e escolha a guia **Monitoramento**.

   Um banner aparece com a opção de escolher a nova visualização de monitoramento. O exemplo a seguir mostra o banner para escolher a nova visualização de monitoramento.  
![\[Banner com navegação para a nova visualização de monitoramento.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/NewMonitoringViewOption.png)

1. Escolha **Ir para a nova visualização de monitoramento** para abrir o painel do Insights de Performance com métricas do Insights de Performance e do CloudWatch para a instância de banco de dados.

1. (Opcional) Se o Insights de Performance estiver desativado para a instância de banco de dados, um banner aparecerá com a opção de modificar o cluster de banco de dados e ativar o Insights de Performance.

   O exemplo a seguir mostra o banner para modificar o cluster de banco de dados na guia **Monitoramento**.  
![\[Modifique a instância de banco de dados para ativar o Insights de Performance.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Monitoring_modifyInstnc_banner.png)

   Escolha **Modificar** para modificar a instância de banco de dados e 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 do Amazon RDS](USER_PerfInsights.Enabling.md)

# Escolher a nova visualização de monitoramento na página do Insights de Performance
<a name="Viewing_Unifiedmetrics.PInavigationPane"></a>

**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 todas as instâncias 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 RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Se você não tomar nenhuma medida, as instâncias 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 RDS 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/). 

No console do Amazon RDS, é possível escolher a nova visualização de monitoramento para visualizar as métricas do Insights de Performance e do CloudWatch para sua instância de banco de dados.

**Como escolher a nova visualização de monitoramento com o Insights de Performance no painel de navegação**

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. Escolha uma instância de banco de dados para visualizar o painel do Insights de Performance que mostra as métricas do Insights de Performance e do CloudWatch para a instância de banco de dados.  
![\[Painel de métricas consolidado do Insights de Performance e do CloudWatch.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Monitoring_UnifiedDashboard.png)

# Criar um painel personalizado com o Insights de Performance
<a name="Viewing_Unifiedmetrics.PIcustomizeMetricslist"></a>

**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 todas as instâncias 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 RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Se você não tomar nenhuma medida, as instâncias 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 RDS 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/). 

Na nova visualização de monitoramento, é possível criar um painel personalizado com as métricas necessárias para atender aos seus requisitos de análise.

É possível criar um painel personalizado selecionando métricas do Insights de Performance e do CloudWatch para sua instância de banco de dados. É possível usar esse painel personalizado para outras instâncias de banco de dados do mesmo tipo de mecanismo de banco de dados em sua conta da AWS.

**nota**  
O painel personalizado permite até 50 métricas.

Use o menu de configurações do widget para editar ou excluir o painel e mover ou redimensionar a janela do widget.

**Como criar um painel personalizado com o Insights de Performance no painel de navegação**

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. Escolha uma instância de banco de dados.

1. Role para baixo até a guia **Métricas** na janela.

1. Selecione o painel personalizado na lista suspensa. O exemplo a seguir mostra a criação do painel personalizado.  
![\[Painel de métricas personalizado sem widgets ainda.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Monitoring_custmDashbrd_addWidget.png)

1. Escolha **Adicionar widget** para abrir a janela **Adicionar widget**. É possível abrir e visualizar as métricas do sistema operacional (SO) disponíveis, as métricas do banco de dados e as métricas do CloudWatch na janela.

   O exemplo a seguir mostra a janela **Adicionar widget** com as métricas.  
![\[As opções de métricas na janela Adicionar widget.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Monitoring_AddWidget.png)

1. Selecione as métricas que você deseja visualizar no painel e escolha **Adicionar widget**. É possível usar o campo de pesquisa para encontrar uma métrica específica. 

   As métricas selecionadas aparecem no painel.

1. (Opcional) Se você quiser modificar ou excluir o painel, escolha o ícone de configurações no canto superior direito do widget e selecione uma das ações a seguir no menu.
   + **Editar** modifique a lista de métricas na janela. Escolha **Atualizar widget** depois de selecionar as métricas para o painel.
   + **Excluir**: exclui o widget. Selecione **Excluir** na janela de confirmação. 

# Escolher o painel predefinido com o Insights de Performance
<a name="Viewing_Unifiedmetrics.PI-preconfigured-dashboard"></a>

**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 todas as instâncias 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 RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Se você não tomar nenhuma medida, as instâncias 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 RDS 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/). 

É possível visualizar as métricas mais usadas com o painel pré-configurado. Esse painel ajuda a diagnosticar problemas de performance com um mecanismo de banco de dados e a reduzir o tempo médio de recuperação de horas para minutos.

**nota**  
Esse painel não pode ser editado.

**Como escolher o painel predefinido com o Insights de Performance no painel de navegação**

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. Escolha uma instância de banco de dados.

1. Role para baixo até a guia **Métricas** na janela

1. Selecione um painel pré-configurado na lista suspensa.

   É possível visualizar as métricas da instância de banco de dados no painel. O exemplo a seguir mostra um painel de métricas pré-configurado.  
![\[Painel de métricas pré-configurado.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Monitoring_preconfigDashboard.png)

# Monitorar métricas do Amazon RDS com o Amazon CloudWatch
<a name="monitoring-cloudwatch"></a>

O Amazon CloudWatch é um repositório de métricas. O repositório coleta e processa dados brutos do Amazon RDS como métricas legíveis, quase em tempo real. Para obter uma lista completa de métricas do Amazon RDS enviadas ao CloudWatch, consulte [Referência de métricas para o Amazon RDS](https://docs.aws.amazon.com/en_us/AmazonRDS/latest/UserGuide/metrics-reference.html).

Para analisar e solucionar problemas de performance de banco de dados em grande escala, use [CloudWatch Database Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DatabaseInsights.html).

**Topics**
+ [Visão geral do Amazon RDS e do Amazon CloudWatch](#cw-metrics-overview)
+ [Visualizar métricas de de instância de banco de dados no console do CloudWatch e na AWS CLI.](metrics_dimensions.md)
+ [Exportar as métricas do Performance Insights para o CloudWatch](PI_metrics_export_CW.md)
+ [Criação de alarmes CloudWatch para monitorar Amazon RDS](creating_alarms.md)
+ [Tutorial: criar um alarme do Amazon CloudWatch para atraso de réplica do cluster de banco de dados multi-AZ para o Amazon RDS](multi-az-db-cluster-cloudwatch-alarm.md)

## Visão geral do Amazon RDS e do Amazon CloudWatch
<a name="cw-metrics-overview"></a>

Por padrão, o Amazon RDS envia dados de métrica automaticamente para o CloudWatch em períodos de um minuto. Por exemplo, a métrica `CPUUtilization` registra a porcentagem de utilização da CPU para uma instância de banco de dados ao longo do tempo. Pontos de dados com um período de 60 segundos (1 minuto) ficam disponíveis por 15 dias. Isso significa que você pode acessar informações históricas e ter uma perspectiva melhor sobre a performance da aplicação ou do serviço web.

Agora você pode exportar painéis de métricas do Performance Insights do Amazon RDS para o Amazon CloudWatch. Você pode exportar os painéis de métricas pré-configurados ou personalizados como um novo painel ou adicioná-los a um painel existente do CloudWatch. O painel exportado está disponível para visualização no console do CloudWatch. Para obter mais informações sobre como exportar os painéis de métricas do Performance Insights para o CloudWatch, consulte. [Exportar as métricas do Performance Insights para o CloudWatch](PI_metrics_export_CW.md)

Conforme mostrado no diagrama a seguir, você pode configurar alarmes para suas métricas do CloudWatch. Por exemplo, é possível criar um alarme que sinalize quando a utilização da CPU para uma instância é superior a 70%. Você pode configurar o Amazon Simple Notification Service para enviar um e-mail quando o limite for ultrapassado.

![\[Métricas de RDS no AWS CloudWatch\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/rds-cloudwatch.png)


O Amazon RDS publica os seguintes tipos de métrica no Amazon CloudWatch:
+ Métricas para suas instâncias de banco de dados do RDS

  Para obter uma tabela dessas métricas, consulte [Métricas do Amazon CloudWatch para o Amazon RDS](rds-metrics.md).
+ Métricas do Performance Insights

  Para obter uma tabela dessas métricas, consulte [Métricas do Amazon CloudWatch para Insights de Performance do Amazon RDS](USER_PerfInsights.Cloudwatch.md) e [Métricas de contadores do Performance Insights](USER_PerfInsights_Counters.md).
+ Métricas de monitoramento aprimoradas (publicadas no Amazon CloudWatch Logs)

  Para obter uma tabela dessas métricas, consulte [Métricas do sistema operacional no monitoramento avançado](USER_Monitoring-Available-OS-Metrics.md).
+ Métricas de uso para as cotas de serviço do Amazon RDS em sua Conta da AWS

  Para obter uma tabela dessas métricas, consulte [Métricas de uso do Amazon CloudWatch para Amazon RDS](rds-metrics.md#rds-metrics-usage). Para obter mais informações sobre cotas do Amazon RDS, consulte [Cotas e restrições do Amazon RDS](CHAP_Limits.md).

Para obter mais informações sobre o CloudWatch, consulte [O que é o Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) no *Guia do usuário do Amazon CloudWatch*. Para obter mais informações sobre a retenção de métricas do CloudWatch, consulte [Retenção de métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/cloudwatch_concepts.html#metrics-retention).

# Visualizar métricas de de instância de banco de dados no console do CloudWatch e na AWS CLI.
<a name="metrics_dimensions"></a>

Veja a seguir detalhes sobre como visualizar métricas de sua instância de banco de dados usando o CloudWatch. Para obter informações sobre o monitoramento de métricas para o sistema operacional da sua instância de banco de dados em tempo real usando o CloudWatch Logs, consulte [Monitorar métricas do SO com o monitoramento avançado](USER_Monitoring.OS.md).

Quando são usados recursos do Amazon RDS, o Amazon RDS envia métricas e dimensões ao Amazon CloudWatch a cada minuto.

Agora você pode exportar painéis de métricas do Performance Insights do Amazon RDS para o Amazon CloudWatch e visualizar essas métricas no console do CloudWatch. Para obter mais informações sobre como exportar os painéis de métricas do Performance Insights para o CloudWatch, consulte. [Exportar as métricas do Performance Insights para o CloudWatch](PI_metrics_export_CW.md)

É possível usar os procedimentos a seguir para visualizar as métricas do Amazon RDS no console do CloudWatch e na CLI.

## Console
<a name="metrics_dimensions.console"></a>

**Para visualizar as métricas usando o console do Amazon CloudWatch**

As métricas são agrupadas primeiro pelo namespace do serviço e, em seguida, por várias combinações de dimensão dentro de cada namespace.

1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

   A página inicial de visão geral do CloudWatch é exibida.  
![\[Página Visão geral do CloudWatch\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/monitoring-overviewpage-console2.png)

1. Se necessário, altere a Região da AWS. Na barra de navegação, escolha a Região da AWS na qual seus recursos da AWS estão localizados. Para obter mais informações, consulte [Regiões e endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html).

1. No painel de navegação, escolha **Metrics** (Métricas) e, em seguida, **All metrics** (Todas as métricas).  
![\[Escolher o namespace de métrica\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/cw-all-metrics.png)

1. Role para baixo e escolha o namespace de métrica **RDS**.

   A página exibe as dimensões do Amazon RDS. Para obter descrições dessas dimensões, consulte [Dimensões do Amazon CloudWatch para o Amazon RDS](dimensions.md).  
![\[Escolher o namespace de métrica\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/rds-monitoring-01.png)

1. Escolha uma dimensão de métrica; por exemplo, **By Database Class (Por classe de banco de dados)**.  
![\[Filtrar métricas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/metrics-by-instance-class.png)

1. Realize uma destas ações:
   + Para classificar a métrica, use o cabeçalho da coluna.
   + Para criar um gráfico de uma métrica, marque a caixa de seleção ao lado da métrica.
   + Para filtrar por recurso, escolha o ID do recurso e **Add to search (Adicionar à pesquisa)**.
   + Para filtrar por métrica, escolha o nome da métrica e **Add to search (Adicionar à pesquisa)**.

   O exemplo a seguir filtra com base na classe **db.t3.medium** e faz um gráfico da métrica **CPUUtilization**.  
![\[Filtrar métricas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/rds-monitoring-03.png)

## AWS CLI
<a name="metrics_dimensions.CLI"></a>

Para obter informações sobre métricas usando a AWS CLI, use o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) do CloudWatch. No exemplo a seguir, você lista todas as métricas no namespace `AWS/RDS`.

```
aws cloudwatch list-metrics --namespace AWS/RDS
```

Para receber os dados de métricas, use o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html).

O exemplo a seguir obtém estatísticas `CPUUtilization` para a instância `my-instance` durante o período específico de 24 horas, com granularidade de 5 minutos.

Crie um arquivo JSON `CPU_metric.json` com o conteúdo apresentado a seguir.

```
 1. {
 2.    "StartTime" : "2023-12-25T00:00:00Z",
 3.    "EndTime" : "2023-12-26T00:00:00Z",
 4.    "MetricDataQueries" : [{
 5.      "Id" : "cpu",	    
 6.      "MetricStat" : {
 7. 	   "Metric" : {	  
 8.   	     "Namespace" : "AWS/RDS",
 9.   	     "MetricName" : "CPUUtilization",
10.   	     "Dimensions" : [{ "Name" : "DBInstanceIdentifier" , "Value" : my-instance}]
11. 	   },  
12.        "Period" : 360,
13.        "Stat" : "Minimum" 
14.      }
15.    }]
16. }
```

**Example**  
Para Linux, macOS ou Unix:  

```
1. aws cloudwatch get-metric-data \
2.     --cli-input-json file://CPU_metric.json
```
Para Windows:  

```
1. aws cloudwatch get-metric-data ^
2.      --cli-input-json file://CPU_metric.json
```
A saída da amostra é exibida da seguinte maneira:  

```
{
    "MetricDataResults": [
        {
            "Id": "cpu",
            "Label": "CPUUtilization",
            "Timestamps": [
                "2023-12-15T23:48:00+00:00",
                "2023-12-15T23:42:00+00:00",
                "2023-12-15T23:30:00+00:00",
                "2023-12-15T23:24:00+00:00",
                ...
            ],
            "Values": [
                13.299778337027714,
                13.677507543049558,
                14.24976250395827,
                13.02521708695145,
                ...
            ],
            "StatusCode": "Complete"
        }
    ],
    "Messages": []
}
```
Para obter mais informações, consulte [Obter as estatísticas de uma métrica](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/getting-metric-data.html) no *Guia do usuário do Amazon CloudWatch*.

# Exportar as métricas do Performance Insights para o CloudWatch
<a name="PI_metrics_export_CW"></a>

O Performance Insights permite que você exporte o painel de métricas pré-configurado ou personalizado da sua instância de banco de dados para o Amazon CloudWatch. Você pode exportar o painel de métricas como um novo painel ou adicioná-lo a um painel existente do CloudWatch. Ao optar por adicionar o painel a um painel existente do CloudWatch, você pode criar um rótulo de cabeçalho para que as métricas apareçam em uma seção separada no painel do CloudWatch.

Você pode visualizar as métricas exportadas no console do CloudWatch. Se você adicionar novas métricas a um painel de métricas do Performance Insights depois de exportá-lo, deverá exportá-lo novamente para visualizar as novas métricas no console do CloudWatch.

Você também pode selecionar um widget de métrica no painel do Performance Insights e visualizar os dados de métricas no console do CloudWatch.

Para obter mais informações sobre como exibir métricas de replicação no console do CloudWatch, consulte [Visualizar métricas de de instância de banco de dados no console do CloudWatch e na AWS CLI.](metrics_dimensions.md).

Nas seções a seguir, exporte as métricas do Insights de Performance para o CloudWatch como um painel novo ou existente e visualize as métricas do Insights de Performance no CloudWatch.

**Topics**
+ [Exportar métricas do Performance Insights como um novo painel para o CloudWatch](PI_metrics_export_CW.new_dashboard.md)
+ [Adicionar as métricas do Performance Insights a um painel existente do CloudWatch](PI_metrics_export_CW.existing_dashboard.md)
+ [Visualizar um widget de métrica do Performance Insights no CloudWatch](PI_metrics_export_CW.individual_widget.md)

# Exportar métricas do Performance Insights como um novo painel para o CloudWatch
<a name="PI_metrics_export_CW.new_dashboard"></a>

Escolha um painel de métricas pré-configurado ou personalizado no painel do Performance Insights e exporte-o como um novo painel no CloudWatch. Você pode visualizar o painel exportado no console do CloudWatch.

**Para exportar métricas do Performance Insights como um novo painel no CloudWatch**

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 escolha **Métricas**.

   Por padrão, é exibido o painel pré-configurado com as métricas do Performance Insights.

1. Escolha um painel pré-configurado ou personalizado e, em seguida, escolha **Exportar para o CloudWatch**.

   A janela **Exportar para o CloudWatch** é exibida.  
![\[Painel do Performance Insights com o botão de exportação para o CloudWatch\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/PI-ExprtToCW.png)

1. Escolha **Exportar como novo painel**.  
![\[Exportar para a janela do CloudWatch com a opção de exportação como novo painel selecionada\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/PI-ExprtToCW-NewDashboard.png)

1. Insira um nome para o novo painel no campo **Nome do painel** e escolha **Confirmar**.

   Um banner exibe uma mensagem após a exportação do painel ser bem-sucedida.  
![\[Banner com mensagem de sucesso\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/PI-ExprtToCW-SuccessBanner.png)

1. Escolha o link ou **Exibir no CloudWatch** no banner para visualizar o painel de métricas no console do CloudWatch.

# Adicionar as métricas do Performance Insights a um painel existente do CloudWatch
<a name="PI_metrics_export_CW.existing_dashboard"></a>

Adicione um painel de métricas pré-configurado ou personalizado a um painel existente do CloudWatch. Você pode adicionar um rótulo ao painel de métricas para aparecer em uma seção separada no painel do CloudWatch.

**Para exportar as métricas para um painel existente do CloudWatch**

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 escolha **Métricas**.

   Por padrão, é exibido o painel pré-configurado com as métricas do Performance Insights.

1. Escolha o painel pré-configurado ou personalizado e, em seguida, escolha **Exportar para o CloudWatch**.

   A janela **Exportar para o CloudWatch** é exibida. 

1. Escolha **Adicionar ao painel existente**.  
![\[Exportar para a janela do CloudWatch com a opção de adição a um painel existente selecionada\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/Pi-ExprtToCW-AddToExistingBoard.png)

1. Especifique o destino e o rótulo do painel e escolha **Confirmar**.
   + **Destino do painel do CloudWatch**: escolha um painel existente do CloudWatch.
   + **Rótulo da seção do painel do CloudWatch - opcional**: insira um nome para as métricas do Performance Insights que aparecerão nesta seção no painel do CloudWatch.

   Um banner exibe uma mensagem após a exportação do painel ser bem-sucedida.

1. Escolha o link ou **Exibir no CloudWatch** no banner para visualizar o painel de métricas no console do CloudWatch.

# Visualizar um widget de métrica do Performance Insights no CloudWatch
<a name="PI_metrics_export_CW.individual_widget"></a>

Selecione um widget de métrica no painel do Performance Insights do Amazon RDS e visualize os dados de métricas no console do CloudWatch. 

**Para exportar um widget de métrica e visualizar os dados das métricas no console do CloudWatch**

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 até **Métricas**.

   Por padrão, é exibido o painel pré-configurado com as métricas do Performance Insights.

1. Escolha um widget de métrica e, em seguida, escolha **Exibir no CloudWatch** no menu.  
![\[Widget selecionado com menu para visualizar no CloudWatch\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/PI-ExprtToCW-SelectedMetric.png)

   Os dados da métrica são exibidos no console do CloudWatch.

# Criação de alarmes CloudWatch para monitorar Amazon RDS
<a name="creating_alarms"></a>

Você pode criar um alarme do CloudWatch que envia uma mensagem do Amazon SNS quando o alarme muda de estado. Um alarme observa uma única métrica por um período tempo que você especifica. O alarme também pode realizar uma ou mais ações com base no valor da métrica relativa a um limite especificado durante vários períodos. A ação é uma notificação enviada para um tópico do Amazon SNS ou por uma política do Amazon EC2 Auto Scaling.

Os alertas invocam ações apenas para alterações de estado mantidas. Os alarmes do CloudWatch não invocam ações somente porque estão em um determinado estado. O estado deve ter sido alterado e mantido por um período especificado.

É possível usar a função matemática métrica **DB\$1PERF\$1INSIGHTS** no console do CloudWatch para consultar métricas do contador do Amazon RDS do Insights de Performance. A função **DB\$1PERF\$1INSIGHTS** também inclui a métrica DBLoad em intervalos de menos de um minuto. Também é possível definir alarmes do CloudWatch para essas métricas.

Para obter mais detalhes sobre como criar um alarme, consulte [Crie um alarme para as métricas do contador do Performance Insights a partir de um banco de dados da AWS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarm_database_performance_insights.html).

**Para definir um alarme usando a AWS CLI**
+ Chame [https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html). Para obter mais informações, consulte *Referência de comandos da [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/)*.

**Para definir um alarme usando a API do CloudWatch**
+ Chame [https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html). Para obter mais informações, consulte a *[Referência da API do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*. 

Para obter mais informações sobre a definição de tópicos do Amazon SNS e a criação de alarmes, consulte [Usar alarmes do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html).

# Tutorial: criar um alarme do Amazon CloudWatch para atraso de réplica do cluster de banco de dados multi-AZ para o Amazon RDS
<a name="multi-az-db-cluster-cloudwatch-alarm"></a>

Você pode criar um alarme do Amazon CloudWatch que envia uma mensagem do Amazon SNS quando o atraso de réplica de um cluster de banco de dados multi-AZ excede um limite. Um alarme observa uma métrica `ReplicaLag` ao longo do período que você especificar. A ação é uma notificação enviada para um tópico do Amazon SNS ou por uma política do Amazon EC2 Auto Scaling.

**Para definir um alarme do CloudWatch para o atraso de réplica do cluster de banco de dados multi-AZ**

1. Faça login no Console de gerenciamento da AWS e abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Alarms** (Alarmes), **All alarms** (Todos os alarmes).

1. Selecione **Create alarm (Criar alarme)**.

1. Na página **Specify metric and conditions (Especificar métrica e condições)**, selecione **Select metric (Selecionar métrica)**.

1. Na caixa de pesquisa, insira o nome do seu cluster de banco de dados multi-AZ e pressione Enter.

   A imagem a seguir mostra a página **Select metric** (Selecionar métrica) com um cluster de banco de dados multi-AZ chamado `rds-cluster` inserido.  
![\[Página “Select metric” (Selecionar métrica)\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-select-metric.png)

1. Escolha **RDS**, **Per-Database Metrics** (Métricas por banco de dados).

1. Na caixa de pesquisa, insira **ReplicaLag** e pressione Enter. Depois selecione cada instância de banco de dados no cluster de banco de dados.

   A imagem a seguir mostra a página **Select metric** (Selecionar métrica) com as instâncias de banco de dados selecionadas referentes à métrica **ReplicaLag**.  
![\[Selecione a página de métricas com as instâncias de banco de dados selecionadas para a métrica ReplicaLag.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-metric-replica-lag.png)

   Este alarme considera o atraso de réplica de todas as três instâncias de banco de dados no cluster de banco de dados multi-AZ. O alarme responde quando qualquer instância de banco de dados excede o limite. Ele usa uma expressão matemática que retorna o valor máximo das três métricas. Comece classificando por nome da métrica e, em seguida, escolha todas as três métricas **ReplicaLag**.

1. Em **Add math** (Adicionar matemática), escolha **All functions** (Todas as funções), **MAX**.  
![\[A configuração Add math (Adicionar matemática)\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-select-metric-math.png)

1. Escolha a guia **Graphed metrics** (Métricas em gráficos) e edite os detalhes de **Expression1** para **MAX([m1,m2,m3])**.

1. Para todas as três métricas **ReplicaLag**, altere **Period** (Período) para **1 minute** (1 minuto).

1. Limpe a seleção de todas as métricas, exceto de **Expression1**.

   A página **Select metric** (Selecionar métrica) deve ser semelhante à imagem a seguir.  
![\[A página Select metric (Selecionar métrica) com a métrica selecionada\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-select-metric-expression1.png)

1. Escolha **Selecionar métrica**.

1. Na página **Specify metric and conditions**, altere o rótulo para um nome significativo, como **ClusterReplicaLag**, e insira um número de segundos em **Define the threshold value** (Definir o valor limite). Para este tutorial, insira **1200** segundos (20 minutos). Você pode ajustar esse valor para os requisitos de sua workload.

   A página **Specify metric and conditions** (Especificar métrica e condições) deve ser semelhante à imagem a seguir.  
![\[A página Specify metric and conditions (Especificar métrica e condições)\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-specify-metric-conditions.png)

1. Selecione **Next** (Próximo), e a página **Configure actions** (Configurar ações) é exibida.

1. Mantenha **In alarm** (Em alarme) selecionado, escolha **Create new topic** (Criar tópico) e insira o nome do tópico e um endereço de e-mail válido.  
![\[A página Configure actions (Configurar ações)\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-configure-actions.png)

1. Escolha **Create topic** (Criar tópico) e, em seguida, escolha **Next** (Próximo).

1. No painel **Add name and description** (Adicionar nome e descrição), insira o **Alarm name** (Nome do alarme) e a **Alarm description** (Descrição do alarme) e, em seguida, escolha **Next** (Próximo).  
![\[A página Add name and description (Adicionar nome e descrição)\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-add-name-and-description.png)

1. Visualize o alarme que você está prestes a criar na página **Preview and create** (Visualizar e criar) e escolha **Create alarm** (Criar alarme). 

# Monitoramento de bancos de dados do Amazon RDS com o CloudWatch Database Insights
<a name="USER_DatabaseInsights"></a>

Monitore a carga do banco de dados da sua frota de instâncias de banco de dados do Amazon RDS com o Database Insights. A carga do banco de dados avalia o nível de atividade de sessão no banco de dados. Você pode usar o Database Insights para analisar e solucionar problemas de performance de seus bancos de dados do Amazon RDS em grande escala.

Com o Database Insights, você pode visualizar a carga do banco de dados na sua frota e filtrá-la por esperas, instruções SQL, hosts ou usuários.

Por padrão, o RDS habilita o modo Padrão do Database Insights para os bancos de dados do Amazon RDS. 

Para obter informações sobre o uso do Database Insights no console do Amazon CloudWatch, consulte [CloudWatch Database Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Database-Insights.html) no *Guia do usuário do Amazon CloudWatch*.

## Preços
<a name="USER_Database-Insights-pricing"></a>

Para obter informações sobre preços, consulte [Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/).

**Topics**
+ [Preços](#USER_Database-Insights-pricing)
+ [Mecanismo de banco de dados do Amazon RDS, região e classe de instância compatíveis com o Database Insights](USER_DatabaseInsights.Engines.md)
+ [Ativação do modo Avançado do Database Insights para Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md)
+ [Ativação do modo Standard do Database Insights para Amazon RDS](USER_DatabaseInsights.TurningOnStandard.md)
+ [Configurar o banco de dados para monitorar consultas SQL lentas com o Database Insights para Amazon RDS](USER_DatabaseInsights.SlowSQL.md)
+ [Considerações sobre o Database Insights para Amazon RDS](USER_DatabaseInsights.Considerations.md)

# Mecanismo de banco de dados do Amazon RDS, região e classe de instância compatíveis com o Database Insights
<a name="USER_DatabaseInsights.Engines"></a>

A tabela a seguir fornece mecanismos de banco de dados do Amazon RDS que são compatíveis com o Database Insights.


|  Mecanismo de banco de dados do Amazon RDS  | Versões do mecanismo e regiões compatíveis | Limitações de classes de instâncias | 
| --- | --- | --- | 
|  Amazon RDS para MariaDB  |  Para ter mais informações sobre a disponibilidade de versões e regiões do Database Insights com o RDS para MariaDB, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  O Database Insights não comporta as seguintes classes de instância: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_DatabaseInsights.Engines.html)  | 
|  RDS para MySQL  |  Para ter mais informações sobre a disponibilidade de versões e regiões do Database Insights com o RDS para MySQL, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  O Database Insights não comporta as seguintes classes de instância: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_DatabaseInsights.Engines.html)  | 
|  Amazon RDS para Microsoft SQL Server  |  Para ter mais informações sobre a disponibilidade de versões e regiões do Database Insights com o RDS para SQL Server, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/D  | 
|  Amazon RDS para PostgreSQL  |  Para ter mais informações sobre a disponibilidade de versões e regiões do Database Insights com o RDS para PostgreSQL, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/D  | 
|  Amazon RDS para Oracle  |  Para ter mais informações sobre a disponibilidade de versões e regiões do Database Insights com o RDS para Oracle, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/D  | 

## Mecanismo de banco de dados do Amazon RDS, região e classe de instância compatíveis com os recursos do Database Insights
<a name="database-insights-feature-support"></a>

A tabela a seguir apresenta os mecanismos de banco de dados do Amazon RDS que são compatíveis com recursos do Database Insights.


| Recurso | [Nível de preço](https://aws.amazon.com/rds/performance-insights/pricing/) |  [Regiões compatíveis](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html#Concepts.RegionsAndAvailabilityZones.Regions)  |  [ Mecanismos de banco de dados compatíveis](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html#Welcome.Concepts.DBInstance)  |  [Classes de instância compatíveis](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html#Concepts.DBInstanceClass.Types)  | 
| --- | --- | --- | --- | --- | 
| [Estatísticas SQL para Performance Insights](sql-statistics.md) | Todos | Todos |  Todos  | Todos | 
| [Analisar planos de execução do Oracle usando o painel do Insights de Performance para o Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md) | Todos | Todos |  RDS para Oracle  | Todos | 
| [Analisar a performance do banco de dados por um período](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md) | Somente nível pago |  Todos  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_DatabaseInsights.Engines.html)  |  Todos  | 
|  [Visualizar as recomendações proativas do Performance Insights](USER_PerfInsights.InsightsRecommendationViewDetails.md) | Somente nível pago | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_DatabaseInsights.Engines.html)  |  Todos  | Todos  | 

## Regiões em que é possível usar o Database Insights no Amazon RDS
<a name="database-insights-region-support"></a>

O Amazon RDS oferece suporte ao Database Insights nas Regiões da AWS a seguir.
+ Leste dos EUA (Norte da Virgínia)
+ Leste dos EUA (Ohio)
+ Oeste dos EUA (N. da Califórnia)
+ Oeste dos EUA (Oregon)
+ África (Cidade do Cabo)
+ Ásia-Pacífico (Hong Kong)
+ Ásia-Pacífico (Hyderabad)
+ Ásia-Pacífico (Jacarta)
+ Ásia-Pacífico (Malásia)
+ Ásia-Pacífico (Melbourne)
+ Ásia-Pacífico (Mumbai)
+ Ásia-Pacífico (Osaka)
+ Ásia-Pacífico (Seul)
+ Ásia-Pacífico (Singapura)
+ Ásia-Pacífico (Sydney)
+ Ásia-Pacífico (Tóquio)
+ Canadá (Central)
+ Oeste do Canadá (Calgary)
+ Europa (Frankfurt)
+ Europa (Irlanda)
+ Europa (Londres)
+ Europa (Milão)
+ Europe (Paris)
+ Europa (Espanha)
+ Europa (Estocolmo)
+ Europa (Zurique)
+ Israel (Tel Aviv)
+ Oriente Médio (Bahrein)
+ Oriente Médio (Emirados Árabes Unidos)
+ América do Sul (São Paulo)
+ AWS GovCloud (Leste dos EUA)
+ AWS GovCloud (Oeste dos EUA)

# Ativação do modo Avançado do Database Insights para Amazon RDS
<a name="USER_DatabaseInsights.TurningOnAdvanced"></a>

Para ativar o modo Avançado do Database Insights para Amazon RDS, use os procedimentos a seguir.

## Ativar ou desativar o modo Avançado do Database Insights ao criar uma instância de banco de dados ou cluster de banco de dados multi-AZ
<a name="USER_DatabaseInsights.TurnOnCreateDatabase"></a>

Ative o modo Avançado do Database Insights ao criar um banco de dados para Amazon RDS.

------
#### [ Console ]

No console, você pode ativar o modo Avançado do Database Insights ao criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ.

**Como ativar o modo Avançado do Database Insights ao criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ usando o console**

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. Escolha **Databases (Bancos de dados)**.

1. Selecione **Criar banco de dados**.

1. Na seção **Database Insights**, selecione **Modo avançado**. Em seguida, escolha as seguintes opções:
   + **Retention (Retenção)** – a duração do período de retenção de dados do Performance Insights. O período de retenção deve ser de 15 meses para o modo avançado do Database Insights.
   + **AWS KMS key** – especifique a sua chave do KMS. O Performance Insights criptografa todos os possíveis dados sigilosos usando a sua chave do KMS. Os dados são criptografados em repouso e em trânsito. Para obter mais informações, consulte [Criptografar recursos do Amazon RDS](Overview.Encryption.md).

1. Selecione **Criar banco de dados**.

------
#### [ AWS CLI ]

Para ativar o modo Avançado do Database Insights ao criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, chame o comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) ou [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) da AWS CLI e forneça os seguintes valores:
+ `--database-insights-mode advanced` para ativar o modo Avançado do Database Insights.
+ `--engine`: o mecanismo de banco de dados para a instância de banco de dados.
+ `--db-instance-identifier`, o identificador da instância de banco de dados, ou `--db-cluster-identifier`, o identificar do cluster de banco de dados multi-AZ.
+ `--enable-performance-insights` para ativar o Performance Insights para o Database Insights.
+ `--performance-insights-retention-period`: o período de retenção de dados do cluster de banco de dados multi-AZ ou da instância de banco de dados. Para ativar o Database Insights, o período de retenção deve ser de pelo menos 465 dias.

O exemplo a seguir habilita o modo Avançado do Database Insights ao criar uma instância de banco de dados.

Para Linux, macOS ou Unix:

```
aws rds create-db-instance \
    --database-insights-mode advanced \ 
    --engine postgresql \
    --db-instance-identifier sample-db-identifier \
    --enable-performance-insights \
    --performance-insights-retention-period 465
```

Para Windows:

```
aws rds create-db-instance ^
    --database-insights-mode advanced ^ 
    --engine postgresql ^
    --db-instance-identifier sample-db-identifier ^
    --enable-performance-insights ^
    --performance-insights-retention-period 465
```

------
#### [ RDS API ]

Para ativar o modo Avançado do Database Insights ao criar um cluster de banco de dados multi-AZ ou uma instância de banco de dados, especifique os parâmetros a seguir para a operação de API [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) ou [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) do Amazon RDS.
+ `DatabaseInsightsMode` para `advanced`
+ `EnablePerformanceInsights` para `True`
+ `PerformanceInsightsRetentionPeriod` para pelo menos 465 dias

------

## Ativar ou desativar o modo Avançado do Database Insights ao modificar uma instância de banco de dados ou cluster de banco de dados multi-AZ
<a name="USER_DatabaseInsights.TurnOnModifyDatabase"></a>

Ative o Database Insights ao modificar um banco de dados para o Amazon RDS. A modificação de uma instância de banco de dados para habilitar o modo avançado do Database Insights não causa tempo de inatividade.

**nota**  
Para habilitar o Database Insights, cada instância de banco de dados em um cluster de banco de dados multi-AZ deve ter as mesmas configurações do Insights de Performance e do monitoramento avançado.

------
#### [ Console ]

No console, você pode ativar o modo Avançado do Database Insights ao modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ.

**Como ativar o modo Avançado do Database Insights ao modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ usando o console**

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. Escolha **Databases (Bancos de dados)**.

1. Escolha uma instância de banco de dados ou um cluster de banco de dados multi-AZ e escolha **Modify** (Modificar).

1. Na seção **Database Insights**, selecione **Modo avançado**. Em seguida, escolha as seguintes opções:
   + **Retention (Retenção)** – a duração do período de retenção de dados do Performance Insights. O período de retenção deve ser de 15 meses para o modo avançado do Database Insights.
   + **AWS KMS key** – especifique a sua chave do KMS. O Performance Insights criptografa todos os possíveis dados sigilosos usando a sua chave do KMS. Os dados são criptografados em repouso e em trânsito. Para obter mais informações, consulte [Criptografar recursos do Amazon RDS](Overview.Encryption.md).

1. Escolha **Continue**.

1. Em **Programação das modificações**, selecione **Aplicar imediatamente**. Se você escolher **Aplicar durante a próxima janela de manutenção programada**, seu banco de dados vai ignorar essa configuração e ativar imediatamente o modo Avançado do Database Insights.

1. Escolha **Modificar instância**.

------
#### [ AWS CLI ]

Para ativar o modo avançado do Database Insights ao modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, chame o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) ou [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) da AWS CLI e forneça os seguintes valores:
+ `--database-insights-mode advanced` para ativar o modo Avançado do Database Insights.
+ `--db-instance-identifier`, o identificador da instância de banco de dados, ou `--db-cluster-identifier`, o identificar do cluster de banco de dados multi-AZ.
+ `--enable-performance-insights` para ativar o Performance Insights para o Database Insights.
+ `--performance-insights-retention-period`: o período de retenção de dados da instância de banco de dados. Para ativar o modo Avançado do Database Insights, o período de retenção deve ser de pelo menos 465 dias.

O exemplo a seguir habilita o modo Avançado do Database Insights ao modificar uma instância de banco de dados.

Para Linux, macOS ou Unix:

```
aws rds modify-db-instance \
    --database-insights-mode advanced \
    --db-instance-identifier sample-db-identifier \
    --enable-performance-insights \
    --performance-insights-retention-period 465
```

Para Windows:

```
aws rds modify-db-instance ^
    --database-insights-mode advanced ^
    --db-instance-identifier sample-db-identifier ^
    --enable-performance-insights ^
    --performance-insights-retention-period 465
```

------
#### [ RDS API ]

Para ativar o modo Avançado do Database Insights ao modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, especifique os parâmetros a seguir para a operação de API [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) ou [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) do Amazon RDS.
+ `DatabaseInsightsMode` para `advanced`
+ `EnablePerformanceInsights` para `True`
+ `PerformanceInsightsRetentionPeriod` para pelo menos 465 dias

------

# Ativação do modo Standard do Database Insights para Amazon RDS
<a name="USER_DatabaseInsights.TurningOnStandard"></a>

Para ativar o modo Standard do Database Insights para Amazon RDS, use os procedimentos a seguir.

## Ativar ou desativar o modo Standard do Database Insights ao criar uma instância de banco de dados ou cluster de banco de dados multi-AZ
<a name="USER_DatabaseInsights.TurnOnCreateDatabaseStandard"></a>

Ative o modo Standard do Database Insights ao criar um banco de dados para Amazon RDS.

------
#### [ Console ]

No console, você pode ativar o modo Padrão do Database Insights ao criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ.

**Como ativar o modo Standard do Database Insights ao criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ usando o console**

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. Escolha **Databases (Bancos de dados)**.

1. Selecione **Criar banco de dados**.

1. Na seção **Database Insights**, selecione **Modo Standard**. Em seguida, escolha uma das opções a seguir para ativar ou desativar o Insights de Performance:
   + Para desativar o Insights de Performance, desmarque a opção **Habilitar Insights de Performance**.
   + Para ativar o Insights de Performance, selecione **Habilitar Insights de Performance**. Para configurar o Performance Insights, especifique as seguintes opções:
     + **Retention (Retenção)** – a duração do período de retenção de dados do Performance Insights. O período de retenção deve ser de pelo menos sete dias.
     + **AWS KMS key** – especifique a sua chave do KMS. O Performance Insights criptografa todos os possíveis dados sigilosos usando a sua chave do KMS. Os dados são criptografados em repouso e em trânsito. Para obter mais informações, consulte [Criptografar recursos do Amazon RDS](Overview.Encryption.md).

1. Selecione **Criar banco de dados**.

------
#### [ AWS CLI ]

Para ativar o modo Padrão do Database Insights ao criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, chame o comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) ou [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) da AWS CLI e forneça os seguintes valores:
+ `--database-insights-mode standard` para ativar o modo Standard do Database Insights.
+ `--engine`: o mecanismo de banco de dados para a instância de banco de dados.
+ `--db-instance-identifier`, o identificador da instância de banco de dados, ou `--db-cluster-identifier`, o identificar do cluster de banco de dados multi-AZ.
+ `--enable-performance-insights` ou `--no-enable-performance-insights` para ativar ou desativar o Performance Insights. Se você especificar `--enable-performance-insights`, também deverá especificar o `--performance-insights-retention-period`, que é o período de retenção de dados do da instância de banco de dados. O período de retenção deve ser de pelo menos sete dias.

O exemplo a seguir habilita o modo Padrão do Database Insights e o Insights de Performance ao criar uma instância de banco de dados.

Para Linux, macOS ou Unix:

```
aws rds create-db-instance \
    --database-insights-mode standard \ 
    --engine postgresql \
    --db-instance-identifier sample-db-identifier \
    --enable-performance-insights \
    --performance-insights-retention-period 7
```

Para Windows:

```
aws rds create-db-instance ^
    --database-insights-mode standard ^ 
    --engine postgresql ^
    --db-instance-identifier sample-db-identifier ^
    --enable-performance-insights ^
    --performance-insights-retention-period 7
```

O exemplo a seguir habilita o modo Padrão do Database Insights e desabilita o Insights de Performance ao criar uma instância de banco de dados.

Para Linux, macOS ou Unix:

```
aws rds create-db-instance \
    --database-insights-mode standard \ 
    --engine postgresql \
    --db-instance-identifier sample-db-identifier \
    --no-enable-performance-insights
```

Para Windows:

```
aws rds create-db-instance ^
    --database-insights-mode standard ^ 
    --engine postgresql ^
    --db-instance-identifier sample-db-identifier ^
    --no-enable-performance-insights
```

------
#### [ RDS API ]

Para ativar o modo Standard do Database Insights ao criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, especifique os parâmetros a seguir para a operação de API [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) ou [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) do Amazon RDS.
+ `DatabaseInsightsMode` para `standard`
+ `EnablePerformanceInsights` como `True` ou `False`. Se você definir `EnablePerformanceInsights` como `True`, deverá definir `PerformanceInsightsRetentionPeriod` como pelo menos sete dias.

------

## Ativar ou desativar o modo Standard do Database Insights ao modificar uma instância de banco de dados ou cluster de banco de dados multi-AZ
<a name="USER_DatabaseInsights.TurnOnModifyDatabaseStandard"></a>

Ative o modo Standard do Database Insights ao modificar um banco de dados para o Amazon RDS. A modificação de um uma instância de banco de dados para habilitar o modo padrão do Database Insights não causa tempo de inatividade.

**nota**  
Para habilitar o Database Insights, cada instância de banco de dados em um cluster de banco de dados multi-AZ deve ter as mesmas configurações do Insights de Performance e do monitoramento avançado.

------
#### [ Console ]

No console, você pode ativar o modo Padrão do Database Insights ao modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ.

**Como ativar o modo Standard do Database Insights ao modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ usando o console**

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. Escolha **Databases (Bancos de dados)**.

1. Escolha uma instância de banco de dados ou um cluster de banco de dados multi-AZ e escolha **Modify** (Modificar).

1. Na seção **Database Insights**, selecione **Modo Standard**. Depois, escolha uma das seguintes opções:
   + Para desativar o Insights de Performance, desmarque a opção **Habilitar Insights de Performance**.
   + Para ativar o Insights de Performance, selecione **Habilitar Insights de Performance**. Para configurar o Performance Insights, especifique as seguintes opções:
     + **Retention (Retenção)** – a duração do período de retenção de dados do Performance Insights. O período de retenção deve ser de pelo menos sete dias.
     + **AWS KMS key** – especifique a sua chave do KMS. O Performance Insights criptografa todos os possíveis dados sigilosos usando a sua chave do KMS. Os dados são criptografados em repouso e em trânsito. Para obter mais informações, consulte [Criptografar recursos do Amazon RDS](Overview.Encryption.md).

1. Escolha **Continue**.

1. Em **Programação das modificações**, selecione **Aplicar imediatamente**. Se você escolher **Aplicar durante a próxima janela de manutenção programada**, seu banco de dados vai ignorar essa configuração e ativar imediatamente o modo Padrão do Database Insights.

1. Escolha **Modificar instância**.

------
#### [ AWS CLI ]

Para ativar o modo Padrão do Database Insights ao modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, chame o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) ou [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) da AWS CLI e forneça os seguintes valores:
+ `--database-insights-mode standard` para ativar o modo Standard do Database Insights.
+ `--db-instance-identifier`, o identificador da instância de banco de dados, ou `--db-cluster-identifier`, o identificar do cluster de banco de dados multi-AZ.
+ `--enable-performance-insights` ou `--no-enable-performance-insights` para ativar ou desativar o Performance Insights. Se você especificar `--enable-performance-insights`, também deverá especificar o `--performance-insights-retention-period`, que é o período de retenção de dados do cluster de banco de dados multi-AZ ou da instância de banco de dados. O período de retenção deve ser de pelo menos sete dias.

O exemplo a seguir habilita o modo Padrão do Database Insights e o Insights de Performance ao modificar uma instância de banco de dados.

Para Linux, macOS ou Unix:

```
aws rds modify-db-instance \
    --database-insights-mode standard \
    --db-instance-identifier sample-db-identifier \
    --enable-performance-insights \
    --performance-insights-retention-period 7
```

Para Windows:

```
aws rds modify-db-instance ^
    --database-insights-mode standard ^
    --db-instance-identifier sample-db-identifier ^
    --enable-performance-insights ^
    --performance-insights-retention-period 7
```

O exemplo a seguir habilita o modo Padrão do Database Insights e desabilita o Insights de Performance ao modificar uma instância de banco de dados.

Para Linux, macOS ou Unix:

```
aws rds modify-db-instance \
    --database-insights-mode standard \
    --db-instance-identifier sample-db-identifier \
    --no-enable-performance-insights
```

Para Windows:

```
aws rds modify-db-instance ^
    --database-insights-mode standard ^
    --db-instance-identifier sample-db-identifier ^
    --no-enable-performance-insights
```

------
#### [ RDS API ]

Para ativar o modo Standard do Database Insights ao modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, especifique os parâmetros a seguir para a operação de API [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) ou [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) do Amazon RDS.
+ `DatabaseInsightsMode` para `standard`
+ `EnablePerformanceInsights` como `True` ou `False`. Se você definir `EnablePerformanceInsights` como `True`, deverá definir `PerformanceInsightsRetentionPeriod` como pelo menos sete dias.

------

# Configurar o banco de dados para monitorar consultas SQL lentas com o Database Insights para Amazon RDS
<a name="USER_DatabaseInsights.SlowSQL"></a>

Para monitorar consultas SQL lentas em seu banco de dados, você pode usar a seção **Consultas SQL lentas** no painel do Database Insights. Antes de você configurar seu banco de dados para monitorar consultas SQL lentas, a seção **Consultas SQL lentas** se apresenta em branco.

Para ter mais informações sobre o monitoramento de consultas SQL lentas no painel do Database Insights, consulte [Visualizar o painel de instância de banco de dados do CloudWatch Database Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Database-Insights-Database-Instance-Dashboard.html) no *Guia do usuário do Amazon CloudWatch*.

Para configurar o banco de dados para monitorar consultas SQL lentas com o Database Insights, conclua as seguintes etapas:

1. Habilite as exportações de log para o CloudWatch Logs.

1. Crie ou modifique o grupo de parâmetros de banco de dados para sua instância de banco de dados.

Para ter informações sobre como configurar exportações de log, consulte [Publicação de logs de banco de dados no Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch) no *Guia do usuário do Amazon RDS*.

Para criar ou modificar seu grupo de parâmetros de banco de dados, consulte os tópicos a seguir.
+ [Criar um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Creating.md)
+ [Modificar parâmetros em um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Modifying.md)

------
#### [ RDS for MariaDB ]

Para configurar sua instância de banco de dados do RDS para MariaDB e monitorar consultas SQL lentas, defina os parâmetros a seguir.
+ `log_slow_query`: definir como `1`
+ `log_slow_query_time`: definir como `1.0`
+ `log_output`: definir como `FILE`

------
#### [ RDS for MySQL ]

Para configurar sua instância de banco de dados do RDS para MySQL e monitorar consultas SQL lentas, defina os parâmetros a seguir.
+ `slow_query_log`: definir como `1`
+ `long_query_time`: definir como `1.0`
+ `log_output`: definir como `FILE`

------
#### [ RDS for PostgreSQL ]

Para configurar sua instância de banco de dados do RDS para PostgreSQL e monitorar consultas SQL lentas, defina os parâmetros a seguir. Observe que, ao definir esses parâmetros, o desempenho da instância de banco de dados pode diminuir.
+ `log_min_duration_statement`: definir como `1000`
+ `log_statement`: definir como `none`
+ `log_destination`: definir como `stderr`

------

**nota**  
Para o RDS para MySQL, você pode configurar o parâmetro `long_query_time` com granularidade de 1 microssegundo. Por exemplo, você pode definir esse parâmetro como `0.000001`. Dependendo da quantidade de consultas na instância de banco de dados, o valor do parâmetro `long_query_time` pode reduzir o desempenho. Comece com o valor `1.0` e ajuste-o com base na sua workload. Quando você define esse parâmetro como `0`, o Database Insights registra em log todas as consultas.

Para ter informações sobre os logs do RDS para MariaDB, RDS para MySQL e RDS para PostgreSQL, consulte o seguinte:
+ [Arquivos de log do banco de dados MariaDB](USER_LogAccess.Concepts.MariaDB.md)
+ [Arquivos de log do banco de dados MySQL](USER_LogAccess.Concepts.MySQL.md)
+ [Arquivos de log do banco de dados RDS para PostgreSQL](USER_LogAccess.Concepts.PostgreSQL.md)

# Considerações sobre o Database Insights para Amazon RDS
<a name="USER_DatabaseInsights.Considerations"></a>

Confira a seguir considerações sobre o Database Insights para Amazon RDS.
+ Não é possível gerenciar o Database Insights para uma instância de banco de dados em um cluster de banco de dados multi-AZ.
+ Para ativar o modo Avançado do Database Insights, você deve ativar o Insights de Performance e definir o período de retenção do Insights de Performance para pelo menos 465 dias (15 meses). Não há custo adicional para definir o período de retenção do Insights de Performance como 15 meses, além do custo do Database Insights. Para ter informações sobre os preços do Database Insights, consulte [Definição de preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).
+ Para habilitar o Database Insights, cada instância de banco de dados em um cluster de banco de dados multi-AZ deve ter as mesmas configurações do Insights de Performance e do monitoramento avançado.
+ A modificação de uma instância de banco de dados para habilitar qualquer um dos modos do Database Insights não causa tempo de inatividade.

# Monitorar a carga de banco de dados com o Performance Insights no Amazon RDS
<a name="USER_PerfInsights"></a>

**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 todas as instâncias 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 RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Se você não tomar nenhuma medida, as instâncias 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 RDS 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 Performance Insights expande os recursos de monitoramento do Amazon RDS existentes para ilustrar e ajudar você a analisar a performance do banco de dados. Com o painel do Performance Insights, você pode visualizar a carga do banco de dados em sua carga de instâncias de banco de dados do Amazon RDS e filtrá-la por esperas, instruções SQL, hosts ou usuários. Para obter informações sobre como usar o Performance Insights com Amazon DocumentDB, consulte o *[Guia do desenvolvedor do Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html)*.

**Topics**
+ [Visão geral do Performance Insights no Amazon RDS](USER_PerfInsights.Overview.md)
+ [Ativar e desativar o Insights de Performance do Amazon RDS](USER_PerfInsights.Enabling.md)
+ [Visão geral do Performance Schema para o Insights de Performance no Amazon RDS para MariaDB ou MySQL](USER_PerfInsights.EnableMySQL.md)
+ [Configurar políticas de acesso para o Performance Insights](USER_PerfInsights.access-control.md)
+ [Análise de métricas usando o painel do Performance Insights](USER_PerfInsights.UsingDashboard.md)
+ [Visualizar as recomendações proativas do Performance Insights](USER_PerfInsights.InsightsRecommendationViewDetails.md)
+ [Recuperar métricas com a API do Insights de Performance do Amazon RDS](USER_PerfInsights.API.md)
+ [Registrar em log as chamadas do Performance Insights usando o AWS CloudTrail](USER_PerfInsights.CloudTrail.md)
+ [API do Performance Insights e endpoints da VPC de interface (AWS PrivateLink)](pi-vpc-interface-endpoints.md)

# Visão geral do Performance Insights no Amazon RDS
<a name="USER_PerfInsights.Overview"></a>

**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 todas as instâncias 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 RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Se você não tomar nenhuma medida, as instâncias 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 RDS 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/). 

Por padrão, o RDS ativa o Insights de Performance no assistente de criação do console para mecanismos do Amazon RDS. Se você tiver mais de um banco de dados em uma instância de banco de dados, o Performance Insights agregará dados de performance.

É possível encontrar uma visão geral do Performance Insights para Amazon RDS no vídeo a seguir.

[![AWS Videos](http://img.youtube.com/vi/yOeWcPBT458/0.jpg)](http://www.youtube.com/watch?v=yOeWcPBT458)


**Importante**  
Os tópicos a seguir descrevem o uso do Amazon RDS Performance Insights com mecanismos de banco de dados não Aurora. Para obter informações sobre o uso do Amazon RDS Performance Insights com o Amazon Aurora, consulte [Usar o Amazon RDS Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html) no *Guia do usuário do Amazon Aurora*.

**Topics**
+ [Carga de banco de dados](USER_PerfInsights.Overview.ActiveSessions.md)
+ [Máximo de CPU](USER_PerfInsights.Overview.MaxCPU.md)
+ [Mecanismo de banco de dados do Amazon RDS, região e classe de instância compatíveis com o Insights de Performance](USER_PerfInsights.Overview.Engines.md)
+ [Preços e retenção de dados para o Performance Insights](USER_PerfInsights.Overview.cost.md)

# Carga de banco de dados
<a name="USER_PerfInsights.Overview.ActiveSessions"></a>

*Carga do banco do dados* mede o nível de atividade de sessão no banco de dados. `DBLoad` é a métrica principal no Insights de Performance, e o Insights de Performance coleta a carga do banco de dados a cada segundo.

**Topics**
+ [Sessões ativas](#USER_PerfInsights.Overview.ActiveSessions.active-sessions)
+ [Média de sessões ativas](#USER_PerfInsights.Overview.ActiveSessions.AAS)
+ [Média de execuções ativas](#USER_PerfInsights.Overview.ActiveSessions.AAE)
+ [Dimensões](#USER_PerfInsights.Overview.ActiveSessions.dimensions)

## Sessões ativas
<a name="USER_PerfInsights.Overview.ActiveSessions.active-sessions"></a>

Uma *sessão de base de dados relacional* representa o diálogo de uma aplicação com um banco de dados relacional. Uma sessão ativa é uma conexão que enviou trabalho para o mecanismo de banco de dados e está aguardando uma resposta. 

Uma sessão fica ativa quando está em execução na CPU ou aguardando a disponibilidade de um recurso para que ela possa continuar. Por exemplo, uma sessão ativa pode esperar que uma página (ou um bloco) seja lida na memória e, depois, consumir CPU enquanto faz a leitura dos dados na página. 

## Média de sessões ativas
<a name="USER_PerfInsights.Overview.ActiveSessions.AAS"></a>

A *média de sessões ativas (AAS)* é a unidade da métrica `DBLoad` no Performance Insights. Ele mede quantas sessões estão ativas simultaneamente no banco de dados.

A cada segundo, o Insights de Performance faz uma amostra do número de sessões executando simultaneamente uma consulta. Para cada sessão ativa, o Insights de Performance coleta os seguintes dados:
+ Declaração do SQL
+ Estado da sessão (em execução na CPU ou em espera)
+ Host
+ Usuário executando o SQL

O Insights de Performance calcula a AAS dividindo o número total de sessões pelo número total de amostras por um período específico. Por exemplo, a tabela a seguir mostra cinco amostras consecutivas de uma consulta em execução em intervalos de um segundo.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)

No exemplo anterior, a carga do banco de dados para o intervalo de tempo foi de 2 AAS. Essa medida significa que, em média, duas sessões estavam ativas em determinado momento durante o intervalo em que as cinco amostras foram obtidas.

## Média de execuções ativas
<a name="USER_PerfInsights.Overview.ActiveSessions.AAE"></a>

A média de execuções ativas (AAE) por segundo está relacionada ao AAS. Para calcular os AAE, o Performance Insights divide o tempo total de execução de uma consulta pelo intervalo de tempo. A tabela a seguir mostra o cálculo de AAE para a mesma consulta na tabela anterior.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)

Na maioria dos casos, o AAS e o AAE de uma consulta são aproximadamente os mesmos. No entanto, como as entradas para os cálculos são diferentes fontes de dados, os cálculos geralmente variam ligeiramente.

## Dimensões
<a name="USER_PerfInsights.Overview.ActiveSessions.dimensions"></a>

A métrica `db.load` é diferente das outras métricas da série temporal, pois você pode fragmentá-la em subcomponentes chamados de dimensões. Você pode pensar em dimensões como “pedaços” de categorias para as diferentes características da métrica `DBLoad`.

Quando você está diagnosticando problemas de performance, as seguintes dimensões geralmente são as mais úteis:

**Topics**
+ [Eventos de espera](#USER_PerfInsights.Overview.ActiveSessions.waits)
+ [SQL principal](#USER_PerfInsights.Overview.ActiveSessions.top-sql)
+ [Planos](#USER_PerfInsights.Overview.ActiveSessions.plans)

Para obter uma lista completa de dimensões dos mecanismos Amazon RDS, consulte [Carga de banco de dados separada por dimensões](USER_PerfInsights.UsingDashboard.Components.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims).

### Eventos de espera
<a name="USER_PerfInsights.Overview.ActiveSessions.waits"></a>

Um *evento de espera* faz com que uma instrução SQL aguarde que um evento específico aconteça antes que ele possa continuar a execução. Eventos de espera são uma dimensão, ou categoria, importante para a carga do banco de dados, pois indicam onde o trabalho está impedido. 

Todas as sessões ativas estão em um estado de espera ou de execução na CPU. Por exemplo, sessões consomem CPU quando procuram um buffer na memória, realizam um cálculo ou executam um código processual. Quando as sessões não estão consumindo CPU, elas podem estar aguardando a liberação de um buffer de memória, a leitura de um arquivo de dados ou a gravação em um log. Quanto mais tempo uma sessão aguardar recursos, menos tempo ela será executada na CPU. 

Ao ajustar um banco de dados, muitas vezes você tenta descobrir os recursos que as sessões estão aguardando. Por exemplo, dois ou três eventos de espera podem representar 90% da carga do banco de dados. Essa medida significa que, em média, as sessões ativas estão passando a maior parte do tempo aguardando um pequeno número de recursos. Se você conseguir descobrir a causa dessas esperas, poderá tentar uma solução. 

Os eventos de espera variam de acordo com o mecanismo de banco de dados: 
+ Para obter informações sobre todos os eventos de espera do MariaDB e do MySQL, consulte [Tabelas de resumo de eventos de espera](https://dev.mysql.com/doc/refman/8.0/en/performance-schema-wait-summary-tables.html) na documentação do MySQL.
+ Para obter informações sobre todos os eventos de espera do PostgreSQL, consulte [The Statistics Collector > Wait Event tables](https://www.postgresql.org/docs/current/monitoring-stats.html#WAIT-EVENT-TABLE) (Coletor de estatísticas > Tabelas de eventos de espera) na documentação do PostgreSQL.
+ Para obter mais informações sobre todos os eventos de espera do Oracle, consulte [Descriptions of Wait Events](https://docs.oracle.com/database/121/REFRN/GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2.htm#REFRN-GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2) (Descrições de ventos de espera) na documentação do Oracle.
+ Para obter informações sobre todos os eventos de espera do SQL Server, consulte [Tipos de esperas](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) na documentação do SQL Server.

**nota**  
No Oracle, às vezes, os processos em segundo plano funcionam sem uma instrução SQL associada. Nesses casos, o Performance Insights relata o tipo de processo em segundo plano concatenado com dois-pontos e a classe de espera associada a esse processo em segundo plano. Os tipos de processos em segundo plano incluem `LGWR`, `ARC0`, `PMON` e assim por diante.   
Por exemplo, quando o arquivador está realizando E/S, o relatório do Performance Insights é semelhante a `ARC1:System I/O`. Às vezes, o tipo de processo em segundo plano também está ausente, e o Performance Insights só informa a classe de espera, por exemplo, `:System I/O`.

### SQL principal
<a name="USER_PerfInsights.Overview.ActiveSessions.top-sql"></a>

Enquanto eventos de espera mostram gargalos, o gráfico Top SQL (SQL principal) mostra quais consultas estão contribuindo mais para a carga do banco de dados. Por exemplo, muitas consultas podem estar em execução no banco de dados, mas uma única consulta pode consumir 99% da carga do banco de dados. Nesse caso, a carga alta pode indicar um problema com a consulta.

Por padrão, o console do Performance Insights exibe as consultas de SQL principal que estão contribuindo para a carga do banco de dados. O console também mostra estatísticas relevantes para cada instrução. Para diagnosticar problemas de performance para uma instrução específica, você pode examinar seu plano de execução.

### Planos
<a name="USER_PerfInsights.Overview.ActiveSessions.plans"></a>

Um *plano de execução*, também chamado simplesmente de *plano*, é uma sequência de etapas que acessam dados. Por exemplo, um plano para unir tabelas `t1` e `t2` pode percorrer todas as linhas em `t1` e comparar cada linha com uma linha em `t2`. Em um banco de dados relacional, um *otimizador* é um código interno que determina o plano mais eficiente para uma consulta SQL.

Em relação a instâncias de banco de dados, o Insights de Performance coleta planos de execução automaticamente. Para diagnosticar problemas de performance do SQL, examine os planos capturados para consultas de SQL com uso elevado de recursos. Os planos mostram como o banco de dados analisou e executou consultas.

Para saber como analisar a carga de banco de dados, consulte:
+ Oracle: [Analisar planos de execução do Oracle usando o painel do Insights de Performance para o Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md)
+ SQL Server: [Analisar planos de execução do SQL Server usando o painel do Insights de Performance para o Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md)

#### Captura de planos
<a name="USER_PerfInsights.Overview.ActiveSessions.plans.capture"></a>

A cada cinco minutos, o Insights de Performance identifica as consultas com uso mais intenso de recursos e captura os planos. Assim, você não precisa coletar e gerenciar manualmente um grande número de planos. Em vez disso, você pode usar o **SQL principal** para focar nos planos para as consultas mais problemáticas. 

**nota**  
O Performance Insights não captura planos para consultas cujo texto exceda o limite máximo de texto de consulta coletável. Para ter mais informações, consulte [Acessar mais texto SQL no painel do Performance Insights.](USER_PerfInsights.UsingDashboard.SQLTextSize.md).

O período de retenção para planos de execução é o mesmo dos seus dados do Performance Insights. A configuração de retenção no nível gratuito é **Default (7 days)** (Padrão (7 dias)). Para reter seus dados de performance por mais tempo, especifique entre 1 e 24 meses. Para obter mais informações sobre os períodos de retenção, consulte [Preços e retenção de dados para o Performance Insights](USER_PerfInsights.Overview.cost.md).

#### Consultas de resumo
<a name="USER_PerfInsights.Overview.ActiveSessions.plans.digest"></a>

O **SQL principal** mostra as consultas de resumo por padrão. Uma consulta de resumo não tem um plano, mas todas as consultas que usam valores literais têm planos. Por exemplo, uma consulta de resumo pode incluir o texto `WHERE `email`=?`. O resumo pode conter duas consultas, uma com o texto `WHERE email=user1@example.com` e outro com `WHERE email=user2@example.com`. Cada uma dessas consultas literais pode incluir vários planos.

Ao selecionar uma consulta de resumo, o console mostra todos os planos para declarações secundárias do resumo selecionado. Assim, você não precisa examinar todas as instruções filho para encontrar o plano. Você pode ver planos que não estão na lista exibida das 10 principais instruções filho. O console mostra planos para todas as consultas filho para as quais os planos foram coletados, independentemente de as consultas estarem entre as dez principais.

# Máximo de CPU
<a name="USER_PerfInsights.Overview.MaxCPU"></a>

No painel, o gráfico **Carga de banco de dados** coleta, agrega e exibe informações da sessão. Para ver se as sessões ativas estão excedendo o máximo de CPU, observe sua relação com a linha **Máx. vCPU**. O Insights Performance determina o valor de **Máx. vCPU** pelo número de núcleos de vCPU (CPUs virtuais) da instância de banco de dados. 

Um processo pode ser executado em uma vCPU por vez. Se o número de processos exceder o número de vCPUs, os processos começarão a ser colocados em fila. Quando a colocação em fila aumenta, a performance do banco de dados diminui. Se a carga de banco de dados estiver com frequência acima da linha **Máx. vCPU** e o estado de espera primário for CPU, isso indicará que a CPU está sobrecarregada. Nesse caso, convém limitar as conexões com a instância, ajustar todas as consultas SQL com uma alta carga de CPU ou considerar uma classe de instância maior. As instâncias altas e consistentes de qualquer estado de espera indicam que pode haver problemas de gargalos ou de contenção de recursos que você deve resolver. Isso pode ser válido mesmo quando a carga do banco de dados não ultrapassa a linha de **Máx. vCPU**.

# Mecanismo de banco de dados do Amazon RDS, região e classe de instância compatíveis com o Insights de Performance
<a name="USER_PerfInsights.Overview.Engines"></a>

**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 todas as instâncias 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 RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Se você não tomar nenhuma medida, as instâncias 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 RDS 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/). 

A tabela a seguir fornece mecanismos de banco de dados do Amazon RDS que são compatíveis com o Insights de Performance.

**nota**  
Para o Amazon Aurora, consulte [Suporte ao mecanismo de bancos de dados Amazon Aurora para Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.Engines.html) no *Guia do usuário do Amazon Aurora*.


|  Mecanismo de banco de dados do Amazon RDS  | Versões do mecanismo e regiões compatíveis | Limitações de classes de instâncias | 
| --- | --- | --- | 
|  Amazon RDS para MariaDB  |  Para obter mais informações sobre a disponibilidade de versões e regiões do Performance Insights com o RDS para MariaDB, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  O Insights de Performance não tem suporte para as seguintes classes de instâncias: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  | 
|  RDS para MySQL  |  Para obter mais informações sobre a disponibilidade de versões e regiões do Performance Insights com o RDS para MySQL, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  O Insights de Performance não tem suporte para as seguintes classes de instâncias: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  | 
|  Amazon RDS para Microsoft SQL Server  |  Para obter mais informações sobre a disponibilidade de versões e regiões do Performance Insights com o RDS para SQL Server, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/D  | 
|  Amazon RDS para PostgreSQL  |  Para obter mais informações sobre a disponibilidade de versões e regiões do Performance Insights com o RDS para PostgreSQL, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/D  | 
|  Amazon RDS para Oracle  |  Para obter mais informações sobre a disponibilidade de versões e regiões do Performance Insights com o RDS para Oracle, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/D  | 

## Mecanismo de banco de dados do Amazon RDSAmazon Aurora, região e classe de instância compatíveis com recursos do Insights de Performance
<a name="USER_PerfInsights.Overview.PIfeatureEngnRegSupport"></a>

A tabela a seguir fornece mecanismos de banco de dados do Amazon RDS que são compatíveis com atributos do Insights de Performance.


| Recurso | [Nível de preço](https://aws.amazon.com/rds/performance-insights/pricing/) |  [Regiões compatíveis](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html#Concepts.RegionsAndAvailabilityZones.Regions)  |  [ Mecanismos de banco de dados compatíveis](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html#Welcome.Concepts.DBInstance)  |  [Classes de instância compatíveis](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html#Concepts.DBInstanceClass.Types)  | 
| --- | --- | --- | --- | --- | 
| [Estatísticas SQL para Performance Insights](sql-statistics.md) | Todos | Todos |  Todos  | Todos | 
| [Analisar planos de execução do Oracle usando o painel do Insights de Performance para o Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md) | Todos | Todos |  RDS para Oracle  | Todos | 
| [Analisar a performance do banco de dados por um período](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md) | Somente nível pago |  Todos  |  RDS para PostgreSQL.  |  Todos  | 
|  [Visualizar as recomendações proativas do Performance Insights](USER_PerfInsights.InsightsRecommendationViewDetails.md) | Somente nível pago | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  |  Todos  | Todos  | 

# Preços e retenção de dados para o Performance Insights
<a name="USER_PerfInsights.Overview.cost"></a>

Por padrão, o Performance Insights oferece um nível gratuito que inclui 7 dias de histórico de dados de performance e 1 milhão de solicitações de API por mês. Você também pode comprar períodos de retenção mais longos. Para obter informações completas sobre custos, consulte [Definição de preço do Performance Insights](https://aws.amazon.com/rds/performance-insights/pricing/).

No console do RDS, você pode escolher qualquer um dos seguintes períodos de retenção para seus dados do Performance Insights:
+ **Default (7 days)** (Padrão (7 dias))
+ ***n* meses**, em que ***n*** é um número entre 1 e 24

![\[Escolha um período de retenção para seus dados do Performance Insights.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/pi-retention-periods.png)


Para saber como definir um período de retenção usando a AWS CLI, consulte .

# Ativar e desativar o Insights de Performance do Amazon RDS
<a name="USER_PerfInsights.Enabling"></a>

**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 todas as instâncias 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 RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Se você não tomar nenhuma medida, as instâncias 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 RDS 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/). 

É possível ativar o Insights de Performance para a instância de banco de dados ou o cluster de banco de dados multi-AZ durante a criação. Se necessário, você pode desativá-lo posteriormente modificando a instância de banco de dados no console. A ativação e a desativação do Performance Insights não causa tempo de inatividade, reinicialização ou failover.

**nota**  
O Performance Schema é uma ferramenta de performance opcional usada pelo Amazon RDS para MariaDB ou MySQL. Se você ativar ou desativar o Performance Schema, será necessário reinicializar. No entanto, se você ativar ou desativar o Performance Insights, não será necessário reinicializar. Para obter mais informações, consulte [Visão geral do Performance Schema para o Insights de Performance no Amazon RDS para MariaDB ou MySQL](USER_PerfInsights.EnableMySQL.md).

O agente do Performance Insights consome CPU e memória limitadas no host do banco de dados. Quando a carga do banco de dados é alta, o agente limita o impacto sobre a performance coletando dados com menos frequência.

------
#### [ Console ]

No console, ative ou desative o Performance Insights ao criar ou modificar uma instância de banco de dados ou cluster de banco de dados multi-AZ.

**Ativar ou desativar o Insights de Performance ao criar uma instância de banco de dados ou cluster de banco de dados multi-AZ**

Depois de criar uma instância de banco de dados ou cluster de banco de dados multi-AZ, o Amazon RDS habilita o Insights de Performance por padrão. Para desativar o Insights de Performance, escolha a opção **Database Insights: padrão** e desmarque a opção **Habilitar Insights de Performance**.

Para obter mais informações, consulte os tópicos a seguir. 
+ Para criar uma instância de banco de dados, siga as instruções do seu mecanismo de banco de dados em [Criar uma instância de banco de dados do Amazon RDS](USER_CreateDBInstance.md).
+ Para criar um cluster de banco de dados multi-AZ, siga as instruções relacionadas ao seu mecanismo de banco de dados em [Criar um cluster de banco de dados multi-AZ para o Amazon RDS](create-multi-az-db-cluster.md).

A captura de tela a seguir mostra a seção **Performance Insights**.

![\[Ativar o Performance Insights durante a criação da instância de banco de dados ou do cluster de banco de dados multi-AZ com o console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_enabling.png)


Se você escolher **Enable Performance Insights (Habilitar o Performance Insights)** terá as seguintes opções:
+ **Retenção** (apenas para o modo padrão do Database Insights): o intervalo de tempo para reter os dados do Insights de Performance. A configuração de retenção é **Padrão (7 dias)**. Para reter seus dados de performance por mais tempo, especifique entre 1 e 24 meses. Para obter mais informações sobre os períodos de retenção, consulte [Preços e retenção de dados para o Performance Insights](USER_PerfInsights.Overview.cost.md).
+ **AWS KMS key** – especifica a sua AWS KMS key. O Performance Insights criptografa todos os possíveis dados sigilosos usando a sua chave do KMS. Os dados são criptografados em repouso e em trânsito. Para obter mais informações, consulte [Alterar uma política do AWS KMS para o Insights de Performance](USER_PerfInsights.access-control.cmk-policy.md).

**Ativar ou desativar o Insights de Performance ao modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ**

No console, é possível modificar uma instância de banco de dados ou um cluster de banco de dados multi-AZ para gerenciar o Insights de Performance. 

**Como gerenciar o Insights de Performance para uma instância de banco de dados ou um cluster de banco de dados multi-AZ usando o console**

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. Escolha **Databases (Bancos de dados)**.

1. Escolha uma instância de banco de dados ou um cluster de banco de dados multi-AZ e selecione **Modificar**.

1. Para ativar o Insights de Performance, selecione **Habilitar Insights de Performance**. Para desativar o Insights de Performance, escolha a opção **Database Insights: padrão** e desmarque a opção **Habilitar Insights de Performance**.

   Se você escolher **Enable Performance Insights (Habilitar o Performance Insights)** terá as seguintes opções:
   + **Retenção** (apenas para o modo padrão do Database Insights): o intervalo de tempo para reter os dados do Insights de Performance. A configuração de retenção é **Padrão (7 dias)**. Para reter seus dados de performance por mais tempo, especifique entre 1 e 24 meses. Para obter mais informações sobre os períodos de retenção, consulte [Preços e retenção de dados para o Performance Insights](USER_PerfInsights.Overview.cost.md).
   + **AWS KMS key** – especifique a sua chave do KMS. O Performance Insights criptografa todos os possíveis dados sigilosos usando a sua chave do KMS. Os dados são criptografados em repouso e em trânsito. Para obter mais informações, consulte [Criptografar recursos do Amazon RDS](Overview.Encryption.md).

1. Escolha **Continue**.

1. Em **Scheduling of Modifications** (Programação de modificações), escolha Apply immediately (Aplicar imediatamente). Se você escolher Apply during the next scheduled maintenance window (Aplicar durante a próxima janela de manutenção agendada), sua instância ignorará essa configuração e ativará o Performance Insights imediatamente.

1. Escolha **Modify instance (Modificar instância)**.

------
#### [ AWS CLI ]

Ao usar o comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) da AWS CLI, ative o Insights de Performance especificando `--enable-performance-insights` e definindo `--database-insights-mode` como `advanced` ou `standard`. Para desativar o Insights de Performance, especifique `--no-enable-performance-insights` e `database-insights-mode` como `standard`.

Você também pode especificar esses valores usando os seguintes comandos da AWS CLI:
+  [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 você ativa o Performance Insights na CLI, é possível especificar o número de dias para retenção dos dados do Performance Insights com a opção `--performance-insights-retention-period`. Você pode especificar `7`, *mês* \$1 31 (em que *mês* é um número de 1 a 23) ou `731`. Por exemplo, se você quiser reter seus dados de desempenho por 3 meses, especifique `93`, que é 3 \$1 31. O padrão são `7` dias. Para obter mais informações sobre os períodos de retenção, consulte [Preços e retenção de dados para o Performance Insights](USER_PerfInsights.Overview.cost.md).

O exemplo a seguir ativa o Performance Insights para `sample-db-cluster` e especifica que os dados do Performance Insights serão retidos por 93 dias (3 meses).

Para Linux, macOS ou Unix:

```
aws rds modify-db-cluster \
	--database-insights-mode standard \
    --db-cluster-identifier sample-db-instance \
    --enable-performance-insights \
    --performance-insights-retention-period 93
```

Para 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 você especificar um período de retenção como 94 dias, que não é um valor válido, o RDS emitirá um erro.

```
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**  
É possível ativar o Insights de Performance para uma instância em um cluster de banco de dados no qual o Insights de Performance não é gerenciado no nível do cluster.

------
#### [ RDS API ]

Ao criar uma instância de banco de dados usando a operação [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) da API do Amazon RDS, ative o Performance Insights definindo `EnablePerformanceInsights` como `True`. Para desativar o Insights de Performance, defina `EnablePerformanceInsights` como `False` e `DatabaseInsightsMode` como `standard`.

Também é possível especificar o valor `EnablePerformanceInsights` usando as seguintes operações da API:
+  [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) (cluster de banco de dados multi-AZ) 
+  [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) (cluster de banco de dados multi-AZ) 
+  [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) 
+  [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) 
+  [RestoreDBInstanceFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html) 

Quando você ativar o Performance Insights, é possível especificar a quantidade de tempo, em dias, para a retenção de dados do Performance Insights com o parâmetro `PerformanceInsightsRetentionPeriod`. Você pode especificar `7`, *mês* \$1 31 (em que *mês* é um número de 1 a 23) ou `731`. Por exemplo, se você quiser reter seus dados de desempenho por 3 meses, especifique `93`, que é 3 \$1 31. O padrão são `7` dias. Para obter mais informações sobre os períodos de retenção, consulte [Preços e retenção de dados para o Performance Insights](USER_PerfInsights.Overview.cost.md).

------

# Visão geral do Performance Schema para o Insights de Performance no Amazon RDS para MariaDB ou MySQL
<a name="USER_PerfInsights.EnableMySQL"></a>

O Performance Schema é um recurso opcional para monitorar a performance do tempo de execução do Amazon RDS para MariaDB ou MySQL em um nível inferior de detalhes. O Performance Schema foi projetado para causar impacto mínimo na performance do banco de dados. O Performance Insights é um recurso separado que você pode usar com ou sem o Performance Schema.

**Topics**
+ [Visão Geral do Performance Schema](#USER_PerfInsights.EnableMySQL.overview)
+ [Performance Insights e Performance Schema](#USER_PerfInsights.effect-of-pfs)
+ [Gerenciamento automático do Performance Schema pelo Performance Insights](#USER_PerfInsights.EnableMySQL.options)
+ [Efeito de uma reinicialização no Performance Schema](#USER_PerfInsights.EnableMySQL.reboot)
+ [Determinar se o Performance Insights está gerenciando o Performance Schema](USER_PerfInsights.EnableMySQL.determining-status.md)
+ [Ativar o Performance Schema para o Amazon RDS para MariaDB ou MySQL](USER_PerfInsights.EnableMySQL.RDS.md)

## Visão Geral do Performance Schema
<a name="USER_PerfInsights.EnableMySQL.overview"></a>

O Performance Schema monitora os eventos nos bancos de dados MariaDB e MySQL. Um *evento* é uma ação do servidor de banco de dados que consome tempo e foi instrumentada para que as informações de tempo possam ser coletadas. São exemplos de evento:
+ Chamadas de função
+ Aguarda o sistema operacional
+ Estágios da execução SQL
+ Grupos de instruções SQL

O mecanismo de armazenamento `PERFORMANCE_SCHEMA` é um mecanismo para implementar o recurso Performance Schema. Esse mecanismo coleta dados de eventos usando instrumentação no código-fonte do banco de dados. O mecanismo armazena eventos em tabelas somente na memória no banco de dados `performance_schema`. É possível consultar `performance_schema` assim como quaisquer outras tabelas. Para obter mais informações, consulte [MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) no *Guia de referência do MySQL*.

## Performance Insights e Performance Schema
<a name="USER_PerfInsights.effect-of-pfs"></a>

O Performance Insights e o Performance Schema são recursos separados, mas estão conectados. O comportamento do Performance Insights para Amazon RDS para MariaDB ou MySQL depende se o Performance Schema está ativado e, em caso afirmativo, se o Performance Insights gerencia o Performance Schema automaticamente. A tabela a seguir descreve o comportamento.


| Performance Schema ativado | Modo de gerenciamento do Performance Insights | Comportamento do Performance Insights | 
| --- | --- | --- | 
|  Sim  |  Automatico  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 
|  Sim  |  Manual  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 
|  Não  |  N/D  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 

## Gerenciamento automático do Performance Schema pelo Performance Insights
<a name="USER_PerfInsights.EnableMySQL.options"></a>

Quando você cria uma instância de banco de dados do Amazon RDS para MariaDB ou MySQL com o Performance Insights ativado, o Performance Schema também é ativado. Nesse caso, o Performance Insights gerencia automaticamente seus parâmetros do Performance Schema. Essa é a configuração recomendada.

Quando o Insights de Performance gerencia o Performance Schema automaticamente, a **Origem** de `performance_schema` é `System default`.

**nota**  
O gerenciamento automático do esquema de performance não é compatível com a classe de instância t4g.medium.

Se você alterar o valor do parâmetro `performance_schema` manualmente e, posteriormente, quiser reverter para o gerenciamento automático, consulte [Ativar o Performance Schema para o Amazon RDS para MariaDB ou MySQL](USER_PerfInsights.EnableMySQL.RDS.md).

**Importante**  
Quando o Performance Insights ativa o Performance Schema, ele não altera os valores do grupo de parâmetros. No entanto, os valores são alterados nas instâncias de banco de dados que estão em execução. A única forma de ver os valores alterados é executar o comando `SHOW GLOBAL VARIABLES`.

## Efeito de uma reinicialização no Performance Schema
<a name="USER_PerfInsights.EnableMySQL.reboot"></a>

O Performance Insights e o Performance Schema diferem em seus requisitos para reinicializações de instâncias de banco de dados:

**Performance Schema**  
Para ativar ou desativar esse recurso, você deve reinicializar a instância de banco de dados.

**Performance Insights**  
Para ativar ou desativar esse recurso, não é necessário reinicializar a instância de banco de dados.

Se o Performance Schema não estiver ativado no momento e você ativar o Performance Insights sem reinicializar a instância de banco de dados, o Performance Schema não será ativado.

# Determinar se o Performance Insights está gerenciando o Performance Schema
<a name="USER_PerfInsights.EnableMySQL.determining-status"></a>

Para descobrir se, no momento, o Insights de Performance está gerenciando o Performance Schema nas versões principais compatíveis do mecanismo, consulte a tabela a seguir.


| Configuração do parâmetro performance\$1schema | Configuração da coluna Source (Fonte) | O Performance Insights está gerenciando o Performance Schema? | 
| --- | --- | --- | 
| 0 | System default | Sim | 
| 0 ou 1 | Modified | Não | 

No procedimento a seguir, você determinará se o Performance Insights está gerenciando o Performance Schema automaticamente.

**Como saber se o Performance Insights está gerenciando automaticamente o Performance Schema**

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. Escolha **Parameter groups** (Grupos de parâmetros).

1. Selecione o nome do grupo de parâmetros para a instância de banco de dados.

1. Insira **performance\$1schema** na barra de pesquisa.

1. Confira se o valor de **Origem** é o padrão do sistema e **Valor** é **0**. Nesse caso, o Performance Insights está gerenciando o Performance Schema automaticamente.

   No exemplo mostrado aqui, o Performance Insights não está gerenciando o Performance Schema automaticamente.  
![\[Mostra que as configurações do parâmetro performance_schema foram modificadas.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_schema_user.png)

# Ativar o Performance Schema para o Amazon RDS para MariaDB ou MySQL
<a name="USER_PerfInsights.EnableMySQL.RDS"></a>

Suponha que o Performance Insights esteja ativado para sua instância de banco de dados ou o cluster de banco de dados multi-AZ, mas no momento, não está gerenciando o Performance Schema. Se você quiser permitir que o Performance Insights gerencie o Performance Schema automaticamente, conclua as etapas a seguir.

**Como configurar o Performance Schema para gerenciamento automático**

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. Escolha **Parameter groups** (Grupos de parâmetros).

1. Selecione o nome do grupo de parâmetros de sua instância de banco de dados ou cluster de banco de dados multi-AZ.

1. Escolha **Editar**.

1. Insira **performance\$1schema** na barra de pesquisa.

1. Selecione o parâmetro `performance_schema`.

1. Selecione **Definir como valor padrão**.

1. Confirme escolhendo **Definir valores como padrão**.

1. Escolha **Salvar alterações**.

1. Reinicialize a instância de banco de dados ou o cluster de banco de dados multi-AZ.
**Importante**  
Sempre que habilitar ou desabilitar o Performance Schema, você deverá reinicializar a instância de banco de dados ou o cluster de banco de dados multi-AZ.

Para obter mais informações sobre como modificar os parâmetros da instância, consulte [Modificar parâmetros em um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Modifying.md). Para obter mais informações sobre o painel, consulte [Análise de métricas usando o painel do Performance Insights](USER_PerfInsights.UsingDashboard.md). Para obter mais informações sobre o esquema de desempenho do MySQL, consulte [MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) (para 8.0) na [MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.4/en/performance-schema.html) (para 8.4) na documentação do MySQL.

# Configurar políticas de acesso para o Performance Insights
<a name="USER_PerfInsights.access-control"></a>

Para acessar o Performance Insights, é necessário que uma entidade principal tenha as permissões apropriadas do AWS Identity and Access Management (IAM).

**nota**  
Para usar o Insights de Performance com uma chave gerenciada pelo cliente, conceda aos usuários as permissões `kms:Decrypt` e `kms:GenerateDataKey` para sua chave do AWS AWS KMS.

Acesse o Insights de Performance usando estes métodos:
+ [Anexar a política gerenciada `AmazonRDSPerformanceInsightsReadOnly` para acesso somente leitura](USER_PerfInsights.access-control.managed-policy.md).
+ [Anexar a política gerenciada `AmazonRDSPerformanceInsightsFullAccess` para acessar todas as operações da API do Insights de Performance](USER_PerfInsights.access-control.FullAccess-managed-policy.md)
+ [Criar uma política personalizada do IAM com permissões específicas](USER_PerfInsights.access-control.custom-policy.md).
+ [Configurar permissões do AWS KMS para dados criptografados do Insights de Performance](USER_PerfInsights.access-control.cmk-policy.md).
+ [Configurar o acesso refinado usando permissões em nível de recurso](USER_PerfInsights.access-control.dimensionAccess-policy.md).
+ [Usar o controle de acesso baseado em tags para gerenciar permissões por meio de tags de recursos](USER_PerfInsights.access-control.tag-based-policy.md).

# Anexar a política AmazonRDSPerformanceInsightsReadOnly a uma entidade principal do IAM
<a name="USER_PerfInsights.access-control.managed-policy"></a>

A `AmazonRDSPerformanceInsightsReadOnly` é uma política gerenciada pela AWS que concede acesso a todas as operações somente leitura da API do Insights de Performance do Amazon RDS. 

Se você anexar `AmazonRDSPerformanceInsightsReadOnly` a um conjunto de permissões ou perfil, também deverá anexar as seguintes permissões do CloudWatch:
+ `GetMetricStatistics`
+ `ListMetrics`
+ `GetMetricData`

Com essas permissões, o destinatário pode usar o Insights de Performance junto com outros recursos do console.

 Para ter mais informações sobre as permissões do CloudWatch, consulte [Referência de permissões do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html).

Para obter mais informações sobre o `AmazonRDSPerformanceInsightsReadOnly`, consulte [AWSPolítica gerenciada pela : AmazonRDSPerformanceInsightsReadOnly](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsReadOnly).

# Anexar a política AmazonRDSPerformanceInsightsFullAccess a uma entidade principal do IAM
<a name="USER_PerfInsights.access-control.FullAccess-managed-policy"></a>

A `AmazonRDSPerformanceInsightsFullAccess` é uma política gerenciada pela AWS que concede acesso a todas as operações da API do Insights de Performance do Amazon RDS.

Se você anexar `AmazonRDSPerformanceInsightsFullAccess` a um conjunto de permissões ou perfil, também deverá anexar as seguintes permissões do CloudWatch:
+ `GetMetricStatistics`
+ `ListMetrics`
+ `GetMetricData`

Com essas permissões, o destinatário pode usar o Insights de Performance junto com outros recursos do console.

 Para ter mais informações sobre as permissões do CloudWatch, consulte [Referência de permissões do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html).

Para obter mais informações sobre o `AmazonRDSPerformanceInsightsFullAccess`, consulte [Política gerenciada pela AWS: AmazonRDSPerformanceInsightsFullAccess](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsFullAccess).

# Criação de uma política de IAM personalizada para o Performance Insights
<a name="USER_PerfInsights.access-control.custom-policy"></a>

Para usuários que não têm a política `AmazonRDSPerformanceInsightsReadOnly` ou `AmazonRDSPerformanceInsightsFullAccess`, é possível conceder acesso ao Insights de Performance criando ou modificando uma política do IAM gerenciada pelo usuário. Quando você anexa a política a um conjunto de permissões ou perfil do IAM, o destinatário pode usar o Performance Insights.

**Para criar uma política personalizada**

1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. No painel de navegação, escolha **Policies**.

1. Selecione **Criar política**.

1. Na página **Criar política**, selecione a guia **JSON**.

1. Copie e cole o texto fornecido na seção do *documento de política JSON* no *Guia de referência de políticas gerenciadas da AWS* para [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html) ou a política [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. Escolha **Review policy (Revisar política)**.

1. Forneça um nome para a política e, se preferir, uma descrição. Em seguida, escolha **Criar política**.

Agora você pode anexar a política a um conjunto de permissões ou perfil. O procedimento a seguir pressupõe que você já tem um usuário disponível para essa finalidade.

**Como anexar a política a um usuário**

1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. No painel de navegação, escolha **Usuários**.

1. Escolha um usuário existente na lista.
**Importante**  
Para usar o Performance Insights, você deve ter acesso ao Amazon RDS e à política personalizada. Por exemplo, a política predefinida `AmazonRDSPerformanceInsightsReadOnly` concede acesso somente leitura ao Amazon RDS. Para obter mais informações, consulte [Gerenciamento do acesso usando políticas](UsingWithRDS.IAM.md#security_iam_access-manage).

1. Na página **Summary (Resumo)**, escolha **Add permissions (Adicionar permissões)**.

1. Escolha **Anexar políticas existentes diretamente**. Em **Pesquisar**, digite os primeiros caracteres do nome da política, conforme mostrado na imagem a seguir.   
![\[Escolher uma política\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_attach_iam_policy.png)

1. Escolha a política e, em seguida, escolha **Próximo: revisar**.

1. Escolha **Adicionar permissões**.

# Alterar uma política do AWS KMS para o Insights de Performance
<a name="USER_PerfInsights.access-control.cmk-policy"></a>

O Performance Insights usa uma AWS KMS key para criptografar dados sigilosos. Ao habilitar o Performance Insights por meio da API ou do console, você poderá seguir um destes procedimentos:
+ Escolha o padrão Chave gerenciada pela AWS.

  O Amazon RDS usa a Chave gerenciada pela AWS para a sua nova instância de banco de dados. O Amazon RDS cria uma Chave gerenciada pela AWS para a sua Conta da AWS. A sua Conta da AWS tem uma Chave gerenciada pela AWS diferente para o Amazon RDS para cada Região da AWS.
+ Escolha uma chave gerenciada pelo cliente.

  Se você especificar uma chave gerenciada pelo cliente, os usuários em sua conta que chamam a API do Performance Insights precisarão das permissões `kms:Decrypt` e `kms:GenerateDataKey` na chave do KMS. É possível configurar essas permissões por meio de políticas do IAM. No entanto, recomendamos que você gerencie essas permissões por meio da política de chaves do KMS. Para saber mais, consulte [Políticas de chaves no AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) no *Guia do desenvolvedor do AWS Key Management Service*. 

**Example**  
O exemplo a seguir mostra como adicionar instruções à sua política da chaves do KMS. Essas instruções permitem acesso ao Performance Insights. Dependendo de como você usa a chave KMS, talvez você queira alterar algumas restrições. Antes de adicionar instruções à política, remova todos os comentários.    
****  

```
{
    "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"
                }
            }
        }
    ]
}
```

## Como o Insights de Performance usa a chave do AWS KMS gerenciada pelo cliente
<a name="USER_PerfInsights.access-control.PI-using-KMS-cmk-policy"></a>

O Insights de Performance usa chaves gerenciadas pelo cliente para criptografar dados sigilosos. Ao ativar o Insights de Performance, você pode fornecer uma chave do AWS KMS por meio da API. O Insights de Performance cria permissões do AWS KMS nessa chave. Ele usa a chave e executa as operações necessárias para processar dados sigilosos. Os dados sigilosos incluem campos como usuário, banco de dados, aplicação e texto de consulta SQL. O Insights de Performance garante que os dados permaneçam criptografados tanto em repouso quanto em trânsito.

## Como o Insights de Performance e o IAM funcionam com o AWS KMS
<a name="USER_PerfInsights.access-control.PI-work-with-kms"></a>

O IAM concede permissões para APIs específicas. O Insights de Performance tem as seguintes APIs públicas, que você pode restringir usando políticas do IAM:
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`
+ `GetResourceMetadata`
+ `GetResourceMetrics`
+ `ListAvailableResourceDimensions`
+ `ListAvailableResourceMetrics`

Você pode usar as solicitações de API a seguir para obter dados sigilosos.
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`
+ `GetResourceMetrics`

Quando você usa a API para obter dados sigilosos, o Insights de Performance utiliza as credenciais do chamador. Essa verificação garante que o acesso a dados sigilosos seja limitado àqueles com acesso à chave do KMS.

Ao chamar essas APIs, você precisa de permissões para chamar a API por meio da política do IAM e de permissões para invocar a ação `kms:decrypt` por meio da política de chave AWS KMS.

A API `GetResourceMetrics` pode retornar dados sigilosos e não sigilosos. Os parâmetros da solicitação determinam se a resposta deve incluir dados sigilosos. A API retorna dados sigilosos quando a solicitação inclui uma dimensão confidencial nos parâmetros filtrar ou agrupar por. 

Para obter mais informações sobre as dimensões que você pode usar com a API `GetResourceMetrics`, consulte [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html).

**Example Exemplos**  
O seguinte exemplo solicita dados sigilosos para o grupo `db.user`:  

```
POST / HTTP/1.1
Host: <Hostname>
Accept-Encoding: identity
X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics
Content-Type: application/x-amz-json-1.1
User-Agent: <UserAgentString>
X-Amz-Date: <Date> 
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
Content-Length: <PayloadSizeBytes>
{
  "ServiceType": "RDS",
  "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
  "MetricQueries": [
    {
      "Metric": "db.load.avg",
      "GroupBy": {
        "Group": "db.user",
        "Limit": 2
      }
    }
  ],
  "StartTime": 1693872000,
  "EndTime": 1694044800,
  "PeriodInSeconds": 86400
}
```

**Example**  
O seguinte exemplo solicita dados não sigilosos para o grupo `db.load.avg`:  

```
POST / HTTP/1.1
Host: <Hostname>
Accept-Encoding: identity
X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics
Content-Type: application/x-amz-json-1.1
User-Agent: <UserAgentString>
X-Amz-Date: <Date> 
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
Content-Length: <PayloadSizeBytes>
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "MetricQueries": [
        {
            "Metric": "db.load.avg"
        }
    ],
    "StartTime": 1693872000,
    "EndTime": 1694044800,
    "PeriodInSeconds": 86400
}
```

# Atribuir acesso refinado para o Insights de Performance
<a name="USER_PerfInsights.access-control.dimensionAccess-policy"></a>

O controle de acesso refinado oferece formas adicionais de controlar o acesso para o Insights de Performance. Esse controle de acesso pode permitir ou negar acesso a dimensões individuais para as ações `GetResourceMetrics`, `DescribeDimensionKeys` e `GetDimensionKeyDetails` do Insights de Performance. Para usar o acesso refinado, especifique as dimensões na política do IAM usando chaves de condição. A avaliação do acesso segue a lógica de avaliação da política do IAM. Para acessar mais informações, consulte [Lógica da avaliação de política](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html) no *Guia do usuário do IAM*. Se a declaração de política do IAM não especificar nenhuma dimensão, a declaração controlará o acesso a todas as dimensões da ação especificada. Para ver a lista de dimensões disponíveis, consulte [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html).

Para descobrir as dimensões que as credenciais estão autorizadas a acessar, use o parâmetro `AuthorizedActions` em `ListAvailableResourceDimensions` e especifique a ação. Os valores permitidos para `AuthorizedActions` são os seguintes:
+ `GetResourceMetrics`
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`

Por exemplo, se você especificar `GetResourceMetrics` como o parâmetro `AuthorizedActions`, `ListAvailableResourceDimensions` exibirá a lista de dimensões que a ação `GetResourceMetrics` está autorizada a acessar. Se você especificar várias ações no parâmetro `AuthorizedActions`, `ListAvailableResourceDimensions` exibirá uma interseção de dimensões que essas ações estão autorizadas a acessar.

**Example**  
O exemplo a seguir concede acesso às dimensões especificadas para as ações `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"
                    ]
                }
            }
        }
        

    ]
}
```
Veja abaixo a resposta para a dimensão solicitada:  

```
	// 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" }
                ] 
            }
            
        ] }
    ]
}
```
O exemplo a seguir especifica uma permissão e duas negações de acesso às dimensões.    
****  

```
{
    "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"
                    ]
                }
            }
        }
    ]
}
```
Veja abaixo a resposta para as dimensões solicitadas:  

```
			// 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" }
                ] 
            },
            ...
        ] }
    ]
}
```

# Usar controle de acesso baseado em tags para o Insights de Performance
<a name="USER_PerfInsights.access-control.tag-based-policy"></a>

É possível controlar o acesso às métricas do Insights de Performance usando tags herdadas da instância de banco de dados principal. Para controlar o acesso às operações do Insights de Performance, use as políticas do IAM. Essas políticas podem conferir as tags na sua instância de banco de dados para determinar as permissões.

## Como as tags funcionam com o Insights de Performance
<a name="USER_PerfInsights.access-control.tag-inheritance"></a>

O Insights de Performance aplica automaticamente suas tags de instância de banco de dados para autorizar as respectivas métricas. Ao adicionar tags à sua instância de banco de dados, você pode usá-las imediatamente para controlar o acesso aos dados do Insights de Performance.
+ Para adicionar ou atualizar tags para métricas do Insights de Performance, modifique as tags na sua instância de banco de dados.
+ Para ver as tags das métricas do Insights de Performance, chame `ListTagsForResource` no recurso de métricas da solução. Ele exibirá as tags da instância de banco de dados associadas à métrica.

**nota**  
As operações `TagResource` e `UntagResource` exibirão um erro se você tentar usá-las diretamente nas métricas do Insights de Performance.

## Criar políticas do IAM baseadas em tag
<a name="USER_PerfInsights.access-control.tag-based-policies"></a>

Para controlar o acesso às operações do Insights de Performance, use a chave de condição `aws:ResourceTag` nas políticas do IAM. Essas políticas conferem as tags na sua instância de banco de dados.

**Example**  
Essa política impede o acesso às métricas do Insights de Performance para bancos de dados de produção. A política nega a operação `pi:GetResourceMetrics` no Insights de Performance para qualquer recurso de banco de dados marcado com `env:prod`.   

```
 {
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "pi:GetResourceMetrics",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/env": "prod"
                }
            }
        }
    ]
}
```

# Análise de métricas usando o painel do Performance Insights
<a name="USER_PerfInsights.UsingDashboard"></a>

**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 todas as instâncias 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 RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Se você não tomar nenhuma medida, as instâncias 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 RDS 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)
+ [Analisar a carga superior de PDBs da Oracle](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB.md)
+ [Analisar planos de execução usando o painel do Insights de Performance para o Amazon RDS](USER_PerfInsights.UsingDashboard.AnalyzingPlans.md)

# Visão geral do painel do Performance Insights
<a name="USER_PerfInsights.UsingDashboard.Components"></a>

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.

![\[Filtrar métricas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_0b.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
<a name="USER_PerfInsights.UsingDashboard.Components.time-range"></a>

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.

![\[Tempo relativo do Performance Insights\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf-insights-relative-time.png)


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.

![\[Tempo absoluto do Performance Insights\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf-insights-absolute-time.png)


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.

![\[Selecione o fuso horário local para o painel do Insights de Performance\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf-insights-local-time-zone.png)


## Gráfico de métricas de contador
<a name="USER_PerfInsights.UsingDashboard.Components.Countermetrics"></a>

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:
+ 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`

![\[Métricas de contador\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/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/UserGuide/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
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions"></a>

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/UserGuide/images/perf_insights_2.png)


### Carga de banco de dados separada por dimensões
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims"></a>

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 | Oracle | SQL Server | PostgreSQL | MySQL | 
| --- | --- | --- | --- | --- | 
|  Host  |  Sim  |  Sim  |  Sim  |  Sim  | 
|  SQL  |  Sim  |  Sim  |  Sim  |  Sim  | 
|  Usuário  |  Sim  |  Sim  |  Sim  |  Sim  | 
|  Espera  |  Sim  |  Sim  |  Sim  |  Sim  | 
|  Planos  |  Sim  |  Não  |  Não  |  Não  | 
|  Aplicação  |  Não  |  Não  |  Sim  |  Não  | 
|  Banco de dados  |  Não  |  Não  |  Sim  |  Sim  | 
|  Tipo de sessão  |  Não  |  Nã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/UserGuide/images/perf_insights_2b.png)


### Detalhes de carga de banco de dados para um item de dimensão
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.item-details"></a>

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/UserGuide/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/UserGuide/images/perf_insights_3.png)


## Tabela Top dimensions (Principais dimensões)
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable"></a>

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/UserGuide/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 bancos de dados  |  O nome do banco de dados ao qual o cliente está conectado  |  Somente PostgreSQL, MySQL, MariaDB e SQL Server  | 
|  Principais aplicações  |  O nome da aplicação que está conectada ao banco de dados  |  Somente PostgreSQL e SQL Server  | 
|  Principais tipos de sessão  |  O tipo da sessão atual  | Apenas 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.
<a name="USER_PerfInsights.UsingDashboard.Opening"></a>

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/UserGuide/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/UserGuide/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/UserGuide/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/UserGuide/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/UserGuide/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/UserGuide/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
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad"></a>

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/UserGuide/images/perf_insights_7.png)


# Analisar a performance do banco de dados por um período
<a name="USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod"></a>

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 do Amazon RDS](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 RDSAmazon 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
<a name="USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport"></a>

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 RDSAmazon 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/UserGuide/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/UserGuide/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/UserGuide/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/UserGuide/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 name="USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport"></a>

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/UserGuide/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/UserGuide/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/UserGuide/images/PI_AnalysisRepInsight_Recommendations.png)

# Adicionar tags a um relatório de análise de performance no Insights de Performance
<a name="USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags"></a>

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/UserGuide/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
<a name="USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport"></a>

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/UserGuide/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
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics"></a>

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)
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL"></a>

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
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text"></a>

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/UserGuide/images/sql-text-oracle.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/UserGuide/images/perf_insights_4b.png)


**nota**  
Um resumo SQL agrupa instruções SQL semelhantes, mas não edita informações confidenciais.

O Performance Insights pode mostrar o texto Oracle SQL como **Unknown** (Desconhecido). O texto tem esse status nas seguintes situações:
+ Um usuário de banco de dados Oracle diferente de `SYS` está ativo, mas não está executando SQL no momento. Por exemplo, quando uma consulta paralela é concluída, o coordenador de consultas aguarda que os processos auxiliares enviem suas estatísticas de sessão. Durante a espera, o texto da consulta é exibido como **Unknown** (Desconhecido).
+ Para uma instância do RDS para Oracle na Standard Edition, o Oracle Resource Manager limita o número de threads paralelos. O processo em segundo plano que realiza esse trabalho faz com que o texto da consulta seja exibido como **Unknown** (Desconhecido).

### Estatísticas SQL
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics"></a>

*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/UserGuide/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 RDS 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 RDS 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 Amazon RDS, consulte [Estatísticas SQL para Performance Insights](sql-statistics.md).

### Load by waits (AAS) (Carga por esperas)
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits"></a>

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/UserGuide/images/perf_insights_6.png)


### Visualizar informações do SQL
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information"></a>

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/UserGuide/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
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences"></a>

É 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/UserGuide/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/UserGuide/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 Amazon RDS, 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.
<a name="USER_PerfInsights.UsingDashboard.SQLTextSize"></a>

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/UserGuide/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 mecanismos Amazon RDS](#sql-text-engine-limits)
+ [Definir o limite do texto SQL para instâncias de banco de dados do Amazon RDS for 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 mecanismos Amazon RDS
<a name="sql-text-engine-limits"></a>

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 | 
| --- | --- | 
| Amazon RDS para MySQL e MariaDB | O comprimento é fixado em 4.096 bytes quando o Performance Schema está habilitado. Se o Performance Schema não estiver habilitado, o comprimento será fixado em 65.535 bytes. | 
| Amazon RDS para Microsoft SQL Server | 4,096 caracteres | 
| Amazon RDS para Oracle | 1.000 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 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 Amazon RDS for PostgreSQL
<a name="USER_PerfInsights.UsingDashboard.SQLTextLimit"></a>

Amazon RDS for 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 Amazon RDS para PostgreSQL versão 9.6, a configuração padrão do parâmetro `track_activity_query_size` é 1.024 bytes. No Amazon RDS para 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 Amazon RDS para 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 Amazon RDS for 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 RDS](USER_WorkingWithParamGroups.Modifying.md).

# Visualizar e baixar texto SQL no painel do Performance Insights
<a name="view-download-text"></a>

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/UserGuide/images/perf-insights-large-text-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/UserGuide/images/perf-insights-large-text-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
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel"></a>

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 individualou consulta de resumo.  
![\[Visualizar métricas de consultas em execução\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_sql.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 RDS, consulte [Estatísticas SQL para Performance Insights](sql-statistics.md).

   O exemplo a seguir mostra as preferências de estatísticas para instâncias de banco de dados Oracle.  
![\[Preferências de métricas para consultas em execução de instâncias de banco de dados Oracle.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_oracle.png)

   O exemplo a seguir mostra as preferências para instâncias de banco de dados do MariaDB e MySQL.  
![\[Preferências de métricas para consultas em execução de instâncias de banco de dados MariaDB e MySQL.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_ams.png)

1. Escolha Save (Salvar) para salvar suas preferências.

   A tabela **Top SQL** (SQL principal) é atualizada.

   O exemplo a seguir mostra estatísticas de uma consulta SQL do Oracle.  
![\[Estatísticas de uma consulta SQL\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_stats_oracle.png)

# Analisar a carga superior de PDBs da Oracle
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB"></a>

Ao analisar a carga em um banco de dados de contêiner (CDB) da Oracle, convém identificar quais bancos de dados conectáveis (PDBs) contribuem mais para a carga do banco de dados. Além disso, é recomendável comparar a performance de PDBs individuais que estão executando consultas semelhantes para ajustar a performance. Para ter mais informações sobre CDBs da Oracle, consulte [Arquitetura de banco de dados RDS para Oracle](oracle-multi-architecture.md).

No painel do Insights de Performance do Amazon RDS, é possível encontrar informações sobre bancos de dados conectáveis (PDBs) na guia **Principal PDB**, na guia **Dimensões**.

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 RDSAmazon 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 analisar a carga do principal PDB em um CDB da Oracle**

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 à esquerda, escolha **Insights de Performance**.

1. Escolha uma instância de banco de dados Oracle.

   O painel do Insights de Performance é exibido para a instância de banco de dados.

1. Na seção **Carga do banco de dados**, selecione **Banco de dados conectável (PDB)** o lado de Separar por.

   O grafo Média de sessões ativas mostra o PDB com a carga mais alta. Os identificadores de PDBs aparecem à direita dos quadrados codificados por cores. Cada identificador identifica exclusivamente um PDB.  
![\[Grafo Média de sessões ativas para carga de PDB\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_AAS.png)

1. Role para baixo até a guia **Top SQL ** (SQL principal).

   No exemplo a seguir, é possível ver a mesma consulta SQL e a carga que ela direciona para vários PDBs.  
![\[Mesma carga de consulta SQL para vários PDBs\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex1.png)

   No exemplo a seguir, um único PDB está lidando com uma carga maior do que outros PDBs no CDB.  
![\[Alta carga de consultas SQL para PDB\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex2.png)

   Para ter mais informações sobre CDBs da Oracle, consulte [CDBs and PDBs](https://docs.oracle.com/en/database/oracle/oracle-database/21/cncpt/CDBs-and-PDBs.html#GUID-FC2EB562-ED31-49EF-8707-C766B6FE66B8).

# Analisar planos de execução usando o painel do Insights de Performance para o Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AnalyzingPlans"></a>

No painel do Insights de Performance do Amazon RDS, é possível encontrar informações sobre planos de execução para instâncias de banco de dados do Oracle e do SQL Server. É possível usar essas informações para saber quais planos contribuem mais para a carga do banco de dados.

Para analisar os planos de execução do Oracle ou do SQL Server, consulte os tópicos a seguir.

**Analisar planos de execução**
+ [Analisar planos de execução do Oracle usando o painel do Insights de Performance para o Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md)
+ [Analisar planos de execução do SQL Server usando o painel do Insights de Performance para o Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md)

## Visão geral da análise de planos de execução para o Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AnalyzingPlans.Overview"></a>

É possível usar o painel do Insights de Performance do Amazon RDS para saber quais planos contribuem mais para a carga de banco de dados das instâncias de banco de dados do Oracle e do SQL Server. 

 Por exemplo, as principais instruções SQL em um determinado momento podem estar usando os planos mostrados na tabela a seguir.


****  

| SQL principal | Planejamento | 
| --- | --- | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 10  |  Plano A  | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 521  |  Plano B  | 
|  SELECT SUM(s\$1total) FROM sales WHERE region = 10  |  Plano A  | 
|  SELECT \$1 FROM emp WHERE emp\$1id = 1000  |  Plano C  | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 72  |  Plano A  | 

Com o recurso de plano do Performance Insights, você pode fazer o seguinte:
+ Descobrir quais planos são usados pelas principais consultas SQL. 

  Por exemplo, você pode descobrir que a maior parte da carga de banco de dados é gerada por consultas usando o plano A e o plano B, com apenas uma pequena porcentagem usando o plano C.
+ Comparar planos diferentes para a mesma consulta. 

  No exemplo anterior, três consultas são idênticas, exceto o ID do produto. Duas consultas usam o plano A, mas uma consulta usa o plano B. Para ver a diferença nos dois planos, você pode usar o Performance Insights.
+ Descobrir quando uma consulta mudou para um novo plano. 

  Você pode ver que uma consulta usou o plano A e, em seguida, mudou para o plano B em um determinado momento. Houve uma alteração no banco de dados neste momento? Por exemplo, se uma tabela estiver vazia, o otimizador poderá escolher uma varredura de tabela completa. Se a tabela for carregada com um milhão de linhas, o otimizador poderá alternar para uma varredura de intervalo de índice.
+ Verifique as etapas específicas de um plano com o maior custo.

  Por exemplo, uma consulta de longa execução pode mostrar uma condição de união ausente em uma equi-join. Essa condição faltante força uma união cartesiana, que une todas as linhas de duas tabelas.

Você pode executar as tarefas anteriores usando o recurso de captura de plano do Performance Insights. Assim como você pode dividir consultas por eventos de espera e SQL principal, é possível separá-las pela dimensão do plano.

# Analisar planos de execução do Oracle usando o painel do Insights de Performance para o Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AccessPlans"></a>

Ao analisar a carga de banco de dados em um banco de dados Oracle, talvez você queira saber quais planos estão contribuindo mais para a carga do banco de dados. É possível determinar quais planos estão contribuindo mais para a carga de banco de dados usando o recurso de captura de plano do Insights de Performance. 

**Para analisar planos de execução Oracle usando o console**

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 do Oracle. O painel do Performance Insights será exibido nessa instância de banco de dados.

1. Na seção **Database load (DB load)** (Carga de banco de dados (carga de DB)), escolha **Plans** (Planos) o lado de **Slice by** (Separar por).

   O gráfico Média de sessões ativas mostra os planos usados pelas instruções SQL principais. Os valores de hash do plano aparecem à direita dos quadrados codificados por cores. Cada valor de hash identifica exclusivamente um plano.  
![\[Separe por planos\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans.png)

1. Role para baixo até a guia **Top SQL ** (SQL principal).

   No exemplo a seguir, o resumo do SQL principal tem dois planos. Você pode dizer que é um resumo pelo ponto de interrogação na instrução.   
![\[Escolha um plano de resumo\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected.png)

1. Escolha o resumo para expandi-lo em suas instruções de componente.

   No exemplo a seguir, a instrução `SELECT` é uma consulta de resumo. As consultas de componentes no resumo usam dois planos diferentes. As cores dos planos correspondem ao gráfico de carga do banco de dados. O número total de planos no resumo é mostrado na segunda coluna.  
![\[Escolha um plano de resumo\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/pi-digest-plan.png)

1. Role para baixo e escolha dois **Planos** para comparar na lista de **Planos para consulta de resumo**.

   Você pode visualizar um ou dois planos para uma consulta por vez. A captura de tela a seguir compara os dois planos no resumo, com hash 2032253151 e hash 1117438016. No exemplo a seguir, 62% das sessões ativas médias que executam essa consulta de resumo estão usando o plano à esquerda, enquanto 38% estão usando o plano à direita.  
![\[Compare os planos lado a lado\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/pi-compare-plan.png)

   Neste exemplo, os planos diferem de forma importante. A Etapa 2 do plano 2032253151 usa uma verificação de índice, enquanto o plano 1117438016 usa uma varredura de tabela completa. Para uma tabela com um grande número de linhas, uma consulta de uma única linha é quase sempre mais rápida com uma varredura de índice.  
![\[Compare os planos lado a lado\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/pi-table-access.png)

1. (Opcional) Escolha **Copy** (Copiar) para copiar o plano para a área de transferência ou **Download** (Baixar) para salvar o plano no disco rígido. 

# Analisar planos de execução do SQL Server usando o painel do Insights de Performance para o Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AccessPlansSqlServer"></a>

Ao analisar a carga do banco de dados em um SQL Server Database, convém saber quais planos estão contribuindo mais para a carga do banco de dados. É possível determinar quais planos estão contribuindo mais para a carga de banco de dados usando o recurso de captura de plano do Insights de Performance. 

**Como analisar planos de execução do SQL Server usando o console**

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 do SQL Server. O painel do Performance Insights será exibido nessa instância de banco de dados.

1. Na seção **Database load (DB load)** (Carga de banco de dados (carga de DB)), escolha **Plans** (Planos) o lado de **Slice by** (Separar por).

   O gráfico Média de sessões ativas mostra os planos usados pelas instruções SQL principais. Os valores de hash do plano aparecem à direita dos quadrados codificados por cores. Cada valor de hash identifica exclusivamente um plano.  
![\[Separe por planos\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans-sqlserver.png)

1. Role para baixo até a guia **Top SQL ** (SQL principal).

   No exemplo a seguir, o resumo do SQL principal tem três planos. A presença de um ponto de interrogação na declaração SQL indica que a declaração é um resumo. Para visualizar a declaração SQL completa, escolha um valor na coluna **Declarações SQL**.  
![\[Escolha um plano de resumo\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected-sqlserver.png)

1. Escolha o resumo para expandi-lo em suas instruções de componente.

   No exemplo a seguir, a instrução `SELECT` é uma consulta de resumo. As consultas de componentes no resumo usam três planos diferentes. As cores atribuídas aos planos correspondem ao grafo de carga do banco de dados.  
![\[Escolha um plano de resumo\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/pi-digest-plan-sqlserver.png)

1. Role para baixo e escolha dois **Planos** para comparar na lista de **Planos para consulta de resumo**.

   Você pode visualizar um ou dois planos para uma consulta por vez. O screenshot a seguir compara os dois planos no resumo. No exemplo a seguir, 40% das sessões ativas médias que executam essa consulta de resumo estão usando o plano à esquerda, enquanto 28% estão usando o plano à direita.  
![\[Compare os planos lado a lado\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/pi-compare-plan-sqlserver.png)

   No exemplo anterior, os planos apresentam diferenças importantes. A etapa 2 no plano à esquerda usa uma verificação de tabela, enquanto o plano à direita usa uma verificação de índice em cluster. Para uma tabela com um grande número de linhas, uma consulta que recupere uma única linha é quase sempre mais rápida com uma verificação de índice em cluster.

1. (Opcional) Selecione o ícone **Configurações** na tabela Detalhes do plano para personalizar a visibilidade e a ordem das colunas. O screenshot a seguir mostra a tabela Detalhes do plano com a coluna **Lista de saídas** como a segunda coluna.  
![\[Personalizar a visibilidade e a ordem das colunas na tabela Detalhes do plano\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/pi-plan-fields-sql-server.png)

1. (Opcional) Escolha **Copy** (Copiar) para copiar o plano para a área de transferência ou **Download** (Baixar) para salvar o plano no disco rígido. 

**nota**  
O Insights de Performance exibe planos de execução estimados usando uma tabela de árvore hierárquica. A tabela inclui as informações de execução parcial de cada declaração. Para ter mais informações sobre as colunas na tabela Detalhes do plano, consulte [SET SHOWPLAN\$1ALL](https://learn.microsoft.com/en-us/sql/t-sql/statements/set-showplan-all-transact-sql) na documentação do SQL Server. Para exibir as informações de execução completa de um plano de execução estimado, escolha **Fazer download** para baixar o plano e, depois, carregue o plano no SQL Server Management Studio. Para ter mais informações sobre a exibição de um plano de execução estimado usando o SQL Server Management Studio, consulte [Display an Estimated Execution Plan](https://learn.microsoft.com/en-us/sql/relational-databases/performance/display-the-estimated-execution-plan) na documentação do SQL Server. 

# Visualizar as recomendações proativas do Performance Insights
<a name="USER_PerfInsights.InsightsRecommendationViewDetails"></a>

O Insights de Performance do Amazon RDS monitora métricas específicas e cria limites automaticamente analisando quais níveis podem ser problemáticos para um recurso específico. Quando os novos valores de métricas ultrapassam um limite predefinido em um período específico, o Performance Insights gera uma recomendação proativa. Essa recomendação ajuda a evitar um impacto futuro na performance do banco de dados. Para receber essas recomendações proativas, é necessário ativar o Performance Insights com um período de retenção de nível pago.

Para obter mais informações sobre como ativar o Insights de Performance, consulte [Ativar e desativar o Insights de Performance do Amazon RDS](USER_PerfInsights.Enabling.md). Para ter informações sobre preços e retenção de dados para o Performance Insights, consulte [Preços e retenção de dados para o Performance Insights](USER_PerfInsights.Overview.cost.md).

Para descobrir as regiões, os mecanismos de banco de dados e as classes de instância compatíveis com as recomendações proativas, consulte [Mecanismo de banco de dados do Amazon RDSAmazon 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). 

É possível visualizar a análise detalhada e as investigações recomendadas de recomendações proativas na página de detalhes da recomendação.

Para obter mais informações e recomendações, consulte [Recomendações do Amazon RDS](monitoring-recommendations.md).

**Como visualizar a análise detalhada de uma recomendação proativa**

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, execute qualquer uma das seguintes opções:
   + Selecione **Recomendações**.

     A página **Recomendações** exibe uma lista de recomendações classificadas pela gravidade de todos os recursos da conta.
   + Selecione **Bancos de dados** e, depois, escolha **Recomendações** para um recurso na página de bancos de dados.

     A guia **Recomendações** exibe as recomendações e os detalhes do recurso selecionado.

1. Encontre uma recomendação proativa e escolha **Visualizar detalhes**.

   A página de detalhes da recomendação é exibida. O título fornece o nome do recurso afetado com o problema detectado e a gravidade.

   Veja a seguir os componentes na página de detalhes da recomendação:
   + **Resumo da recomendação**: o problema detectado, a recomendação e o status do problema, a hora de início e término do problema, a hora de modificação da recomendação e o tipo de mecanismo.  
![\[Página de detalhes da recomendação proativa mostrando a seção Resumo da recomendação no console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/RecommendationProactive-RecSummary.png)
   + **Métricas**: os grafos do problema detectado. Cada grafo exibe um limite determinado pelo comportamento básico do recurso, bem como dados da métrica relatados a partir da hora de início do problema.  
![\[Página de detalhes da recomendação proativa mostrando a seção Métricas no console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/RecommedationProactive_Metrics.png)
   + **Análise e recomendações**: a recomendação e o motivo da recomendação sugerida.  
![\[Página de detalhes da recomendação proativa mostrando a seção Análise e recomendações no console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/ProactiveRecommendation-AnalysisAndRec.png)

   É possível analisar a causa do problema e, depois, executar as ações recomendadas sugeridas para corrigir o problema ou escolher **Dispensar** no canto superior direito para dispensar a recomendação.

# Recuperar métricas com a API do Insights de Performance do Amazon RDS
<a name="USER_PerfInsights.API"></a>

Quando o Insights de Performance está ativado, a API oferece visibilidade à performance da instância. O Amazon CloudWatch Logs fornece a fonte de autorização para métricas de monitoramento fornecidas para serviços da AWS. 

O Performance Insights oferece uma visão específica do domínio da carga do banco de dados medida como sessões ativas médias (AAS). Essa métrica aparece para os consumidores de API como um conjunto de dados bidimensional de séries temporais. A dimensão de tempo dos dados fornece a carga do banco de dados para cada ponto de tempo no intervalo de tempo consultado. Cada ponto de tempo decompõe a carga geral em relação às dimensões solicitadas, como `SQL`, `Wait-event`, `User` ou `Host`, medidas naquele ponto de tempo.

O Amazon RDS Performance Insights monitora o cluster Amazon RDS da instância de banco de dados , para que você possa analisar e solucionar problemas relacionados à performance do banco de dados. Uma maneira de visualizar os dados do Performance Insights está no Console de gerenciamento da AWS. O Performance Insights também fornece uma API pública para que você possa consultar seus próprios dados. É possível usar a API para fazer o seguinte:
+ Descarregar dados em um banco de dados
+ Adicione dados do Performance Insights aos painéis de monitoramento existentes
+ Criar ferramentas de monitoramento

Para usar a API do Performance Insights, habilite o Performance Insights em uma das suas instâncias de banco de dados do Amazon RDS. Para obter informações sobre como habilitar o Performance Insights, consulte [Ativar e desativar o Insights de Performance do Amazon RDS](USER_PerfInsights.Enabling.md). Para obter mais informações sobre a API do Performance Insights, consulte a [Referência de API do Amazon RDS Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html).

A API do Performance Insights fornece as operações a seguir.


****  

|  Ação do Performance Insights  |  AWS CLI command  |  Descrição  | 
| --- | --- | --- | 
|  [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)  |  Cria um relatório de análise de performance referente a um período específico para a instância de banco de dados. O resultado é `AnalysisReportId`, que é o identificador exclusivo do relatório.  | 
|  [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)  |  Exclui um relatório de análise de performance.  | 
|  [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)  |  Recuperar as N principais chaves de dimensão de uma métrica por um período específico.  | 
|  [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 os atributos do grupo de dimensões especificado para uma instância de banco de dados ou fonte de dados. Por exemplo, se você especificar um ID SQL e se os detalhes da dimensão estiverem disponíveis, `GetDimensionKeyDetails` recuperará o texto completo da dimensão `db.sql.statement` associada a esse ID. Essa operação é útil porque `GetResourceMetrics` e `DescribeDimensionKeys` não oferecem suporte à recuperação de texto grande de instrução SQL.   | 
|  [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 o relatório, incluindo os insights do relatório. O resultado inclui o status do relatório, o ID do relatório, os detalhes do horário do relatório, os insights e as recomendações.  | 
| [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)  |  Recupere os metadados para diferentes recursos. Por exemplo, os metadados podem indicar que um recurso está ativado ou desativado em uma instância de banco de dados específica.   | 
|  [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 as métricas do Performance Insights para um conjunto de fontes de dados, ao longo de um período. É possível fornecer grupos de dimensão e dimensões específicos e fornecer critérios de filtragem e agregação para cada grupo.  | 
| [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)  |  Recupere as dimensões que podem ser consultadas para cada tipo de métrica especificado em uma instância especificada.   | 
| [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)  |  Recupere todas as métricas disponíveis dos tipos de métrica especificados que podem ser consultados para uma instância de banco de dados especificada.  | 
|  `[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 todos os relatórios de análise disponíveis para a instância de banco de dados. Os relatórios são listados com base na hora de início de cada relatório. | 
|  `[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)  |  Lista todas as tags de metadados adicionadas ao recurso. A lista inclui o nome e o valor da 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)  |  Adiciona tags de metadados ao recurso do Amazon RDS. A tag inclui um nome e um valor.  | 
|  `[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)  |  Remove a tag de metadados do recurso.  | 

Para ter mais informações sobre como recuperar métricas de séries temporais e exemplos da AWS CLI para o Insights de Performance, consulte os tópicos a seguir.

**Topics**
+ [Recuperar métricas de séries temporais do Insights de Performance](USER_PerfInsights.API.TimeSeries.md)
+ [Exemplos da AWS CLI para o Performance Insights](USER_PerfInsights.API.Examples.md)

# Recuperar métricas de séries temporais do Insights de Performance
<a name="USER_PerfInsights.API.TimeSeries"></a>

A operação `GetResourceMetrics` recupera uma ou mais métricas de séries temporais dos dados do Performance Insights. `GetResourceMetrics` requer uma métrica e um período de tempo e retorna uma resposta com uma lista de pontos de dados. 

Por exemplo, o Console de gerenciamento da AWS usa `GetResourceMetrics` para preencher o gráfico **Métricas de contador** e o gráfico **Carregamento do banco de dados**, como visto na imagem a seguir.

![\[Gráficos Counter Metrics e Database Load\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf-insights-api-charts.png)


Todas as métricas retornadas por `GetResourceMetrics` são métricas de séries temporais padrão, com exceção de `db.load`. Essa métrica é exibida no gráfico **Carregamento do banco de dados**. A métrica `db.load` é diferente das outras métricas da série temporal, pois você pode fragmentá-la em subcomponentes chamados de *dimensões*. Na imagem anterior, `db.load` é dividido e agrupado pelos estados de espera que compõem o `db.load`.

**nota**  
`GetResourceMetrics` também pode retornar a métrica `db.sampleload`, mas a métrica `db.load` é apropriada na maioria dos casos.

Para obter informações sobre as métricas de contador retornadas pelo `GetResourceMetrics`, consulte [Métricas de contadores do Performance Insights](USER_PerfInsights_Counters.md).

Os cálculos a seguir são compatíveis com as métricas:
+ Média: o valor médio para a métrica por um período. Adicione `.avg` ao nome da métrica.
+ Mínimo: o valor mínimo para a métrica por um período. Adicione `.min` ao nome da métrica.
+ Máximo: o valor máximo para a métrica por um período. Adicione `.max` ao nome da métrica.
+ Soma: a soma dos valores da métrica por um período. Adicione `.sum` ao nome da métrica.
+ Contagem de amostra: o número de vezes que a métrica foi coletada por um período. Adicione `.sample_count` ao nome da métrica.

Por exemplo, considere que uma métrica é coletada por 300 segundos (5 minutos) e que a métrica seja coletada uma vez por minuto. Os valores de cada minuto são 1, 2, 3, 4 e 5. Nesse caso, os seguintes cálculos são retornados:
+ Média: 3
+ Mínimo: 1
+ Máximo: 5
+ Soma: 15
+ Contagem de amostras: 5

Para obter informações sobre como usar o comando `get-resource-metrics` AWS CLI, consulte [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).

Para a opção `--metric-queries`, especifique uma ou mais consultas para as quais deseja obter resultados. Cada consulta consiste em um parâmetro obrigatório `Metric` e opcional `GroupBy` e em parâmetros `Filter`. Veja a seguir um exemplo de uma especificação de opção `--metric-queries`.

```
{
   "Metric": "string",
   "GroupBy": {
     "Group": "string",
     "Dimensions": ["string", ...],
     "Limit": integer
   },
   "Filter": {"string": "string"
     ...}
```

# Exemplos da AWS CLI para o Performance Insights
<a name="USER_PerfInsights.API.Examples"></a>

Nas seções a seguir, saiba mais sobre a AWS Command Line Interface (AWS CLI) para o Insights de Performance e use exemplos da AWS CLI.

**Topics**
+ [Ajuda integrada da AWS CLI para o Insights de Performance](#USER_PerfInsights.API.CLI)
+ [Recuperar métricas de contador](#USER_PerfInsights.API.Examples.CounterMetrics)
+ [Recuperar a média de carga de banco de dados para eventos de espera superior](#USER_PerfInsights.API.Examples.DBLoadAverage)
+ [Recuperar a média de carga de banco de dados para SQL principal](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL)
+ [Recuperação da média de carga de banco de dados filtrada por SQL](#USER_PerfInsights.API.Examples.DBLoadAverageFilterBySQL)
+ [Recuperar o texto completo de uma instrução SQL](#USER_PerfInsights.API.Examples.GetDimensionKeyDetails)
+ [Criar um relatório de análise de performance para um período](#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport)
+ [Recuperar um relatório de análise de performance](#USER_PerfInsights.API.Examples.GetPerfAnalysisReport)
+ [Listar todos os relatórios de análise de performance da instância de banco de dados](#USER_PerfInsights.API.Examples.ListPerfAnalysisReports)
+ [Excluir um relatório de análise de performance](#USER_PerfInsights.API.Examples.DeletePerfAnalysisReport)
+ [Adicionar tags a um relatório de análise de performance](#USER_PerfInsights.API.Examples.TagPerfAnalysisReport)
+ [Listar todas as tags para um relatório de análise de performance](#USER_PerfInsights.API.Examples.ListTagsPerfAnalysisReport)
+ [Excluir tags de um relatório de análise de performance](#USER_PerfInsights.API.Examples.UntagPerfAnalysisReport)

## Ajuda integrada da AWS CLI para o Insights de Performance
<a name="USER_PerfInsights.API.CLI"></a>

É possível visualizar dados do Performance Insights usando o AWS CLI. É possível visualizar a ajuda dos comandos da AWS CLI para o Performance Insights, inserindo o seguinte na linha de comando.

```
aws pi help
```

Se você não tiver a AWS CLI instalada, consulte informações sobre como instalá-la em [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) no *Guia do usuário da AWS CLI*.

## Recuperar métricas de contador
<a name="USER_PerfInsights.API.Examples.CounterMetrics"></a>

A captura de tela a seguir mostra dois gráficos de métricas de contador no Console de gerenciamento da AWS.

![\[Gráficos de métricas de contador.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf-insights-api-counters-charts.png)


O exemplo a seguir mostra como reunir os mesmos dados que o Console de gerenciamento da AWS usa para gerar os dois gráficos de métricas de contador.

Para Linux, macOS ou 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"}]'
```

Para 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"}]'
```

Você também pode tornar um comando mais fácil de ler, especificando um arquivo para a opção `--metrics-query`. O exemplo a seguir usa um arquivo chamado query.json para a opção. O arquivo tem o seguinte conteúdo.

```
[
    {
        "Metric": "os.cpuUtilization.user.avg"
    },
    {
        "Metric": "os.cpuUtilization.idle.avg"
    }
]
```

Execute o seguinte comando para usar o arquivo.

Para Linux, macOS ou 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
```

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

O exemplo anterior especifica os seguintes valores para as opções:
+ `--service-type`: `RDS` para Amazon RDS
+ `--identifier` – O ID do recurso para a instância do banco de dados
+ `--start-time` e `--end-time` – Os valores ISO 8601 de `DateTime` para o período a consultar, com vários formatos compatíveis

Ele consulta um intervalo de tempo de uma hora:
+ `--period-in-seconds` – `60` para uma consulta por minuto
+ `--metric-queries` – uma matriz de duas consultas, cada uma apenas para uma métrica.

  O nome da métrica usa pontos para classificar a métrica em uma categoria útil, com o elemento final sendo uma função. No exemplo, a função é `avg` para cada consulta. Como no Amazon CloudWatch, as funções com suporte são `min`, `max`, `total` e `avg`.

A resposta é semelhante à seguinte.

```
{
    "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
```

A resposta tem `Identifier`, `AlignedStartTime` e `AlignedEndTime`. Se o valor de `--period-in-seconds` fosse `60`, as horas de início e término seriam alinhadas ao minuto. Se `--period-in-seconds` fosse `3600`, as horas de início e término teriam sido alinhadas à hora.

O `MetricList` na resposta tem um número de entradas, cada uma com uma entrada `Key` e `DataPoints`. Cada `DataPoint` tem um `Timestamp` e um `Value`. Cada lista `Datapoints` tem 60 pontos de dados, pois as consultas são para dados por minuto ao longo de uma hora, com `Timestamp1/Minute1`, `Timestamp2/Minute2` e assim por diante, até `Timestamp60/Minute60`. 

Como a consulta é para duas métricas de contador diferentes, há dois elementos na resposta `MetricList`.

## Recuperar a média de carga de banco de dados para eventos de espera superior
<a name="USER_PerfInsights.API.Examples.DBLoadAverage"></a>

O exemplo a seguir é a mesma consulta que o Console de gerenciamento da AWS usa para gerar um gráfico de linha de área empilhada. Este exemplo recupera o `db.load.avg` para a última hora com carga dividida de acordo com os sete principais eventos de espera. O comando é o mesmo que o comando em [Recuperar métricas de contador](#USER_PerfInsights.API.Examples.CounterMetrics). No entanto, o arquivo query.json tem o seguinte conteúdo.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.wait_event", "Limit": 7 }
    }
]
```

Execute o comando a seguir.

Para Linux, macOS ou 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
```

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

O exemplo especifica a métrica de `db.load.avg` e um `GroupBy` dos sete principais eventos de espera. Para obter detalhes sobre valores válidos para esse exemplo, consulte [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html) na *Referência de API do Performance Insights.*

A resposta é semelhante à seguinte.

```
{
    "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
```

Nessa resposta, há oito entradas no `MetricList`. Há uma entrada para o total `db.load.avg`, e sete entradas cada para o `db.load.avg`, divididas de acordo com um dos sete principais eventos de espera. Ao contrário do primeiro exemplo, como havia uma dimensão de agrupamento, deve haver uma chave para cada agrupamento da métrica. Não pode haver apenas uma chave para cada métrica, como no caso de uso de métricas de contador.

## Recuperar a média de carga de banco de dados para SQL principal
<a name="USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL"></a>

O exemplo a seguir agrupa `db.wait_events` pelas 10 principais instruções SQL. Existem dois grupos diferentes para instruções SQL:
+ `db.sql` – a instrução SQL completa, como `select * from customers where customer_id = 123`
+ `db.sql_tokenized` – a instrução SQL tokenizada, como `select * from customers where customer_id = ?`

Ao analisar a performance do banco de dados, pode ser útil considerar instruções SQL que diferem apenas por seus parâmetros como um item lógico. Então, você pode usar `db.sql_tokenized` ao consultar. No entanto, especialmente quando você está interessado em explicar planos, às vezes é mais útil examinar instruções SQL completas com parâmetros e agrupamentos de consulta por `db.sql`. Existe um relacionamento pai-filho entre o SQL tokenizado e o SQL completo, com vários SQL completos (filhos) agrupados sob o mesmo SQL (pai) tokenizado.

O comando neste exemplo é semelhante ao comando em [Recuperar a média de carga de banco de dados para eventos de espera superior](#USER_PerfInsights.API.Examples.DBLoadAverage). No entanto, o arquivo query.json tem o seguinte conteúdo.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.sql_tokenized", "Limit": 10 }
    }
]
```

O exemplo a seguir usa `db.sql_tokenized`.

Para Linux, macOS ou 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
```

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

Este exemplo consulta mais de 24 horas, com um período de uma hora em segundos.

O exemplo especifica a métrica de `db.load.avg` e um `GroupBy` dos sete principais eventos de espera. Para obter detalhes sobre valores válidos para esse exemplo, consulte [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html) na *Referência de API do Performance Insights.*

A resposta é semelhante à seguinte.

```
{
    "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
```

Essa resposta tem 11 entradas no `MetricList` (1 total, 10 principais SQLs tokenizados), com cada entrada com 24 `DataPoints` por hora.

Para o SQL tokenizado, existem três entradas em cada lista de dimensões:
+ `db.sql_tokenized.statement` – a instrução SQL tokenizada.
+ `db.sql_tokenized.db_id ` – o ID do banco de dados nativo usado para referência ao SQL ou um ID sintético que o Performance Insights gera para você quando o ID do banco de dados nativo não está disponível. Este exemplo retorna o ID sintético `pi-2372568224`.
+ `db.sql_tokenized.id` – o ID da consulta dentro do Performance Insights.

  No Console de gerenciamento da AWS, esse ID é chamado de ID de suporte. Ele é chamado assim porque o ID consiste em dados que o AWS Support pode examinar para ajudar você a solucionar um problema no banco de dados. A AWS leva a segurança e privacidade de seus dados extremamente a sério, e quase todos os dados são armazenados criptografados com a chave do AWS KMS. Portanto, ninguém dentro da AWS pode examinar esses dados. No exemplo precedente, `tokenized.statement` e `tokenized.db_id` são armazenados em formato criptografado. Se você tiver um problema com o banco de dados, o Suporte da AWS poderá ajudar você consultando o ID de suporte.

Ao consultar, pode ser conveniente especificar `Group` em `GroupBy`. No entanto, para um controle mais refinado sobre os dados retornados, especifique a lista de dimensões. Por exemplo, se tudo o que for necessário for o `db.sql_tokenized.statement`, um atributo `Dimensions` poderá ser adicionado ao arquivo query.json.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": {
            "Group": "db.sql_tokenized",
            "Dimensions":["db.sql_tokenized.statement"],
            "Limit": 10
        }
    }
]
```

## Recuperação da média de carga de banco de dados filtrada por SQL
<a name="USER_PerfInsights.API.Examples.DBLoadAverageFilterBySQL"></a>

![\[Filtrar por gráfico SQL.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/perf-insights-api-filter-chart.png)


A imagem anterior mostra que uma consulta específica está selecionada e que o gráfico de linhas da área empilhada das sessões ativas da média superior tem o escopo para essa consulta. Embora a consulta ainda seja para os sete principais eventos de espera geral, o valor da resposta é filtrado. O filtro faz com que ele leve em consideração apenas as sessões correspondentes ao filtro específico.

A consulta da API correspondente neste exemplo é semelhante ao comando em [Recuperar a média de carga de banco de dados para SQL principal](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL). No entanto, o arquivo query.json tem o seguinte conteúdo.

```
[
 {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.wait_event", "Limit": 5  }, 
        "Filter": { "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }
    }
]
```

Para Linux, macOS ou 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
```

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

A resposta é semelhante à seguinte.

```
{
    "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
```

Nessa resposta, todos os valores são filtrados de acordo com a contribuição de SQL tokenizado AKIAIOSFODNN7EXAMPLE especificado no arquivo query.json. As chaves também podem seguir uma ordem diferente de uma consulta sem um filtro, porque são os cinco principais eventos de espera que afetaram o SQL filtrado.

## Recuperar o texto completo de uma instrução SQL
<a name="USER_PerfInsights.API.Examples.GetDimensionKeyDetails"></a>

O exemplo a seguir recupera o texto completo de uma instrução SQL para a instância de banco de dados `db-10BCD2EFGHIJ3KL4M5NO6PQRS5`. O `--group` é `db.sql`, e o `--group-identifier` é `db.sql.id`. Nesse exemplo, *my-sql-id* representa um ID SQL recuperado que invoca `pi get-resource-metrics` ou `pi describe-dimension-keys`.

Execute o comando a seguir.

Para Linux, macOS ou Unix:

```
aws pi get-dimension-key-details \
   --service-type RDS \
   --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 \
   --group db.sql \
   --group-identifier my-sql-id \
   --requested-dimensions statement
```

Para Windows:

```
aws pi get-dimension-key-details ^
   --service-type RDS ^
   --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 ^
   --group db.sql ^
   --group-identifier my-sql-id ^
   --requested-dimensions statement
```

Nesse exemplo, os detalhes das dimensões estão disponíveis. Assim, o Performance Insights recupera o texto completo da instrução SQL, sem truncá-lo.

```
{
    "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"
    },
    ...
    ]
}
```

## Criar um relatório de análise de performance para um período
<a name="USER_PerfInsights.API.Examples.CreatePerfAnalysisReport"></a>

O exemplo a seguir cria um relatório de análise de performance com o horário de início `1682969503` e o horário de término `1682979503` do banco de dados `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
```

A resposta é o identificador exclusivo `report-0234d3ed98e28fb17` do relatório.

```
{
   "AnalysisReportId": "report-0234d3ed98e28fb17"
}
```

## Recuperar um relatório de análise de performance
<a name="USER_PerfInsights.API.Examples.GetPerfAnalysisReport"></a>

O exemplo a seguir recupera os detalhes do relatório de análise do relatório `report-0d99cc91c4422ee61`.

```
aws pi get-performance-analysis-report \
--service-type RDS \
--identifier db-loadtest-0 \
--analysis-report-id report-0d99cc91c4422ee61 \
--region us-west-2
```

A resposta fornece o status, o ID, os detalhes do horário e os insights do relatório.

```
        {
    "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)
        ]
    }
}
```

## Listar todos os relatórios de análise de performance da instância de banco de dados
<a name="USER_PerfInsights.API.Examples.ListPerfAnalysisReports"></a>

O exemplo a seguir lista todos os relatórios de análise de performance disponíveis para o banco de dados `db-loadtest-0`.

```
aws pi list-performance-analysis-reports \
--service-type RDS \
--identifier db-loadtest-0 \
--region us-west-2
```

A resposta lista todos os relatórios com o ID do relatório, o status e os detalhes do período.

```
{
    "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"
        }
    ]
}
```

## Excluir um relatório de análise de performance
<a name="USER_PerfInsights.API.Examples.DeletePerfAnalysisReport"></a>

O exemplo a seguir exclui o relatório de análise do banco de dados `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
```

## Adicionar tags a um relatório de análise de performance
<a name="USER_PerfInsights.API.Examples.TagPerfAnalysisReport"></a>

O exemplo a seguir adiciona uma tag com uma chave `name` e um valor `test-tag` ao relatório `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
```

## Listar todas as tags para um relatório de análise de performance
<a name="USER_PerfInsights.API.Examples.ListTagsPerfAnalysisReport"></a>

O exemplo a seguir lista todas as tags do relatório `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
```

A resposta lista o valor e a chave de todas as tags adicionadas ao relatório:

```
{
    "Tags": [
        {
            "Value": "test-tag", 
            "Key": "name"
        }
    ]
}
```

## Excluir tags de um relatório de análise de performance
<a name="USER_PerfInsights.API.Examples.UntagPerfAnalysisReport"></a>

O exemplo a seguir exclui a tag `name` do relatório `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
```

Depois que a tag for excluída, chamar a API `list-tags-for-resource` não listará essa tag.

# Registrar em log as chamadas do Performance Insights usando o AWS CloudTrail
<a name="USER_PerfInsights.CloudTrail"></a>

O Performance Insights é executado com o AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, uma função ou um serviço da AWS no Performance Insights. O CloudTrail captura todas as chamadas de API para o Performance Insights como eventos. Essa captura inclui chamadas do console do Amazon RDS e chamadas de código para as operações de API do Performance Insights. 

Se você criar uma trilha, será possível ativar a entrega contínua de eventos do CloudTrail para um bucket do Amazon S3, incluindo eventos do Performance Insights. Se você não configurar uma trilha, ainda poderá visualizar os eventos mais recentes no console do CloudTrail no **Histórico de eventos**. Ao usar os dados coletados pelo CloudTrail, é possível determinar certas informações. Essas informações incluem a solicitação que foi feita ao Performance Insights, o endereço IP do qual a solicitação foi feita, quem fez a solicitação e quando ela foi feita. Também inclui detalhes adicionais. 

Para saber mais sobre o CloudTrail, consulte o [Guia do usuário do AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).

## Trabalhar com informações do Performance Insights no CloudTrail
<a name="USER_PerfInsights.CloudTrail.service-name-info"></a>

O CloudTrail é habilitado em sua conta AWS ao criá-la. Quando ocorre uma atividade no Performance Insights, ela é registrada em um evento do CloudTrail com outros eventos de serviços da AWS no console do CloudTrail em **Event history** (Histórico de eventos). Você pode visualizar, pesquisar e baixar eventos recentes em sua conta da AWS. Para obter mais informações, consulte [Viewing Events with CloudTrail Event History](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) (Visualizar eventos com o histórico de eventos CloudTrail) no *Guia do Usuário do AWS CloudTrail*.

Para obter um registro contínuo de eventos na conta da AWS, incluindo eventos para o Performance Insights, crie uma trilha. Uma *trilha* permite que o CloudTrail entregue arquivos de log a um bucket do Amazon S3. Por padrão, quando uma trilha é criada no console, a mesma é aplicada a todas as regiões da AWS. A trilha registra em log eventos de todas as regiões da AWS na partição da AWS e entrega os arquivos de log para o bucket do Amazon S3 especificado por você. Além disso, é possível configurar outros AWS serviços para melhor analisar e agir de acordo com dados coletados do evento nos logs CloudTrail. Para obter mais informações, consulte os seguintes tópicos no *Guia do usuário do AWS CloudTrail*:
+ [Visão geral da criação de uma trilha](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [Serviços e integrações com suporte no CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configurando Notificações Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Receber arquivos de log do CloudTrail de várias regiões](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [receber arquivos de log do CloudTrail de várias contas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

Todas as operações do Performance Insights são registradas em log pelo CloudTrail e documentadas na [Referência de API do Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html). Por exemplo, as chamadas para as operações `DescribeDimensionKeys` e `GetResourceMetrics` geram entradas nos arquivos de log do CloudTrail. 

Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar: 
+ Se a solicitação foi feita com credenciais de usuário-raiz ou usuário do IAM.
+ Se a solicitação foi feita com credenciais de segurança temporárias de uma função ou de um usuário federado.
+ Se a solicitação foi feita por outro AWS serviço.

Para obter mais informações, consulte o [Elemento userIdentity do CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

## Entradas de arquivo de log do Performance Insights
<a name="USER_PerfInsights.CloudTrail.service-name-entries"></a>

Uma *trilha* é uma configuração que permite a entrega de eventos como registros de log a um bucket do Amazon S3 especificado. Os arquivos de log do CloudTrail contêm uma ou mais entradas de log. Um *evento* representa uma solicitação única de qualquer fonte. Cada evento inclui informações sobre a operação solicitada, a data e a hora da operação, os parâmetros de solicitação e assim por diante. Os arquivos de log do CloudTrail não são um rastreamento de pilha ordenada de chamadas de API pública. Dessa forma, eles não são exibidos em uma ordem específica. 

O exemplo a seguir mostra uma entrada de log do CloudTrail que demonstra a operação `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 do Performance Insights e endpoints da VPC de interface (AWS PrivateLink)
<a name="pi-vpc-interface-endpoints"></a>

É possível usar o AWS PrivateLink para criar uma conexão privada entre a VPC e o Insights de Performance do Amazon RDS. É possível acessar o Performance Insights como se estivesse em sua VPC, sem usar um gateway da Internet, um dispositivo NAT, uma conexão VPN ou uma conexão do Direct Connect. As instâncias na VPC não precisam de endereços IP públicos para acessar o Performance Insights.

Estabeleça essa conectividade privada criando um *endpoint de interface*, habilitado pelo AWS PrivateLink. Criaremos um endpoint de interface de rede em cada sub-rede que você habilitar para o endpoint de interface. Estas são interfaces de rede gerenciadas pelo solicitante que servem como ponto de entrada para o tráfego destinado ao Performance Insights.

Para obter mais informações, consulte [Acessar os Serviços da AWS pelo AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-access-aws-services.html) no *Guia do AWS PrivateLink*.

## Considerações sobre o Performance Insights
<a name="vpc-endpoint-considerations"></a>

Antes de configurar um endpoint de interface para o Performance Insights, leia [Considerations](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#considerations-interface-endpoints) no *Guia do AWS PrivateLink*.

O Performance Insights aceita fazer chamadas para todas as suas ações de API por meio do endpoint da interface.

Por padrão, o acesso total ao Performance Insights é permitido no endpoint da interface. Para controlar o tráfego pra o Performance Insights por meio do endpoint da interface, associe um grupo de segurança às interfaces de rede do endpoint.

## Disponibilidade
<a name="rds-and-vpc-interface-endpoints-availability"></a>

Atualmente, a API do Performance Insights comporta endpoints da VPC em Regiões da AWS que aceitam o Performance Insights. Para ter informações sobre a disponibilidade do Performance Insights, consulte [Regiões e mecanismos de banco de dados compatíveis com o Insights de Performance no Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md) .

## Criar um endpoint de interface para o Performance Insights
<a name="vpc-endpoint-create"></a>

É possível criar um endpoint de interface para o Performance Insights usando o console da Amazon VPC ou a AWS Command Line Interface (AWS CLI). Para obter mais informações, consulte [Criar um endpoint de interface](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#create-interface-endpoint-aws) no *Guia do usuário do AWS PrivateLink*.

Crie um endpoint de interface para o Performance Insights usando o seguinte nome de serviço:

Se você habilitar o DNS privado para o endpoint da interface, poderá fazer solicitações de API ao Performance Insights usando seu nome do DNS regional padrão. Por exemplo, `pi.us-east-1.amazonaws.com`.

## Criar uma política de endpoint da VPC para a API do Performance Insights
<a name="vpc-endpoint-policy"></a>

Uma política de endpoint é um recurso do IAM que pode ser anexado ao endpoint de interface. A política de endpoint padrão permite acesso total ao Performance Insights por meio do endpoint de interface. Para controlar o acesso permitido ao Performance Insights pela VPC anexe uma política de endpoint personalizada ao endpoint de interface.

Uma política de endpoint especifica as seguintes informações:
+ As entidades principais que podem realizar ações (Contas da AWS, usuários do IAM e perfis do IAM).
+ As ações que podem ser executadas.
+ Os recursos nos quais as ações podem ser executadas.

Para obter mais informações, consulte [Controlar o acesso aos serviços usando políticas de endpoint](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-access.html) no *Guia do AWS PrivateLink*.

**Exemplo: Política de endpoint da VPC para ações do Performance Insights**  
Veja a seguir um exemplo de uma política de endpoint personalizado. Quando anexada ao endpoint de interface, essa política concede acesso às ações do Performance Insights listadas para todas as entidades principais em todos os recursos.

```
{
   "Statement":[
      {
         "Principal":"*",
         "Effect":"Allow",
         "Action":[
            "rds:CreatePerformanceAnalysisReport",
            "rds:DeletePerformanceAnalysisReport",
            "rds:GetPerformanceAnalysisReport"
         ],
         "Resource":"*"
      }
   ]
}
```

**Exemplo: política de endpoint da VPC que nega todo o acesso de uma conta da AWS especificada**  
A política de endpoint da VPC a seguir nega à conta da AWS `123456789012` todo o acesso aos recursos que usam o limite. A política permite todas as ações de outras contas.

```
{
  "Statement": [
    {
      "Action": "*",
      "Effect": "Allow",
      "Resource": "*",
      "Principal": "*"
    },
    {
      "Action": "*",
      "Effect": "Deny",
      "Resource": "*",
      "Principal": { "AWS": [ "123456789012" ] }
     }
   ]
}
```

## Endereçamento IP para Performance Insights
<a name="pi-ip-addressing"></a>

Os endereços IP habilitam recursos na sua VPC para se comunicar com outros e com recursos na Internet. O Performance Insights comporta protocolos de endereçamento IPv4 e IPv6. Por padrão, o Performance Insights e a Amazon VPC usam o protocolo de endereçamento IPv4. Você não pode desativar esse comportamento. Ao criar uma VPC, especifique um bloco CIDR IPv4 (um intervalo de endereços IPv4 privados). 

Também é possível atribuir um bloco CIDR IPv6 à VPC e às sub-redes e atribuir endereços IPv6 desse bloco a recursos do RDS na sub-rede. A compatibilidade com o protocolo IPv6 expande o número de endereços IP compatíveis. Ao usar o protocolo IPv6, você tem a garantia de que terá endereços disponíveis suficientes para o crescimento futuro da Internet. Os recursos do RDS novos e existentes podem usar endereços IPv4 e IPv6 na VPC. Configurar, proteger e converter o tráfego de rede entre os dois protocolos usados em diferentes partes de uma aplicação pode causar sobrecarga operacional. Você pode padronizar o protocolo IPv6 para recursos do Amazon RDS a fim de simplificar sua configuração de rede. Para ter mais informações sobre os endpoints e cotas de serviço, consulte [Endpoints e cotas do Amazon Relational Database Service](https://docs.aws.amazon.com/general/latest/gr/rds-service.html).

Para ter mais informações sobre o endereçamento IP do Amazon RDS, consulte [Endereçamento IP do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.IP_addressing).

# Analisar anomalias de performance com o DevOps Guru para Amazon RDS
<a name="devops-guru-for-rds"></a>

O Amazon DevOps Guru é um serviço de operações totalmente gerenciado que ajuda desenvolvedores e operadores a melhorar a performance e a disponibilidade de suas aplicações. O DevOps Guru dispensa as tarefas associadas à identificação de problemas operacionais, para que você possa implementar rapidamente recomendações para melhorar sua aplicação. Para ter mais informações, consulte [O que é Configurar o Amazon DevOps Guru?](https://docs.aws.amazon.com/devops-guru/latest/userguide/welcome.html) no *Guia do usuário do Amazon DevOps Guru*.

O DevOps Guru detecta, analisa e faz recomendações de problemas operacionais para todos os mecanismos de banco de dados do Amazon RDS. O DevOps Guru para RDS amplia essa capacidade, aplicando machine learning a métricas do Performance Insights para bancos de dados do RDS para PostgreSQL. Esses recursos de monitoramento permitem que o DevOps Guru para RDS detecte e diagnostique gargalos de performance e recomende ações corretivas específicas. O DevOps Guru para RDS também pode detectar condições problemáticas no banco de dados RDS para PostgreSQL antes que elas ocorram.

Agora é possível ver essas recomendações no console do RDS. Para obter mais informações, consulte [Recomendações do Amazon RDS](monitoring-recommendations.md).

O vídeo a seguir apresenta uma visão geral do DevOps Guru para RDS.

[![AWS Videos](http://img.youtube.com/vi/N3NNYgzYUDA/0.jpg)](http://www.youtube.com/watch?v=N3NNYgzYUDA)


Para se aprofundar no assunto, consulte [Bastidores do Amazon DevOps Guru para RDS](https://aws.amazon.com/blogs/database/amazon-devops-guru-for-rds-under-the-hood/).

**Topics**
+ [Benefícios do DevOps Guru para RDS](#devops-guru-for-rds.benefits)
+ [Como funciona o DevOps Guru para RDS](#devops-guru-for-rds.how-it-works)
+ [Configurar o DevOps Guru para RDS](#devops-guru-for-rds.configuring)

## Benefícios do DevOps Guru para RDS
<a name="devops-guru-for-rds.benefits"></a>

Se você é responsável por um banco de dados RDS para PostgreSQL, talvez não esteja ciente da existência de um evento ou regressão que está afetando esse banco de dados. Quando você ficar sabendo do problema, talvez não saiba por que ele está ocorrendo ou o que fazer a respeito. Em vez de recorrer a um administrador de banco de dados (DBA) para obter ajuda ou depender de ferramentas de terceiros, você pode seguir as recomendações do DevOps Guru para RDS. 

Estas são as vantagens das análises detalhadas do DevOps Guru para RDS:

**Diagnóstico rápido**  
O DevOps Guru para RDS monitora e analisa continuamente a telemetria do banco de dados. O Performance Insights, o Enhanced Monitoring e o Amazon CloudWatch coletam dados de telemetria para sua instância de banco de dados. O DevOps Guru para RDS usa técnicas estatísticas e de machine learning para explorar esses dados e detectar anomalias. Para saber mais sobre dados de telemetria, consulte [Monitoramento da carga do banco de dados com Performance Insights no Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html) e [Monitoramento de métricas do sistema operacional com monitoramento aprimorado](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html) no *Guia do usuário do Amazon RDS*.

**Resolução rápida**  
Cada anomalia identifica o problema de performance e sugere rotas de investigação ou ações corretivas. Por exemplo, o DevOps Guru para RDS pode recomendar que você investigue eventos de espera específicos. Ou ele pode recomendar que você ajuste as configurações do seu grupo de aplicações para limitar o número de conexões de banco de dados. Com base nessas recomendações, é possível resolver problemas de performance mais rapidamente do que solucionando problemas manualmente.

**Insights proativos**  
O DevOps Guru para RDS utiliza métricas de seus recursos para detectar um comportamento possivelmente problemático antes que ele se torne um problema maior. Por exemplo, ele pode detectar quando seu banco de dados está utilizando um número crescente de tabelas temporárias em disco, o que pode começar a afetar a performance. Depois, o DevOps Guru fornece recomendações para ajudar você a resolver problemas antes que eles se tornem problemas maiores.

**Conhecimento profundo dos engenheiros da Amazon e de "machine learning**  
Para detectar problemas de performance e ajudar você a resolver gargalos, o DevOps Guru para RDS conta com machine learning (ML) e fórmulas matemáticas avançadas. Os engenheiros de banco de dados da Amazon contribuíram para o desenvolvimento das descobertas do DevOps Guru para RDS, que englobam muitos anos gerenciando centenas de milhares de bancos de dados. Com base nesse conhecimento coletivo, o DevOps Guru para RDS pode ensinar práticas recomendadas para você.

## Como funciona o DevOps Guru para RDS
<a name="devops-guru-for-rds.how-it-works"></a>

O DevOps Guru para RDS coleta dados sobre seus bancos de dados RDS para PostgreSQL por meio do Amazon RDS Performance Insights. A métrica mais importante é `DBLoad`. O DevOps Guru for RDS consome as métricas do Performance Insights, analisa-as com machine learning e publica insights no painel.

Um *insight* é uma coleção de anomalias relacionadas que foram detectadas pelo DevOps Guru.

No DevOps Guru para RDS, uma *anomalia* é um padrão que se desvia do que é considerada a performance normal do seu banco de dados RDS para PostgreSQL. 

### Insights proativos
<a name="devops-guru-for-rds.how-it-works.insights.proactive"></a>

Um *insight proativo* informa você sobre um comportamento problemático antes que ele ocorra. Contém anomalias com recomendações e métricas relacionadas para ajudar você a resolver problemas em seus bancos de dados RDS para PostgreSQL antes que se tornem problemas maiores. Esses insights são publicados no painel do DevOps Guru.

Por exemplo, o DevOps Guru pode detectar que seu banco de dados do RDS para PostgreSQL está criando muitas tabelas temporárias em disco. Se não for tratada, essa tendência poderá gerar problemas de performance. Cada insight proativo inclui recomendações para comportamento corretivo e links para tópicos relevantes em [Ajustar o RDS para PostgreSQL com insights proativos do Amazon DevOps Guru](PostgreSQL.Tuning_proactive_insights.md). Para ter mais informações, consulte [Trabalhar com insights no DevOps Guru](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html) no *Guia do usuário do Amazon DevOps Guru*. 

### Insights reativos
<a name="devops-guru-for-rds.how-it-works.insights.reactive"></a>

Um *insight reativo* identifica um comportamento anômalo quando ele ocorre. Se o DevOps Guru para RDS encontrar problemas de performance nas suas instâncias de banco de dados do RDS para PostgreSQL, ele publicará um insight reativo no painel do DevOps Guru. Para ter mais informações, consulte [Trabalhar com insights no DevOps Guru](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html) no *Guia do usuário do Amazon DevOps Guru*.

#### Anomalias causais
<a name="devops-guru-for-rds.how-it-works.anomalies.causal"></a>

Uma *anomalia causal* é uma anomalia de nível superior dentro de um insight reativo. **Carga do banco de dados** é a anomalia causal do DevOps Guru para RDS. 

Uma anomalia mede o impacto na performance, atribuindo um nível de gravidade de **Alto**, **Médio** ou **Baixo**. Para saber mais, consulte os [Principais conceitos do DevOps Guru para RDS](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-rds.overview.definitions.html), no *Guia do usuário do Amazon DevOps Guru*.

Se o DevOps Guru detectar uma anomalia em sua instância de banco de dados, você será alertado na página **Databases** (Bancos de dados) do console do RDS. O console também alerta você sobre anomalias que ocorreram nas últimas 24 horas. Para acessar a página de anomalias no console do RDS, escolha o link na mensagem de alerta. O console do RDS também alerta você na página da instância de banco de dados do RDS para PostgreSQL.

#### Anomalias contextuais
<a name="devops-guru-for-rds.how-it-works.anomalies.contextual"></a>

Uma *anomalia contextual* é uma descoberta em **Carga do banco de dados (carga do BD)** que é relatada a um insight reativo. Cada anomalia contextual descreve um problema de performance específico do RDS para PostgreSQL que requer investigação. Por exemplo, o DevOps Guru para RDS pode recomendar que você aumente a capacidade da CPU ou investigue eventos de espera que estão contribuindo para a carga do banco de dados.

**Importante**  
Convém testar todas as alterações na instância de teste antes de modificar a instância de produção. Dessa forma, você pode compreender o impacto da alteração.

Para saber mais, consulte [Analisar anomalias no Amazon RDS](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-rds.analyzing.html) no *Guia do usuário do Amazon DevOps Guru*.

## Configurar o DevOps Guru para RDS
<a name="devops-guru-for-rds.configuring"></a>

Para permitir que o DevOps Guru para Amazon RDS publique insights de um banco de dados do RDS para PostgreSQL, conclua as tarefas a seguir.

**Topics**
+ [Configurar políticas de acesso do IAM para DevOps Guru para RDS](#devops-guru-for-rds.configuring.access)
+ [Ativar o Performance Insights para suas instâncias de banco de dados do RDS para PostgreSQL](#devops-guru-for-rds.configuring.performance-insights)
+ [Ativar o DevOps Guru e especificar a cobertura de recursos](#devops-guru-for-rds.configuring.coverage)

### Configurar políticas de acesso do IAM para DevOps Guru para RDS
<a name="devops-guru-for-rds.configuring.access"></a>

Para visualizar alertas do DevOps Guru no console do RDS, seu usuário ou perfil do AWS Identity and Access Management (IAM) deve ter uma das seguintes políticas:
+ A política `AmazonDevOpsGuruConsoleFullAccess` gerenciada pelo AWS
+ A política gerenciada `AmazonDevOpsGuruConsoleReadOnlyAccess` da AWS e uma das seguintes políticas:
  + A política `AmazonRDSFullAccess` gerenciada pelo AWS
  + Uma política gerenciada pelo cliente que inclua `pi:GetResourceMetrics` e `pi:DescribeDimensionKeys`

Para ter mais informações, consulte [Configurar políticas de acesso para o Performance Insights](USER_PerfInsights.access-control.md).

### Ativar o Performance Insights para suas instâncias de banco de dados do RDS para PostgreSQL
<a name="devops-guru-for-rds.configuring.performance-insights"></a>

O DevOps Guru para RDS depende do Performance Insights para seus dados. Sem o Performance Insights, o DevOps Guru publica anomalias, mas não inclui a análise e as recomendações detalhadas.

Ao criar ou modificar uma instância de banco de dados do RDS para PostgreSQL, você pode ativar o Performance Insights. Para ter mais informações, consulte [Ativar e desativar o Insights de Performance do Amazon RDS](USER_PerfInsights.Enabling.md).

### Ativar o DevOps Guru e especificar a cobertura de recursos
<a name="devops-guru-for-rds.configuring.coverage"></a>

Você pode ativar o DevOps Guru para que ele monitore seus bancos de dados do  RDS para PostgreSQL de uma das maneiras a seguir.

**Topics**
+ [Ativar o DevOps Guru no console do RDS](#devops-guru-for-rds.configuring.coverage.rds-console)
+ [Adicionar recursos do RDS para PostgreSQL no console do DevOps Guru](#devops-guru-for-rds.configuring.coverage.guru-console)
+ [Adicionar recursos do RDS para PostgreSQL usando o CloudFormation](#devops-guru-for-rds.configuring.coverage.cfn)

#### Ativar o DevOps Guru no console do RDS
<a name="devops-guru-for-rds.configuring.coverage.rds-console"></a>

Você pode seguir vários caminhos no console do Amazon RDS para ativar o DevOps Guru.

**Topics**
+ [Ativar o DevOps Guru ao criar um banco de dados do RDS para PostgreSQL](#devops-guru-for-rds.configuring.coverage.rds-console.create)
+ [Ativar o DevOps Guru a partir do banner de notificação](#devops-guru-for-rds.configuring.coverage.rds-console.existing)
+ [Responder a um erro de permissões quando você ativa o DevOps Guru](#devops-guru-for-rds.configuring.coverage.rds-console.error)

##### Ativar o DevOps Guru ao criar um banco de dados do RDS para PostgreSQL
<a name="devops-guru-for-rds.configuring.coverage.rds-console.create"></a>

O fluxo de trabalho de criação inclui uma configuração que ativa a cobertura do DevOps Guru para seu banco de dados. Essa configuração é ativada por padrão quando você escolhe o modelo **Production** (Produção).

**Como ativar o DevOps Guru ao criar um banco de dados do RDS para PostgreSQL**

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. Siga as etapas em [Criar uma instância de banco de dados](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating) exceto a etapa em que você escolhe as configurações de monitoramento.

1. Em **Monitoring** (Monitoramento), escolha **Turn on Performance Insights** (Ativar Performance Insights). Para que o DevOps Guru para RDS forneça uma análise detalhada de anomalias de performance, o Performance Insights deve estar ativado.

1. Escolha **Turn on DevOps Guru** (Ativar DevOps Guru).  
![\[Ativar o DevOps Guru ao criar uma instância de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/devops-guru-enable-create.png)

1. Crie uma tag para seu banco de dados para que o DevOps Guru possa monitorá-lo. Faça o seguinte:
   + No campo de texto para **Tag key** (Chave de tag), insira um nome que comece com **Devops-Guru-**.
   + No campo de texto para **Tag value** (Valor da tag), insira qualquer valor. Por exemplo, se você inserir **rds-database-1** para obter o nome do banco de dados do RDS para PostgreSQL, também é possível inserir **rds-database-1** como o valor da tag.

   Para ter mais informações sobre tags, consulte “[Usar tags para identificar recursos em suas aplicações do DevOps Guru](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-resource-tags.html)” no *Guia do usuário do Amazon DevOps Guru*.

1. Conclua as etapas restantes em [Criar uma instância de banco de dados](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).

##### Ativar o DevOps Guru a partir do banner de notificação
<a name="devops-guru-for-rds.configuring.coverage.rds-console.existing"></a>

Se seus recursos não forem cobertos pelo DevOps Guru, o Amazon RDS notificará você com um banner nos seguintes locais:
+ A guia **Monitoring** (Monitoramento) de uma instância de cluster de banco de dados
+ O painel do Performance Insights

![\[Banner do DevOps Guru\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/devops-guru-enable-banner.png)


**Como ativar o DevOps Guru para seu banco de dados do RDS para PostgreSQL**

1. No banner, escolha **Turn on DevOps Guru for RDS** (Ativar DevOps Guru para RDS).

1. Insira um nome de chave e um valor para a tag. Para ter mais informações sobre tags, consulte “[Usar tags para identificar recursos em suas aplicações do DevOps Guru](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-resource-tags.html)” no *Guia do usuário do Amazon DevOps Guru*.  
![\[Ative o DevOps Guru no console do RDS.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/devops-guru-turn-on.png)

1. Escolha **Turn on DevOps Guru** (Ativar DevOps Guru).

##### Responder a um erro de permissões quando você ativa o DevOps Guru
<a name="devops-guru-for-rds.configuring.coverage.rds-console.error"></a>

Se você ativar o DevOps Guru no console do RDS ao criar um banco de dados, o RDS poderá exibir o banner a seguir sobre permissões ausentes.

![\[Banner com um erro de permissões ausentes\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/devops-guru-permissions-error.png)


**Como responder a um erro de permissões**

1. Conceda ao usuário ou ao perfil do IAM a função gerenciada pelo usuário `AmazonDevOpsGuruConsoleFullAccess`. Para ter mais informações, consulte [Configurar políticas de acesso do IAM para DevOps Guru para RDS](#devops-guru-for-rds.configuring.access).

1. Abra o console do RDS.

1. No painel de navegação, escolha **Performance Insights**.

1. Escola uma instância de banco de dados no cluster que você acabou de criar.

1. Selecione o switch para ativar o **DevOps Guru para RDS**.  
![\[Selecionar o switch para ativar o DevOps Guru para RDS\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/devops-guru-pi-toggle-off.png)

1. Escolha um valor de tag. Para ter mais informações, consulte “[Usar tags para identificar recursos em suas aplicações do DevOps Guru](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-resource-tags.html)” no *Guia do usuário do Amazon DevOps Guru*.  
![\[Ativar o DevOps Guru no console do Amazon RDS\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/devops-guru-turn-on.png)

1. Escolha **Turn on DevOps Guru** (Ativar DevOps Guru).

#### Adicionar recursos do RDS para PostgreSQL no console do DevOps Guru
<a name="devops-guru-for-rds.configuring.coverage.guru-console"></a>

Você pode especificar a cobertura de recursos do DevOps Guru no console do DevOps Guru. Siga a etapa descrita em [Especificar a cobertura de recursos do DevOps Guru](https://docs.aws.amazon.com/devops-guru/latest/userguide/choose-coverage.html) no *Guia do usuário do Amazon DevOps Guru*. Ao editar os recursos analisados, escolha uma das seguintes opções:
+ Selecione **Todos os recursos da conta** para analisar todos os recursos compatíveis, inclusive os bancos de dados do RDS para PostgreSQL, em sua Conta da AWS e região.
+ Selecione **Pilhas do CloudFormation** para analisar os bancos de dados do RDS para PostgreSQL que estão nas pilhas escolhidas. Para ter mais informações, consulte [Usar pilhas do AWS CloudFormation para identificar recursos em suas aplicações do DevOps Guru](https://docs.aws.amazon.com//devops-guru/latest/userguide/working-with-cfn-stacks.html) no *Guia do usuário do Amazon DevOps Guru*.
+ Selecione **Tags** para analisar os bancos de dados do RDS para PostgreSQL marcados. Para ter mais informações, consulte [Usar tags para identificar recursos em suas aplicações do DevOps Guru](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-resource-tags.html) no *Guia do usuário do Amazon DevOps Guru*.

Para ter mais informações, consulte [Enable DevOps Guru](https://docs.aws.amazon.com/devops-guru/latest/userguide/getting-started-enable-service.html) (Ativar o DevOps Guru), no *Guia do usuário do Amazon DevOps Guru*.

#### Adicionar recursos do RDS para PostgreSQL usando o CloudFormation
<a name="devops-guru-for-rds.configuring.coverage.cfn"></a>

Você pode usar tags para adicionar cobertura dos recursos do RDS para PostgreSQL aos modelos do CloudFormation. O procedimento a seguir pressupõe que você tenha um modelo do CloudFormation para sua instância de banco de dados do RDS para PostgreSQL e para a pilha do DevOps Guru.

**Como especificar uma instância de banco de dados do RDS para PostgreSQL usando uma tag do CloudFormation**

1. No modelo do CloudFormation para sua instância de banco de dados, defina uma tag usando um par de chave/valor.

   O exemplo a seguir atribui o valor `my-db-instance1` a `Devops-guru-cfn-default` para uma instância de banco de dados do RDS para PostgreSQL.

   ```
   MyDBInstance1:
     Type: "AWS::RDS::DBInstance"
     Properties:
       DBInstanceIdentifier: my-db-instance1
       Tags:
         - Key: Devops-guru-cfn-default
           Value: devopsguru-my-db-instance1
   ```

1. No modelo do CloudFormation para sua pilha do DevOps Guru, especifique a mesma tag em seu filtro de coleta de recursos.

   O exemplo a seguir configura o DevOps Guru para fornecer cobertura para o recurso com o valor da tag `my-db-instance1`.

   ```
   DevOpsGuruResourceCollection:
     Type: AWS::DevOpsGuru::ResourceCollection
     Properties:
       ResourceCollectionFilter:
         Tags:
           - AppBoundaryKey: "Devops-guru-cfn-default"
             TagValues:
             - "devopsguru-my-db-instance1"
   ```

   O exemplo a seguir fornece cobertura para todos os recursos dentro dos limites da aplicação `Devops-guru-cfn-default`.

   ```
   DevOpsGuruResourceCollection:
     Type: AWS::DevOpsGuru::ResourceCollection
     Properties:
       ResourceCollectionFilter:
         Tags:
           - AppBoundaryKey: "Devops-guru-cfn-default"
             TagValues:
             - "*"
   ```

Para ter mais informações, consulte [AWS::DevOpsGuru::ResourceCollection](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsguru-resourcecollection.html) e [AWS::RDS::DBInstance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html) no *Guia do usuário do CloudFormation*.

# Monitorar métricas do SO com o monitoramento avançado
<a name="USER_Monitoring.OS"></a>

Com o monitoramento avançado, você pode monitorar o sistema operacional da sua instância de banco de dados em tempo real. As métricas de monitoramento avançado são úteis quando você quiser ver como os diferentes processos ou threads usam a CPU.

**Topics**
+ [Visão geral do monitoramento avançado](#USER_Monitoring.OS.overview)
+ [Configurar e habilitar o monitoramento avançado](USER_Monitoring.OS.Enabling.md)
+ [Como visualizar métricas do SO no console do RDS](USER_Monitoring.OS.Viewing.md)
+ [Visualizar métricas do SO usando CloudWatch Logs](USER_Monitoring.OS.CloudWatchLogs.md)

## Visão geral do monitoramento avançado
<a name="USER_Monitoring.OS.overview"></a>

O Amazon RDS dispõe de métricas em tempo real para o sistema operacional (SO) no qual sua instância de banco de dados é executada. Você pode visualizar todas as métricas e informações de processo do sistema das suas instâncias de banco de dados do RDS no console. Você pode gerenciar quais métricas deseja monitorar para cada instância e personalizar o painel de acordo com os seus requisitos. Para ver as descrições das métricas do monitoramento avançado, consulte [Métricas do sistema operacional no monitoramento avançado](USER_Monitoring-Available-OS-Metrics.md).

O RDS fornece as métricas do monitoramento avançado à sua conta do Amazon CloudWatch Logs. Você pode criar filtros de métricas no CloudWatch com o CloudWatch Logs e exibir os gráficos no painel do CloudWatch. É possível consumir o resultado do JSON de monitoramento avançado do CloudWatch Logs em um sistema de monitoramento de sua escolha. Para obter mais informações, consulte [Monitoramento avançado](https://aws.amazon.com/rds/faqs/#Enhanced_Monitoring) nas Perguntas frequentes do Amazon RDS.

**Topics**
+ [Disponibilidade do monitoramento avançado](#USER_Monitoring.OS.Availability)
+ [Diferenças entre o CloudWatch e métricas de monitoramento avançado](#USER_Monitoring.OS.CloudWatchComparison)
+ [Retenção de métricas do monitoramento avançado](#USER_Monitoring.OS.retention)
+ [Custo do monitoramento avançado](#USER_Monitoring.OS.cost)

### Disponibilidade do monitoramento avançado
<a name="USER_Monitoring.OS.Availability"></a>

O monitoramento avançado está disponível para os seguintes mecanismos de banco de dados:
+ Db2
+ MariaDB
+ Microsoft SQL Server
+ MySQL
+ Oracle
+ PostgreSQL

### Diferenças entre o CloudWatch e métricas de monitoramento avançado
<a name="USER_Monitoring.OS.CloudWatchComparison"></a>

Um *hipervisor* cria e executa as máquinas virtuais (VMs). Usando um hipervisor, a instância pode oferecer suporte a várias VMs convidadas compartilhando memória e CPU virtualmente. O CloudWatch coleta métricas sobre a utilização da CPU do hipervisor para uma instância de banco de dados. Em contraste, o monitoramento avançado reúne as métricas de um agente na instância de banco de dados.

Você poderá encontrar diferenças entre as CloudWatch medidas do monitoramento avançado, pois a camada do hipervisor realiza uma pequena quantidade de trabalho. As diferenças podem ser maiores se as instâncias de banco de dados usarem classes de instância menores. Nesse cenário, mais máquinas virtuais (VMs) provavelmente são gerenciadas pela camada de hipervisor em uma única instância física.

Para ver as descrições das métricas do monitoramento avançado, consulte [Métricas do sistema operacional no monitoramento avançado](USER_Monitoring-Available-OS-Metrics.md). Para ter mais informações sobre as métricas do CloudWatch, consulte o *[Guia do usuário do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)*.

### Retenção de métricas do monitoramento avançado
<a name="USER_Monitoring.OS.retention"></a>

Por padrão, as métricas do monitoramento avançado são armazenadas por 30 dias no CloudWatch Logs. Esse período de retenção é diferente das métricas típicas do CloudWatch.

Para modificar o tempo em que as métricas são armazenadas nos logs do CloudWatch Logs, altere a retenção do grupo de logs do `RDSOSMetrics` no console do CloudWatch. Para obter mais informações, consulte [Alterar retenção de dados de log em logs do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#SettingLogRetention) no *Amazon CloudWatch Logs User Guide*.

### Custo do monitoramento avançado
<a name="USER_Monitoring.OS.cost"></a>

As métricas de monitoramento avançado são armazenadas no CloudWatch Logs e não métricas do CloudWatch. O custo do monitoramento avançado depende dos seguintes fatores:
+ Só haverá cobrança pelo monitoramento avançado se você exceder a quantidade de transferência de dados e armazenamento oferecida pelo Amazon CloudWatch Logs. As cobranças são baseadas nas taxas de transferência de dados e armazenamento do CloudWatch Logs.
+ A quantidade de informações transferidas para uma instância do RDS é diretamente proporcional ao detalhamento definido para o recurso de monitoramento avançado. Um menor intervalo de monitoramento resulta em relatórios mais frequentes das métricas do sistema operacional e aumenta seu custo de monitoramento. Para gerenciar custos, defina diferentes detalhamentos para diferentes instâncias em suas contas.
+ Os custos de uso do Monitoramento avançado são aplicados a cada instância de banco de dados para a qual o Monitoramento avançado esteja habilitado. O monitoramento de um grande número de instâncias de banco de dados é mais caro do que o monitoramento de apenas algumas.
+ Instâncias de bancos de dados que oferecem suporte a uma workload que exige computação intensiva têm mais atividade de processos de SO para reportar e custos mais altos para Monitoramento avançado.

Para obter mais informações sobre a definição de preço, consulte [Definição de preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).

# Configurar e habilitar o monitoramento avançado
<a name="USER_Monitoring.OS.Enabling"></a>

Para usar o monitoramento avançado, você deve criar uma função do IAM e habilitar o monitoramento avançado.

**Topics**
+ [Criar uma função do IAM para o monitoramento avançado](#USER_Monitoring.OS.Enabling.Prerequisites)
+ [Ativar e desativar o monitoramento aprimorado](#USER_Monitoring.OS.Enabling.Procedure)
+ [Proteção contra o problema do substituto confuso](#USER_Monitoring.OS.confused-deputy)

## Criar uma função do IAM para o monitoramento avançado
<a name="USER_Monitoring.OS.Enabling.Prerequisites"></a>

O Monitoramento avançado requer permissão para agir em seu nome para enviar informações de métricas do SO ao CloudWatch Logs. Você concede as permissões ao monitoramento avançado usando uma função do AWS Identity and Access Management (IAM). Você pode criar essa função ao ativar o monitoramento aprimorado ou criá-la de antemão.

**Topics**
+ [Criar a função do IAM ao habilitar o Monitoramento Avançado](#USER_Monitoring.OS.Enabling.Prerequisites.creating-role-automatically)
+ [Criar a função do IAM antes de ativar o Monitoramento Avançado](#USER_Monitoring.OS.Enabling.Prerequisites.creating-role-manually)

### Criar a função do IAM ao habilitar o Monitoramento Avançado
<a name="USER_Monitoring.OS.Enabling.Prerequisites.creating-role-automatically"></a>

Quando você habilita o Monitoramento Avançado no console do RDS, o Amazon RDS pode criar a função do IAM necessária para você. A função é chamada `rds-monitoring-role`. O RDS usa essa função para a instância de banco de dados especificada, réplica de leitura ou cluster de banco de dados multi-AZ.

**Para criar a função do IAM ao habilitar o Monitoramento Avançado**

1. Siga as etapas em [Ativar e desativar o monitoramento aprimorado](#USER_Monitoring.OS.Enabling.Procedure).

1. Defina a **Monitoring Role (Função de monitoramento)** como **Default (Padrão)** na etapa em que você escolhe uma função.

### Criar a função do IAM antes de ativar o Monitoramento Avançado
<a name="USER_Monitoring.OS.Enabling.Prerequisites.creating-role-manually"></a>

Você pode criar a função necessária antes de habilitar o Monitoramento Avançado. Ao habilitar o Monitoramento Avançado, especifique o nome da nova função. Você deverá criar essa função necessária se habilitar o Monitoramento avançado usando a AWS CLI ou a API do RDS.

O usuário que habilita o monitoramento aprimorado precisa receber a permissão `PassRole`. Para obter mais informações, consulte o Exemplo 2 em [Conceder permissões ao usuário para transmitir uma função para um serviço da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html) no *Manual do usuário do IAM*.<a name="USER_Monitoring.OS.IAMRole"></a>

**Como criar uma função do IAM para o monitoramento avançado do Amazon RDS**

1. Abra o [Console do IAM](https://console.aws.amazon.com/iam/home?#home) em [https://console.aws.amazon.com](https://console.aws.amazon.com/).

1. No painel de navegação, selecione **Roles**.

1. Selecione **Create role**.

1. Escolha a guia **Serviço da AWS** e, em seguida, **RDS** na lista de serviços.

1. Escolha **RDS - Enhanced Monitoring** (RDS: monitoramento aprimorado) e **Next** (Próximo).

1. A página **Permissions policies** (Políticas de permissões) deve mostrar **AmazonRDSEnhancedMonitoringRole**. Escolha **Next** (Próximo).

1. Em **Role name (Nome da função)**, digite um nome para sua função. Por exemplo, digite **emaccess**.

   A entidade confiável para sua função é o serviço da AWS **monitoring.rds.amazonaws.com**.

1. Selecione **Create role (Criar função)**.

## Ativar e desativar o monitoramento aprimorado
<a name="USER_Monitoring.OS.Enabling.Procedure"></a>

É possível gerenciar o monitoramento avançado usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS. Você pode definir detalhamentos diferentes para a coleta de métricas em cada instância de banco de dados. 

### Console
<a name="USER_Monitoring.OS.Enabling.Procedure.Console"></a>

É possível ativar o monitoramento avançado ao criar uma instância de banco de dados, um cluster de banco de dados multi-AZ ou uma réplica de leitura, ou ao modificar uma instância de banco de dados ou cluster de banco de dados multi-AZ. Se você modificar uma instância de banco de dados para ativar o Monitoramento avançado, não será necessário reinicializar a instância de banco de dados para que a alteração entre em vigor. 

Você pode ativar o monitoramento aprimorado no console do RDS ao realizar uma das seguintes ações na página **Databases** (Banco de dados): 
+ **“Create a DB instance or Multi-AZ DB cluster” (Criar uma instância de banco de dados ou cluster de banco de dados multi-AZ)**: escolha **Create database** (Criar banco de dados).
+ **Create a read replica** (Criar uma réplica de leitura) — Escolha **Actions** (Ações) e depois **Create read replica** (Criar réplica de leitura).
+ **Modificar uma instância de banco de dados ou cluster de banco de dados multi-AZ**: escolha **Modificar**.

**Para ativar ou desativar o monitoramento aprimorado no console do RDS**

1. Role até **Additional configuration** (Configuração adicional).

1. Em **Monitoramento**, escolha **Habilitar o Monitoramento avançado** para a instância de banco de dados ou a réplica de leitura. Desmarque a opção para desabilitar o Monitoramento avançado. 

1. Defina a propriedade **Monitoring Role (Função de monitoramento)** como a função do IAM que você criou para permitir que o Amazon RDS se comunique com o Amazon CloudWatch Logs por você. Ou escolha **Default (Padrão)** para que o RDS crie uma função para você chamada `rds-monitoring-role`.

1. Defina a propriedade **Granularidade** como o intervalo, em segundos, entre pontos quando as métricas são coletadas para a instância de banco de dados ou a réplica de leitura. A propriedade **Granularity (Granularidade)** pode ser definida como um dos seguintes valores: `1`, `5`, `10`, `15`, `30` ou `60`.

   A frequência de atualização mais rápida do console do RDS é a cada 5 segundos. Se você definir a granularidade como 1 segundo no console do RDS, ainda verá as métricas atualizadas apenas a cada 5 segundos. É possível recuperar atualizações de métricas de 1 segundo usando a CloudWatch Logs.

### AWS CLI
<a name="USER_Monitoring.OS.Enabling.Procedure.CLI"></a>

Para ativar o monitoramento avançado usando a AWS CLI, defina a opção `--monitoring-interval` nos comandos a seguir como um valor diferente de `0` e defina a opção `--monitoring-role-arn` para a função criada em [Criar uma função do IAM para o monitoramento avançado](#USER_Monitoring.OS.Enabling.Prerequisites).
+ [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.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)
+ [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) (cluster de banco de dados multi-AZ)
+ [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) (cluster de banco de dados multi-AZ)

A opção `--monitoring-interval` especifica o intervalo, em segundos, entre pontos quando as métricas de monitoramento avançado são coletadas. Os valores válidos para a opção são `0`, `1`, `5`, `10`, `15`, `30` e `60`.

Para desativar o monitoramento aprimorado usando a AWS CLI, defina a opção `--monitoring-interval` para `0` nestes comandos.

**Example**  
O seguinte exemplo ativa o monitoramento avançado para uma instância de banco de dados:  
Para Linux, macOS ou Unix:  

```
aws rds modify-db-instance \
    --db-instance-identifier mydbinstance \
    --monitoring-interval 30 \
    --monitoring-role-arn arn:aws:iam::123456789012:role/emaccess
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier mydbinstance ^
    --monitoring-interval 30 ^
    --monitoring-role-arn arn:aws:iam::123456789012:role/emaccess
```

**Example**  
O seguinte exemplo ativa o monitoramento avançado para um cluster de banco de dados multi-AZ:  
Para Linux, macOS ou Unix:  

```
aws rds modify-db-cluster \
    --db-cluster-identifier mydbcluster \
    --monitoring-interval 30 \
    --monitoring-role-arn arn:aws:iam::123456789012:role/emaccess
```
Para Windows:  

```
aws rds modify-db-cluster ^
    --db-cluster-identifier mydbcluster ^
    --monitoring-interval 30 ^
    --monitoring-role-arn arn:aws:iam::123456789012:role/emaccess
```

### API do RDS
<a name="USER_Monitoring.OS.Enabling.Procedure.API"></a>

Para ativar o monitoramento aprimorado usando a API do RDS, defina o parâmetro `MonitoringInterval` como um valor diferente de `0` e defina o parâmetro `MonitoringRoleArn` para a função criada em [Criar uma função do IAM para o monitoramento avançado](#USER_Monitoring.OS.Enabling.Prerequisites). Defina esses parâmetros nas seguintes ações:
+ [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html)
+ [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html)
+ [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html)
+ [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) (cluster de banco de dados multi-AZ)
+ [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) (cluster de banco de dados multi-AZ)

O parâmetro `MonitoringInterval` especifica o intervalo, em segundos, entre pontos quando as métricas de monitoramento avançado são coletadas. Os valores válidos são `0`, `1`, `5`, `10`, `15`, `30` e `60`.

Para desativar o monitoramento aprimorado usando a API do RDS, defina `MonitoringInterval` como `0`.

## Proteção contra o problema do substituto confuso
<a name="USER_Monitoring.OS.confused-deputy"></a>

“Confused deputy” é um problema de segurança no qual uma entidade sem permissão para executar uma ação pode coagir uma entidade mais privilegiada a executá-la. Na AWS, a personificação entre serviços pode resultar no problema do ‘confused deputy’. A personificação entre serviços pode ocorrer quando um serviço (o *serviço de chamada*) chama outro serviço (o *serviço chamado*). O serviço de chamada pode ser manipulado de modo a usar suas permissões para atuar nos recursos de outro cliente de uma forma na qual ele não deveria ter permissão para acessar. Para evitar isso, a AWS fornece ferramentas que ajudam você a proteger seus dados para todos os serviços com entidades principais de serviço que receberam acesso aos recursos em sua conta. Para obter mais informações, consulte [O problema do substituto confuso](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html).

Para limitar as permissões ao recurso que o Amazon RDS pode fornecer a outro serviço, recomendamos usar as chaves de contexto de condição global `aws:SourceArn` e `aws:SourceAccount` em uma política de confiança para sua função de monitoramento aprimorado. Se você usar as duas chaves de contexto de condição global, elas deverão usar o mesmo ID de conta.

A maneira mais eficaz de se proteger contra o problema do substituto confuso é usar a chave de contexto de condição global `aws:SourceArn` com o ARN completo do recurso. Para o Amazon RDS, defina `aws:SourceArn` como `arn:aws:rds:Region:my-account-id:db:dbname`.

O exemplo a seguir usa as chaves de contexto de condição global `aws:SourceArn` e `aws:SourceAccount` em uma política de confiança para evitar o problema de substituto confuso.

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "monitoring.rds.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringLike": {
          "aws:SourceArn": "arn:aws:rds:Region:my-123456789012:db:dbname"
        },
        "StringEquals": {
          "aws:SourceAccount": "my-123456789012"
        }
      }
    }
  ]
}
```

------

# Como visualizar métricas do SO no console do RDS
<a name="USER_Monitoring.OS.Viewing"></a>

Você pode visualizar as métricas do sistema operacional informadas pelo Monitoramento avançado no console do RDS escolhendo a exibição **Enhanced monitoring (Monitoramento avançado)** para **Monitoring (Monitoramento)**.

O exemplo a seguir mostra a página Monitoramento avançado. Para ver as descrições das métricas do monitoramento avançado, consulte [Métricas do sistema operacional no monitoramento avançado](USER_Monitoring-Available-OS-Metrics.md).

![\[Visualização de painel\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/metrics1.png)


Algumas instâncias de banco de dados usam mais de um disco para o volume de armazenamento de dados da instância de banco de dados. Nessas instâncias de banco de dados, os gráficos **Physical Devices (Dispositivos físicos)** mostram métricas para cada um dos discos. Por exemplo, o gráfico a seguir mostra métricas para quatro discos.

![\[Gráfico com vários discos\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/enhanced-monitoring-multiple-disks.png)


**nota**  
Atualmente, gráficos **Physical Devices (Dispositivos físicos)** não estão disponíveis para instâncias de banco de dados do Microsoft SQL Server.

Quando você visualiza grafos **Sistema de arquivos** agregados, o dispositivo **rdsdbdata\$1** está relacionado ao sistema de arquivos `rdsfilesys/rdsdbdata*`, em que todos os arquivos e logs de bancos de dados são armazenados. O dispositivo **rootfilesys** está relacionado ao sistema de arquivos `/` (também conhecido como root), no qual os arquivos relacionados ao sistema operacional são armazenados. Quando você usar volumes de armazenamento adicionais, visualize as métricas de volume `rdsdbdata2`, `rdsdbdata3` e `rdsdbdata4` para obter informações específicas do volume.

Quando você está visualizando grafos agregados de **E/S de disco**, o dispositivo **rdsdbdata** está relacionado ao volume de armazenamento `/rdsdbdata` primário. Quando você usar volumes de armazenamento adicionais, visualize as métricas de volume `rdsdbdata2`, `rdsdbdata3` e `rdsdbdata4` para obter informações específicas do volume. O dispositivo filesystem está relacionado ao sistema de arquivos (também conhecido como root), no qual os arquivos relacionados ao sistema operacional são armazenados.

O nome do dispositivo **rdsdev** está obsoleto. O dispositivo **rdsdev** está relacionado apenas ao volume de armazenamento `/rdsdbdata` primário e não inclui métricas de volumes de armazenamento adicionais.

![\[Gráfico mostrando o uso do sistema de arquivos\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/enhanced-monitoring-filesystem.png)


Se a instância de banco de dados for uma implantação Multi-AZ, você poderá visualizar as métricas do sistema operacional para a instância de banco de dados primária e sua réplica em espera Multi-AZ. Na visualização **Enhanced monitoring (Monitoramento avançado)**, escolha **primary (primária)** para ver as métricas do sistema operacional para a instância de banco de dados primária ou escolha **secondary (secundária)** para ver as métricas do sistema operacional para a réplica de espera.

![\[Opção primária e secundária para Monitoramento aprimorado\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/enhanced-monitoring-primary-secondary.png)


Para obter mais informações sobre implantações Multi-AZ, consulte [Configurar e gerenciar uma implantação multi-AZ para o Amazon RDS](Concepts.MultiAZ.md).

**nota**  
No momento, a visualização de métricas do sistema operacional para uma réplica em espera multi-AZ não é compatível com instâncias de banco de dados do MariaDB.

Se quiser ver detalhes dos processos em execução na sua instância de banco de dados, escolha **OS process list (Lista de processos do SO)** para **Monitoring (Monitoramento)**.

A visualização **Process List (Lista de processos)** é mostrada a seguir.

![\[Visualização da lista de processos\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/metrics2.png)


As métricas de Monitoramento avançado mostradas na visualização **Process list (Lista de processos)** estão organizadas da seguinte forma:
+ **RDS child processes (Processos filho do RDS)** – mostra um resumo dos processos do RDS que oferecem suporte à instância de banco de dados, por exemplo, `mysqld` para instâncias de banco de dados MySQL. Os segmentos de processos aparecem aninhados abaixo do processo pai. Os threads de processos mostram a utilização da CPU apenas enquanto as outras métricas forem as mesmas para todos os threads do processo. O console exibe um máximo de 100 processos e threads. Os resultados são uma combinação dos principais processos e threads que consomem CPU e memória. Se houver mais de 50 processos e mais de 50 threads, o console exibirá os 50 melhores consumidores em cada categoria. Essa exibição ajuda a identificar quais processos estão tendo o maior impacto sobre a performance.
+ **RDS processes** (Processos do RDS): mostra um resumo dos recursos utilizados pelo agente de gerenciamento do RDS, processos de monitoramento de diagnóstico e outros processos da AWS necessários para dar suporte a instâncias de bancos de dados do RDS.
+ **OS processes (Processos do SO)** – Mostra um resumo dos processos de kernel e do sistema, que geralmente têm um impacto mínimo sobre a performance.

Os itens listados para cada processo são:
+ **VIRT** – Exibe o tamanho virtual do processo.
+ **RES** – Exibe a memória física real que está sendo usada pelo processo.
+ **CPU%** – exibe a porcentagem da largura de banda total da CPU que está sendo usada pelo processo.
+ **MEM%** – exibe a porcentagem da memória total que está sendo consumida pelo processo.

Os dados de monitoramento que são mostrados no console do RDS são recuperados do Amazon CloudWatch Logs. Você também pode recuperar as métricas para uma instância de banco de dados como um stream de log do CloudWatch Logs. Para obter mais informações, consulte [Visualizar métricas do SO usando CloudWatch Logs](USER_Monitoring.OS.CloudWatchLogs.md).

Métricas de Monitoramento avançado não são retornadas durante o seguinte: 
+ Um failover da instância de banco de dados.
+ Alteração da classe da instância de banco de dados (computação de escala).

As métricas de Monitoramento avançado são retornadas durante uma reinicialização de uma instância de banco de dados, pois somente o mecanismo do banco de dados é reinicializado. Métricas para o sistema operacional ainda serão informadas.

# Visualizar métricas do SO usando CloudWatch Logs
<a name="USER_Monitoring.OS.CloudWatchLogs"></a>

Depois de ativar o monitoramento avançado em sua instância de banco de dados ou cluster de banco de dados multi-AZ, você poderá exibir as respectivas métricas usando o CloudWatch Logs, com cada transmissão de log representando uma única instância ou cluster de banco de dados em monitoramento. O identificador da transmissão de log é o identificador de recurso (`DbiResourceId`) da instância ou cluster de banco de dados.

**Para visualizar os dados de log de Monitoramento avançado**

1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Se necessário, selecione a Região da AWS em que sua instância de banco de dados ou cluster de banco de dados multi-AZ está. Para obter mais informações, consulte [Regiões e endpoints do ](https://docs.aws.amazon.com/general/latest/gr/index.html?rande.html) na *Referência geral do Amazon Web Services*.

1. Escolha **Logs** no painel de navegação.

1. Escolha **RDSOSMetrics** na lista de grupos de log.

   Em uma implantação de instância de banco de dados multi-AZ, arquivos de log com `-secondary` anexado ao nome se referem à réplica em espera multi-AZ.  
![\[Arquivo de log de réplica em espera Multi-AZ\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/enhanced-monitoring-cloudwatch-secondary.png)

1. Escolha o stream de log que você deseja visualizar na lista de streams de log.

# Referência de métricas do Amazon RDS
<a name="metrics-reference"></a>

Nesta referência, você pode encontrar descrições de métricas do Amazon RDS referentes ao Amazon CloudWatch, Performance Insights e monitoramento avançado.

**Topics**
+ [Métricas do Amazon CloudWatch para o Amazon RDS](rds-metrics.md)
+ [Dimensões do Amazon CloudWatch para o Amazon RDS](dimensions.md)
+ [Métricas do Amazon CloudWatch para Insights de Performance do Amazon RDS](USER_PerfInsights.Cloudwatch.md)
+ [Métricas de contadores do Performance Insights](USER_PerfInsights_Counters.md)
+ [Estatísticas SQL para Performance Insights](sql-statistics.md)
+ [Métricas do sistema operacional no monitoramento avançado](USER_Monitoring-Available-OS-Metrics.md)

# Métricas do Amazon CloudWatch para o Amazon RDS
<a name="rds-metrics"></a>

As métricas do Amazon CloudWatch fornecem insights sobre o desempenho e a integridade de instâncias e clusters do Amazon RDS, permitindo monitorar o comportamento do sistema e tomar decisões baseadas em dados. Essas métricas ajudam a monitorar a utilização de recursos, a atividade do banco de dados e a eficiência operacional, oferecendo visibilidade sobre o desempenho das instâncias. 

Essa referência descreve as métricas específicas disponíveis para o Amazon RDS e explica como interpretá-las e usá-las para otimizar o desempenho do banco de dados, solucionar problemas e garantir alta disponibilidade.

O Amazon RDS publica métricas para o Amazon CloudWatch nos namespaces `AWS/RDS` e `AWS/Usage`.

**Topics**
+ [Métricas específicas da instância do Amazon CloudWatch para Amazon RDS](#rds-cw-metrics-instance)
+ [Métricas de uso do Amazon CloudWatch para Amazon RDS](#rds-metrics-usage)

## Métricas específicas da instância do Amazon CloudWatch para Amazon RDS
<a name="rds-cw-metrics-instance"></a>

O namespace `AWS/RDS` no Amazon CloudWatch inclui as métricas específicas de instância a seguir.

**nota**  
O console do Amazon RDS pode exibir métricas em unidades diferentes das unidades enviadas para o Amazon CloudWatch. Por exemplo, o console do Amazon RDS pode exibir uma métrica em megabytes (MB), enquanto a métrica é enviada para o Amazon CloudWatch em bytes.


| Métrica | Descrição | Aplica-se a | Unidades | 
| --- | --- | --- | --- | 
| `BinLogDiskUsage` |  A quantidade de espaço em disco ocupada por logs binários. Se backups automáticos estiverem habilitados para instâncias MySQL e MariaDB, incluindo réplicas de leitura, serão criados logs binários.  |  MariaDB MySQL  |  Bytes  | 
| `BurstBalance` |  A porcentagem de créditos de E/S em burst-bucket SSD de finalidade geral (gp2) disponível.   |  Todos  |  Percentual  | 
| `CheckpointLag` |  A quantidade de tempo desde o ponto de verificação mais recente.  |    |  Segundos  | 
|  `ConnectionAttempts`  |  O número de tentativas de conexão com uma instância, sejam elas bem-sucedidas ou não.  |  MySQL  |  Contagem  | 
| `CPUUtilization` |  O percentual de utilização da CPU.  |  Todos  |  Percentual  | 
| `CPUCreditUsage` | O número de créditos de CPU gastos pela instância por utilização de CPU. Um crédito de CPU é igual a um vCPU em execução com 100% de utilização por um minuto ou uma combinação equivalente de vCPUs, utilização e tempo. Por exemplo, talvez você tenha uma vCPU em execução com 50% de utilização por dois minutos ou duas vCPUs em execução com 25% de utilização por dois minutos.Essa métrica se aplica apenas às instâncias db.t2, db.t3 e db.t4g. Recomendamos usar as classes de instância de banco de dados T somente para servidores de desenvolvimento e teste, ou outros servidores que não sejam de produção. Para ter mais detalhes sobre as classes de instâncias T, consulte [Tipos de classe de instância de banco de dados](Concepts.DBInstanceClass.Types.md). As métricas de crédito de CPU estão disponíveis a uma frequência de apenas 5 minutos. Se você especificar um período de mais cinco minutos, use a estatística `Sum` em vez da estatística `Average`. |    |  Créditos (minutos de vCPU)  | 
| `CPUCreditBalance` | O número de créditos ganhos de CPU que uma instância acumulou desde que foi executada ou iniciada. Para a T2 Padrão, o `CPUCreditBalance` também inclui o número de créditos de execução que foram acumulados.Os créditos são acumulados no saldo de créditos após terem sido ganhos e são removidos do saldo de créditos quando são gastos. O saldo de crédito tem um limite máximo, determinado pelo tamanho da instância. Depois que o limite for atingido, todos os novos créditos ganhos serão descartados. Para a T2 Padrão, os créditos de execução não são contabilizados para o limite.Os créditos do `CPUCreditBalance` são disponibilizados para que a instância gaste e apresente intermitência com uma utilização de CPU acima da linha de base.Quando uma instância está em execução, os créditos do `CPUCreditBalance` não expiram. Quando a instância para, o `CPUCreditBalance` não persiste, e todos os créditos acumulados são perdidos.As métricas de crédito de CPU estão disponíveis a uma frequência de apenas 5 minutos.Essa métrica se aplica apenas às instâncias db.t2, db.t3 e db.t4g. Recomendamos usar as classes de instância de banco de dados T somente para servidores de desenvolvimento e teste, ou outros servidores que não sejam de produção. Para ter mais detalhes sobre as classes de instâncias T, consulte [Tipos de classe de instância de banco de dados](Concepts.DBInstanceClass.Types.md). Os créditos de execução funcionam da mesma forma no Amazon RDS e no Amazon EC2. Para ter mais informações, consulte [Créditos de execução](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-standard-mode-concepts.html#launch-credits) no *Guia do usuário do Amazon Elastic Compute Cloud para instâncias do Linux*. |    |  Créditos (minutos de vCPU)  | 
| `CPUSurplusCreditBalance` |  O número de créditos excedentes gastos por uma instância ilimitada quando seu valor `CPUCreditBalance` é zero. O valor `CPUSurplusCreditBalance` é pago pelos créditos de CPU ganhos. Se o número de créditos excedentes ultrapassar o número máximo de créditos que a instância pode ganhar em um período de 24 horas, os créditos excedentes gastos acima do limite máximo incorrerão em uma taxa adicional. As métricas de crédito de CPU estão disponíveis apenas a uma frequência de 5 minutos.   |  Todos  |  Créditos (minutos de vCPU)   | 
| `CPUSurplusCreditsCharged` |  O número de créditos excedentes gastos que não são pagos pelos créditos de CPU ganhos e que, portanto, incorrem em uma cobrança adicional. Os créditos excedentes gastos são cobrados quando uma das seguintes situações ocorre: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/rds-metrics.html) As métricas de crédito de CPU estão disponíveis apenas a uma frequência de 5 minutos.   |  Todos  |  Créditos (minutos de vCPU)  | 
| `DatabaseConnections` |  O número de conexões de rede cliente com a instância do banco de dados. O número de sessões de banco de dados pode ser maior que o valor da métrica porque o valor da métrica não inclui o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/rds-metrics.html)  |  Todos  |  Contagem  | 
| `DiskQueueDepth` |  O número de E/Ss (solicitações de leitura/gravação) pendentes aguardando para acessar o disco.  |  Todos  |  Contagem  | 
| `DiskQueueDepthLogVolume` |  O número de E/Ss (solicitações de leitura/gravação) pendentes aguardando para acessar o disco.  |  Instâncias de banco de dados com [volume de log dedicado](USER_PIOPS.dlv.md) habilitado  |  Contagem  | 
| `EBSByteBalance%` |  A porcentagem de créditos de taxa de transferência restantes no bucket de intermitência do seu banco de dados do RDS. Essa métrica está disponível somente para monitoramento básico.  O valor da métrica é baseado no throughput e nas IOPS de todos os volumes, inclusive o volume raiz, em vez de apenas nos volumes que contêm arquivos de banco de dados. Para localizar os tamanhos de instância compatíveis com essa métrica, consulte os tamanhos de instância com um asterisco (\$1) na tabela [Otimizadas para EBS por padrão](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-optimized.html#current) no *Guia do usuário do Amazon EC2*. A estatística `Sum` não é aplicável a essa métrica.  |  Todos  |  Percentual  | 
| `EBSIOBalance%` |  A porcentagem de créditos de E/S restantes no bucket de intermitência do seu banco de dados do RDS. Essa métrica está disponível somente para monitoramento básico. O valor da métrica é baseado no throughput e nas IOPS de todos os volumes, inclusive o volume raiz, em vez de apenas nos volumes que contêm arquivos de banco de dados. Para localizar os tamanhos de instância que comportam essa métrica, consulte [Amazon EBS–optimized instance types](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-optimized.html) no *Guia do usuário do Amazon EC2*. A estatística `Sum` não é aplicável a essa métrica. Esta métrica é diferente de `BurstBalance`. Para saber como usar essa métrica, consulte [Melhorar a performance das aplicações e reduzir custos com o recurso de intermitência de instâncias otimizadas para Amazon EBS](https://aws.amazon.com/blogs/compute/improving-application-performance-and-reducing-costs-with-amazon-ebs-optimized-instance-burst-capability/).   |  Todos  |  Percentual  | 
| `FailedSQLServerAgentJobsCount` |  O número de trabalhos do Microsoft SQL Server Agent durante o último minuto.  |  Microsoft SQL Server  |  Contagem a cada minuto  | 
| `FreeableMemory` |  A quantidade de memória de acesso aleatório disponível. Para instâncias de banco de dados MariaDB, MySQL, Oracle e PostgreSQL, essa métrica reporta o valor do campo `MemAvailable` de `/proc/meminfo`.   |  Todos  |  Bytes  | 
| `FreeLocalStorage` |  A quantidade de espaço de armazenamento local disponível. Essa métrica só se aplica a classes de instância de banco de dados com volumes de armazenamento de instância SSD de NVMe. Para obter informações sobre instâncias do Amazon EC2 com volumes de armazenamento de instância SSD de NVMe, consulte [Volumes de armazenamento de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes). As classes de instância de banco de dados RDS equivalentes têm os mesmos volumes de armazenamento de instância. Por exemplo, as classes de instância de banco de dados db.m6gd e db.r6gd têm volumes de armazenamento de instância SSD de NVMe.  |    |  Bytes  | 
| `FreeLocalStoragePercent` |  A porcentagem de espaço de armazenamento local disponível. Essa métrica só se aplica a classes de instância de banco de dados com volumes de armazenamento de instância SSD de NVMe. Para obter informações sobre instâncias do Amazon EC2 com volumes de armazenamento de instância SSD de NVMe, consulte [Volumes de armazenamento de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes). As classes de instância de banco de dados RDS equivalentes têm os mesmos volumes de armazenamento de instância. Por exemplo, as classes de instância de banco de dados db.m6gd e db.r6gd têm volumes de armazenamento de instância SSD de NVMe.  |    |  Percentual  | 
| `FreeStorageSpace` |  A quantidade de espaço de armazenamento disponível.   |  Todos  |  Bytes  | 
| `FreeStorageSpaceLogVolume` |  A quantidade de espaço de armazenamento disponível.  |  Instâncias de banco de dados com [volume de log dedicado](USER_PIOPS.dlv.md) habilitado  |  Bytes  | 
| `IamDbAuthConnectionRequests` |  O número de solicitações de conexão usando autenticação do IAM para a instância de banco de dados.  |  Todos  |  Contagem  | 
| `MaximumUsedTransactionIDs` |  Os IDs máximos de transação que foram usados.  |  PostgreSQL  |  Contagem  | 
| `NetworkReceiveThroughput` |  O tráfego de rede de entrada (recebido) na instância de banco de dados, incluindo o tráfego de banco de dados do cliente e o tráfego do Amazon RDS usado para monitoramento e replicação.  |  Todos  |  Bytes por segundo  | 
| `NetworkTransmitThroughput` |  O tráfego de rede de saída (transmitido) na instância de banco de dados, incluindo o tráfego de banco de dados do cliente e o tráfego do Amazon RDS usado para monitoramento e replicação.  |  Todos  |  Bytes por segundo  | 
| `OldestLogicalReplicationSlotLag` |  O tamanho do atraso do Amazon RDS é a diferença entre o momento em que uma transação é confirmada no banco de dados de origem e o momento em que o RDS aplica a transação no banco de dados de réplica.  |  PostgreSQL  |  Bytes  | 
| `OldestReplicationSlotLag` |  O tamanho do atraso da réplica que demora mais em termos de dados de log com gravação antecipada (WAL) recebidos.  |  PostgreSQL  |  Bytes  | 
| `ReadIOPS` |  O número médio de operações E/S de leitura de disco por segundo.   |  Todos  |  Contagem por segundo  | 
| `ReadIOPSLocalStorage` |  O número médio de operações de E/S de leitura de disco no armazenamento local por segundo. Essa métrica só se aplica a classes de instância de banco de dados com volumes de armazenamento de instância SSD de NVMe. Para obter informações sobre instâncias do Amazon EC2 com volumes de armazenamento de instância SSD de NVMe, consulte [Volumes de armazenamento de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes). As classes de instância de banco de dados RDS equivalentes têm os mesmos volumes de armazenamento de instância. Por exemplo, as classes de instância de banco de dados db.m6gd e db.r6gd têm volumes de armazenamento de instância SSD de NVMe.  |    |  Contagem por segundo  | 
| `ReadIOPSLogVolume` |  O número médio de operações E/S de leitura de disco por segundo.  |  Instâncias de banco de dados com [volume de log dedicado](USER_PIOPS.dlv.md) habilitado  |  Contagem por segundo  | 
| `ReadLatency` |  O tempo médio necessário por operação de E/S de disco.   |  Todos  |  Segundos  | 
| `ReadLatencyLocalStorage` |  O tempo médio necessário por operação de I/O de disco para armazenamento local. Essa métrica só se aplica a classes de instância de banco de dados com volumes de armazenamento de instância SSD de NVMe. Para obter informações sobre instâncias do Amazon EC2 com volumes de armazenamento de instância SSD de NVMe, consulte [Volumes de armazenamento de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes). As classes de instância de banco de dados RDS equivalentes têm os mesmos volumes de armazenamento de instância. Por exemplo, as classes de instância de banco de dados db.m6gd e db.r6gd têm volumes de armazenamento de instância SSD de NVMe.  |    |  Segundos  | 
| `ReadLatencyLogVolume` |  O tempo médio necessário por operação de E/S de disco.  |  Instâncias de banco de dados com [volume de log dedicado](USER_PIOPS.dlv.md) habilitado  |  Segundos  | 
| `ReadThroughput` |  O número médio de bytes lidos do disco por segundo.   |  Todos  |  Bytes por segundo  | 
| `ReadThroughputLocalStorage` |  O número médio de bytes lidos do disco por segundo para armazenamento local. Essa métrica só se aplica a classes de instância de banco de dados com volumes de armazenamento de instância SSD de NVMe. Para obter informações sobre instâncias do Amazon EC2 com volumes de armazenamento de instância SSD de NVMe, consulte [Volumes de armazenamento de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes). As classes de instância de banco de dados RDS equivalentes têm os mesmos volumes de armazenamento de instância. Por exemplo, as classes de instância de banco de dados db.m6gd e db.r6gd têm volumes de armazenamento de instância SSD de NVMe.  |    |  Bytes por segundo  | 
| `ReadThroughputLogVolume` |  O número médio de bytes lidos do disco por segundo.  |  Instâncias de banco de dados com [volume de log dedicado](USER_PIOPS.dlv.md) habilitado  |  Bytes por segundo  | 
| `ReplicaLag` |  Em relação às configurações de réplicas de leitura, a quantidade de tempo que uma instância de banco de dados de réplica de leitura atrasa em relação à instância de banco de dados de origem. Aplica-se a réplicas de leitura do MySQL, MariaDB, Oracle, PostgreSQL e SQL Server. Em relação aos clusters de banco de dados multi-AZ, a diferença de tempo entre a transação mais recente na instância de banco de dados de gravador e a transação aplicada mais recente em uma instância de banco de dados de leitor.  |    |  Segundos  | 
| `ReplicationChannelLag` |  Em relação às configurações de réplicas de várias origens, a quantidade de tempo que um canal específico na réplica de várias origens atrasa em relação à origem da instância de banco de dados. Para obter mais informações, consulte [Monitorar canais de replicação de várias fontes](mysql-multi-source-replication.md#mysql-multi-source-replication-monitoring).  |  MySQL  |  Segundos  | 
| `ReplicationSlotDiskUsage` |  O espaço em disco usado por arquivos de slot de replicação.  |  PostgreSQL  |  Bytes  | 
| `SwapUsage` |  A quantidade de troca usada na instância de banco de dados.  |  MariaDB MySQL Oracle PostgreSQL  |  Bytes  | 
| `TempDbAvailableDataSpace` |  A quantidade de espaço de dados disponível no tempdb e no volume em que o tempdb está localizado. Use essa métrica para monitorar a disponibilidade de espaço de dados do tempdb e planejar a capacidade adequadamente. Valores baixos podem indicar a necessidade de aumentar o armazenamento ou otimizar consultas que usam muito o tempdb.  | SQL Server | Bytes | 
| `TempDbAvailableLogSpace` |  A quantidade de espaço de log disponível no tempdb e no volume em que o tempdb está localizado. Use essa métrica para monitorar a disponibilidade de espaço de log do tempdb e evitar condições de log de transações cheio. Essencial para workloads com transações grandes ou alta simultaneidade que geram atividade de log significativa.  | SQL Server | Bytes | 
| `TempDbDataFileUsage` |  A porcentagem de arquivos de dados usados no tempdb. Essa métrica não leva em conta a possibilidade de crescimento de arquivos. Use essa métrica para monitorar a utilização do arquivo de dados do tempdb e identificar possíveis gargalos de desempenho. Valores altos podem indicar a necessidade de otimizar consultas que criam grandes objetos temporários ou de aumentar o tamanho do tempdb.  | SQL Server | Percentual | 
| `TempDbLogFileUsage` |  A porcentagem de arquivos de log usados no tempdb. Essa métrica não leva em conta a possibilidade de crescimento de arquivos. Use essa métrica para monitorar a utilização do arquivo de log do tempdb e evitar problemas de desempenho. Valores altos podem indicar transações de longa duração ou atividade excessiva de registro em log que podem afetar o desempenho geral do banco de dados.  | SQL Server | Percentual | 
| `TransactionLogsDiskUsage` |  O espaço em disco usado por logs de transação.  |  PostgreSQL  |  Bytes  | 
| `TransactionLogsGeneration` |  O tamanho dos logs de transação gerados por segundo.  |  PostgreSQL  |  Bytes por segundo  | 
| `WriteIOPS` |  O número médio de operações de E/S de gravação de disco por segundo.   |  Todos  |  Contagem por segundo  | 
| `WriteIOPSLocalStorage` |  O número médio de operações de E/S de gravação de disco por segundo no armazenamento local. Essa métrica só se aplica a classes de instância de banco de dados com volumes de armazenamento de instância SSD de NVMe. Para obter informações sobre instâncias do Amazon EC2 com volumes de armazenamento de instância SSD de NVMe, consulte [Volumes de armazenamento de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes). As classes de instância de banco de dados RDS equivalentes têm os mesmos volumes de armazenamento de instância. Por exemplo, as classes de instância de banco de dados db.m6gd e db.r6gd têm volumes de armazenamento de instância SSD de NVMe.  |    |  Contagem por segundo  | 
| `WriteIOPSLogVolume` |  O número médio de operações de E/S de gravação de disco por segundo.  |  Instâncias de banco de dados com [volume de log dedicado](USER_PIOPS.dlv.md) habilitado  |  Contagem por segundo  | 
| `WriteLatency` |  O tempo médio necessário por operação de E/S de disco.   |  Todos  |  Segundos  | 
| `WriteLatencyLocalStorage` |  O tempo médio necessário por operação de E/S de disco no armazenamento local. Essa métrica só se aplica a classes de instância de banco de dados com volumes de armazenamento de instância SSD de NVMe. Para obter informações sobre instâncias do Amazon EC2 com volumes de armazenamento de instância SSD de NVMe, consulte [Volumes de armazenamento de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes). As classes de instância de banco de dados RDS equivalentes têm os mesmos volumes de armazenamento de instância. Por exemplo, as classes de instância de banco de dados db.m6gd e db.r6gd têm volumes de armazenamento de instância SSD de NVMe.  |    |  Segundos  | 
| `WriteLatencyLogVolume` |  O tempo médio necessário por operação de E/S de disco.  |  Instâncias de banco de dados com [volume de log dedicado](USER_PIOPS.dlv.md) habilitado  |  Segundos  | 
| `WriteThroughput` |  O número médio de bytes gravados no disco por segundo.  |  Todos  |  Bytes por segundo  | 
| `WriteThroughputLogVolume` |  O número médio de bytes gravados no disco por segundo.  |  Instâncias de banco de dados com [volume de log dedicado](USER_PIOPS.dlv.md) habilitado  |  Bytes por segundo  | 
| `WriteThroughputLocalStorage` |  O número médio de bytes gravados no disco por segundo para o armazenamento local. Essa métrica só se aplica a classes de instância de banco de dados com volumes de armazenamento de instância SSD de NVMe. Para obter informações sobre instâncias do Amazon EC2 com volumes de armazenamento de instância SSD de NVMe, consulte [Volumes de armazenamento de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes). As classes de instância de banco de dados RDS equivalentes têm os mesmos volumes de armazenamento de instância. Por exemplo, as classes de instância de banco de dados db.m6gd e db.r6gd têm volumes de armazenamento de instância SSD de NVMe.  |    |  Bytes por segundo  | 

## Métricas de uso do Amazon CloudWatch para Amazon RDS
<a name="rds-metrics-usage"></a>

O namespace `AWS/Usage` no Amazon CloudWatch inclui métricas de uso específico da conta para suas cotas de serviço do Amazon RDS. O CloudWatch coleta métricas de uso automaticamente para todas as Regiões da AWS.

Para ter mais informações, consulte [Métricas de uso do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Usage-Metrics.html) no *Guia do usuário do Amazon CloudWatch*. Para ter mais informações sobre cotas, consulte [Cotas e restrições do Amazon RDS](CHAP_Limits.md) e [Solicitar um aumento da cota](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) no *Guia do usuário do Service Quotas*.


| Métrica | Descrição | Unidades\$1 | 
| --- | --- | --- | 
| AllocatedStorage |  O armazenamento total para todas as instâncias de banco de dados A soma exclui instâncias de migração temporária.  |  Gigabytes  | 
| AuthorizationsPerDBSecurityGroup |  O número de regras de entrada por grupo de segurança do banco de dados na sua Conta da AWS. O valor usado é o maior número de regras de entrada em um grupo de segurança de banco de dados na conta. Outros grupos de segurança de banco de dados na conta podem ter um número menor de regras de entrada.  |  Contagem  | 
| CustomEndpointsPerDBCluster |  O número de endpoints personalizados por cluster de banco de dados na sua Conta da AWS. O valor usado é o maior número de endpoints personalizados em um cluster de banco de dados na conta. Outros clusters de banco de dados na conta podem ter um número menor de endpoints personalizados.  |  Contagem  | 
| CustomEngineVersions |  O número de versões personalizadas do mecanismo (CEVs) para o Amazon RDS Custom na sua Conta da AWS.  |  Contagem  | 
| DBClusterParameterGroups |  O número máximo de grupos de parâmetros de cluster de banco de dados em sua Conta da AWS. A contagem exclui grupos de parâmetros padrão.  |  Contagem  | 
| DBClusterRoles |  O número de perfis do AWS Identity and Access Management (IAM) associados por cluster de banco de dados na sua Conta da AWS. O valor usado é o maior número de perfis do IAM associadas a um cluster de banco de dados na conta. Outros clusters de banco de dados na conta podem ter um número menor de perfis do IAM associados.  |  Contagem  | 
| DBClusters |  O número de clusters de banco de dados do Amazon Aurora em sua Conta da AWS.  |  Contagem  | 
| DBInstanceRoles |  O número de perfis do AWS Identity and Access Management (IAM) associados por instância de banco de dados na sua Conta da AWS. O valor usado é o maior número de perfis do IAM associadas a uma instância de banco de dados na conta. Outras instâncias de banco de dados na conta podem ter um número menor de perfis do IAM associados.  |  Contagem  | 
| DBInstances |  O número de instâncias de banco de dados em sua Conta da AWS.  |  Contagem  | 
| DBParameterGroups |  O número de grupos de parâmetros de banco de dados em sua Conta da AWS. A contagem exclui grupos de parâmetros de banco de dados padrão.  |  Contagem  | 
| DBSecurityGroups |  O número de grupos de segurança em sua Conta da AWS. A contagem exclui o grupo de segurança padrão e o da VPC padrão.  |  Contagem  | 
| DBSubnetGroups  |  O número de grupos de sub-redes de banco de dados em sua Conta da AWS. A contagem exclui o grupo de sub-redes padrão.  |  Contagem  | 
| EventSubscriptions | O número de assinaturas de notificação de eventos em sua Conta da AWS. | Contagem | 
| Integrations | O número de Integrações ETL zero com o Amazon Redshift em sua Conta da AWS. | Contagem | 
| ManualClusterSnapshots |  O número de snapshots de cluster de banco de dados criados manualmente em sua Conta da AWS. A contagem exclui snapshots inválidos.  |  Contagem  | 
| ManualSnapshots |  O número de snapshots de banco de dados criados manualmente em sua Conta da AWS. A contagem exclui snapshots inválidos.  |  Contagem  | 
| OptionGroups |  O número de grupos de opções em sua Conta da AWS. A contagem exclui os grupo de opções padrão.  |  Contagem  | 
| Proxies |  O número de proxies do RDS na sua conta da AWS.  |  Contagem  | 
| ReadReplicasPerMaster |  O número de réplicas de leitura por instância de banco de dados na sua conta. O valor usado é o maior número de réplicas de leitura para uma instância de banco de dados na conta. Outras instâncias de banco de dados na conta podem ter um número menor de réplicas de leitura.  |  Contagem  | 
| ReservedDBInstances |  O número de instâncias de banco de dados reservadas em sua Conta da AWS. A contagem exclui instâncias desativadas ou recusadas.  |  Contagem  | 
| SubnetsPerDBSubnetGroup |  O número de sub-redes para por grupo de sub-redes de banco de dados na sua Conta da AWS. O número máximo de sub-redes para um grupo de sub-redes de banco de dados na conta. Outros grupos de sub-redes de banco de dados na conta podem ter um número menor de sub-redes.  |  Contagem  | 

**nota**  
O Amazon RDS não publica unidades para métricas de uso no CloudWatch. As unidades só aparecem na documentação.

# Dimensões do Amazon CloudWatch para o Amazon RDS
<a name="dimensions"></a>

Você pode filtrar dados de métricas do Amazon RDSmétricas usando qualquer dimensão na tabela a seguir.


|  Dimensão  |  Filtra os dados solicitados para . . .  | 
| --- | --- | 
|  DBInstanceIdentifier  |  Uma instância específica de banco de dados.  | 
|  DatabaseClass  |  Todas as instâncias em uma classe de banco de dados. Por exemplo, você pode agregar métricas para todas as instâncias que pertencem à classe do banco de dado `db.r5.large`.  | 
|  EngineName  |  Apenas o nome do motor identificado. Por exemplo, você pode agrupar métricas para todas as instâncias que têm o nome de mecanismo `postgres`.  | 
|  SourceRegion  |  Apenas a região especificada. Por exemplo, você pode agregar métricas de todas as instâncias de Bancos de Dados na região `us-east-1`.  | 
|  DbInstanceIdentifier, VolumeName  |  As métricas por volume para uma única instância. O RDS captura métricas para vários volumes de armazenamento.  | 

**nota**  
Se você estiver usando volumes de armazenamento adicionais, poderá ver as métricas de armazenamento agregado sob a dimensão `DBInstanceIdentifier`. Para ver as métricas de armazenamento por volume, use as dimensões `DbInstanceIdentifier, VolumeName`.

# Métricas do Amazon CloudWatch para Insights de Performance do Amazon RDS
<a name="USER_PerfInsights.Cloudwatch"></a>

O Insights de Performance publica automaticamente algumas métricas no Amazon CloudWatch. Os mesmos dados podem ser consultados do Performance Insights, mas ter as métricas no CloudWatch facilita a adição de alarmes do CloudWatch. Também facilita a adição de métricas aos painéis do CloudWatch existentes.


| Métrica | Descrição | 
| --- | --- | 
|  DBLoad  |  O número de sessões ativas para o banco de dados. Normalmente, você deseja os dados para o número médio de sessões ativas. No Performance Insights, esses dados são consultados como `db.load.avg`.  | 
|  DBLoadCPU  |  O número de sessões ativas em que o tipo do evento de espera é CPU. No Performance Insights, esses dados são consultados como `db.load.avg`, filtrados pelo tipo de evento de espera `CPU`.  | 
|  DBLoadNonCPU  |  O número de sessões ativas em que o tipo do evento de espera não é CPU.  | 
| DBLoadRelativeToNumVCPUs |  A proporção entre a carga de banco de dados e o número de CPUs virtuais para o banco de dados.  | 

**nota**  
Essas métricas serão publicadas no CloudWatch somente se houver carga na instância de banco de dados.

Você pode examinar essas métricas usando o console do CloudWatch, a AWS CLI ou a API do CloudWatch. Você também pode examinar outras métricas de contador do Insights de Performance usando uma função matemática de métrica especial. Para obter mais informações, consulte [Consultar outras métricas de contadores do Insights de Performance no CloudWatch](#USER_PerfInsights.Cloudwatch.ExtraMetrics).

Por exemplo, você pode obter as estatísticas da métrica `DBLoad` executando o comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html).

```
aws cloudwatch get-metric-statistics \
    --region us-west-2 \
    --namespace AWS/RDS \
    --metric-name DBLoad  \
    --period 60 \
    --statistics Average \
    --start-time 1532035185 \
    --end-time 1532036185 \
    --dimensions Name=DBInstanceIdentifier,Value=db-loadtest-0
```

Este exemplo gera uma saída semelhante à seguinte.

```
{
		"Datapoints": [
		{
		"Timestamp": "2021-07-19T21:30:00Z",
		"Unit": "None",
		"Average": 2.1
		},
		{
		"Timestamp": "2021-07-19T21:34:00Z",
		"Unit": "None",
		"Average": 1.7
		},
		{
		"Timestamp": "2021-07-19T21:35:00Z",
		"Unit": "None",
		"Average": 2.8
		},
		{
		"Timestamp": "2021-07-19T21:31:00Z",
		"Unit": "None",
		"Average": 1.5
		},
		{
		"Timestamp": "2021-07-19T21:32:00Z",
		"Unit": "None",
		"Average": 1.8
		},
		{
		"Timestamp": "2021-07-19T21:29:00Z",
		"Unit": "None",
		"Average": 3.0
		},
		{
		"Timestamp": "2021-07-19T21:33:00Z",
		"Unit": "None",
		"Average": 2.4
		}
		],
		"Label": "DBLoad"
		}
```

Para obter mais informações sobre o CloudWatch, consulte [O que é o Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) no *Guia do usuário do Amazon CloudWatch*. 

## Consultar outras métricas de contadores do Insights de Performance no CloudWatch
<a name="USER_PerfInsights.Cloudwatch.ExtraMetrics"></a>

**nota**  
Se você habilitar o modo Avançado do Database Insights, o Amazon RDS publicará métricas de contador do Insights de Performance no Amazon CloudWatch. Com o Database Insights, você não precisa usar a função de matemática métrica `DB_PERF_INSIGHTS`. Você pode usar o painel do CloudWatch Database Insights para pesquisar, consultar e definir alarmes para métricas de contador do Insights de Performance.

É possível consultar, emitir alarmes e criar grafos sobre as métricas do Insights de Performance do RDS pelo CloudWatch. Você pode acessar informações sobre a instância de banco de dados usando a função matemática de métrica `DB_PERF_INSIGHTS` do CloudWatch. Essa função permite que você use as métricas do Insights de Performance que não são diretamente informadas ao CloudWatch para criar uma série temporal.

É possível usar a nova função matemática de métrica clicando no menu suspenso **Adicionar matemática** na tela **Selecionar métrica** no console do CloudWatch. Você pode usá-lo para criar alarmes e grafos sobre as métricas do Insights de Performance ou sobre combinações das métricas do CloudWatch e do Insights de Performance, incluindo alarmes de alta resolução para métricas abaixo de um minuto. Também é possível usar a função programaticamente incluindo a expressão matemática de métrica em uma solicitação [https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html). Consulte mais informações em [Metric math syntax and functions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax-functions-list) e [Create an alarm on Performance Insights counter metrics from an AWS database](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarm_database_performance_insights.html).

# Métricas de contadores do Performance Insights
<a name="USER_PerfInsights_Counters"></a>

Métricas de contador são métricas de performance do sistema operacional e do banco de dados no painel do Performance Insights. Para ajudar a identificar e analisar problemas de performance, é possível correlacionar métricas de contadores com a carga de banco de dados. Você deve adicionar uma função estatística à métrica para obter os valores métricos. Por exemplo, as funções compatíveis com a métrica `os.memory.active` são `.avg`, `.min`, `.max`, `.sum` e `.sample_count`. 

As métricas do contador são coletadas uma vez por minuto. A coleta de métricas do sistema operacional depende do status do recurso Monitoramento Avançado. Se o recurso estiver desativado, as métricas do sistema operacional serão coletadas uma vez por minuto. Se o recurso estiver ativado, as métricas do sistema operacional serão coletadas para o período selecionado. Para obter mais informações sobre como ativar ou desativar o recurso Monitoramento Avançado, consulte [Ativar e desativar o monitoramento aprimorado](USER_Monitoring.OS.Enabling.md#USER_Monitoring.OS.Enabling.Procedure).

**Topics**
+ [Contadores de sistema operacional do Performance Insights](#USER_PerfInsights_Counters.OS)
+ [Contadores do Performance Insights para o Amazon RDS para MariaDB e MySQL](#USER_PerfInsights_Counters.MySQL)
+ [Contadores do Performance Insights para o Amazon RDS para Microsoft SQL Server](#USER_PerfInsights_Counters.SQLServer)
+ [Contadores do Performance Insights para o Amazon RDS para Oracle](#USER_PerfInsights_Counters.Oracle)
+ [Contadores do Performance Insights para o Amazon RDS para PostgreSQL](#USER_PerfInsights_Counters.PostgreSQL)

## Contadores de sistema operacional do Performance Insights
<a name="USER_PerfInsights_Counters.OS"></a>

Os contadores de sistema operacional a seguir, que são prefixados com `os`, estão disponíveis para o recurso Insights de Performance em todos os mecanismos do RDS, exceto o RDS para SQL Server.

Você pode usar a API `ListAvailableResourceMetrics` para obter a lista de métricas de contador disponíveis para sua instância de banco de dados. Para obter mais informações, consulte [ListAvailableResourceMetrics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics) no Guia de referência de API do Insights de Performance do Amazon RDS.


| Contador | Type | Unidade | Métrica | Descrição | 
| --- | --- | --- | --- | --- | 
| Ativo | Memória | Kilobytes | os.memory.active | A quantidade de memória atribuída, em kilobytes. | 
| Buffers | Memória | Kilobytes | os.memory.buffers | A quantidade de memória usada para o buffer de solicitações de E/S antes de gravar no dispositivo de armazenamento, em kilobytes. | 
| Em cache | Memória | Kilobytes | os.memory.cached | A quantidade de memória utilizada para o armazenamento em cache da E/S baseada em sistema de arquivos, em quilobytes. | 
| Cache de banco de dados | Memória | Bytes | os.memory.db.cache |  A quantidade de memória usada para o cache de páginas por processo de banco de dados, incluindo tmpfs (shmem), em bytes.  | 
| Tamanho do conjunto residente de banco de dados | Memória | Bytes | os.memory.db.residentSetSize |  A quantidade de memória usada para o cache anônimo e swap por processo de banco de dados, sem incluir tmpfs (shmem), em bytes.  | 
| Swap de banco de dados | Memória | Bytes | os.memory.db.swap |   A quantidade de memória usada para swap por processo de banco de dados, em bytes.  | 
| Sujeira | Memória | Kilobytes | os.memory.dirty | A quantidade de páginas de memória na RAM que foram modificadas, mas não gravadas nos blocos de dados relacionados no armazenamento, em kilobytes. | 
| Gratuito | Memória | Kilobytes | os.memory.free | A quantidade de memória não atribuída, em kilobytes. | 
| Páginas enormes livres | Memória | Páginas | os.memory.hugePagesFree | O número de páginas enormes livres. Páginas enormes são um recurso do kernel do Linux. | 
| Páginas enormes reservadas | Memória | Páginas | os.memory.hugePagesRsvd | O número de páginas enormes confirmadas. | 
| Tamanho de páginas enormes | Memória | Kilobytes | os.memory.hugePagesSize | O tamanho de cada unidade de páginas enormes, em kilobytes. | 
| Páginas enormes surp | Memória | Páginas | os.memory.hugePagesSurp | O número de páginas enormes excedentes disponíveis em comparação com o total. | 
| Total de páginas enormes | Memória | Páginas | os.memory.hugePagesTotal | O número total de páginas enormes. | 
| Inativo | Memória | Kilobytes | os.memory.inactive | A quantidade de páginas de memória usadas com menos frequência, em kilobytes. | 
| Mapeamento | Memória | Kilobytes | os.memory.mapped | A quantidade total de conteúdo do sistema de arquivos que é mapeada na memória dentro de um espaço de endereçamento de processos, em kilobytes. | 
| Contagem de eliminações por memória insuficiente | Memória | Eliminações | os.memory.outOfMemoryKillCount |  O número de encerramentos OOM que aconteceram durante o último intervalo de coleta.  | 
| Tabelas de página | Memória | Kilobytes | os.memory.pageTables | A quantidade de memória usada por tabelas de página, em kilobytes. | 
| Slab | Memória | Kilobytes | os.memory.slab | A quantidade de estruturas de dados reutilizáveis do kernel, em kilobytes. | 
| Total | Memória | Kilobytes | os.memory.total | A quantidade total de memória, em kilobytes. | 
| Writeback | Memória | Kilobytes | os.memory.writeback | A quantidade de páginas sujas na RAM que ainda estão sendo gravadas no armazenamento de suporte, em kilobytes. | 
| Visitas | Utilização da CPU | Porcentagem | os.cpuUtilization.guest | A porcentagem de CPU em uso por programas de convidado. | 
| Idle | Utilização da CPU | Porcentagem | os.cpuUtilization.idle | A porcentagem de CPU que está ociosa. | 
| Irq | Utilização da CPU | Porcentagem | os.cpuUtilization.irq | A porcentagem de CPU em uso por interrupções de software. | 
| Amigável | Utilização da CPU | Porcentagem | os.cpuUtilization.nice | A porcentagem de CPU em uso por programas em execução com a prioridade mais baixa. | 
| Roubo | Utilização da CPU | Porcentagem | os.cpuUtilization.steal | A porcentagem de CPU em uso por outras máquinas virtuais. | 
| Sistema | Utilização da CPU | Porcentagem | os.cpuUtilization.system | A porcentagem de CPU em uso pelo kernel. | 
| Total | Utilização da CPU | Porcentagem | os.cpuUtilization.total | A porcentagem total da CPU em uso. Esse valor inclui o valor amigável. | 
| Usuário | Utilização da CPU | Porcentagem | os.cpuUtilization.user | A porcentagem de CPU em uso por programas do usuário. | 
| Wait | Utilização da CPU | Porcentagem | os.cpuUtilization.wait | A porcentagem de CPU fora de uso ao aguardar o acesso de E/S. | 
|  PS de E/S de leitura  | E/S de disco | Solicitações por segundo |  os.diskIO.<devicename>.readIOsPS  | O número de operações de leitura por segundo. | 
|  PS de E/S de gravação  | E/S de disco | Solicitações por segundo |  os.diskIO.<devicename>.writeIOsPS  | O número de operações de gravação por segundo. | 
|  Comprimento médio da fila | E/S de disco | Solicitações |  os.diskIO.<devicename>.avgQueueLen  | O número de solicitações que aguardam na fila do dispositivo de E/S. | 
|  Tamanho médio de solicitação  | E/S de disco | Solicitações |  os.diskIO.<devicename>.avgReqSz  | O número de solicitações que aguardam na fila do dispositivo de E/S. | 
|  Espera  | E/S de disco | Milissegundos |  os.diskIO.<devicename>.await  | O número de milissegundos necessários para responder a solicitações, incluindo o tempo na fila e o tempo de serviço. | 
|  PS de E/S de leitura  | E/S de disco | Solicitações |  os.diskIO.<devicename>.readIOsPS  | O número de operações de leitura por segundo. | 
|  KB de leitura  | E/S de disco | Kilobytes |  os.diskIO.<devicename>.readKb  | O número total de kilobytes lidos. | 
|  PS de KB de leitura  | E/S de disco | Quilobytes/segundo |  os.diskIO.<devicename>.readKbPS  | O número de kilobytes lidos por segundo. | 
|  PS de rrqm  | E/S de disco | Solicitações por segundo |  os.diskIO.<devicename>.rrqmPS  | O número de solicitações de leitura mescladas enfileiradas por segundo. | 
|  TPS  | E/S de disco | Transações por segundo |  os.diskIO.<devicename>.tps  | O número de transações de E/S por segundo. | 
|  Util  | E/S de disco | Porcentagem |  os.diskIO.<devicename>.util  | A porcentagem de tempo de CPU durante o qual as solicitações foram emitidas. | 
|  KB de gravação  | E/S de disco | Kilobytes |  os.diskIO.<devicename>.writeKb  | O número total de kilobytes gravados. | 
|  PS de KB de gravação  | E/S de disco | Quilobytes/segundo |  os.diskIO.<devicename>.writeKbPS  | O número de kilobytes gravados por segundo. | 
|  PS de wrqm  | E/S de disco | Solicitações por segundo |  os.diskIO.<devicename>.wrqmPS  | O número de solicitações de gravação mescladas enfileiradas por segundo. | 
| Bloqueado | Tarefas | Tarefas | os.tasks.blocked | O número de tarefas que estão bloqueadas. | 
| Executar | Tarefas | Tarefas | os.tasks.running | O número de tarefas que estão sendo executadas. | 
| Sleeping | Tarefas | Tarefas | os.tasks.sleeping | O número de tarefas que estão em suspensão. | 
| Interrompida | Tarefas | Tarefas | os.tasks.stopped | O número de tarefas que estão interrompidas. | 
| Total | Tarefas | Tarefas | os.tasks.total | O número total de tarefas. | 
| Zumbi | Tarefas | Tarefas | os.tasks.zombie | O número de tarefas filho que estão inativas com uma tarefa pai ativa. | 
| Um | Carga média por minuto | Processos | os.loadAverageMinute.one | O número de processos que estão solicitando tempo de CPU no último minuto. | 
| Quinze | Carga média por minuto | Processos | os.loadAverageMinute.fifteen | O número de processos que estão solicitando tempo de CPU nos últimos 15 minutos. | 
| Cinco | Carga média por minuto | Processos | os.loadAverageMinute.five | O número de processos que estão solicitando tempo de CPU nos últimos 5 minutos. | 
| Em cache | Troca | Kilobytes | os.swap.cached | A quantidade de memória de permuta, em kilobytes, usada como a memória cache. | 
| Gratuito | Troca | Kilobytes | os.swap.free | A quantidade de memória de troca livre, em kilobytes.  | 
| Em | Troca | Kilobytes | os.swap.in | A quantidade de memória, em kilobytes, transferida temporariamente do disco. | 
| Saída | Troca | Kilobytes | os.swap.out | A quantidade de memória, em kilobytes, transferida temporariamente para o disco. | 
| Total | Troca | Kilobytes | os.swap.total |  A quantidade de memória swap disponível, em kilobytes.  | 
| Máximo de arquivos | Sistema de arquivos | Arquivos | os.fileSys.maxFiles | O número máximo de arquivos que podem ser criados para o sistema de arquivos em todos os volumes de armazenamento. | 
| Arquivos usados | Sistema de arquivos | Arquivos | os.fileSys.usedFiles | O número de arquivos no sistema de arquivos em todos os volumes de armazenamento. | 
| Porcentagem de arquivos usados | Sistema de arquivos | Arquivos | os.fileSys.usedFilePercent | A porcentagem de arquivos disponíveis em uso em todos os volumes de armazenamento. | 
| Porcentagem usada | Sistema de arquivos | Porcentagem | os.fileSys.usedPercent | A porcentagem do espaço em disco do sistema de arquivos em uso em todos os volumes de armazenamento. | 
| Usado | Sistema de arquivos | Kilobytes | os.fileSys.used | A quantidade de espaço em disco usada pelos arquivos no sistema de arquivos em todos os volumes de armazenamento, em kilobytes. | 
| Total | Sistema de arquivos | Kilobytes | os.fileSys.total | O espaço total disponível em disco para o sistema de arquivos em todos os volumes de armazenamento, em kilobytes. | 
| Máximo de arquivos | Sistema de arquivos | Arquivos | os.fileSys.<volumeName>.maxFiles | O número máximo de arquivos que podem ser criados para o sistema de armazenamento. | 
| Arquivos usados | Sistema de arquivos | Arquivos | os.fileSys.<volumeName>.usedFiles | O número de arquivos no volume de armazenamento. | 
| Porcentagem de arquivos usados | Sistema de arquivos | Arquivos | os.fileSys.<volumeName>.usedFilePercent | A porcentagem de arquivos disponíveis em uso no volume de armazenamento. | 
| Porcentagem usada | Sistema de arquivos | Porcentagem | os.fileSys.<volumeName>.usedPercent | A porcentagem do espaço em disco do volume de armazenamento em uso. | 
| Usado | Sistema de arquivos | Kilobytes | os.fileSys.<volumeName>.used | A quantidade de espaço em disco usada pelos arquivos no sistema de armazenamento, em kilobytes. | 
| Total | Sistema de arquivos | Kilobytes | os.fileSys.<volumeName>.total | O espaço total disponível em disco no volume de armazenamento, em kilobytes. | 
| Rx | Rede | Bytes por segundo | os.network.rx | O número de bytes recebidos por segundo. | 
| Tx | Rede | Bytes por segundo | os.network.tx | O número de bytes carregados por segundo. | 
| Utilização de acu | Geral | Porcentagem | os.general.acuUtilization |  A porcentagem de capacidade atual da capacidade máxima configurada.  | 
| Configuração máxima de acu | Geral | ACUs | os.general.maxConfiguredAcu |  A capacidade máxima configurada pelo usuário, em unidades de capacidade do Aurora (ACUs).  | 
| Configuração mínima de acu | Geral | ACUs | os.general.minConfiguredAcu |  A capacidade mínima configurada pelo usuário, em ACUs.  | 
| Número de vCPUs | Geral | vCPUs | os.general.numVCPUs | O número de CPUs virtuais (vCPUs) para a instância de banco de dados. | 
| Capacidade de banco de dados sem servidor | Geral | ACUs | os.general.serverlessDatabaseCapacity |  A capacidade atual da instância, em ACUs.  | 

## Contadores do Performance Insights para o Amazon RDS para MariaDB e MySQL
<a name="USER_PerfInsights_Counters.MySQL"></a>

Os seguintes contadores de banco de dados estão disponíveis com o Performance Insights para Amazon RDS para MariaDB e MySQL.

**Topics**
+ [Contadores nativos para o RDS para MariaDB e o RDS para MySQL](#USER_PerfInsights_Counters.MySQL.Native)
+ [Contadores não nativos para o Amazon RDS para MariaDB e MySQL](#USER_PerfInsights_Counters.MySQL.NonNative)

### Contadores nativos para o RDS para MariaDB e o RDS para MySQL
<a name="USER_PerfInsights_Counters.MySQL.Native"></a>

Métricas nativas são definidas pelo mecanismo de banco de dados e não pelo Amazon RDS. Para obter definições dessas métricas nativas, consulte [Variáveis de status do servidor](https://dev.mysql.com/doc/refman/8.0/en/server-status-variables.html) (para 8.0) e [Variáveis de status do servidor](https://dev.mysql.com/doc/refman/8.4/en/server-status-variables.html) (para 8.4) na documentação do MySQL.


| Contador | Type | Unidade | Métrica | 
| --- | --- | --- | --- | 
| Com\$1analyze | SQL | Consultas por segundo | db.SQL.Com\$1analyze | 
| Com\$1optimize | SQL | Consultas por segundo | db.SQL.Com\$1optimize | 
| Com\$1select | SQL | Consultas por segundo | db.SQL.Com\$1select | 
| Conexões | SQL | O número de tentativas de conexão por minuto (bem-sucedidas ou não) para o servidor MySQL | db.Users.Connections | 
| Innodb\$1rows\$1deleted | SQL | Linhas por segundo | db.SQL.Innodb\$1rows\$1deleted | 
| Innodb\$1rows\$1inserted | SQL | Linhas por segundo | db.SQL.Innodb\$1rows\$1inserted | 
| Innodb\$1rows\$1read | SQL | Linhas por segundo | db.SQL.Innodb\$1rows\$1read | 
| Innodb\$1rows\$1updated | SQL | Linhas por segundo | db.SQL.Innodb\$1rows\$1updated | 
| Select\$1full\$1join | SQL | Consultas por segundo | db.SQL.Select\$1full\$1join | 
| Select\$1full\$1range\$1join | SQL | Consultas por segundo | db.SQL.Select\$1full\$1range\$1join | 
| Select\$1range | SQL | Consultas por segundo | db.SQL.Select\$1range | 
| Select\$1range\$1check | SQL | Consultas por segundo | db.SQL.Select\$1range\$1check | 
| Select\$1scan | SQL | Consultas por segundo | db.SQL.Select\$1scan | 
| Slow\$1queries | SQL | Consultas por segundo | db.SQL.Slow\$1queries | 
| Sort\$1merge\$1passes | SQL | Consultas por segundo | db.SQL.Sort\$1merge\$1passes | 
| Sort\$1range | SQL | Consultas por segundo | db.SQL.Sort\$1range | 
| Sort\$1rows | SQL | Consultas por segundo | db.SQL.Sort\$1rows | 
| Sort\$1scan | SQL | Consultas por segundo | db.SQL.Sort\$1scan | 
| Perguntas | SQL | Consultas por segundo | db.SQL.Questions | 
| Innodb\$1row\$1lock\$1time | Travas | Milissegundos (média) | db.Locks.Innodb\$1row\$1lock\$1time | 
| Table\$1locks\$1immediate | Travas | Solicitações por segundo | db.Locks.Table\$1locks\$1immediate | 
| Table\$1locks\$1waited | Travas | Solicitações por segundo | db.Locks.Table\$1locks\$1waited | 
| Aborted\$1clients | Usuários | Conexões | db.Users.Aborted\$1clients | 
| Aborted\$1connects | Usuários | Conexões | db.Users.Aborted\$1connects | 
| max\$1connections | Usuários | Conexões | db.User.max\$1connections | 
| Threads\$1created | Usuários | Conexões | db.Users.Threads\$1created | 
| Threads\$1running | Usuários | Conexões | db.Users.Threads\$1running | 
| Innodb\$1data\$1writes | E/S | Operações por segundo | db.IO.Innodb\$1data\$1writes | 
| Innodb\$1dblwr\$1writes | I/O | Operações por segundo | db.IO.Innodb\$1dblwr\$1writes | 
| Innodb\$1log\$1write\$1requests | I/O | Operações por segundo | db.IO.Innodb\$1log\$1write\$1requests | 
| Innodb\$1log\$1writes | I/O | Operações por segundo | db.IO.Innodb\$1log\$1writes | 
| Innodb\$1pages\$1written | I/O | Páginas por segundo | db.IO.Innodb\$1pages\$1written | 
| Created\$1tmp\$1disk\$1tables | Temporário | Tabelas por segundo | db.Temp.Created\$1tmp\$1disk\$1tables | 
| Created\$1tmp\$1tables | Temporário | Tabelas por segundo | db.Temp.Created\$1tmp\$1tables | 
| Innodb\$1buffer\$1pool\$1pages\$1data | Cache | Páginas | db.Cache.Innodb\$1buffer\$1pool\$1pages\$1data | 
| Innodb\$1buffer\$1pool\$1pages\$1total | Cache | Páginas | db.Cache.Innodb\$1buffer\$1pool\$1pages\$1total | 
| Innodb\$1buffer\$1pool\$1read\$1requests | Cache | Páginas por segundo | db.Cache.Innodb\$1buffer\$1pool\$1read\$1requests | 
| Innodb\$1buffer\$1pool\$1reads | Cache | Páginas por segundo | db.Cache.Innodb\$1buffer\$1pool\$1reads | 
| Opened\$1tables | Cache | Tabelas | db.Cache.Opened\$1tables | 
| Opened\$1table\$1definitions | Cache | Tabelas | db.Cache.Opened\$1table\$1definitions | 
| Qcache\$1hits | Cache | Consultas | db.Cache.Qcache\$1hits | 

### Contadores não nativos para o Amazon RDS para MariaDB e MySQL
<a name="USER_PerfInsights_Counters.MySQL.NonNative"></a>

Métricas de contador não nativas são contadores definidos pelo Amazon RDS. Uma métrica não nativa pode ser uma métrica obtida com uma consulta específica. Uma métrica não nativa também pode ser uma métrica derivada, em que dois ou mais contadores nativos são usados em cálculos para proporções, taxas de ocorrência ou latências.


| Contador | Type | Unidade | Métrica | Descrição | Definição | 
| --- | --- | --- | --- | --- | --- | 
| innodb\$1buffer\$1pool\$1hits | Cache | Leituras | db.Cache.innoDB\$1buffer\$1pool\$1hits | O número de leituras que o InnoDB pode atender no pool de buffer. | innodb\$1buffer\$1pool\$1read\$1requests - innodb\$1buffer\$1pool\$1reads | 
| innodb\$1buffer\$1pool\$1hit\$1rate | Cache | Porcentagem | db.Cache.innoDB\$1buffer\$1pool\$1hit\$1rate | A porcentagem de leituras que o InnoDB pode atender no pool de buffer. | 100 \$1 innodb\$1buffer\$1pool\$1read\$1requests / (innodb\$1buffer\$1pool\$1read\$1requests \$1 innodb\$1buffer\$1pool\$1reads) | 
| innodb\$1buffer\$1pool\$1usage | Cache | Porcentagem | db.Cache.innoDB\$1buffer\$1pool\$1usage |  A porcentagem do pool de buffers do InnoDB que contém dados (páginas).  Ao usar tabelas compactadas, esse valor pode variar. Para obter mais informações, consulte as informações sobre `Innodb_buffer_pool_pages_data` e `Innodb_buffer_pool_pages_total` em [Variáveis de status do servidor](https://dev.mysql.com/doc/refman/8.0/en/server-status-variables.html) (para 8.0) e [Variáveis de status do servidor](https://dev.mysql.com/doc/refman/8.4/en/server-status-variables.html) (para 8.4) na documentação do MySQL.   | Innodb\$1buffer\$1pool\$1pages\$1data / Innodb\$1buffer\$1pool\$1pages\$1total \$1 100.0 | 
| query\$1cache\$1hit\$1rate | Cache | Porcentagem | db.Cache.query\$1cache\$1hit\$1rate | Índice de acertos de cache do conjunto de resultados do MySQL (cache de consulta). | Qcache\$1hits / (QCache\$1hits \$1 Com\$1select) \$1 100 | 
| innodb\$1datafile\$1writes\$1to\$1disk | E/S | Gravações | db.IO.innoDB\$1datafile\$1writes\$1to\$1disk | O número de gravações de arquivos de dados do InnoDB em disco, excluindo operações de gravação de duplas e de gravação em logs redo. | Innodb\$1data\$1writes - Innodb\$1log\$1writes - Innodb\$1dblwr\$1writes | 
| innodb\$1rows\$1changed | SQL | Linhas | db.SQL.innodb\$1rows\$1changed | O total de operações de linhas do InnoDB. | db.SQL.Innodb\$1rows\$1inserted \$1 db.SQL.Innodb\$1rows\$1deleted \$1 db.SQL.Innodb\$1rows\$1updated | 
| active\$1transactions | Transações | Transações | db.Transactions.active\$1transactions | O total de transações ativas. | SELECT COUNT(1) AS active\$1transactions FROM INFORMATION\$1SCHEMA.INNODB\$1TRX | 
| trx\$1rseg\$1history\$1len | Transações | Nenhum | db.Transactions.trx\$1rseg\$1history\$1len | Uma lista das páginas de undo log de transações confirmadas que é mantida pelo sistema de transações InnoDB para implementar o controle de simultaneidade de várias versões. Para obter mais informações sobre os detalhes para desfazer os registros de log, consulte [InnoDB Multi-Versioning](https://dev.mysql.com/doc/refman/8.0/en/innodb-multi-versioning.html) (para 8.0) e [InnoDB Multi-Versioning](https://dev.mysql.com/doc/refman/8.4/en/innodb-multi-versioning.html) (para 8.4) na documentação do MySQL. | SELECT COUNT AS trx\$1rseg\$1history\$1len FROM INFORMATION\$1SCHEMA.INNODB\$1METRICS WHERE NAME='trx\$1rseg\$1history\$1len'  | 
| innodb\$1deadlocks | Travas | Travas | db.Locks.innodb\$1deadlocks | O número total de deadlocks. | SELECT COUNT AS innodb\$1deadlocks FROM INFORMATION\$1SCHEMA.INNODB\$1METRICS WHERE NAME='lock\$1deadlocks' | 
| innodb\$1lock\$1timeouts | Travas | Travas | db.Locks.innodb\$1lock\$1timeouts | O número total de bloqueios que expiraram. | SELECT COUNT AS innodb\$1lock\$1timeouts FROM INFORMATION\$1SCHEMA.INNODB\$1METRICS WHERE NAME='lock\$1timeouts' | 
| innodb\$1row\$1lock\$1waits | Travas | Travas | db.Locks.innodb\$1row\$1lock\$1waits | O número total de bloqueios de linha que resultaram em uma espera. | SELECT COUNT AS innodb\$1row\$1lock\$1waits FROM INFORMATION\$1SCHEMA.INNODB\$1METRICS WHERE NAME='lock\$1row\$1lock\$1waits' | 

## Contadores do Performance Insights para o Amazon RDS para Microsoft SQL Server
<a name="USER_PerfInsights_Counters.SQLServer"></a>

Os contadores de banco de dados a seguir estão disponíveis para o Performance Insights para o RDS for Microsoft SQL Server.

### Contadores nativos do RDS for Microsoft SQL Server
<a name="USER_PerfInsights_Counters.SQLServer.Native"></a>

Métricas nativas são definidas pelo mecanismo de banco de dados e não pelo Amazon RDS. Você pode encontrar definições para essas métricas nativas em [Usar objetos do SQL Server](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/use-sql-server-objects?view=sql-server-2017), na documentação do Microsoft SQL Server.


| Contador | Type | Unidade | Métrica | 
| --- | --- | --- | --- | 
| Registros encaminhados | [Métodos de acesso](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-access-methods-object?view=sql-server-2017) | Registros por segundo | db.Access Methods.Forwarded Records | 
| Divisões de página | [Métodos de acesso](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-access-methods-object?view=sql-server-2017) | Divisões por segundo | db.Access Methods.Page Splits | 
| Proporção de acertos de cache de buffer | [Gerenciador de buffer](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-buffer-manager-object?view=sql-server-2017) | Proporção | Proporção de acertos do cache de db.Buffer Manager.Buffer | 
| Expectativa de duração de páginas | [Gerenciador de buffer](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-buffer-manager-object?view=sql-server-2017) | Expectativa em segundos | Expectativa de vida de db.Buffer Manager.Page | 
| Consultas de página | [Gerenciador de buffer](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-buffer-manager-object?view=sql-server-2017) | Consultas por segundo | db.Buffer Manager.Page lookups | 
| Leituras de página | [Gerenciador de buffer](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-buffer-manager-object?view=sql-server-2017) | Leituras por segundo | db.Buffer Manager.Page reads | 
| Gravações de página | [Gerenciador de buffer](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-buffer-manager-object?view=sql-server-2017) | Gravações por segundo | db.Buffer Manager.Page writes | 
| Transações ativas | [Bancos de dados](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-databases-object?view=sql-server-2017) | Transações | db.Databases.Active Transactions (\$1Total) | 
| Bytes de log liberados | [Bancos de dados na](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-databases-object?view=sql-server-2017) | Bytes liberados por segundo | db.Databases.Log Bytes Flushed (\$1Total) | 
| Esperas de liberação de log | [Bancos de dados na](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-databases-object?view=sql-server-2017) | Esperas por segundo | db.Databases.Log Flush Waits (\$1Total) | 
| Liberações de log | [Bancos de dados na](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-databases-object?view=sql-server-2017) | Liberações por segundo | db.Databases.Log Flushes (\$1Total) | 
| Transações de gravação | [Bancos de dados na](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-databases-object?view=sql-server-2017) | Transações por segundo | db.Databases.Write Transactions (\$1Total) | 
| Processos bloqueados | [Estatísticas gerais](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-general-statistics-object?view=sql-server-2017) | Processos bloqueados | db.General Statistics.Processes blocked | 
| Conexões de usuários | [Estatísticas gerais](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-general-statistics-object?view=sql-server-2017) | Conexões | db.General Statistics.User Connections | 
| Esperas de travamento | [Travamentos](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-latches-object?view=sql-server-2017) | Esperas por segundo | db.Latches.Latch Waits | 
| Número de deadlocks | [Travas](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-locks-object?view=sql-server-2017) | Deadlocks por segundo | db.Locks.Number of Deadlocks (\$1Total) | 
| Concessões de memória pendentes | [Gerenciador de memória](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-memory-manager-object?view=sql-server-2017) | Concessões de memória | Concessões pendentes para db.Memory Manager.Memory | 
| Solicitações em lote | [Estatísticas SQL](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-sql-statistics-object?view=sql-server-2017) | Solicitações por segundo | db.SQL Statistics.Batch Requests | 
| Compilações SQL | [Estatísticas SQL](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-sql-statistics-object?view=sql-server-2017) | Compilações por segundo | db.SQL Statistics.SQL Compilations | 
| Recompilações SQL | [Estatísticas SQL](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-sql-statistics-object?view=sql-server-2017) | Recompilações por segundo | db.SQL Statistics.SQL Re-Compilations | 

## Contadores do Performance Insights para o Amazon RDS para Oracle
<a name="USER_PerfInsights_Counters.Oracle"></a>

Os contadores de banco de dados a seguir estão disponíveis para o Performance Insights para o RDS for Oracle.

### Contadores nativos para o RDS for Oracle
<a name="USER_PerfInsights_Counters.Oracle.Native"></a>

Métricas nativas são definidas pelo mecanismo de banco de dados e não pelo Amazon RDS. Você pode encontrar definições para essas métricas nativas em [Statistics Descriptions](https://docs.oracle.com/en/database/oracle/oracle-database/12.2/refrn/statistics-descriptions-2.html#GUID-2FBC1B7E-9123-41DD-8178-96176260A639) (Descrições de estatísticas) na documentação do Oracle.

**nota**  
Para a métrica de contador `CPU used by this session`, a unidade foi transformada dos centésimos de segundo nativos para sessões ativas a fim de facilitar o uso do valor. Por exemplo, o envio de CPU no gráfico de carga do banco de dados representa a demanda por CPU. A métrica de contador `CPU used by this session` representa a quantidade de CPU usada por sessões do Oracle. É possível comparar o envio de CPU à métrica de contador `CPU used by this session`. Quando a demanda por CPU for maior que a CPU usada, as sessões aguardarão o tempo da CPU.


| Contador | Type | Unidade | Métrica | 
| --- | --- | --- | --- | 
| CPU usada por esta sessão | Usuário | Sessões ativas | db.User.CPU usada por esta sessão | 
| Rotas de ida e volta do SQL\$1Net para/do cliente | Usuário | Idas e voltas por segundo | Rotas de ida e volta do db.User.SQL\$1Net para/do cliente | 
| Bytes recebidos via SQL\$1Net do cliente | Usuário | Bytes por segundo | db.User.bytes recebidos pelo SQL\$1Net do cliente | 
| Confirmações de usuários | Usuário | Confirmações por segundo | Confirmações de db.User.user | 
| Logons cumulativos | Usuário | Logons por segundo | db.User.logons cumulativos | 
| Chamadas de usuários | Usuário | Chamadas por segundo | Chamadas de db.User.user | 
| Bytes enviados via SQL\$1Net ao cliente | Usuário | Bytes por segundo | db.User.bytes enviados pelo SQL\$1Net ao cliente | 
| Reversões de usuários | Usuário | Reversões por segundo | Reversões de db.User.user | 
| Tamanho do redo | Redo | Bytes por segundo | Tamanho de db.Redo.redo | 
| Contagem de análises (total) | SQL | Análises por segundo | Contagem de db.SQL.parse (total) | 
| Contagem de análises (fixa) | SQL | Análises por segundo | Contagem de db.SQL.parse (fixa) | 
| Linhas de varredura de tabela obtidas | SQL | Linhas por segundo | Linhas de varredura de db.SQL.table obtidas | 
| Classificações (memória) | SQL | Classificações por segundo | db.SQL.sorts (memória) | 
| Classificações (disco) | SQL | Classificações por segundo | db.SQL.sorts (disco) | 
| Classificações (linhas) | SQL | Classificações por segundo | db.SQL.sorts (linhas) | 
| Bytes de leitura física | Cache | Bytes por segundo | Bytes de leitura de db.Cache.physical | 
| Obtenções de bloqueios de banco de dados | Cache | Blocos por segundo | Obtenções de blocos de db.Cache.db | 
| Pontos de verificação DBWR | Cache | Pontos de verificação por minuto | Pontos de verificação de db.Cache.DBWR | 
| Leituras físicas | Cache | Leituras por segundo | Leituras de db.Cache.physical | 
| Obtenções consistentes do cache | Cache | Obtenções por segundo | Obtenções consistentes de db.Cache.consistent do cache | 
| Obtenções de bloqueios de banco de dados do cache | Cache | Obtenções por segundo | Obtenções de blocos de db.Cache.db do cache | 
| Obtenções consistentes | Cache | Obtenções por segundo | Obtenções consistentes de db.Cache.consistent | 

## Contadores do Performance Insights para o Amazon RDS para PostgreSQL
<a name="USER_PerfInsights_Counters.PostgreSQL"></a>

Os seguintes contadores de banco de dados estão disponíveis com o Performance Insights para Amazon RDS para PostgreSQL.

**Topics**
+ [Contadores nativos para o Amazon RDS para PostgreSQL](#USER_PerfInsights_Counters.PostgreSQL.Native)
+ [Contadores não nativos para o Amazon RDS para PostgreSQL](#USER_PerfInsights_Counters.PostgreSQL.NonNative)

### Contadores nativos para o Amazon RDS para PostgreSQL
<a name="USER_PerfInsights_Counters.PostgreSQL.Native"></a>

Métricas nativas são definidas pelo mecanismo de banco de dados e não pelo Amazon RDS. É possível encontrar definições dessas métricas em [Visualizar estatísticas](https://www.postgresql.org/docs/current/monitoring-stats.html#MONITORING-STATS-VIEWS) (em inglês) na documentação do PostgreSQL.


| Contador | Type | Unidade | Métrica | 
| --- | --- | --- | --- | 
| blks\$1hit | Cache | Blocos por segundo | db.Cache.blks\$1hit | 
| buffers\$1alloc | Cache | Blocos por segundo | db.Cache.buffers\$1alloc | 
| buffers\$1checkpoint | Ponto de verificação | Blocos por segundo | db.Checkpoint.buffers\$1checkpoint | 
| checkpoint\$1sync\$1time | Ponto de verificação | Milissegundos por ponto de verificação | db.Checkpoint.checkpoint\$1sync\$1time | 
| checkpoint\$1write\$1time | Ponto de verificação | Milissegundos por ponto de verificação | db.Checkpoint.checkpoint\$1write\$1time | 
| checkpoints\$1req | Ponto de verificação | Pontos de verificação por minuto | db.Checkpoint.checkpoints\$1req | 
| checkpoints\$1timed | Ponto de verificação | Pontos de verificação por minuto | db.Checkpoint.checkpoints\$1timed | 
| maxwritten\$1clean | Ponto de verificação | Paradas de limpeza de Bgwriter por minuto  | db.Checkpoint.maxwritten\$1clean | 
| deadlocks | Simultaneidade | Deadlocks por minuto | db.Concurrency.deadlocks | 
| blk\$1read\$1time | I/O | Milissegundos | db.IO.blk\$1read\$1time | 
| blks\$1read | I/O | Blocos por segundo | db.IO.blks\$1read | 
| buffers\$1backend | I/O | Blocos por segundo | db.IO.buffers\$1backend | 
| buffers\$1backend\$1fsync | I/O | Blocos por segundo | db.IO.buffers\$1backend\$1fsync | 
| buffers\$1clean | I/O | Blocos por segundo | db.IO.buffers\$1clean | 
| tup\$1deleted | SQL | Tuplas por segundo | db.SQL.tup\$1deleted | 
| tup\$1fetched | SQL | Tuplas por segundo | db.SQL.tup\$1fetched | 
| tup\$1inserted | SQL | Tuplas por segundo | db.SQL.tup\$1inserted | 
| tup\$1returned | SQL | Tuplas por segundo | db.SQL.tup\$1returned | 
| tup\$1updated | SQL | Tuplas por segundo | db.SQL.tup\$1updated | 
| temp\$1bytes | Temporário | Bytes por segundo | db.Temp.temp\$1bytes | 
| temp\$1files | Temporário | Arquivos por minuto | db.Temp.temp\$1files | 
| xact\$1commit | Transações | Confirmações por segundo | db.Transactions.xact\$1commit | 
| xact\$1rollback | Transações | Reversões por segundo | db.Transactions.xact\$1rollback | 
| numbackends | Usuário | Conexões | db.User.numbackends | 
| archived\$1count | Log de gravação antecipada (WAL) | Arquivos por minuto | db.WAL.archived\$1count | 

### Contadores não nativos para o Amazon RDS para PostgreSQL
<a name="USER_PerfInsights_Counters.PostgreSQL.NonNative"></a>

Métricas de contador não nativas são contadores definidos pelo Amazon RDS. Uma métrica não nativa pode ser uma métrica obtida com uma consulta específica. Uma métrica não nativa também pode ser uma métrica derivada, em que dois ou mais contadores nativos são usados em cálculos para proporções, taxas de ocorrência ou latências.


| Contador | Type | Unidade | Métrica | Descrição | Definição | 
| --- | --- | --- | --- | --- | --- | 
| checkpoint\$1sync\$1latency | Ponto de verificação | db.Checkpoint.checkpoint\$1sync\$1latency |  | O tempo que foi gasto na parte do processamento de ponto de verificação em que os arquivos são sincronizados no disco. | checkpoint\$1sync\$1time / (checkpoints\$1timed \$1 checkpoints\$1req) | 
| checkpoint\$1write\$1latency | Ponto de verificação | db.Checkpoint.checkpoint\$1write\$1latency | O tempo que foi gasto na parte do processamento de ponto de verificação em que os arquivos são gravados no disco. | checkpoint\$1write\$1time / (checkpoints\$1timed \$1 checkpoints\$1req) | 
| read\$1latency | I/O | db.IO.read\$1latency | O tempo gasto lendo blocos de arquivos de dados pelos backends nesta instância. | blk\$1read\$1time / blks\$1read | 
| idle\$1in\$1transaction\$1aborted\$1count | Estado | Sessões | db.state.idle\$1in\$1transaction\$1aborted\$1count | O número de sessões no estado idle in transaction (aborted). | Não aplicável | 
| idle\$1in\$1transaction\$1count | Estado | Sessões | db.state.idle\$1in\$1transaction\$1count | O número de sessões no estado idle in transaction. | Não aplicável | 
| idle\$1in\$1transaction\$1max\$1time | Estado | Segundos | db.state.idle\$1in\$1transaction\$1max\$1time | A duração da transação mais longa no estado idle in transaction, em segundos. | Não aplicável | 
| active\$1transactions | Transações | Transações | db.Transactions.active\$1transactions | O número de transações ativas. | Não aplicável | 
| blocked\$1transactions | Transações | Transações | db.Transactions.blocked\$1transactions | O número de transações bloqueadas. | Não aplicável | 
| oldest\$1active\$1logical\$1replication\$1slot\$1xid\$1age | Transações | db.Transactions.oldest\$1active\$1logical\$1replication\$1slot\$1xid\$1age | A idade da transação mais antiga em um slot de replicação lógica ativo. Para obter mais informações, consulte [Slot de replicação lógica](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Logical_replication_slot). | – | 
| oldest\$1inactive\$1logical\$1replication\$1slot\$1xid\$1age | Transações | db.Transactions.oldest\$1inactive\$1logical\$1replication\$1slot\$1xid\$1age | A idade da transação mais antiga em um slot de replicação lógica inativo. Para obter mais informações, consulte [Slot de replicação lógica](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Logical_replication_slot). | – | 
| oldest\$1prepared\$1transaction\$1xid\$1age | Transações | db.transactions.oldest\$1prepared\$1transaction\$1xid\$1age | A idade da transação preparada mais antiga. Para obter mais informações, consulte [Transação preparada](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Prepared_transaction). | – | 
| oldest\$1running\$1transaction\$1xid\$1age | Transações | db.Transactions.oldest\$1running\$1transaction\$1xid\$1age | A idade da transação em execução mais antiga. Para obter mais informações, consulte [Instrução ativa](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Active_statement) para a transação ativa em execução mais antiga e [Ocioso na transação](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Idle_in_transaction) para a transação ociosa em execução mais antiga.  | – | 
| oldest\$1hot\$1standby\$1feedback\$1xid\$1age | Transações | db.Transactions.oldest\$1hot\$1standby\$1feedback\$1xid\$1age | A idade da transação em execução mais antiga em uma réplica de leitura com `hot_standby_feedback` habilitado. Para obter mais informações, consulte [Réplicas de leitura](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Read_replicas). | – | 
| max\$1used\$1xact\$1ids | Transações | Transações | db.Transactions.max\$1used\$1xact\$1ids | O número de transações que não foram apagadas. | Não aplicável | 
| max\$1connections | Usuários | Conexões | db.User.max\$1connections | O número máximo de conexões permitido para uma instância de banco de dados, conforme configurado no parâmetro max\$1connections. | Não aplicável | 
| archive\$1failed\$1count | WAL | Arquivos por minuto | db.WAL.archive\$1failed\$1count | O número de tentativas malsucedidas de arquivamento de arquivos WAL, em arquivos por minuto. | Não aplicável | 

# Estatísticas SQL para Performance Insights
<a name="sql-statistics"></a>

*Estatísticas SQL* são métricas de performance sobre consultas SQL coletadas pelo Performance Insights. O Performance Insights reúne estatísticas para cada segundo em que uma consulta está sendo executada e para cada chamada SQL. As estatísticas do SQL são uma média para o intervalo de tempo selecionado.

Um resumo SQL é um composto de todas as consultas com determinado padrão, mas não necessariamente com os mesmos valores literais. O resumo substitui valores literais por um ponto de interrogação. Por exemplo, `SELECT * FROM emp WHERE lname= ?`. Esse resumo pode consistir nas seguintes consultas subordinadas:

```
SELECT * FROM emp WHERE lname = 'Sanchez'
SELECT * FROM emp WHERE lname = 'Olagappan'
SELECT * FROM emp WHERE lname = 'Wu'
```

Todos os mecanismos são compatíveis com estatísticas de consultas de resumo.

Para receber informações sobre a compatibilidade da região, do mecanismo de banco de dados e da classe de instância com esse atributo, consulte [Mecanismo de banco de dados do Amazon RDSAmazon 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).

**Topics**
+ [Estatísticas SQL para o MariaDB e o MySQL](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.md)
+ [Estatísticas de SQL para o Amazon RDS para Oracle](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.md)
+ [Estatísticas de SQL para o Amazon RDS para SQL Server](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.md)
+ [Estatísticas SQL do RDS PostgreSQL](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.md)

# Estatísticas SQL para o MariaDB e o MySQL
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL"></a>

O MariaDB e o MySQL coletam estatísticas SQL somente em nível de resumo. Nenhuma estatística é mostrada em nível de instrução.

**Topics**
+ [Estatísticas de resumo para MariaDB e MySQL](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.truncation)
+ [Estatísticas por segundo para o MariaDB e o MySQL](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.per-second)
+ [Estatísticas por chamada para o MariaDB e o MySQL](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.truncation.per-call)
+ [Principais estatísticas para MariaDB e MySQL](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.primary)

## Estatísticas de resumo para MariaDB e MySQL
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.truncation"></a>

O Performance Insights coleta estatísticas de resumo do SQL da tabela `events_statements_summary_by_digest`. A tabela `events_statements_summary_by_digest` é gerenciada pelo seu banco de dados. 

Ela não tem uma política de evicção. Quando a tabela estiver cheia, o Console de gerenciamento da AWS mostrará a seguinte mensagem:

```
Performance Insights is unable to collect SQL Digest statistics on new queries because the table events_statements_summary_by_digest is full. 
Please truncate events_statements_summary_by_digest table to clear the issue. Check the User Guide for more details.
```

Nessa situação, o MariaDB e o MySQL não rastreiam consultas SQL. Para resolver esse problema, o Performance Insights trunca automaticamente a tabela de resumo quando ambas as condições são satisfeitas:
+ A tabela está cheia.
+ O Performance Insights gerencia o Performance Schema automaticamente.

  Para gerenciamento automático, o parâmetro `performance_schema` deve ser definido como `0` e **Source** (Origem) não deve ser definido como `user`. Se o Performance Insights não estiver gerenciando o Performance Schema automaticamente, consulte [Visão geral do Performance Schema para o Insights de Performance no Amazon RDS para MariaDB ou MySQL](USER_PerfInsights.EnableMySQL.md).

Na AWS CLI, verifique a origem de um valor de parâmetro executando o comando [describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html).

## Estatísticas por segundo para o MariaDB e o MySQL
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.per-second"></a>

As seguintes estatísticas do SQL estão disponíveis para instâncias de banco de dados do MariaDB e MySQL


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.count\$1star\$1per\$1sec | Chamadas por segundo | 
| db.sql\$1tokenized.stats.sum\$1timer\$1wait\$1per\$1sec | Latência média por segundo (em ms) | 
| db.sql\$1tokenized.stats.sum\$1select\$1full\$1join\$1per\$1sec | Selecionar junção completa por segundo | 
| db.sql\$1tokenized.stats.sum\$1select\$1range\$1check\$1per\$1sec | Selecionar verificação de intervalo por segundo | 
| db.sql\$1tokenized.stats.sum\$1select\$1scan\$1per\$1sec | Selecionar verificação por segundo | 
| db.sql\$1tokenized.stats.sum\$1sort\$1merge\$1passes\$1per\$1sec | Classificar passagens de mesclagem por segundo | 
| db.sql\$1tokenized.stats.sum\$1sort\$1scan\$1per\$1sec | Classificar verificações por segundo | 
| db.sql\$1tokenized.stats.sum\$1sort\$1range\$1per\$1sec | Classificar intervalos por segundo | 
| db.sql\$1tokenized.stats.sum\$1sort\$1rows\$1per\$1sec | Classificar linhas por segundo | 
| db.sql\$1tokenized.stats.sum\$1rows\$1affected\$1per\$1sec | Linhas afetadas por segundo | 
| db.sql\$1tokenized.stats.sum\$1rows\$1examined\$1per\$1sec | Linhas examinadas por segundo | 
| db.sql\$1tokenized.stats.sum\$1rows\$1sent\$1per\$1sec | Linhas enviadas por segundo | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1disk\$1tables\$1per\$1sec | Tabelas de disco temporárias criadas por segundo | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1tables\$1per\$1sec | Tabelas temporárias criadas por segundo | 
| db.sql\$1tokenized.stats.sum\$1lock\$1time\$1per\$1sec | Tempo de bloqueio por segundo (em ms) | 

## Estatísticas por chamada para o MariaDB e o MySQL
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.truncation.per-call"></a>

As métricas a seguir fornecem estatísticas por chamada para uma instrução SQL.


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.sum\$1timer\$1wait\$1per\$1call | Latência média por chamada (em ms)  | 
| db.sql\$1tokenized.stats.sum\$1select\$1full\$1join\$1per\$1call | Selecionar junções completas por chamada | 
| db.sql\$1tokenized.stats.sum\$1select\$1range\$1check\$1per\$1call | Selecionar verificação de intervalo por chamada | 
| db.sql\$1tokenized.stats.sum\$1select\$1scan\$1per\$1call | Selecionar verificações por chamada | 
| db.sql\$1tokenized.stats.sum\$1sort\$1merge\$1passes\$1per\$1call | Classificar passagens de mesclagem por chamada | 
| db.sql\$1tokenized.stats.sum\$1sort\$1scan\$1per\$1call | Classificar verificações por chamada | 
| db.sql\$1tokenized.stats.sum\$1sort\$1range\$1per\$1call | Classificar intervalos por chamada | 
| db.sql\$1tokenized.stats.sum\$1sort\$1rows\$1per\$1call | Classificar linhas por chamada | 
| db.sql\$1tokenized.stats.sum\$1rows\$1affected\$1per\$1call | Linhas afetadas por chamada | 
| db.sql\$1tokenized.stats.sum\$1rows\$1examined\$1per\$1call | Linhas examinadas por chamada | 
| db.sql\$1tokenized.stats.sum\$1rows\$1sent\$1per\$1call | Linhas enviadas por chamada | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1disk\$1tables\$1per\$1call | Tabelas de disco temporárias criadas por chamada | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1tables\$1per\$1call | Tabelas temporárias criadas por chamada | 
| db.sql\$1tokenized.stats.sum\$1lock\$1time\$1per\$1call | Tempo de leitura por chamada (em ms) | 

## Principais estatísticas para MariaDB e MySQL
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.primary"></a>

As seguintes estatísticas do SQL estão disponíveis para instâncias de banco de dados do MariaDB e MySQL


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.count\$1star | Calls | 
| db.sql\$1tokenized.stats.sum\$1timer\$1wait | Tempo de espera (em ms) | 
| db.sql\$1tokenized.stats.sum\$1select\$1full\$1join | Selecionar junção completa | 
| db.sql\$1tokenized.stats.sum\$1select\$1range\$1check | Selecionar verificações de intervalo | 
| db.sql\$1tokenized.stats.sum\$1select\$1scan | Selecionar verificações | 
| db.sql\$1tokenized.stats.sum\$1sort\$1merge\$1passes | Classificar passagens de mesclagem | 
| db.sql\$1tokenized.stats.sum\$1sort\$1scan | Classificar verificações | 
| db.sql\$1tokenized.stats.sum\$1sort\$1range | Classificar intervalos | 
| db.sql\$1tokenized.stats.sum\$1sort\$1rows | Classificar linhas | 
| db.sql\$1tokenized.stats.sum\$1rows\$1affected | Linhas afetadas | 
| db.sql\$1tokenized.stats.sum\$1rows\$1examined | Linhas examinadas | 
| db.sql\$1tokenized.stats.sum\$1rows\$1sent | Linhas enviadas | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1disk\$1tables | Tabelas de disco temporárias criadas | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1tables | Tabelas temporárias criadas | 
| db.sql\$1tokenized.stats.sum\$1lock\$1time | Tempo de bloqueio (em ms) | 

# Estatísticas de SQL para o Amazon RDS para Oracle
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle"></a>

O Amazon RDS para Oracle coleta estatísticas SQL tanto em nível de instrução quanto em nível de resumo. Em nível de instrução, a coluna ID representa o valor de `V$SQL.SQL_ID`. Em nível de resumo, a coluna ID mostra o valor de `V$SQL.FORCE_MATCHING_SIGNATURE`. 

Se o ID for `0` em nível de resumo, significa que o Oracle Database determinou que essa instrução não é apropriada para reutilização. Nesse caso, as instruções SQL subordinadas podem pertencer a resumos diferentes. Entretanto, as instruções são agrupadas sob `digest_text` para a primeira instrução SQL coletada.

**Topics**
+ [Estatísticas por segundo para o Oracle](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.per-second)
+ [Estatísticas por chamada para o Oracle](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.per-call)
+ [Principais estatísticas do Oracle](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.primary)

## Estatísticas por segundo para o Oracle
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.per-second"></a>

As métricas a seguir fornecem estatísticas por segundo referentes a uma consulta SQL do Oracle.


| Métrica | Unidade | 
| --- | --- | 
| db.sql.stats.executions\$1per\$1sec | Número de execuções por segundo | 
| db.sql.stats.elapsed\$1time\$1per\$1sec | Média de execuções ativas (AAE) | 
| db.sql.stats.rows\$1processed\$1per\$1sec | Linhas processadas por segundo | 
| db.sql.stats.buffer\$1gets\$1per\$1sec | Obtenções de buffer por segundo | 
| db.sql.stats.physical\$1read\$1requests\$1per\$1sec | Leituras físicas por segundo | 
| db.sql.stats.physical\$1write\$1requests\$1per\$1sec | Gravações físicas por segundo | 
| db.sql.stats.total\$1sharable\$1mem\$1per\$1sec | Memória compartilhável total por segundo (em bytes)  | 
| db.sql.stats.cpu\$1time\$1per\$1sec | Tempo de CPU por segundo (em ms) | 

As métricas a seguir fornecem estatísticas por segundo referentes a uma consulta de SQL resumo do Oracle.


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.executions\$1per\$1sec | Número de execuções por segundo | 
| db.sql\$1tokenized.stats.elapsed\$1time\$1per\$1sec | Média de execuções ativas (AAE) | 
| db.sql\$1tokenized.stats.rows\$1processed\$1per\$1sec | Linhas processadas por segundo | 
| db.sql\$1tokenized.stats.buffer\$1gets\$1per\$1sec | Obtenções de buffer por segundo | 
| db.sql\$1tokenized.stats.physical\$1read\$1requests\$1per\$1sec | Leituras físicas por segundo | 
| db.sql\$1tokenized.stats.physical\$1write\$1requests\$1per\$1sec | Gravações físicas por segundo | 
| db.sql\$1tokenized.stats.total\$1sharable\$1mem\$1per\$1sec | Memória compartilhável total por segundo (em bytes)  | 
| db.sql\$1tokenized.stats.cpu\$1time\$1per\$1sec | Tempo de CPU por segundo (em ms) | 

## Estatísticas por chamada para o Oracle
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.per-call"></a>

As métricas a seguir fornecem estatísticas por chamada referentes a uma instrução SQL do Oracle.


| Métrica | Unidade | 
| --- | --- | 
| db.sql.stats.elapsed\$1time\$1per\$1exec | Tempo decorrido por execuções (em ms)  | 
| db.sql.stats.rows\$1processed\$1per\$1exec | Linhas processadas por execução | 
| db.sql.stats.buffer\$1gets\$1per\$1exec | Obtenções de buffer por execução | 
| db.sql.stats.physical\$1read\$1requests\$1per\$1exec | Leituras físicas por execução | 
| db.sql.stats.physical\$1write\$1requests\$1per\$1exec | Gravações físicas por execução | 
| db.sql.stats.total\$1sharable\$1mem\$1per\$1exec | Memória compartilhável total por execução (em bytes) | 
| db.sql.stats.cpu\$1time\$1per\$1exec | Tempo de CPU por execução (em ms) | 

As métricas a seguir fornecem estatísticas por chamada referentes a uma consulta de resumo SQL do Oracle.


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.elapsed\$1time\$1per\$1exec | Tempo decorrido por execuções (em ms)  | 
| db.sql\$1tokenized.stats.rows\$1processed\$1per\$1exec | Linhas processadas por execução | 
| db.sql\$1tokenized.stats.buffer\$1gets\$1per\$1exec | Obtenções de buffer por execução | 
| db.sql\$1tokenized.stats.physical\$1read\$1requests\$1per\$1exec | Leituras físicas por execução | 
| db.sql\$1tokenized.stats.physical\$1write\$1requests\$1per\$1exec | Gravações físicas por execução | 
| db.sql\$1tokenized.stats.total\$1sharable\$1mem\$1per\$1exec | Memória compartilhável total por execução (em bytes) | 
| db.sql\$1tokenized.stats.cpu\$1time\$1per\$1exec | Tempo de CPU por execução (em ms) | 

## Principais estatísticas do Oracle
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.primary"></a>

As métricas a seguir fornecem as principais estatísticas referentes a uma consulta SQL do Oracle.


| Métrica | Unidade | 
| --- | --- | 
| db.sql.stats.executions | Número de execuções  | 
| db.sql.stats.elapsed\$1time | Tempo decorrido (em ms) | 
| db.sql.stats.rows\$1processed | Linhas processadas  | 
| db.sql.stats.buffer\$1gets | Obtenções de buffer  | 
| db.sql.stats.physical\$1read\$1requests | Leituras físicas  | 
| db.sql.stats.physical\$1write\$1requests | Gravações físicas  | 
| db.sql.stats.total\$1sharable\$1mem | Memória compartilhável total (em bytes)  | 
| db.sql.stats.cpu\$1time | Tempo de CPU (em ms) | 

As métricas a seguir fornecem as principais estatísticas referentes a uma consulta de resumo SQL do Oracle.


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.executions | Número de execuções | 
| db.sql\$1tokenized.stats.elapsed\$1time | Tempo decorrido (em ms) | 
| db.sql\$1tokenized.stats.rows\$1processed | Linhas processadas | 
| db.sql\$1tokenized.stats.buffer\$1gets | Obtenções de buffer | 
| db.sql\$1tokenized.stats.physical\$1read\$1requests | Leituras físicas | 
| db.sql\$1tokenized.stats.physical\$1write\$1requests | Gravações físicas | 
| db.sql\$1tokenized.stats.total\$1sharable\$1mem | Memória compartilhável total (em bytes)  | 
| db.sql\$1tokenized.stats.cpu\$1time | Tempo de CPU (em ms) | 

# Estatísticas de SQL para o Amazon RDS para SQL Server
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer"></a>

O Amazon RDS para SQL Server coleta estatísticas SQL tanto em nível de instrução quanto em nível de resumo. Em nível de instrução, a coluna ID representa o valor de `sql_handle`. Em nível de resumo, a coluna ID mostra o valor de `query_hash`. 

O SQL Server retorna valores NULL para `query_hash` para algumas instruções. Por exemplo, ALTER INDEX, CHECKPOINT, UPDATE STATISTICS, COMMIT TRANSACTION, FETCH NEXT FROM Cursor e algumas instruções INSERT, SELECT @<variable>, instruções condicionais e procedimentos armazenados executáveis. Nesse caso, o valor `sql_handle` é exibido como o ID em nível de resumo dessa instrução. 

**Topics**
+ [Estatísticas por segundo para o SQL Server](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.per-second)
+ [Estatísticas por chamada para o SQL Server](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.per-call)
+ [Principais estatísticas para o SQL Server](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.primary)

## Estatísticas por segundo para o SQL Server
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.per-second"></a>

As métricas a seguir fornecem estatísticas por segundo referentes a uma consulta SQL do SQL Server.


| Métrica | Unidade | 
| --- | --- | 
| db.sql.stats.execution\$1count\$1per\$1sec | Número de execuções por segundo | 
| db.sql.stats.total\$1elapsed\$1time\$1per\$1sec | Tempo total decorrido por segundo | 
| db.sql.stats.total\$1rows\$1per\$1sec | Total de linhas processadas por segundo | 
| db.sql.stats.total\$1logical\$1reads\$1per\$1sec | Total de leituras lógicas por segundo | 
| db.sql.stats.total\$1logical\$1writes\$1per\$1sec | Total de gravações lógicas por segundo | 
| db.sql.stats.total\$1physical\$1reads\$1per\$1sec | Total de leituras físicas por segundo | 
| db.sql.stats.total\$1worker\$1time\$1per\$1sec | Tempo total de CPU (em ms) | 

As métricas a seguir fornecem estatísticas por segundo referentes a uma consulta SQL de resumo do SQL Server.


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.execution\$1count\$1per\$1sec | Número de execuções por segundo | 
| db.sql\$1tokenized.stats.total\$1elapsed\$1time\$1per\$1sec | Tempo total decorrido por segundo | 
| db.sql\$1tokenized.stats.total\$1rows\$1per\$1sec | Total de linhas processadas por segundo | 
| db.sql\$1tokenized.stats.total\$1logical\$1reads\$1per\$1sec | Total de leituras lógicas por segundo | 
| db.sql\$1tokenized.stats.total\$1logical\$1writes\$1per\$1sec | Total de gravações lógicas por segundo | 
| db.sql\$1tokenized.stats.total\$1physical\$1reads\$1per\$1sec | Total de leituras físicas por segundo | 
| db.sql\$1tokenized.stats.total\$1worker\$1time\$1per\$1sec | Tempo total de CPU (em ms) | 

## Estatísticas por chamada para o SQL Server
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.per-call"></a>

As métricas a seguir fornecem estatísticas por chamada para uma instrução SQL do SQL Server.


| Métrica | Unidade | 
| --- | --- | 
| db.sql.stats.total\$1elapsed\$1time\$1per\$1call | Tempo total decorrido por execução (em ms) | 
| db.sql.stats.total\$1rows\$1per\$1call | Total de linhas processadas por execução | 
| db.sql.stats.total\$1logical\$1reads\$1per\$1call | Total de leituras lógicas por execução | 
| db.sql.stats.total\$1logical\$1writes\$1per\$1call | Total de gravações lógicas por execução | 
| db.sql.stats.total\$1physical\$1reads\$1per\$1call | Total de leituras físicas por execução | 
| db.sql.stats.total\$1worker\$1time\$1per\$1call | Total de tempo de CPU por execução (em ms) | 

As métricas a seguir fornecem estatísticas por chamada referentes a uma consulta SQL de resumo do SQL Server.


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.total\$1elapsed\$1time\$1per\$1call | Tempo total decorrido por execução | 
| db.sql\$1tokenized.stats.total\$1rows\$1per\$1call | Total de linhas processadas por execução | 
| db.sql\$1tokenized.stats.total\$1logical\$1reads\$1por\$1call | Total de leituras lógicas por execução | 
| db.sql\$1tokenized.stats.total\$1logical\$1writes\$1per\$1call | Total de gravações lógicas por execução | 
| db.sql\$1tokenized.stats.total\$1physical\$1reads\$1por\$1call | Total de leituras físicas por execução  | 
| db.sql\$1tokenized.stats.total\$1worker\$1time\$1per\$1call | Total de tempo de CPU por execução (em ms) | 

## Principais estatísticas para o SQL Server
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.primary"></a>

As métricas a seguir fornecem as principais estatísticas referentes a uma consulta SQL do SQL Server.


| Métrica | Unidade | 
| --- | --- | 
| db.sql.stats.execution\$1count | Número de execuções | 
| db.sql.stats.total\$1elapsed\$1time | Tempo total decorrido (em ms) | 
| db.sql.stats.total\$1rows | Total de linhas processadas | 
| db.sql.stats.total\$1logical\$1reads | Total de leituras lógicas | 
| db.sql.stats.total\$1logical\$1writes | Total de gravações lógicas | 
| db.sql.stats.total\$1physical\$1reads | Total de leituras lógicas | 
| db.sql.stats.total\$1worker\$1time | Tempo total de CPU (em ms) | 

As métricas a seguir fornecem as principais estatísticas referentes a uma consulta de resumo SQL do SQL Server.


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.execution\$1count | Número de execução | 
| db.sql\$1tokenized.stats.total\$1elapsed\$1time | Tempo total decorrido (em ms) | 
| db.sql\$1tokenized.stats.total\$1rows | Total de linhas processadas | 
| db.sql\$1tokenized.stats.total\$1logical\$1reads | Total de leituras lógicas | 
| db.sql\$1tokenized.stats.total\$1logical\$1writes | Total de gravações lógicas | 
| db.sql\$1tokenized.stats.total\$1physical\$1reads | Total de leituras lógicas | 
| db.sql\$1tokenized.stats.total\$1worker\$1time | Tempo total de CPU (em ms) | 

# Estatísticas SQL do RDS PostgreSQL
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL"></a>

Para cada chamada SQL e para cada segundo em que uma consulta é executada, o Performance Insights coleta estatísticas SQL. O Aurora PostgreSQL coleta estatísticas SQL somente em nível de resumo. Nenhuma estatística é mostrada em nível de instrução. 

A seguir, você pode encontrar informações sobre estatísticas no nível do resumo para RDS para PostgreSQL. 

**Topics**
+ [Estatísticas de resumo do RDSPostgreSQL](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.digest)
+ [Estatísticas de resumo por segundo para o RDS PostgreSQL](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.per-second)
+ [Estatísticas de resumo por chamada para o RDS PostgreSQL](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.per-call)
+ [Principais estatísticas do RDS PostgreSQL](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.primary)

## Estatísticas de resumo do RDSPostgreSQL
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.digest"></a>

Para visualizar estatísticas de resumo SQL, o RDS PostgreSQL deve carregar a biblioteca `pg_stat_statements`. Para instâncias de banco de dados do PostgreSQL compatíveis com o PostgreSQL 11 ou versões posteriores, o banco de dados carrega essa biblioteca por padrão. Para instâncias de banco de dados PostgreSQL compatíveis com PostgreSQL 10 ou versões anteriores, essa biblioteca é habilitada manualmente. Para ativá-la manualmente, adicione `pg_stat_statements` a `shared_preload_libraries` no grupo de parâmetros de banco de dados associado à instância de banco de dados. Em seguida, reinicialize sua instância de banco de dados. Para obter mais informações, consulte [Grupos de parâmetros para Amazon RDS](USER_WorkingWithParamGroups.md).

**nota**  
O Performance Insights só pode coletar estatísticas em relação a consultas não truncadas em `pg_stat_activity`. Por padrão, os bancos de dados PostgreSQL truncam consultas com mais de 1.024 bytes. Para aumentar o tamanho das consultas, altere o parâmetro `track_activity_query_size` no grupo de parâmetros de banco de dados associado à sua instância de banco de dados. Ao alterar esse parâmetro, uma reinicialização da instância de banco de dados é necessária.

## Estatísticas de resumo por segundo para o RDS PostgreSQL
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.per-second"></a>

As seguintes estatísticas de resumo SQL estão disponíveis para instância de banco de dados PostgreSQL.


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.calls\$1per\$1sec | Chamadas por segundo | 
| db.sql\$1tokenized.stats.rows\$1per\$1sec | Linhas por segundo | 
| db.sql\$1tokenized.stats.total\$1time\$1per\$1sec | Média de execuções ativas por segundo (AAE) | 
| db.sql\$1tokenized.stats.shared\$1blks\$1hit\$1per\$1sec | Acertos de bloco por segundo | 
| db.sql\$1tokenized.stats.shared\$1blks\$1read\$1per\$1sec | Leituras de bloco por segundo | 
| db.sql\$1tokenized.stats.shared\$1blks\$1dirtied\$1per\$1sec | Blocos sujos por segundo | 
| db.sql\$1tokenized.stats.shared\$1blks\$1written\$1per\$1sec | Gravações de bloco por segundo | 
| db.sql\$1tokenized.stats.local\$1blks\$1hit\$1per\$1sec | Acertos de bloco local por segundo | 
| db.sql\$1tokenized.stats.local\$1blks\$1read\$1per\$1sec | Leituras de bloco local por segundo | 
| db.sql\$1tokenized.stats.local\$1blks\$1dirtied\$1per\$1sec | Bloco local sujo por segundo | 
| db.sql\$1tokenized.stats.local\$1blks\$1written\$1per\$1sec | Gravações de bloco local por segundo | 
| db.sql\$1tokenized.stats.temp\$1blks\$1written\$1per\$1sec | Gravações temporárias por segundo | 
| db.sql\$1tokenized.stats.temp\$1blks\$1read\$1per\$1sec | Leituras temporárias por segundo | 
| db.sql\$1tokenized.stats.blk\$1read\$1time\$1per\$1sec | Leituras simultâneas médias por segundo | 
| db.sql\$1tokenized.stats.blk\$1write\$1time\$1per\$1sec | Gravações simultâneas médias por segundo | 

## Estatísticas de resumo por chamada para o RDS PostgreSQL
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.per-call"></a>

As métricas a seguir fornecem estatísticas por chamada para uma instrução SQL.


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.rows\$1per\$1call | Linhas por chamada | 
| db.sql\$1tokenized.stats.avg\$1latency\$1per\$1call | Latência média por chamada (em ms) | 
| db.sql\$1tokenized.stats.shared\$1blks\$1hit\$1per\$1call | Acertos de bloco por chamada | 
| db.sql\$1tokenized.stats.shared\$1blks\$1read\$1per\$1call | Leituras de bloco por chamada | 
| db.sql\$1tokenized.stats.shared\$1blks\$1written\$1per\$1call | Gravações de bloco por chamada | 
| db.sql\$1tokenized.stats.shared\$1blks\$1dirtied\$1per\$1call | Blocos sujos por chamada | 
| db.sql\$1tokenized.stats.local\$1blks\$1hit\$1per\$1call | Acertos de bloco local por chamada | 
| db.sql\$1tokenized.stats.local\$1blks\$1read\$1per\$1call | Leituras de bloco local por chamada | 
| db.sql\$1tokenized.stats.local\$1blks\$1dirtied\$1per\$1call | Bloco local sujo por chamada | 
| db.sql\$1tokenized.stats.local\$1blks\$1written\$1per\$1call | Gravações de bloco local por chamada | 
| db.sql\$1tokenized.stats.temp\$1blks\$1written\$1per\$1call | Gravações temporárias de bloco por chamada | 
| db.sql\$1tokenized.stats.temp\$1blks\$1read\$1per\$1call | Leituras temporárias de bloco por chamada | 
| db.sql\$1tokenized.stats.blk\$1read\$1time\$1per\$1call | Tempo de leitura por chamada (em ms) | 
| db.sql\$1tokenized.stats.blk\$1write\$1time\$1per\$1call | Tempo de gravação por chamada (em ms) | 

## Principais estatísticas do RDS PostgreSQL
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.primary"></a>

As estatísticas de SQL a seguir estão disponíveis para instâncias de banco de dados do PostgreSQL.


| Métrica | Unidade | 
| --- | --- | 
| db.sql\$1tokenized.stats.calls | Calls  | 
| db.sql\$1tokenized.stats.rows | Linhas  | 
| db.sql\$1tokenized.stats.total\$1time | Tempo total (em ms) | 
| db.sql\$1tokenized.stats.shared\$1blks\$1hit | Acertos de bloco  | 
| db.sql\$1tokenized.stats.shared\$1blks\$1read | Leituras de bloco  | 
| db.sql\$1tokenized.stats.shared\$1blks\$1dirtied | Blocos sujos  | 
| db.sql\$1tokenized.stats.shared\$1blks\$1written | Gravações de bloco  | 
| db.sql\$1tokenized.stats.local\$1blks\$1hit | Acertos de bloco local  | 
| db.sql\$1tokenized.stats.local\$1blks\$1read | Leituras de bloco local  | 
| db.sql\$1tokenized.stats.local\$1blks\$1dirtied | Blocos locais sujos | 
| db.sql\$1tokenized.stats.local\$1blks\$1written | Gravações de bloco local  | 
| db.sql\$1tokenized.stats.temp\$1blks\$1written | Gravações temporárias  | 
| db.sql\$1tokenized.stats.temp\$1blks\$1read | Leituras temporárias  | 
| db.sql\$1tokenized.stats.blk\$1read\$1time | Média de leituras simultâneas (em ms) | 
| db.sql\$1tokenized.stats.blk\$1write\$1time | Média de gravações simultâneas (em ms) | 

Para obter mais informações sobre essas métricas, consulte [pg\$1stat\$1statements](https://www.postgresql.org/docs/current/pgstatstatements.html) na documentação do PostgreSQL.

# Métricas do sistema operacional no monitoramento avançado
<a name="USER_Monitoring-Available-OS-Metrics"></a>

O Amazon RDS fornece métricas em tempo real para o sistema operacional (SO) no qual seu de instância de banco de dados é executado. O RDS fornece as métricas do monitoramento avançado à sua conta do Amazon CloudWatch Logs. As tabelas a seguir listam métricas de SO disponíveis usando o Amazon CloudWatch Logs.



**Topics**
+ [Métricas do sistema operacional Db2, MariaDB, MySQL, Oracle e PostgreSQL](#USER_Monitoring-Available-OS-Metrics-RDS)
+ [Métricas de SO para Microsoft SQL Server](#USER_Monitoring-Available-OS-Metrics-RDS.SQLServer)

## Métricas do sistema operacional Db2, MariaDB, MySQL, Oracle e PostgreSQL
<a name="USER_Monitoring-Available-OS-Metrics-RDS"></a>

O RDS coleta métricas de disco para `rdsdbdata`, bem como volumes adicionais de armazenamento presentes no sistema operacional. Para visualizar métricas do SO no CloudWatch Logs, consulte [Visualizar métricas do SO usando CloudWatch Logs](USER_Monitoring.OS.CloudWatchLogs.md).

<a name="cloudwatch-os-metrics"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_Monitoring-Available-OS-Metrics.html)

## Métricas de SO para Microsoft SQL Server
<a name="USER_Monitoring-Available-OS-Metrics-RDS.SQLServer"></a>

O RDS coleta métricas de disco para `rdsdbdata`, bem como volumes adicionais de armazenamento presentes no sistema operacional. Para visualizar métricas do SO no CloudWatch Logs, consulte [Visualizar métricas do SO usando CloudWatch Logs](USER_Monitoring.OS.CloudWatchLogs.md).

<a name="cloudwatch-sql-server-metrics"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_Monitoring-Available-OS-Metrics.html)