ウィザードを使用して CloudWatch エージェント設定ファイルを作成する - Amazon CloudWatch
CloudWatch エージェントの事前定義されたメトリクスセットCloudWatch エージェント設定ウィザードを実行する

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

エージェント設定ファイルウィザード、amazon-cloudwatch-agent-config-wizard、は以下のような一連の質問を表示します。

  • エージェントを Amazon EC2 インスタンスとオンプレミスサーバーのどちらにインストールするか。

  • サーバーで Linux と Windows Server のどちらが実行されているか。

  • エージェントがログファイルを CloudWatch Logs に送信するようにするか。持っている場合は､既存の CloudWatch Logs エージェント設定ファイルを持っているか。持っている場合､CloudWatch エージェントは､このファイルを使用してサーバーから収集するログを判別できます。

  • エージェントがログファイルを CloudWatch Logs に送信する場合、それらのログファイルを保持する必要がある期間。デフォルト値の -1 にすると、ログアイテムは無期限に保持されるように設定されます。

  • サーバーからメトリクスを収集する場合は、デフォルトのメトリクスセットの 1 つを監視するか、収集するメトリクスのリストをカスタマイズしますか。

  • StatsD または collectd プロトコルを使用して、アプリケーションまたはサービスからカスタムメトリクスを取得しますか。

  • 既存の SSM Agent から移行しますか?

ウィザードの開始前に 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 エージェントにより収集されるメトリクスを参照してください。

注記

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

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

詳細レベル 含められるメトリクス

Basic (ベーシック)

Mem: mem_used_percent

Disk: disk_used_percent

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 を実行しているオンプレミスサーバー

詳細レベル 含められるメトリクス

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

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 です。

詳細レベル 含められるメトリクス

Basic (ベーシック)

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 です。

詳細レベル 含められるメトリクス

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

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

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 ロールとユーザーを作成する」を参照してください。