

# Coletar métricas de performance da rede
<a name="CloudWatch-Agent-network-performance"></a>

Instâncias do EC2 em execução no Linux que usam o Elastic Network Adapter (ENA) publicam métricas de performance da rede. A versão 1.246396.0 e posteriores do atendente do CloudWatch permitem importar essas métricas de performance de rede para o CloudWatch. Quando você importa essas métricas de performance de rede para o CloudWatch, elas são cobradas como métricas personalizadas do CloudWatch.

Para obter mais informações sobre o driver do ENA, consulte [Habilitar redes avançadas com o Elastic Network Adapter (ENA) em instâncias do Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/enhanced-networking-ena.html) e [Habilitar redes avançadas com o Elastic Network Adapter (ENA) em instâncias do Windows](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/enhanced-networking-ena.html).

A forma de configurar a coleção de métricas de performance de redes é diferente nos servidores Linux e Windows.

A tabela a seguir lista essas métricas de performance de rede habilitadas pelo adaptador ENA. Quando o atendente do CloudWatch importa essas métricas para o CloudWatch a partir de instâncias do Linux, ele inroduz `ethtool_` no início de cada um desses nomes da métrica.


| Métrica | Descrição | 
| --- | --- | 
|  Nome em servidores Linux: `bw_in_allowance_exceeded` Nome em servidores Windows: `Aggregate inbound BW allowance exceeded`  |  O número de pacotes que foram colocados em fila e/ou descartados devido ao fato de que a largura de banda de entrada agregada excedeu o limite máximo para a instância. Essa métrica será coletada somente se você listá-la na subseção `ethtool` da seção `metrics_collected` do arquivo de configuração do atendente do CloudWatch. Para mais informações, consulte [Coletar métricas de performance da rede](#CloudWatch-Agent-network-performance) Unidade: nenhuma  | 
|   Nome em servidores Linux: `bw_out_allowance_exceeded` Nome em servidores Windows: `Aggregate outbound BW allowance exceeded` |  Número de pacotes na fila e/ou descartados porque a largura de banda agregada de saída excedeu o máximo para a instância. Essa métrica será coletada somente se você listá-la na subseção `ethtool` da seção `metrics_collected` do arquivo de configuração do atendente do CloudWatch. Para mais informações, consulte [Coletar métricas de performance da rede](#CloudWatch-Agent-network-performance) Unidade: nenhuma  | 
|  Nome em servidores Linux: :`conntrack_allowance_available` Nome em servidores Windows: `Available connection tracking allowance` |  Relata o número de conexões rastreadas que podem ser estabelecidas pela instância antes de atingir a cota de conexões rastreadas desse tipo de instância. Esta métrica está disponível somente em instâncias do EC2 baseadas em Nitro usando o driver Linux para o Adaptador de Rede Elástica (ENA) a partir da versão 2.8.1 e em computadores usando o driver do Windows para o Adaptador de Rede Elástica (ENA) a partir da versão 2.6.0. Essa métrica será coletada somente se você listá-la na subseção `ethtool` da seção `metrics_collected` do arquivo de configuração do atendente do CloudWatch. Para mais informações, consulte [Coletar métricas de performance da rede](#CloudWatch-Agent-network-performance) Unidade: nenhuma  | 
|  Nome em servidores Linux: :`ena_srd_mode` Nome em servidores Windows: `ena srd mode` |  Descreve quais recursos do ENA Express estão habilitados. Para obter mais informações sobre o ENA Express, consulte [Melhorar a performance da rede com o ENA Express em instâncias Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ena-express.html). Os valores são os seguintes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-network-performance.html)  | 
|  Nome em servidores Linux: :`ena_srd_eligible_tx_pkts` Nome em servidores Windows: `ena srd eligible tx pkts` |  O número de pacotes de rede enviados em um determinado período que atendem aos requisitos de elegibilidade do Scalable Reliable Datagram (SRD) da AWS, como se segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-network-performance.html)  | 
|  Nome em servidores Linux: :`ena_srd_tx_pkts` Nome em servidores Windows: `ena srd tx pkts` |  O número de pacotes de SRD transmitidos em um determinado período.  | 
|  Nome em servidores Linux: :`ena_srd_rx_pkts` Nome em servidores Windows: `ena srd rx pkts` |  O número de pacotes de SRD recebidos em um determinado período.  | 
|  Nome em servidores Linux: :`ena_srd_resource_utilization` Nome em servidores Windows: `ena srd resource utilization` |  A porcentagem da utilização da memória máxima permitida para conexões por SRD simultâneas que a instância consumiu.  | 
|  Nome em servidores Linux: `linklocal_allowance_exceeded` Nome em servidores Windows: `Link local packet rate allowance exceeded`  |  Número de pacotes descartados porque o PPS do tráfego para os serviços de proxy local excedeu o máximo para a interface da rede. Isso afeta o tráfego para o serviço de DNS, o serviço de metadados de instância e o Serviço de Sincronização Temporal da Amazon, mas não afeta o tráfego para resolvedores personalizados de DNS. Essa métrica será coletada somente se você listá-la na subseção `ethtool` da seção `metrics_collected` do arquivo de configuração do atendente do CloudWatch. Para mais informações, consulte [Coletar métricas de performance da rede](#CloudWatch-Agent-network-performance) Unidade: nenhuma  | 
|  Nome em servidores Linux: `pps_allowance_exceeded` Nome em servidores Windows: `PPS allowance exceeded` |  Número de pacotes na fila e/ou descartados porque o PPS bidirecional excedeu o máximo para a instância.  Essa métrica será coletada somente se você listá-la na subseção `ethtool` da seção `metrics_collected` do arquivo de configuração do atendente do CloudWatch. Para mais informações, consulte [Coletar métricas de performance da rede](#CloudWatch-Agent-network-performance) Unidade: nenhuma  | 

## Configuração do Linux
<a name="CloudWatch-Agent-network-performance-Linux"></a>

Em servidores Linux, o *plugin ethtool* permite importar as métricas de performance de rede para o CloudWatch.

O ethtool é um utilitário Linux padrão que pode coletar estatísticas sobre dispositivos Ethernet em servidores Linux. As estatísticas coletadas dependem do dispositivo de rede e do driver. Exemplos dessas estatísticas incluem `tx_cnt`, `rx_bytes`, `tx_errors` e `align_errors`. Ao usar o plugin ethtool com o atendente do CloudWatch, também é possível importar essas estatísticas para o CloudWatch, juntamente com as métricas de performance de rede do EC2 listadas anteriormente nesta seção.

**dica**  
Para encontrar as estatísticas disponíveis em nosso sistema operacional e dispositivo de rede, use o comando `ethtool –S`.

Quando o atendente do CloudWatch importa métricas para o CloudWatch, ele adiciona um prefixo `ethtool_` para os nomes de todas as métricas importadas. Assim, a estatística ethtool padrão `rx_bytes` é chamada `ethtool_rx_bytes` no CloudWatch, e a métrica de performance de rede do EC2 `bw_in_allowance_exceeded` é chamado `ethtool_bw_in_allowance_exceeded` no CloudWatch.

Em servidores Linux, para importar métricas do ethtool, adicione uma seção `ethtool` à seção `metrics_collected` do arquivo de configuração do atendente do CloudWatch. A seção `ethtool` pode incluir as seguintes subseções:
+ **interface\$1include**: incluir essa seção faz com que o atendente colete métricas somente das interfaces cujo nome está listado nessa seção. Se você omitir essa seção, as métricas serão coletadas de todas as interfaces ethernet que não estão listadas em `interface_exclude`.

  A interface ethernet padrão é `eth0`.
+ **interface\$1exclude**: se você incluir essa seção, liste as interfaces ethernet cujas métricas não deseja coletar.

  O plugin ethtool sempre ignora interfaces de loopback.
+ **metrics\$1include**: essa seção lista as métricas a serem importadas para o CloudWatch. Pode incluir estatísticas padrão coletadas pelo ethtool e métricas de rede de alta resolução do Amazon EC2.

O exemplo a seguir exibe parte do arquivo de configuração do atendente do CloudWatch. Essa configuração coleta as métricas padrão do ethtool `rx_packets` e `tx_packets`, e as métricas de performance de rede do Amazon EC2 apenas da interface `eth1`.

Para obter mais informações sobre o arquivo de configuração do atendente do CloudWatch, consulte [Criar ou editar manualmente o arquivo de configuração do atendente do CloudWatch](CloudWatch-Agent-Configuration-File-Details.md).

```
{
"metrics": {
    "append_dimensions": {
      "InstanceId": "${aws:InstanceId}"
    },
    "metrics_collected": {
      "ethtool": {
        "interface_include": [
          "eth1"
        ],
        "metrics_include": [
          "bw_in_allowance_exceeded",
          "bw_out_allowance_exceeded",
          "conntrack_allowance_exceeded",
          "linklocal_allowance_exceeded",
          "pps_allowance_exceeded"
         ]
      }
   }
}
}
```

## Configuração do Windows
<a name="CloudWatch-Agent-network-performance-Windows"></a>

Nos servidores Windows, as métricas de performance da rede estão disponíveis por meio dos contadores de performance do Windows, dos quais o agente CloudWatch já coleta métricas. Assim sendo, você não precisa de um plug-in para coletar essas métricas dos servidores Windows.

Veja a seguir um exemplo de arquivo de configuração para coletar métricas de performance de rede do Windows. Para obter mais informações sobre como editar as configurações no arquivo de configuração do agente do CloudWatch, consulte [Criar ou editar manualmente o arquivo de configuração do atendente do CloudWatch](CloudWatch-Agent-Configuration-File-Details.md).

```
{
    "metrics": {
        "append_dimensions": {
            "InstanceId": "${aws:InstanceId}"
        },
        "metrics_collected": {
            "ENA Packets Shaping": {
                "measurement": [
                    "Aggregate inbound BW allowance exceeded",
                    "Aggregate outbound BW allowance exceeded",
                    "Connection tracking allowance exceeded",
                    "Link local packet rate allowance exceeded",
                    "PPS allowance exceeded"
                ],
                "metrics_collection_interval": 60,
                "resources": [
                    "*"
                ]
            }
        }
    }
}
```

## VIsualizar métricas de performance da rede
<a name="CloudWatch-view-ENA-metrics"></a>

Depois de importar métricas de performance de rede para o CloudWatch, é possível visualizar essas métricas como gráficos de séries temporais e criar alarmes que podem observar essas métricas e notificar você, se elas violarem um limite especificado. O procedimento a seguir mostra como visualizar métricas do ethtool como um gráfico de séries temporais. Para obter mais informações sobre configuração de alarmes, consulte [Usar alarmes do Amazon CloudWatch](CloudWatch_Alarms.md).

Como todas essas métricas são contadores agregados, é possível usar funções de matemática métrica do CloudWatch, como `RATE(METRICS())`, para calcular a taxa dessas métricas em gráficos ou usá-las para definir alarmes. Para mais informações sobre funções matemáticas de métrica, consulte [Uso de expressões matemáticas com as métricas do CloudWatch](using-metric-math.md).

**Para visualizar métricas de performance de rede no console do CloudWatch**

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

1. Escolha o namespace para as métricas coletadas pelo atendente. Por padrão, é **CWAgent**, mas você pode ter especificado um namespace diferente no arquivo de configuração do atendente do CloudWatch.

1. Escolha uma dimensão de métrica; por exemplo, **Per-Instance Metrics** (Métricas por instância).

1. A guia **All metrics** (Todas as métricas) exibe todas as métricas dessa dimensão no namespace. Você pode fazer o seguinte:

   1. Para criar um gráfico de uma métrica, marque a caixa de seleção ao lado da métrica. Para selecionar todas as métricas, marque a caixa de seleção na linha de cabeçalho da tabela.

   1. Para classificar a tabela, use o cabeçalho da coluna.

   1. Para filtrar por recurso, escolha o ID do recurso e **Add to search (Adicionar à pesquisa)**.

   1. Para filtrar por métrica, escolha o nome da métrica e **Add to search (Adicionar à pesquisa)**.

1. (Opcional) Para adicionar esse gráfico a um painel do CloudWatch, escolha **Actions** (Ações) e **Add to dashboard** (Adicionar ao painel).