More than 1 year has passed since last update.

CloudWatch Agentでのログ監視

Posted at 2023-04-27

はじめに

CloudWatch Agentを使用してログを収集し、エラーが発生した場合には通知を行いたいというユースケースが以前にもあって、やり方を忘れかけていたので備忘録として記事に残そうと思います。(最近AWSに触れていなかったせいもあり。。)
この記事では、EC2上のサンプルログをCloudWatch Logsに収集し、SNSを使用してエラーが発生した場合にメールを送信する方法を記載します。

手順

画像挿入

主に以下のような手順で実施していきます。

EC2インスタンスにCloudWatch Agentをインストールし、設定ファイルを作成。
CloudWatch Logsにロググループを作成し、設定ファイルで指定したログストリームにログを送信するように設定。
SNSトピックを作成し、通知先のメールアドレスを設定。
CloudWatch Alarmを設定し、SNSトピックを通知先に設定。

EC2インスタンスの設定

IAM Roleの作成

まずはじめにEC2インスタンスからCloudWatchにログを収集するためのRoleを作成する必要があります。「CloudWatchAgentServerPolicy」をアタッチしたRoleを作成します。IAMコンソール上から作成可能なので細かい手順は飛ばします。
以下のようなRoleができればOKです。

CloudWatch Agentのインストールと設定ファイルの作成

今回はamazon linuxのインスタンスを利用しますので手順は別OSを利用する場合はインストール方などは異なりますが、ドキュメントに記載してあるのでそれ通り行えば問題ないです。

CloudWatch Agentのインストール

以下のコマンドでインストールを行います。

　　$ sudo yum install amazon-cloudwatch-agent -y

設定ファイルの作成

今回はsample.log、sample_2.log(自分で作成した)の２つを同じSampleグループになるように設定しました。シスログを送ろうとしたのですが、amazon linux2023ではsystemd-journaldで管理しているぽいので/var/log/messagesなどがなかったです。。今回の目的とはずれてしまうので適当なlogを指定して試すことにしました。

  {
      "logs": {
        "logs_collected": {
          "files": {
            "collect_list": [
              {
                "file_path": "/home/ec2-user/sample.log",
                "log_group_name": "Sample",
                "log_stream_name": "sample.log",
                "timezone": "UTC"
              },
              {
                "file_path": "/home/ec2-user/sample_2.log",
                "log_group_name": "Sample",
                "log_stream_name": "sample_2.log",
                "timezone": "UTC"
              }
            ]
          } 
        },
        "log_stream_name": "sample"
      }
}

起動

上記で作成したjsonファイルを指定してCloudWatch Agentを起動します。

$ sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -s -c file:configuration-file-path
$ sudo sysytemctl status amazon-cloudwatch-agent