SSMを使ってCloudWatch Logsにログを収集してみた

iwashita written 2年 ago

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので十分ご注意ください。

こんにちは。株式会社協栄情報クラウド事業本部の岩下です。
今回は、CloudWatchを利用するためにCloudWatchエージェントを使い、実際にCloudWatch Logsにログを収集するまでのハンズオンを実行したので記録として残します。

CloudWatchエージェントを使いCloudWatch Logsにログを収集することでEC2インスタンスにログインすることなく、マネジメントコンソールにて見やすく、また簡易的にログの確認ができるというメリットがあります。

CloudWatchエージェントについて

まずCloudWatchとは、AWSで実行されているアプリケーションをリアルタイムでモニタリングできるサービスのことです。
CloudWatchを使用してメトリクスを収集し、追跡できます。メトリクスとは、リソースやアプリケーションに関して測定できる変数のことです。

CloudWatchだけでは監視できない部分(EC2インスタンスの内)をEC2にCloudWatchエージェントをインストールすることで、より細かなメトリクスを測定できる機能のことです。

CloudWatch(サービス全体)とCloudWatchエージェント(EC2インスタンス内)それぞれをわかりやすくいうと、システムでエラーが起きていないかをログを記録し監視するツールになります。

CloudWatchエージェントをサーバーで実行する前に、CloudWatchエージェント設定ファイルの作成が必要です。

CloudWatch エージェント設定ファイルとは、agent、metrics、logs の 3 つのセクションを持つ JSON ファイルのことをいい言います。

前提条件として、

以上を前提条件として始めていきたいと思います。

まずは、TeraTermでEC２インスタンスに接続します。

CloudWatchエージェントをダウンロードします。
(該当のリージョンIDに書き換えが必要。今回の場合はeu-west-1を利用)
```
wget https://s3.eu-west-1.amazonaws.com/amazoncloudwatch-agent-eu-west-1/amazon_linux/amd64/latest/amazon-cloudwatch-agent.rpm
```
CloudWatchエージェントをインストールする
```
$ sudo yum install amazon-cloudwatch-agent
```

CloudWatchエージェント設定ファイルの作成

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

CloudWatchエージェント設定ファイルを作成する際、質問形式で聞かれます。
質問に答えて、サーバーの設定ファイルをカスタマイズします。

collectdをインストール
collectd は、サーバの統計情報を収集するためのオープンソースソフトウェアです。
```
$ sudo amazon-linux-extras install collectd
```

以上でEC2インスタンス上での準備は完了したので、実際にSSMの『Run Command』でエージェントを起動します。

また、EC2の内部に入ることなく簡易的にEC2のコマンドを実行できることから、今回SSMのRun Commandを利用しています。

※『Run Command』とは、各種コマンドをマネジメントコンソール上で実行できるコマンド

SSM(AWS Systems Manager)のサイドメニューから『Run Command』を選択
コマンドドキュメント：起動対象の『AmazonCloudWatch-ManageAgent』を検索して該当のドキュメントを開く
※コマンドドキュメントとは、AWS Systems Managerドキュメントタイプのひとつであり、Systems Managerが実行するアクションが定義されたドキュメントとのこと。
開いたら、『コマンドを実行する』をクリック
コマンドパラメータの画面にて下記を設定する

パラメータストアに保存されているファイル名
Optional Configuration Location: 『AmazonCloudWatch-linux』を入力