

# 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*.