# 使用向导创建 CloudWatch 代理配置文件
<a name="create-cloudwatch-agent-configuration-file-wizard"></a>

 代理配置文件向导 `amazon-cloudwatch-agent-config-wizard` 会询问一系列问题，帮助您根据需要配置 CloudWatch 代理。本节介绍配置文件所需的凭证。介绍了如何运行 CloudWatch 代理配置向导。还介绍了向导中预定义的指标。

## 必需的凭证
<a name="create-cloudwatch-agent-wizard-credentials"></a>

如果在启动向导之前已具有 Amazon 凭证和配置文件，向导可以自动检测要使用的凭证和 Amazon 区域。有关这些文件的更多信息，请参阅 *Amazon Systems Manager 用户指南*中的[配置和凭证文件](https://docs.amazonaws.cn/cli/latest/userguide/cli-config-files.html)。

在 Amazon 凭证文件中，向导会检查默认凭证，还会查找 `AmazonCloudWatchAgent` 部分，如下所示：

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

向导将显示默认凭证、来自 `AmazonCloudWatchAgent` 的凭证以及 `Others` 选项。您可以选择要使用的凭证。如果您选择 `Others`，则可以输入凭证。

在 Amazon 配置文件中，您可以指定代理将指标发送到的区域（如果与 `[default]` 部分不同）。默认设置为将指标发布到 Amazon EC2 实例所在的区域。如果要将指标发布到不同的区域，请在此处指定该区域。在以下示例中，指标将发布到 `us-west-1` 区域。

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

## 运行 CloudWatch 代理配置向导
<a name="cloudwatch-agent-running-wizard"></a>

**创建 CloudWatch 代理配置文件**

1. 输入以下命令以启动 CloudWatch 代理配置向导：

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

   在运行 Windows Server 的服务器上，运行以下命令，以启动向导：

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

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

1. 回答这些问题以自定义您的服务器的配置文件。

1. 如果您要在本地存储配置文件，则配置文件 `config.json` 将存储在 Linux 服务器上的 `/opt/aws/amazon-cloudwatch-agent/bin/` 中以及 Windows 服务器上的 `C:\Program Files\Amazon\AmazonCloudWatchAgent` 中。然后，您可以将该文件复制到要安装代理的其他服务器上。

   如果要使用 Systems Manager 安装和配置该代理，请务必在提示是否将该文件存储在 Systems Manager Parameter Store 时回答 **Yes（是）**。您也可以选择将该文件存储在 Parameter Store 中，即使未使用 SSM Agent 安装 CloudWatch 代理。要能够将该文件存储在 Parameter Store 中，您必须使用具有足够权限的 IAM 角色。

## CloudWatch 代理预定义指标集
<a name="cloudwatch-agent-preset-metrics"></a>

向导配置了具有不同详细信息级别的预定义指标集。下表显示了这些指标集。有关这些指标的更多信息，请参阅 [CloudWatch 代理收集的指标](metrics-collected-by-CloudWatch-agent.md)。

**注意**  
Parameter Store 支持标准层和高级层中的参数。这些参数层与这些表中描述的“基本”、“标准”和“高级”指标详细信息级别无关。

**运行 Linux 的 Amazon EC2 实例**


| 详细信息级别 | 包含的指标 | 
| --- | --- | 
|  **基本** |  **Mem：**mem\$1used\$1percent **Disk：**disk\$1used\$1percent `disk` 指标（如 `disk_used_percent`）具有一个用于 `Partition` 的维度 ，这意味着生成的自定义指标的数量取决于与您的实例关联的分区数量。您拥有的磁盘分区数取决于您使用的 AMI 以及您附加到服务器的 Amazon EBS 卷数。  | 
|  **Standard** |  **CPU：**`cpu_usage_idle`、`cpu_usage_iowait`、`cpu_usage_user`、`cpu_usage_system` **Disk：**`disk_used_percent`、`disk_inodes_free` **Diskio：**`diskio_io_time` **Mem：**`mem_used_percent` **Swap：**`swap_used_percent`  | 
|  **高级** |  **CPU：**`cpu_usage_idle`、`cpu_usage_iowait`、`cpu_usage_user`、`cpu_usage_system` **Disk：**`disk_used_percent`、`disk_inodes_free` **Diskio：**`diskio_io_time`、`diskio_write_bytes`、`diskio_read_bytes`、`diskio_writes`、`diskio_reads` **Mem：**`mem_used_percent` **Netstat：**`netstat_tcp_established`、`netstat_tcp_time_wait` **Swap：**`swap_used_percent`  | 

**运行 Linux 的本地服务器**


| 详细信息级别 | 包含的指标 | 
| --- | --- | 
|  **基本** |  **Disk：**`disk_used_percent` **Diskio：**`diskio_write_bytes`、`diskio_read_bytes`、`diskio_writes`、`diskio_reads` **Mem：**`mem_used_percent` **Net：**`net_bytes_sent`、`net_bytes_recv`、`net_packets_sent`、`net_packets_recv` **Swap：**`swap_used_percent`  | 
|  **Standard** |  **CPU：**`cpu_usage_idle`、`cpu_usage_iowait` **Disk：**`disk_used_percent`、`disk_inodes_free` **Diskio：**`diskio_io_time`、`diskio_write_bytes`、`diskio_read_bytes`、`diskio_writes`、`diskio_reads` **Mem：**`mem_used_percent` **Net：**`net_bytes_sent`、`net_bytes_recv`、`net_packets_sent`、`net_packets_recv` **Swap：**`swap_used_percent`  | 
|  **高级** |  **CPU：** `cpu_usage_guest`、`cpu_usage_idle`、`cpu_usage_iowait`、`cpu_usage_steal`、`cpu_usage_user`、`cpu_usage_system` **Disk：**`disk_used_percent`、`disk_inodes_free` **Diskio：**`diskio_io_time`、`diskio_write_bytes`、`diskio_read_bytes`、`diskio_writes`、`diskio_reads`  **Mem：**`mem_used_percent`  **Net：**`net_bytes_sent`、`net_bytes_recv`、`net_packets_sent`、`net_packets_recv` **Netstat：**`netstat_tcp_established`、`netstat_tcp_time_wait` **Swap：**`swap_used_percent`  | 

**运行 Windows Server 的 Amazon EC2 实例**

**注意**  
此表中列出的指标名称显示了在控制台中查看时该指标的显示方式。实际的指标名称可能不包含第一个单词。例如，`LogicalDisk % Free Space` 的实际指标名称仅为 `% Free Space`。


| 详细信息级别 | 包含的指标 | 
| --- | --- | 
|  **基本** |  **Memory：**`Memory % Committed Bytes In Use` **LogicalDisk：**`LogicalDisk % Free Space`  | 
|  **Standard** |  **Memory：**`Memory % Committed Bytes In Use` **Paging：**`Paging File % Usage` **Processor：**`Processor % Idle Time`、`Processor % Interrupt Time`、`Processor % User Time` **PhysicalDisk：**`PhysicalDisk % Disk Time` **LogicalDisk：**`LogicalDisk % Free Space`  | 
|  **高级** |  **Memory：**`Memory % Committed Bytes In Use` **Paging：**`Paging File % Usage` **Processor：**`Processor % Idle Time`、`Processor % Interrupt Time`、`Processor % User Time` **LogicalDisk：**`LogicalDisk % Free Space` **PhysicalDisk：**`PhysicalDisk % Disk Time`、`PhysicalDisk Disk Write Bytes/sec`、`PhysicalDisk Disk Read Bytes/sec`、`PhysicalDisk Disk Writes/sec`、`PhysicalDisk Disk Reads/sec` **TCP：**`TCPv4 Connections Established`、`TCPv6 Connections Established`  | 

**运行 Windows Server 的本地服务器**

**注意**  
此表中列出的指标名称显示了在控制台中查看时该指标的显示方式。实际的指标名称可能不包含第一个单词。例如，`LogicalDisk % Free Space` 的实际指标名称仅为 `% Free Space`。


| 详细信息级别 | 包含的指标 | 
| --- | --- | 
|  **基本** |  **Paging：**`Paging File % Usage` **Processor：**`Processor % Processor Time` **LogicalDisk：**`LogicalDisk % Free Space` **PhysicalDisk：**、`PhysicalDisk Disk Write Bytes/sec`、`PhysicalDisk Disk Read Bytes/sec`、`PhysicalDisk Disk Writes/sec`、`PhysicalDisk Disk Reads/sec` **Memory：**`Memory % Committed Bytes In Use` **Network Interface：**`Network Interface Bytes Sent/sec`、`Network Interface Bytes Received/sec`、`Network Interface Packets Sent/sec`、`Network Interface Packets Received/sec`  | 
|  **Standard** |  **Paging：**`Paging File % Usage` **Processor：**`Processor % Processor Time`、`Processor % Idle Time`、`Processor % Interrupt Time` **LogicalDisk：**`LogicalDisk % Free Space` **PhysicalDisk：**`PhysicalDisk % Disk Time`、`PhysicalDisk Disk Write Bytes/sec`、`PhysicalDisk Disk Read Bytes/sec`、`PhysicalDisk Disk Writes/sec`、`PhysicalDisk Disk Reads/sec` **Memory：**`Memory % Committed Bytes In Use` **Network Interface：**`Network Interface Bytes Sent/sec`、`Network Interface Bytes Received/sec`、`Network Interface Packets Sent/sec`、`Network Interface Packets Received/sec`  | 
|  **高级** |  **Paging：**`Paging File % Usage` **Processor：**`Processor % Processor Time`、`Processor % Idle Time`、`Processor % Interrupt Time`、`Processor % User Time` **LogicalDisk：**`LogicalDisk % Free Space` **PhysicalDisk：**`PhysicalDisk % Disk Time`、`PhysicalDisk Disk Write Bytes/sec`、`PhysicalDisk Disk Read Bytes/sec`、`PhysicalDisk Disk Writes/sec`、`PhysicalDisk Disk Reads/sec` **Memory：**`Memory % Committed Bytes In Use` **Network Interface：**`Network Interface Bytes Sent/sec`、`Network Interface Bytes Received/sec`、`Network Interface Packets Sent/sec`、`Network Interface Packets Received/sec` **TCP：**`TCPv4 Connections Established`、`TCPv6 Connections Established`  |