# Criar o arquivo de configuração do atendente do CloudWatch com o assistente
<a name="create-cloudwatch-agent-configuration-file-wizard"></a>

 O assistente de arquivo de configuração do agente, `amazon-cloudwatch-agent-config-wizard`, faz uma série de perguntas para ajudá-lo a configurar o agente do CloudWatch para suas necessidades. Esta seção descreve as credenciais necessárias para o arquivo de configuração. A seção descreve como executar o assistente de configuração do agente do CloudWatch. Ela também descreve as métricas que são predefinidas no assistente. 

## Credenciais necessárias
<a name="create-cloudwatch-agent-wizard-credentials"></a>

O assistente poderá detectar automaticamente as credenciais e a região da AWS a serem usadas se você tiver as credenciais e os arquivos de configuração da AWS antes de iniciar o assistente. Para obter mais informações sobre esses arquivos, consulte [ Arquivos de configuração e credenciais](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html) no *Manual do usuário do AWS Systems Manager*.

No arquivo de credenciais da AWS, o assistente verifica a existência de credenciais padrão e também procura uma seção `AmazonCloudWatchAgent` como a seguinte:

```
[AmazonCloudWatchAgent]
aws_access_key_id = {{my_access_key}}
aws_secret_access_key = {{my_secret_key}}
```

O assistente exibe as credenciais padrão, as credenciais do `AmazonCloudWatchAgent` e uma opção `Others`. Você pode selecionar as credenciais a serem usadas. Se você escolher `Others`, insira as credenciais.

Para {{my\_access\_key}} e {{my\_secret\_key}}, use as chaves do usuário do IAM que têm permissões para gravar no Systems Manager Parameter Store. 

No arquivo de configuração da AWS, especifique a região para a qual o atendente enviará métricas, se ela for diferente da seção `[default]`. O padrão é publicar as métricas na região na qual a instância do Amazon EC2 está localizada. Se as métricas precisarem ser publicadas em uma região diferente, especifique-a aqui. No exemplo a seguir, as métricas são publicadas na região `us-west-1`.

```
[AmazonCloudWatchAgent]
region = us-west-1
```

## Executar o assistente de configuração do atendente do CloudWatch
<a name="cloudwatch-agent-running-wizard"></a>

**Para criar o arquivo de configuração do atendente do CloudWatch**

1. Inicie o assistente de configuração do atendente do CloudWatch inserindo o seguinte:

   ```
   sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-config-wizard
   ```

   Em um servidor com o Windows Server, execute os comandos a seguir para iniciar o agente:

   ```
   cd "C:\Program Files\Amazon\AmazonCloudWatchAgent"
   ```

   ```
   .\amazon-cloudwatch-agent-config-wizard.exe
   ```

1. Responda às perguntas para personalizar o arquivo de configuração para o servidor.

1. Se você estiver armazenando o arquivo de configuração localmente, o arquivo de configuração `config.json` será armazenado em `/opt/aws/amazon-cloudwatch-agent/bin/` em servidores Linux e armazenado em `C:\Program Files\Amazon\AmazonCloudWatchAgent` no Windows Server. Depois, você pode copiar esse arquivo em outros servidores em que você deseja instalar o atendente.

   Se você for usar o Systems Manager para instalar e configurar o atendente, responda **Yes** (Sim) quando solicitado para armazenar o arquivo no Systems Manager Parameter Store. Você também pode optar por armazenar o arquivo no Parameter Store mesmo que não esteja usando o SSM Agent para instalar o atendente do CloudWatch. Para poder armazenar o arquivo no Parameter Store, você deve usar uma função do IAM com permissões suficientes. 

## Conjuntos de métricas predefinidas do atendente CloudWatch
<a name="cloudwatch-agent-preset-metrics"></a>

O assistente está configurado com conjuntos de métricas predefinidos, com diferentes níveis de detalhes. Esses conjuntos de métricas são mostrados nas tabelas a seguir. Para ter mais informações sobre essas métricas, consulte [Métricas coletadas pelo atendente do CloudWatch](metrics-collected-by-CloudWatch-agent.md). 

**nota**  
O Parameter Store oferece suporte a parâmetros nos níveis padrão e avançado. Esses níveis de parâmetro não estão relacionados aos níveis Básico, Padrão e Avançado de detalhes da métrica descritos nessas tabelas.

**Instâncias do Amazon EC2 que executam o Linux**


| Nível de detalhes | Métricas incluídas | 
| --- | --- | 
| **Básico** | **Mem:** mem\_used\_percent<br />**Disk:** disk\_used\_percent<br />As métricas de `disk`, como, `disk_used_percent`, têm uma dimensão para `Partition`, o que significa que o número de métricas personalizadas geradas depende do número de partições associadas à instância. O número de partições de disco que você tem depende da AMI usada e do número de volumes do Amazon EBS que estão sendo anexados ao servidor. | 
| **Standard** | **CPU:** `cpu_usage_idle`, `cpu_usage_iowait`, `cpu_usage_user`, `cpu_usage_system`<br />**Disco:** `disk_used_percent`, `disk_inodes_free`<br />**Diskio:** `diskio_io_time`<br />**Mem:** `mem_used_percent`<br />**Swap:** `swap_used_percent` | 
| **Advanced (Avançado** | **CPU:** `cpu_usage_idle`, `cpu_usage_iowait`, `cpu_usage_user`, `cpu_usage_system`<br />**Disco:** `disk_used_percent`, `disk_inodes_free`<br />**Diskio:** `diskio_io_time`, `diskio_write_bytes`, `diskio_read_bytes`, `diskio_writes`, `diskio_reads`<br />**Mem:** `mem_used_percent`<br />**Netstat:** `netstat_tcp_established`, `netstat_tcp_time_wait`<br />**Swap:** `swap_used_percent` | 

**Servidores on-premises que executam o Linux**


| Nível de detalhes | Métricas incluídas | 
| --- | --- | 
| **Básico** | **Disco:** `disk_used_percent`<br />**Diskio:** `diskio_write_bytes`, `diskio_read_bytes`, `diskio_writes`, `diskio_reads`<br />**Mem:** `mem_used_percent`<br />**Rede:** `net_bytes_sent`, `net_bytes_recv`, `net_packets_sent`, `net_packets_recv`<br />**Swap:** `swap_used_percent` | 
| **Standard** | **CPU:** `cpu_usage_idle`, `cpu_usage_iowait`<br />**Disco:** `disk_used_percent`, `disk_inodes_free`<br />**Diskio:** `diskio_io_time`, `diskio_write_bytes`, `diskio_read_bytes`, `diskio_writes`, `diskio_reads`<br />**Mem:** `mem_used_percent`<br />**Rede:** `net_bytes_sent`, `net_bytes_recv`, `net_packets_sent`, `net_packets_recv`<br />**Swap:** `swap_used_percent` | 
| **Advanced (Avançado** | **CPU:** `cpu_usage_guest`, `cpu_usage_idle`, `cpu_usage_iowait`, `cpu_usage_steal`, `cpu_usage_user`, `cpu_usage_system`<br />**Disco:** `disk_used_percent`, `disk_inodes_free`<br />**Diskio:** `diskio_io_time`, `diskio_write_bytes`, `diskio_read_bytes`, `diskio_writes`, `diskio_reads`<br /> **Mem:** `mem_used_percent`<br /> **Rede:** `net_bytes_sent`, `net_bytes_recv`, `net_packets_sent`, `net_packets_recv`<br />**Netstat:** `netstat_tcp_established`, `netstat_tcp_time_wait`<br />**Swap:** `swap_used_percent` | 

**Instâncias do Amazon EC2 que executam o Windows Server**

**nota**  
Os nomes das métricas listados nesta tabela mostram como a métrica aparece quando visualizada no console. O nome real da métrica pode não incluir a primeira palavra. Por exemplo, o nome real da métrica `LogicalDisk % Free Space` é apenas `% Free Space`.


| Nível de detalhes | Métricas incluídas | 
| --- | --- | 
| **Básico** | **Memory" (Memória:** `Memory % Committed Bytes In Use`<br />**LogicalDisk:** `LogicalDisk % Free Space` | 
| **Standard** | **Memory" (Memória:** `Memory % Committed Bytes In Use`<br />**Paginação:** `Paging File % Usage`<br />**Processador:** `Processor % Idle Time`, `Processor % Interrupt Time`, `Processor % User Time`<br />**PhysicalDisk:** `PhysicalDisk % Disk Time`<br />**LogicalDisk:** `LogicalDisk % Free Space` | 
| **Advanced (Avançado** | **Memory" (Memória:** `Memory % Committed Bytes In Use`<br />**Paginação:** `Paging File % Usage`<br />**Processador:** `Processor % Idle Time`, `Processor % Interrupt Time`, `Processor % User Time`<br />**LogicalDisk:** `LogicalDisk % Free Space`<br />**PhysicalDisk:** `PhysicalDisk % Disk Time`, `PhysicalDisk Disk Write Bytes/sec`, `PhysicalDisk Disk Read Bytes/sec`, `PhysicalDisk Disk Writes/sec`, `PhysicalDisk Disk Reads/sec`<br />**TCP:** `TCPv4 Connections Established`, `TCPv6 Connections Established` | 

**Servidor on-premises que executa o Windows Server**

**nota**  
Os nomes das métricas listados nesta tabela mostram como a métrica aparece quando visualizada no console. O nome real da métrica pode não incluir a primeira palavra. Por exemplo, o nome real da métrica `LogicalDisk % Free Space` é apenas `% Free Space`.


| Nível de detalhes | Métricas incluídas | 
| --- | --- | 
| **Básico** | **Paginação: **`Paging File % Usage`<br />**Processador:** `Processor % Processor Time`<br />**LogicalDisk:**`LogicalDisk % Free Space` <br />**PhysicalDisk:** `PhysicalDisk Disk Write Bytes/sec`, `PhysicalDisk Disk Read Bytes/sec`, `PhysicalDisk Disk Writes/sec`, `PhysicalDisk Disk Reads/sec`<br />**Memory" (Memória:** `Memory % Committed Bytes In Use`<br />**Interface de rede:** `Network Interface Bytes Sent/sec`, `Network Interface Bytes Received/sec`, `Network Interface Packets Sent/sec`, `Network Interface Packets Received/sec` | 
| **Standard** | **Paginação:** `Paging File % Usage`<br />**Processador:** `Processor % Processor Time`, `Processor % Idle Time`, `Processor % Interrupt Time`<br />**LogicalDisk:** `LogicalDisk % Free Space`<br />**PhysicalDisk:** `PhysicalDisk % Disk Time`, `PhysicalDisk Disk Write Bytes/sec`, `PhysicalDisk Disk Read Bytes/sec`, `PhysicalDisk Disk Writes/sec`, `PhysicalDisk Disk Reads/sec`<br />**Memory" (Memória:** `Memory % Committed Bytes In Use`<br />**Interface de rede:** `Network Interface Bytes Sent/sec`, `Network Interface Bytes Received/sec`, `Network Interface Packets Sent/sec`, `Network Interface Packets Received/sec` | 
| **Advanced (Avançado** | **Paginação:**`Paging File % Usage`<br />**Processador:** `Processor % Processor Time`, `Processor % Idle Time`, `Processor % Interrupt Time`, `Processor % User Time`<br />**LogicalDisk:** `LogicalDisk % Free Space`<br />**PhysicalDisk:** `PhysicalDisk % Disk Time`, `PhysicalDisk Disk Write Bytes/sec`, `PhysicalDisk Disk Read Bytes/sec`, `PhysicalDisk Disk Writes/sec`, `PhysicalDisk Disk Reads/sec`<br />**Memory" (Memória:** `Memory % Committed Bytes In Use`<br />**Interface de rede:** `Network Interface Bytes Sent/sec`, `Network Interface Bytes Received/sec`, `Network Interface Packets Sent/sec`, `Network Interface Packets Received/sec`<br />**TCP:** `TCPv4 Connections Established`, `TCPv6 Connections Established` |