インフォ・ラウンジ Advent Calendar 2023 の16日目です。

やること

2023年3月にリリースされたAmazon Linux 2023にCloudWatch Agentをインストールしてメトリクスを収集します。

Amazon Linux 2023はFedoraベースとなって（ただしFeroraとの互換性はない）、パッケージ管理ツールがyumからdnfへの変更、5年間のサポートを基本とするライフサイクルなどの変更がありました。

そのため、今までAmazon Linux2で使用していたインストール手順が使えなくなったので改めてまとめてみます。使用したAMIは以下の通りです。

al2023-ami-2023.2.20231113.0-kernel-6.1-x86_64

EC2の準備

まずはCloudWatchを使用できるロールを持ったEC2を立てます。コンソールから立てても構わないのですが、今回はAWS CDKで設定しました。概要は以下のような感じで、インスタンスロールにCloudWatchAgentServerPolicyを適用します。また、UserDataを使って起動時にエージェントをインストールしてしまいます。

const instance = new ec2.Instance(this, 'Ec2Instance', {
  instanceType: ec2.InstanceType.of(
    ec2.InstanceClass.T3A,
    ec2.InstanceSize.MICRO
  ),
  machineImage: ec2.MachineImage.lookup({
    name: 'al2023-ami-2023.2.20231113.0-kernel-6.1-x86_64',
    owners: ['amazon'],
  }),
  vpc: vpc,
  // CloudWatchのポリシーを持ったロールを設定
  role: new iam.Role(this, 'MediagInstanceRole', {
    assumedBy: new iam.ServicePrincipal('ec2.amazonaws.com'),
    description: 'Role for Mediag Instance',
    managedPolicies: [
      iam.ManagedPolicy.fromAwsManagedPolicyName('CloudWatchAgentServerPolicy')
    ]
  }),
  ssmSessionPermissions: true
}
// dnfでagentをインストール・有効化
instance.addUserData(
  'sudo dnf install amazon-cloudwatch-agent',
  'sudo systemctl enable amazon-ssm-agent',
  'sudo systemctl start amazon-ssm-agent',
)

agentの設定

ssmSessionPermissionsを有効にしておいたので、セッションマネージャー経由でSSH接続することができます。エージェントは起動しているので、細かい設定をしていきます。

# インストール確認
$ rpm -qa amazon-cloudwatch-agent
amazon-cloudwatch-agent-1.300028.1-1.amzn2023.x86_64

# ステータスチェック
$ systemctl status amazon-cloudwatch-agent
● amazon-cloudwatch-agent.service - Amazon CloudWatch Agent
     Loaded: loaded (/etc/systemd/system/amazon-cloudwatch-agent.service; enabled; preset: disabled)
     Active: active (running) since Thu 2023-12-07 05:39:16 UTC; 1 week 1 day ago
   Main PID: 714650 (amazon-cloudwat)
      Tasks: 9 (limit: 1066)
     Memory: 50.2M
        CPU: 1h 1min 10.082s
     CGroup: /system.slice/amazon-cloudwatch-agent.service

$ amazon-cloudwatch-agent-ctl -a status
{
  "status": "running",
  "starttime": "2023-12-07T05:39:15+00:00",
  "configstatus": "configured",
  "version": "1.300028.1"
}

設定ファイル

設定ファイルは、以前(AmazonLinux2)は /opt/aws/amazon-cloudwatch-agent/bin/config.jsonというファイルを置いて読み込んでいたような気がするのですが、/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.jsonに置けば良いようです。ここが一番の注意点かもしれません。

jsonファイル自体は、以前のものを流用できました。ここでは、nginxのアクセスログと、EC2のメモリやディスク使用量を収集するようにしています。細かい設定項目はドキュメントがあります。ウィザードを使用して対話的に作成することもできるようですね。

$ cat /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json

{
    "agent": {
        "metrics_collection_interval": 60
    },
    "logs": {
        "logs_collected": {
            "files": {
                "collect_list": [
                    {
                        "file_path": "/var/log/nginx/access.log",
                        "auto_removal" : false,
                        "log_group_name": "/hoge/fuga",
                        "log_stream_name": "nginx_access.log_{instance_id}",
                        "timestamp_format": "%d/%b/%Y:%H:%M:%S %z"
                    }
                ]
            }
        }
    },
    "metrics": {
        "metrics_collected": {
            "mem": {
                "measurement": ["mem_used_percent"]
            },
            "disk": {
                "measurement": ["used_percent"],
                "resources": ["*"]
            }
        },
        "append_dimensions": {
            "ImageId": "${aws:ImageId}",
            "InstanceId": "${aws:InstanceId}",
            "InstanceType": "${aws:InstanceType}",
            "AutoScalingGroupName": "${aws:AutoScalingGroupName}"
        }
    }
}

設定ファイルを置いたら、再起動して変更を反映しましょう

$ sudo systemctl restart amazon-cloudwatch-agent

コンソールからCloudWatchを確認して、ロググループやカスタムメトリクスが収集されていればOKです。

うまく収集されていない場合は、ログを見てみるとよいかもしれません。デフォルトの状態ではjournalに出ているようです。

$ journalctl | grep cloudwatch

Dec 16 04:49:24 ip-10-0-0-87.ap-northeast-1.compute.internal start-amazon-cloudwatch-agent[1331795]: I! Detected the instance is EC2
Dec 16 04:49:24 ip-10-0-0-87.ap-northeast-1.compute.internal start-amazon-cloudwatch-agent[1331795]: 2023/12/16 04:49:24 Reading json config file path: /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json ...
Dec 16 04:49:24 ip-10-0-0-87.ap-northeast-1.compute.internal start-amazon-cloudwatch-agent[1331795]: 2023/12/16 04:49:24 I! Valid Json input schema.
:

まとめ

Amazon Linux 2023でCloudWatch Agentの設定をしてみました。
Amazon Linux 2のサポートは2025年の6月までなので、今後は徐々にAmazon Linux 2023が増えてくると思います。少しずつ変更に慣れていくと良さそうですね。参考になれば嬉しいです。

Amazon Linux 2023でCloudWatch Agentを設定する

やること

EC2の準備

agentの設定

設定ファイル

まとめ