AWS CloudWatchでLinuxサーバーを監視する方法｜CloudWatch Agentの設定からメトリクス収集・アラート通知まで

この記事のポイント

・CloudWatch Agentがないとメモリ・ディスクは取得できない
・IAMポリシー2つをEC2ロールにアタッチするのが設定の前提
・put-metric-alarmでメモリ85%・ディスク80%のアラームを設定
・CloudWatch Logsへのログ集約とERRORフィルターで異常を検知

# IAMロールにアタッチされているポリシーを確認
# INSTANCE_PROFILE_NAME はEC2インスタンスのIAMロール名に置き換える
aws iam list-attached-role-policies --role-name INSTANCE_PROFILE_NAME   --query 'AttachedPolicies[].PolicyName' --output table

# 出力例（2つのポリシーがあれば準備OK）
# ----------------------------------------
# |      ListAttachedRolePolicies        |
# +--------------------------------------+
# |  CloudWatchAgentServerPolicy         |
# |  AmazonSSMManagedInstanceCore        |
# +--------------------------------------+

# CloudWatch Agentをdnfでインストール
sudo dnf install amazon-cloudwatch-agent -y

# インストール確認
/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl --version

# 出力例（バージョンは環境により異なる）
# /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl --version
# /opt/aws/amazon-cloudwatch-agent: CWAgent/1.300044.0b703 (linux; amd64; go1.22.1)

# 設定ウィザードの起動
sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-config-wizard

# ウィザードの主な設問と推奨回答
# On which OS are you running this agent?
#   => 1 (Linux)
# Are you installing the agent on an EC2 instance?
#   => 1 (Yes)
# Do you want to monitor cpu metrics per core?
#   => 2 (No)  # コア別は通常不要。全体CPUで十分
# Do you want to add ec2 dimensions?
#   => 1 (Yes)  # InstanceIdがメトリクスのディメンションに付与される
# Would you like to monitor memory utilization?
#   => 1 (Yes)
# Would you like to monitor disk utilization?
#   => 1 (Yes)
# Which disk paths do you want to monitor?
#   => / と入力（複数の場合は改行で追加）
# Do you have any existing CloudWatch Log Agent?
#   => 2 (No)  # 初回は No
# Do you want to monitor any log files?
#   => 1 (Yes)
# Log file path
#   => /var/log/messages
# Log group name
#   => (デフォルトのまま Enter → /var/log/messages)
# Log stream name
#   => (デフォルトのまま Enter → {instance_id})

# 設定ファイルの保存先
# /opt/aws/amazon-cloudwatch-agent/bin/config.json

# 設定ファイルを読み込んでエージェントを起動
sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl   -a fetch-config   -m ec2   -c file:/opt/aws/amazon-cloudwatch-agent/bin/config.json   -s

# エージェントの状態確認
sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl   -a status

# 正常起動時の出力例
# {
#   "status": "running",
#   "starttime": "2026-07-05T09:15:32+09:00",
#   "configstatus": "configured",
#   "cwoc_status": "stopped",
#   "version": "1.300044.0b703"
# }

# OS起動時の自動起動確認
sudo systemctl is-enabled amazon-cloudwatch-agent
# enabled

# SNSトピックを作成
aws sns create-topic --name ec2-linux-alerts   --region ap-northeast-1

# 出力例
# {
#     "TopicArn": "arn:aws:sns:ap-northeast-1:123456789012:ec2-linux-alerts"
# }

# メール購読を追加（TopicArnは上記出力の値を使用）
aws sns subscribe   --topic-arn arn:aws:sns:ap-northeast-1:123456789012:ec2-linux-alerts   --protocol email   --notification-endpoint your-alert-address@example.com   --region ap-northeast-1

# 購読後、メールに届くconfirmリンクをクリックして承認する

# メモリ使用率アラームの作成
# INSTANCE_ID は実際のEC2インスタンスIDに置き換える
aws cloudwatch put-metric-alarm   --alarm-name "ec2-mem-used-high"   --alarm-description "Memory usage over 85 percent for 5 minutes"   --metric-name mem_used_percent   --namespace CWAgent   --dimensions Name=InstanceId,Value=i-0123456789abcdef0   --statistic Average   --period 300   --evaluation-periods 1   --threshold 85   --comparison-operator GreaterThanThreshold   --alarm-actions arn:aws:sns:ap-northeast-1:123456789012:ec2-linux-alerts   --treat-missing-data notBreaching   --region ap-northeast-1

# アラーム一覧の確認
aws cloudwatch describe-alarms   --alarm-names ec2-mem-used-high   --query 'MetricAlarms[*].{Name:AlarmName,State:StateValue}'   --output table

# 出力例
# -----------------------------------------------
# |           DescribeAlarms                     |
# +-----------------------+-----------------------+
# |  Name                 |  State                |
# +-----------------------+-----------------------+
# |  ec2-mem-used-high    |  OK                   |
# +-----------------------+-----------------------+

# ディスク使用率アラームの作成（device・fstypeは環境に合わせて調整）
aws cloudwatch put-metric-alarm   --alarm-name "ec2-disk-used-high"   --alarm-description "Disk usage over 80 percent for 5 minutes"   --metric-name disk_used_percent   --namespace CWAgent   --dimensions     Name=InstanceId,Value=i-0123456789abcdef0     Name=device,Value=nvme0n1p1     Name=fstype,Value=xfs     Name=path,Value=/   --statistic Average   --period 300   --evaluation-periods 1   --threshold 80   --comparison-operator GreaterThanThreshold   --alarm-actions arn:aws:sns:ap-northeast-1:123456789012:ec2-linux-alerts   --treat-missing-data notBreaching   --region ap-northeast-1

# ロググループの一覧確認
aws logs describe-log-groups   --log-group-name-prefix /var/log   --query 'logGroups[*].logGroupName'   --output table   --region ap-northeast-1

# 出力例
# --------------------------------
# |     DescribeLogGroups        |
# +------------------------------+
# |  /var/log/messages           |
# +------------------------------+

# 最新ログストリームの確認
aws logs describe-log-streams   --log-group-name /var/log/messages   --order-by LastEventTime   --descending   --max-items 3   --query 'logStreams[*].{Stream:logStreamName,Last:lastEventTimestamp}'   --output table   --region ap-northeast-1

# 最新イベントの表示（ログストリーム名はインスタンスIDを指定）
aws logs get-log-events   --log-group-name /var/log/messages   --log-stream-name i-0123456789abcdef0   --limit 10   --query 'events[*].message'   --output text   --region ap-northeast-1

# ロググループにメトリクスフィルターを作成（"ERROR"を検出してカウント）
aws logs put-metric-filter   --log-group-name /var/log/messages   --filter-name ErrorCount   --filter-pattern "ERROR"   --metric-transformations     metricName=ErrorCount,metricNamespace=LinuxServer/Logs,metricValue=1   --region ap-northeast-1

# フィルター確認
aws logs describe-metric-filters   --log-group-name /var/log/messages   --region ap-northeast-1

# 5分間のErrorCountが3件を超えたらアラームを発報する設定
aws cloudwatch put-metric-alarm   --alarm-name "ec2-log-error-spike"   --alarm-description "Log ERROR count over 3 in 5 minutes"   --metric-name ErrorCount   --namespace LinuxServer/Logs   --statistic Sum   --period 300   --evaluation-periods 1   --threshold 3   --comparison-operator GreaterThanThreshold   --alarm-actions arn:aws:sns:ap-northeast-1:123456789012:ec2-linux-alerts   --treat-missing-data notBreaching   --region ap-northeast-1

# エージェントのエラーログを確認
sudo tail -50 /opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log

# よくあるエラーメッセージと原因
# "NoCredentialProviders: no valid providers in chain"
#   -> IAMロールがアタッチされていない。EC2インスタンスのIAMロールを確認
# "RequestError: send request failed ... EOF"
#   -> CloudWatchエンドポイントへの通信が遮断されている。
#      セキュリティグループのアウトバウンド443の設定を確認
# "context deadline exceeded"
#   -> タイムアウト。NTPが正確に同期されているか確認

# インスタンスに割り当てられたIAMロールの確認（EC2インスタンス内から実行）
curl -s http://169.254.169.254/latest/meta-data/iam/info | python3 -m json.tool

# 出力例（正常時）
# {
#   "Code": "Success",
#   "LastUpdated": "2026-07-05T00:15:31Z",
#   "InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/CloudWatchAgentRole",
#   "InstanceProfileId": "AIPA000000000000EXAMPLE"
# }

# chronydの同期状態確認
chronyc tracking

# 出力例（正常時）
# Reference ID    : 169.254.169.123 (169.254.169.123)
# Stratum         : 4
# Ref time (UTC)  : Sat Jul  5 00:15:31 2026
# System time     : 0.000003826 seconds fast of NTP time
# Last offset     : +0.000002154 seconds
# RMS offset      : 0.000003971 seconds
# Frequency       : 1.234 ppm slow
# Residual freq   : +0.000 ppm
# Skew            : 0.015 ppm
# Root delay      : 0.000000001 seconds
# Root dispersion : 0.000017639 seconds
# Update interval : 1025.3 seconds
# Leap status     : Normal