# ウィザードを使用して 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>

ウィザードの開始前に AWS 認証方法および設定ファイルを所定の場所に置いた場合、ウィザードは使用する認証情報と AWS リージョンを自動検出できます。これらのファイルの詳細については、*AWS Systems Manager ユーザーガイド*の[設定ファイルと認証情報ファイル](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html)を参照してください。

ウィザードでは、AWS 認証ファイルのデフォルトの認証情報を確認するとともに、次のような `AmazonCloudWatchAgent` セクションを探します。

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

また、このウィザードには、デフォルトの認証情報、`AmazonCloudWatchAgent` の認証情報、および `Others` オプションが表示されます。使用する認証情報を選択することができます。`Others` を選択した場合は、認証情報を入力できます。

{{my\_access\_key}} および {{my\_secret\_key}} で、Systems Manager Parameter Store に書き込むアクセス許可がある IAM ユーザーのキーを使用します。

AWS 設定ファイルで、エージェントからメトリクスを送信する先のリージョンを指定できます (`[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 Server では `C:\Program Files\Amazon\AmazonCloudWatchAgent` に保存されます。これで、エージェントをインストールする他のサーバーにこのファイルをコピーできます。

   Systems Manager を使用してエージェントをインストールおよび設定する場合、ファイルを Systems Manager Parameter Store に保存するかどうかを確認するよう求められたら、必ず「**Yes**」と回答してください。SSM Agent を使用して CloudWatch エージェントをインストールしていない場合でも、ファイルを Parameter Store に保存することもできます。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\_used\_percent<br />**Disk:** disk\_used\_percent<br />`disk` などの `disk_used_percent` メトリクスには `Partition` のディメンションがあります。つまり、生成されるカスタムメトリクスの数は、インスタンスに関連付けられたパーティションの数によって異なります。ディスクパーティションの数は、使用している AMI とサーバーにアタッチする Amazon EBS ボリュームの数によって異なります。 | 
| **スタンダード** | **CPU:** `cpu_usage_idle`、`cpu_usage_iowait`、`cpu_usage_user`、`cpu_usage_system`<br />**Disk:** `disk_used_percent`、`disk_inodes_free`<br />**Diskio:** `diskio_io_time`<br />**Mem:** `mem_used_percent`<br />**Swap:** `swap_used_percent` | 
| **アドバンスト** | **CPU:** `cpu_usage_idle`、`cpu_usage_iowait`、`cpu_usage_user`、`cpu_usage_system`<br />**Disk:** `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` | 

**Linux を実行しているオンプレミスサーバー**


| 詳細レベル | 含められるメトリクス | 
| --- | --- | 
| **ベーシック** | **Disk:** `disk_used_percent`<br />**Diskio:** `diskio_write_bytes`、`diskio_read_bytes`、`diskio_writes`、`diskio_reads`<br />**Mem:** `mem_used_percent`<br />**Net:** `net_bytes_sent`、`net_bytes_recv`、`net_packets_sent`、`net_packets_recv`<br />**Swap:** `swap_used_percent` | 
| **スタンダード** | **CPU:** `cpu_usage_idle`、`cpu_usage_iowait`<br />**Disk:** `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 />**Net:** `net_bytes_sent`、`net_bytes_recv`、`net_packets_sent`、`net_packets_recv`<br />**Swap:** `swap_used_percent` | 
| **アドバンスト** | **CPU:** `cpu_usage_guest`、`cpu_usage_idle`、`cpu_usage_iowait`、`cpu_usage_steal` 、`cpu_usage_user`、`cpu_usage_system`<br />**Disk:** `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 /> **Net:** `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` | 

**Windows Server を実行する Amazon EC2 インスタンス**

**注記**  
この表に記載されているメトリクス名は、メトリクスがどのようにコンソールに表示されるかを示しています。実際のメトリクス名には、最初の単語が含まれていない場合があります。例えば、`LogicalDisk % Free Space` の実際のメトリクス名は `% Free Space` です。


| 詳細レベル | 含められるメトリクス | 
| --- | --- | 
| **ベーシック** | **Memory:** `Memory % Committed Bytes In Use`<br />**LogicalDisk:** `LogicalDisk % Free Space` | 
| **スタンダード** | **Memory:** `Memory % Committed Bytes In Use`<br />**Paging:** `Paging File % Usage`<br />**Processor:** `Processor % Idle Time`、`Processor % Interrupt Time`、`Processor % User Time`<br />**PhysicalDisk:** `PhysicalDisk % Disk Time`<br />**LogicalDisk:** `LogicalDisk % Free Space` | 
| **アドバンスト** | **Memory:** `Memory % Committed Bytes In Use`<br />**Paging:** `Paging File % Usage`<br />**Processor:** `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` | 

**Windows Server を実行しているオンプレミスサーバー**

**注記**  
この表に記載されているメトリクス名は、メトリクスがどのようにコンソールに表示されるかを示しています。実際のメトリクス名には、最初の単語が含まれていない場合があります。例えば、`LogicalDisk % Free Space` の実際のメトリクス名は `% Free Space` です。


| 詳細レベル | 含められるメトリクス | 
| --- | --- | 
| **ベーシック** | **Paging: **`Paging File % Usage`<br />**Processor:** `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:** `Memory % Committed Bytes In Use`<br />**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`<br />**Processor:** `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:** `Memory % Committed Bytes In Use`<br />**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` <br />**Processor:** `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:** `Memory % Committed Bytes In Use`<br />**Network Interface:** `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` |