# Estatísticas para as métricas do CloudWatch para as instâncias
É possível obter estatísticas para as métricas do CloudWatch para suas instâncias. *Estatísticas* são agregações de dados de métrica ao longo de períodos especificados. O CloudWatch fornece estatísticas com base nos pontos de dados de métrica fornecidos por seus dados personalizados ou por outros serviços na AWS para o CloudWatch. As agregações são feitas usando o namespace, o nome da métrica, as dimensões e a unidade de medida do ponto de dados no período especificado. A tabela a seguir descreve as estatísticas disponíveis.
| Estatística | Descrição |
| --- | --- |
| Minimum | O valor mais baixo observado durante o período especificado. É possível usar esse valor para determinar baixos volumes de atividade para a sua aplicação |
| Maximum | O valor mais alto observado durante o período especificado. É possível usar esse valor para determinar altos volumes de atividade para a sua aplicação. |
| Sum | Todos os valores enviados para a métrica correspondente, somados. Essa estatística pode ser útil para determinar o volume total de uma métrica. |
| Average | O valor de `Sum` / `SampleCount` durante o período especificado. Ao comparar essa estatística com o `Minimum` e o `Maximum`, é possível determinar o escopo completo de uma métrica e a proximidade da média de uso com o `Minimum` e o `Maximum`. Essa comparação ajuda você a saber quando aumentar ou diminuir seus recursos conforme necessário. |
| SampleCount | A contagem (número) de pontos de dados usados para o cálculo estatístico. |
| pNN.NN | O valor do percentil especificado. É possível especificar qualquer percentil usando até duas casas decimais (por exemplo, p95.45). |
**Topics**
+ [Obter estatísticas para uma instância específica](US_SingleMetricPerInstance.md)
+ [Agregar estatísticas entre instâncias](GetSingleMetricAllDimensions.md)
+ [Agregar estatísticas por grupo de Auto Scaling](GetMetricAutoScalingGroup.md)
+ [Agregar estatísticas por AMI](US_SingleMetricPerAMI.md)
# Obter estatísticas para uma instância específica
É possível usar o Console de gerenciamento da AWS ou a AWS CLI para obter estatísticas para uma instância específica. Os exemplos a seguir mostram como usar o Console de gerenciamento da AWS ou a AWS CLI para determinar a utilização horária de CPU de uma instância do EC2 específica.
**Requisitos**
+ É necessário ter o ID da instância. É possível obter o ID da instância usando o Console de gerenciamento da AWS ou o comando [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html).
+ Por padrão, o monitoramento básico é ativado, mas é possível habilitar o monitoramento detalhado. Para obter mais informações, consulte [Gerenciar o monitoramento detalhado das instâncias do Amazon EC2](manage-detailed-monitoring.md).
**Para exibir a utilização de CPU para uma instância específica (console)**
1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione **Metrics** (Métricas).
1. Escolha o namespace de métricas do **EC2**.
1. Escolha a dimensão **Per-Instance Metrics (Métricas por instância)**.
1. No campo de pesquisa, digite **CPUUtilization** e pressione Enter. Escolha a linha da instância específica, que exibe um gráfico da métrica **CPUUtilization** para a instância. Para dar nome a um gráfico, selecione o ícone do lápis. Para alterar o período, selecione um dos valores predefinidos ou escolha **custom (personalizado)**.
![\[Criar um gráfico de uma métrica\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/metric_statistics_ec2_instance.png)
1. Para alterar a estatística ou o período da métrica, selecione a guia **Graphed metrics (Métricas em gráfico)**. Escolha o cabeçalho de coluna ou um valor individual e, em seguida, escolha um valor diferente.
![\[Alterar a estatística ou o período para uma métrica\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/metric_statistics_ec2_instance_statistic_period.png)
**Para obter a utilização de CPU para uma instância específica (AWS CLI)**
Use o comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) para obter a métrica **CPUUtilization** da instância específica usando o período e o intervalo de tempo especificados:
```
aws cloudwatch get-metric-statistics --namespace AWS/EC2 --metric-name CPUUtilization --period 3600 \
--statistics Maximum --dimensions Name=InstanceId,Value=i-1234567890abcdef0 \
--start-time 2022-10-18T23:18:00 --end-time 2022-10-19T23:18:00
```
A seguir está um exemplo de saída. Cada valor representa a porcentagem máxima de utilização da CPU para uma única instância do EC2.
```
{
"Datapoints": [
{
"Timestamp": "2022-10-19T00:18:00Z",
"Maximum": 0.33000000000000002,
"Unit": "Percent"
},
{
"Timestamp": "2022-10-19T03:18:00Z",
"Maximum": 99.670000000000002,
"Unit": "Percent"
},
{
"Timestamp": "2022-10-19T07:18:00Z",
"Maximum": 0.34000000000000002,
"Unit": "Percent"
},
{
"Timestamp": "2022-10-19T12:18:00Z",
"Maximum": 0.34000000000000002,
"Unit": "Percent"
}
],
"Label": "CPUUtilization"
}
```
# Agregar estatísticas entre instâncias
Estatísticas agregadas estão disponíveis para as instâncias que têm o monitoramento detalhado habilitado. As instâncias que usam o monitoramento básico não estão incluídas nos agregados. Antes que seja possível obter estatísticas agregadas em todas as instâncias, é necessário [habilitar o monitoramento detalhado](manage-detailed-monitoring.md#enable-detailed-monitoring) (a uma cobrança adicional), que fornece dados em períodos de um minuto.
O Amazon CloudWatch não pode agregar dados entre regiões da AWS. As métricas são completamente separadas entre regiões.
Este exemplo mostra a você como usar o monitoramento detalhado para obter uso médio de CPU para suas instâncias do EC2. Como nenhuma dimensão é especificada, o CloudWatch retorna estatísticas para todas as dimensões no namespace `AWS/EC2`.
**Importante**
Essa técnica para recuperar todas as dimensões em um namespace da AWS não funciona para namespaces personalizados que você publicar no Amazon CloudWatch. Com namespaces personalizados, especifique o conjunto completo de dimensões associadas a um determinado ponto de dados para recuperar estatísticas que incluam o ponto de dados.
**Para exibir a utilização média de CPU em suas instâncias (console)**
1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione **Metrics** (Métricas).
1. Escolha o namespace **EC2** e escolha **Across All Instances (Em todas as instâncias)**.
1. Escolha a linha que contém **CPUUtilization**, que exibe um gráfico da métrica para todas as instâncias do EC2. Para dar nome a um gráfico, selecione o ícone do lápis. Para alterar o período, selecione um dos valores predefinidos ou escolha **custom (personalizado)**.
![\[Métricas agregadas entre suas instâncias do EC2\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/metric_aggregated_instances.png)
1. Para alterar a estatística ou o período da métrica, selecione a guia **Graphed metrics (Métricas em gráfico)**. Escolha o cabeçalho de coluna ou um valor individual e, em seguida, escolha um valor diferente.
**Para obter a utilização média de CPU em suas instâncias (AWS CLI)**
Use o comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) da seguinte forma para obter a média da métrica **CPUUtilization** em todas as suas instâncias.
```
aws cloudwatch get-metric-statistics \
--namespace AWS/EC2 \
--metric-name CPUUtilization \
--period 3600 --statistics "Average" "SampleCount" \
--start-time 2022-10-11T23:18:00 \
--end-time 2022-10-12T23:18:00
```
A seguir está um exemplo de saída:
```
{
"Datapoints": [
{
"SampleCount": 238.0,
"Timestamp": "2022-10-12T07:18:00Z",
"Average": 0.038235294117647062,
"Unit": "Percent"
},
{
"SampleCount": 240.0,
"Timestamp": "2022-10-12T09:18:00Z",
"Average": 0.16670833333333332,
"Unit": "Percent"
},
{
"SampleCount": 238.0,
"Timestamp": "2022-10-11T23:18:00Z",
"Average": 0.041596638655462197,
"Unit": "Percent"
}
],
"Label": "CPUUtilization"
}
```
# Agregar estatísticas por grupo de Auto Scaling
É possível agregar estatísticas para as instâncias do EC2 em um grupo do Auto Scaling. O Amazon CloudWatch não pode agregar dados entre regiões da AWS. As métricas são completamente separadas entre regiões.
Este exemplo mostra como recuperar o total de bytes gravados em disco para um grupo do Auto Scaling. O total é calculado para períodos de 1 minuto para um intervalo de 24 horas em todas as instâncias do EC2 no grupo do Auto Scaling especificado.
**Para exibir DiskWriteBytes para as instâncias em um grupo do Auto Scaling (console)**
1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione **Metrics** (Métricas).
1. Escolha o namespace **EC2** e escolha **By Auto Scaling Group (Por grupo de Auto Scaling)**.
1. Escolha a linha da métrica **DiskWriteBytes** e o grupo do Auto Scaling específico, que exibe um gráfico da métrica para as instâncias no grupo do Auto Scaling. Para dar nome a um gráfico, selecione o ícone do lápis. Para alterar o período, selecione um dos valores predefinidos ou escolha **custom (personalizado)**.
1. Para alterar a estatística ou o período da métrica, selecione a guia **Graphed metrics (Métricas em gráfico)**. Escolha o cabeçalho de coluna ou um valor individual e, em seguida, escolha um valor diferente.
**Para exibir DiskWriteBytes para as instâncias em um grupo do Auto Scaling (AWS CLI)**
Use o comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) da seguinte forma.
```
aws cloudwatch get-metric-statistics --namespace AWS/EC2 --metric-name DiskWriteBytes --period 360 \
--statistics "Sum" "SampleCount" --dimensions Name=AutoScalingGroupName,Value=my-asg --start-time 2022-10-16T23:18:00 --end-time 2022-10-18T23:18:00
```
A seguir está um exemplo de saída:
```
{
"Datapoints": [
{
"SampleCount": 18.0,
"Timestamp": "2022-10-19T21:36:00Z",
"Sum": 0.0,
"Unit": "Bytes"
},
{
"SampleCount": 5.0,
"Timestamp": "2022-10-19T21:42:00Z",
"Sum": 0.0,
"Unit": "Bytes"
}
],
"Label": "DiskWriteBytes"
}
```
# Agregar estatísticas por AMI
É possível agregar estatísticas pela AMI para as instâncias com monitoramento detalhado habilitado. As instâncias que usam o monitoramento básico não estão incluídas nos agregados. Antes que seja possível obter estatísticas agregadas em todas as instâncias, é necessário [habilitar o monitoramento detalhado](manage-detailed-monitoring.md#enable-detailed-monitoring) (a uma cobrança adicional), que fornece dados em períodos de um minuto.
O Amazon CloudWatch não pode agregar dados entre regiões da AWS. As métricas são completamente separadas entre regiões.
Este exemplo mostra como determinar a utilização média da CPU para todas as instâncias que usam uma imagem de máquina da Amazon (AMI) específica. A média é intervalos de mais de 60 segundos para um período de um dia.
**Para exibir a utilização média de CPU por AMI (console)**
1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione **Metrics** (Métricas).
1. Escolha o namespace **EC2** e escolha **By Image (AMI) Id (Por ID de imagem (AMI))**.
1. Escolha a linha da métrica **CPUUtilization** e a AMI específica, que exibe um gráfico da métrica para a AMI especificada. Para dar nome a um gráfico, selecione o ícone do lápis. Para alterar o período, selecione um dos valores predefinidos ou escolha **custom (personalizado)**.
1. Para alterar a estatística ou o período da métrica, selecione a guia **Graphed metrics (Métricas em gráfico)**. Escolha o cabeçalho de coluna ou um valor individual e, em seguida, escolha um valor diferente.
**Para obter utilização média de CPU para um ID de imagem (AWS CLI)**
Use o comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) da seguinte forma.
```
aws cloudwatch get-metric-statistics --namespace AWS/EC2 --metric-name CPUUtilization --period 3600 \
--statistics Average --dimensions Name=ImageId,Value=ami-3c47a355 --start-time 2022-10-10T00:00:00 --end-time 2022-10-11T00:00:00
```
A seguir está um exemplo de saída. Cada valor representa uma porcentagem de utilização média da CPU para as instâncias do EC2 que executam a AMI especificada.
```
{
"Datapoints": [
{
"Timestamp": "2022-10-10T07:00:00Z",
"Average": 0.041000000000000009,
"Unit": "Percent"
},
{
"Timestamp": "2022-10-10T14:00:00Z",
"Average": 0.079579831932773085,
"Unit": "Percent"
},
{
"Timestamp": "2022-10-10T06:00:00Z",
"Average": 0.036000000000000011,
"Unit": "Percent"
}
],
"Label": "CPUUtilization"
}
```