CloudWatchエージェントがEC2サービスエンドポイントのデュアルスタックに対応したのでIPv6だけでカスタムメトリクス送信できた！

2026/01/03

CloudWatchエージェントがEC2サービスデュアルスタックエンドポイントに送信できない

昨日のCloudWatchエンドポイントがIPv6に対応したのでCloudWatchエージェントからカスタムメトリクスを送信しましたに書いた通り、CloudWatchエージェントがEC2サービスエンドポイントでデュアルスタックエンドポイントを使ってくれないので、このブログのIPv6ありパブリックIPv4なしのEC2インスタンスからはカスタムメトリクスのディメンションを設定できませんでした。

CloudWatchエージェントv1.300061.0で解決

そこでAmazon Q Developerに何かやり方がないかなと思って色々聞いてみたのですが、これといって信頼性のある回答もありませんでした。
その中で、override_endpointに複数のエンドポイント設定ができるという誤った情報がありまして、試したところエラーが発生したので、エラーメッセージを見せると「CloudWatchエージェントのバージョンが古いからです」などと言われました。
本当かなと思って、リリースノートをリリースノートを確認しました。
aws/amazon-cloudwatch-agent Releases

すると、最新バージョンの1つ前のバージョンv1.300061.0に次の記述がありました。

[Agent] IPv6 Support on EC2
Adds CloudWatch Agent support for IPv6 on EC2 INSTANCES

リンク先のPull Requestsを見に行くと、サンプルのパラメーター設定と合わせて使い方が書かれていました。
Cloudwatch Agent IPv6 support (#1864) #1871

logsとmetricsで個別にoverride_endpointは使わなくて良いようです。
use_dualstack_endpoint=trueをagentセクションに設定すれば良いだけです。
append_dimensionsと併用しているサンプルもあったのでできそうでした。

設定

今動いているCloudWatchエージェントを停止

amazon-cloudwatch-agent-ctl -a stop

1 2	amazon-cloudwatch-agent-ctl -a stop

最新のCloudWatchエージェントのパッケージをダウンロード
まだdnf updateなどではv1.300060.0までしか取得できませんでした。

wget https://amazoncloudwatch-agent.s3.amazonaws.com/amazon_linux/arm64/latest/amazon-cloudwatch-agent.rpm

1 2	wget https://amazoncloudwatch-agent.s3.amazonaws.com/amazon_linux/arm64/latest/amazon-cloudwatch-agent.rpm

ダウンロードしたパッケージのバージョンを確認

rpm -qp amazon-cloudwatch-agent.rpm

1 2	rpm -qp amazon-cloudwatch-agent.rpm

最新バージョンであることを確認できました。
amazon-cloudwatch-agent-1.300062.0b1304-1.aarch64

最新のCloudWatchエージェントをインストール

rpm -U ./amazon-cloudwatch-agent.rpm

1 2	rpm -U ./amazon-cloudwatch-agent.rpm

状態を確認

amazon-cloudwatch-agent-ctl -a status

1 2	amazon-cloudwatch-agent-ctl -a status

最新バージョンがインストールされて停止中であることを確認しました。
{
“status”: “stopped”,
“starttime”: “”,
“configstatus”: “configured”,
“version”: “1.300062.0b1304”
}

パラメータ設定ファイルを作成

vim /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json

1 2	vim /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json

次の設定にしました。
EC2エンドポイントを必要とする${aws:InstanceId}などもappend_dimensionsで設定しています。
“use_dualstack_endpoint”: trueを設定しています。

{
        "agent": {
                "metrics_collection_interval": 60,
                "run_as_user": "root",
                "use_dualstack_endpoint": true
        },
        "logs": {
                "logs_collected": {
                        "files": {
                                "collect_list": [
                                        {
                                                "file_path": "/var/log/cloud-init-output.log",
                                                "log_group_name": "/blog/cloud-init-output",
                                                "log_stream_name": "{instance_id}"
                                        },
                                        {
                                                "file_path": "/var/log/nginx/access.log",
                                                "log_group_name": "/blog/nginx-access",
                                                "log_stream_name": "{instance_id}"
                                        },
                                        {
                                                "file_path": "/var/log/nginx/error.log",
                                                "log_group_name": "/blog/nginx-error",
                                                "log_stream_name": "{instance_id}"
                                        },
                                        {
                                                "file_path": "/var/log/php-fpm/error.log",
                                                "log_group_name": "/blog/php-fpm-error",
                                                "log_stream_name": "{instance_id}"
                                        },
                                        {
                                                "file_path": "/var/log/php-fpm/www-error.log",
                                                "log_group_name": "/blog/php-fpm-www-error",
                                                "log_stream_name": "{instance_id}"
                                        },
                                        {
                                                "file_path": "/var/log/amazon/ssm/amazon-ssm-agent.log",
                                                "log_group_name": "/blog/amazon-ssm-agent",
                                                "log_stream_name": "{instance_id}"
                                        },
                                        {
                                                "file_path": "/var/log/secure",
                                                "log_group_name": "/blog/secure",
                                                "log_stream_name": "{instance_id}"
                                        },
                                        {
                                                "file_path": "/var/log/cloud-init.log",
                                                "log_group_name": "/blog/cloud-init",
                                                "log_stream_name": "{instance_id}"
                                        },
                                        {
                                                "file_path": "/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log",
                                                "log_group_name": "/blog/cwagent",
                                                "log_stream_name": "{instance_id}"
                                        }
                                ]
                        }
                }
        },
        "metrics": {
                "append_dimensions": {
                        "AutoScalingGroupName": "${aws:AutoScalingGroupName}",
                        "ImageId": "${aws:ImageId}",
                        "InstanceId": "${aws:InstanceId}",
                        "InstanceType": "${aws:InstanceType}"
                },
                "metrics_collected": {
                        "collectd": {
                                "metrics_aggregation_interval": 60
                        },
                        "disk": {
                                "measurement": [
                                        "used_percent"
                                ],
                                "metrics_collection_interval": 60,
                                "resources": [
                                        "*"
                                ]
                        },
                        "mem": {
                                "measurement": [
                                        "mem_used_percent"
                                ],
                                "metrics_collection_interval": 60
                        },
                        "statsd": {
                                "metrics_aggregation_interval": 60,
                                "metrics_collection_interval": 10,
                                "service_address": ":8125"
                        }
                }
        }
}

{

"agent": {

"metrics_collection_interval": 60,

"run_as_user": "root",

"use_dualstack_endpoint": true

"logs": {

"logs_collected": {

"files": {

"collect_list": [

{

"file_path": "/var/log/cloud-init-output.log",

"log_group_name": "/blog/cloud-init-output",