Skip to main content

CloudWatch Agent の設定

参考) CloudWatch エージェントを使用して Amazon EC2 インスタンスとオンプレミスサーバーからメトリクスとログを収集する

インストール​

以下は Ubuntu Linux の例です。

sudo apt-get install -y collectd
curl -O https://s3.amazonaws.com/amazoncloudwatch-agent/ubuntu/arm64/latest/amazon-cloudwatch-agent.deb
sudo dpkg -i -E /tmp/amazon-cloudwatch-agent.deb

収集可能なメトリクス​

参考) デフォルトの EC2 メトリクス​

EC2 では以下のメトリクスが設定なしで収集されます。これらの基本メトリクスを 5 分間隔で収集する場合、追加料金もかかりません。詳細は インスタンスの利用可能な CloudWatch メトリクスのリスト表示 を参照。

Namespace: AWS/EC2

  • CPU: CPUUtilization
  • CPU credits(T系のみ): CPUCreditUsage, CPUCreditBalance, CPUSurplusCreditBalance, CPUSurplusCreditsCharged
  • Disk: DiskReadOps, DiskWriteOps, DiskReadBytes, DiskWriteBytes
  • Network: NetworkIn, NetworkOut, NetworkPacketsIn, NetworkPacketsOut
  • EBS(ベアメタルを除く): EBSReadOps, EBSWriteOps, EBSReadBytes, EBSWriteBytes, EBSIOBalance%, EBSByteBalance%
  • Status: StatusCheckFailed, StatusCheckFailed_Instance, StatusCheckFailed_System
  • その他: MetadataNoToken

CloudWatch Agent で収集可能な追加のメトリクス​

CloudWatch Agent をインストールすることで、以下のメトリクスが収集可能になります。詳細は CloudWatch エージェントにより収集されるメトリクス を参照。

Namespace: CWAgent

  • CPU: cpu_time_active, cpu_time_guest, cpu_time_guest_nice, cpu_time_idle, cpu_time_iowait, cpu_time_irq, cpu_time_nice, cpu_time_softirq, cpu_time_steal, cpu_time_system, cpu_time_user, cpu_usage_active, cpu_usage_guest, cpu_usage_guest_nice, cpu_usage_idle, cpu_usage_iowait, cpu_usage_irq, cpu_usage_nice, cpu_usage_softirq, cpu_usage_steal, cpu_usage_system, cpu_usage_user
  • Disk: disk_free, disk_inodes_free, disk_inodes_total, disk_inodes_used, disk_total, disk_used, disk_used_percent
  • Diskio: diskio_iops_in_progress, diskio_io_time, diskio_reads, diskio_read_bytes, diskio_read_time, diskio_writes, diskio_write_bytes, diskio_write_time
  • Mem: mem_active, mem_available, mem_available_percent, mem_buffered, mem_cached, mem_free, mem_inactive, mem_total, mem_used, mem_used_percent
  • Network: net_bytes_recv, net_bytes_sent, net_drop_in, net_drop_out, net_err_in, net_err_out, net_packets_sent, net_packets_recv
  • Netstat: netstat_tcp_close, netstat_tcp_close_wait, netstat_tcp_closing, netstat_tcp_established, netstat_tcp_fin_wait1, netstat_tcp_fin_wait2, netstat_tcp_last_ack, netstat_tcp_listen, netstat_tcp_none, netstat_tcp_syn_sent, netstat_tcp_syn_recv, netstat_tcp_time_wait, netstat_udp_socket
  • Processor: processes_blocked, processes_dead, processes_idle, processes_paging, processes_running, processes_sleeping, processes_stopped, processes_total, processes_total_threads, processes_wait, processes_zombies
  • Swap: swap_free, swap_used, swap_used_percent

設定​

ウィザードを使用して CloudWatch エージェント設定ファイルを作成する を参考に、CloudWatch Agent をインストールしたインスタンスで以下を実行すると、デフォルトの設定ファイルが作成できます。手動で設定を作成・変更する場合は CloudWatch エージェント設定ファイルを手動で作成または編集する を参考に編集します。

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

ウィザードで Linux, EC2 を選択してデフォルト(3種)を選択した場合、以下のメトリクスが収集されます。

MetricsBasicStandardAdvancedDescription
cpu_usage_idle-○○CPU アイドル時間
cpu_usage_iowait-○○CPU I/O 待ち時間
cpu_usage_user-○○CPU ユーザーモード時間
cpu_usage_system-○○CPU システムモード時間
disk_used_percent○○○使用済みディスク容量の割合
disk_inodes_free-○○使用可能なインデックスノード数
diskio_io_time-○○I/O リクエストをキューに入れている時間
diskio_write_bytes--○ディスク書き込みバイト数
diskio_read_bytes--○ディスク読み込みバイト数
diskio_writes--○ディスク書き込み回数
diskio_reads--○ディスク読み込み回数
mem_used_percent○○○使用中のメモリの割合
netstat_tcp_established--○TCP ESTABLISHED コネクション数
netstat_tcp_time_wait--○TCP TIME_WAIT コネクション数
swap_used_percent-○○使用中のスワップスペースの割合

例

設定を変更した場合、以下のようなコマンドで反映します。

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl \
    -a fetch-config -m ec2 -s \
    -c file:/opt/aws/amazon-cloudwatch-agent/bin/config.json

ログの送信​

ファイルを CloudWatch Logs に送信することもできます。

起動・停止​

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a start
sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a stop
Last updated on