ウィザードを使用して CloudWatch エージェント設定ファイルを作成する

エージェント設定ファイルウィザード (amazon-cloudwatch-agent-config-wizard) では、ニーズに合わせて CloudWatch エージェントを設定するための一連の質問を行います。このセクションでは、設定ファイルに必要な認証情報について説明します。また、CloudWatch エージェント設定ウィザードを実行する方法について説明します。さらに、ウィザードに事前定義されているメトリクスについても説明します。

必要な認証情報

ウィザードの開始前に AWS 認証方法および設定ファイルを所定の場所に置いた場合、ウィザードは使用する認証情報と AWS リージョンを自動検出できます。これらのファイルの詳細については、AWS Systems Manager ユーザーガイドの設定ファイルと認証情報ファイルを参照してください。

ウィザードでは、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 ユーザーのキーを使用します。CloudWatch エージェントに必要な IAM ユーザーの詳細については、「オンプレミスサーバーで CloudWatch エージェントを使用するための IAM ユーザーを作成する」を参照してください。

AWS 設定ファイルで、エージェントからメトリクスを送信する先のリージョンを指定できます ([default] セクションのリージョンと異なる場合)。デフォルトでは、Amazon EC2 インスタンスが配置されているリージョンにメトリクスが発行されます。メトリクスを別のリージョンに発行する場合は、ここでリージョンを指定します。次の例では、メトリクスを us-west-1 リージョンに発行しています。

[AmazonCloudWatchAgent]
region = us-west-1

CloudWatch エージェント設定ウィザードを実行する

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

2. 質問に答えて、サーバーの設定ファイルをカスタマイズします。

3. 設定ファイルをローカルに保存する場合、設定ファイル 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 エージェントで使用する IAM ロールとユーザーを作成する」を参照してください。

CloudWatch エージェントの事前定義されたメトリクスセット

ウィザードは、異なる詳細レベルを持つ、事前定義されたメトリクスセットで設定されます。これらのメトリクスのセットを次の表に示します。これらのメトリクスの詳細については、CloudWatch エージェントにより収集されるメトリクスを参照してください。

注記

Parameter Store では、標準とアドバンストの階層のパラメータをサポートしています。これらのパラメータ層は、これらの表で説明されているメトリクス詳細のベーシックレベル、標準レベル、アドバンストレベルとは関係ありません。

Linux を実行する Amazon EC2 インスタンス

詳細レベル	含められるメトリクス
Basic (ベーシック)	Mem: mem_used_percent Disk: disk_used_percent disk などの disk_used_percent メトリクスには Partition のディメンションがあります。つまり、生成されるカスタムメトリクスの数は、インスタンスに関連付けられたパーティションの数によって異なります。ディスクパーティションの数は、使用している AMI とサーバーにアタッチする Amazon EBS ボリュームの数によって異なります。
標準	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 を実行しているオンプレミスサーバー

詳細レベル	含められるメトリクス
Basic (ベーシック)	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
標準	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 です。

詳細レベル	含められるメトリクス
Basic (ベーシック)	Memory: Memory % Committed Bytes In Use LogicalDisk: LogicalDisk % Free Space
標準	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 です。

詳細レベル	含められるメトリクス
Basic (ベーシック)	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
標準	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