# Monitorar métricas do Amazon Aurora com o Amazon CloudWatch O Amazon CloudWatch é um repositório de métricas. O repositório coleta e processa dados brutos do Amazon Aurora como métricas legíveis, quase em tempo real. Para obter uma lista completa de métricas do Amazon Aurora enviadas ao CloudWatch, consulte [Referência de métricas para o Amazon Aurora](https://docs.aws.amazon.com/en_us/AmazonRDS/latest/AuroraUserGuide/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/AuroraUserGuide/USER_DatabaseInsights.html). **Topics** + [Visão geral do Amazon Aurora e do Amazon CloudWatch](#cw-metrics-overview) + [Visualizar métricas de cluster de 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 Aurora](creating_alarms.md) ## Visão geral do Amazon Aurora e do Amazon CloudWatch Por padrão, o Amazon Aurora 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/AuroraUserGuide/images/rds-cloudwatch.png) O Amazon RDS publica os seguintes tipos de métrica no Amazon CloudWatch: + Métricas do Aurora em nível de cluster e instância Para obter uma tabela dessas métricas, consulte [Métricas do Amazon CloudWatch para o Amazon Aurora](Aurora.AuroraMonitoring.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 Aurora](Aurora.AuroraMonitoring.Metrics.md#rds-metrics-usage). Para obter mais informações sobre cotas do Amazon RDS, consulte [Cotas e restrições do Amazon Aurora](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 cluster de de banco de dados no console do CloudWatch e na AWS CLI. 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 Aurora, o Amazon Aurora 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 Aurora no console do CloudWatch e na CLI. ## Console **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/AuroraUserGuide/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/AuroraUserGuide/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 Aurora. Para obter descrições dessas dimensões, consulte [Dimensões do Amazon CloudWatch para o Aurora](dimensions.md). ![\[Escolher o namespace de métrica\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/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/AuroraUserGuide/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/AuroraUserGuide/images/rds-monitoring-03.png) Veja detalhes sobre como analisar o uso de recursos do Aurora PostgreSQL usando métricas do CloudWatch. Para obter mais informações, consulte . [Usar métricas do Amazon CloudWatch para analisar o uso de recursos do Aurora PostgreSQL](AuroraPostgreSQL_AnayzeResourceUsage.md) ## AWS CLI 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 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 cluster de 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 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/AuroraUserGuide/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/AuroraUserGuide/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/AuroraUserGuide/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 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/AuroraUserGuide/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 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/AuroraUserGuide/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 Aurora 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. **nota** Para o Aurora, use métricas da função `WRITER` ou `READER` para configurar alarmes em vez de depender de métricas de instâncias de banco de dados específicas. As funções de instância de bancos de dados Aurora podem ser alteradas com o tempo. Você pode encontrar essas métricas baseadas em função no console do CloudWatch. O Auto Scaling do Aurora define automaticamente alarmes com base em métricas da função `READER`. Para obter mais informações sobre o Auto Scaling do Aurora, consulte [Amazon Aurora Auto Scaling com réplicas do Aurora](Aurora.Integrating.AutoScaling.md). É 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).