はじめに

豊富な機能を持つことから、Systems Manager（以下、SSM）への苦手意識があったのですが、
先日、builders-flashで以下の記事を読み、少し見え方が変わりました。

読むと分かるのですが、SSMは結構便利そうで、楽しそうです！

今回はSSMの触りとして、
CloudWatchエージェントのインストールと設定を、複数のEC2を対象に一括で実行してみようと思います！！

やってみた

EC2を用意する

SSMで操作するための要件を確認する

まずはEC2を用意します。

EC2インスタンスをSSMで操作するためには、以下を満たす必要があります。
① SSMエージェントがインストールされている
② SSMやCloudwatchを操作するポリシーがEC2にアタッチされている
③ EC2から外部インターネットにアウトバウンドが可能である

また、これらの条件を満たし、SSMが操作可能なインスタンスをマネージドインスタンスと呼びます。

参考）

AMIの選定

いくつかのAMIでは、デフォルトでSSMエージェントがインストールしています。

参考）

今回はAmazonLinuxとUbuntuのAMIを使用してみます。

IAMポリシーの選定

必要なIAMポリシーですが、AWSマネージドのものが存在するので、それを利用します。

SSMエージェント用と、CloudWatchエージェント用の2つのポリシーをアタッチしています。

SSMで操作できるか確認

上述した設定で、EC2が作成できました！

SSMにはフリートマネージャーという機能があり、マネージドインスタンスの一覧が簡単にできます。

マネージドインスタンスとして表示されており、
SSMエージェントのインストールやポリシーなどに問題がなさそうなことが確認できました！

CloudWatch エージェントをインストールする

それでは、2つのマネージドインスタンスを一括操作していきます！
まずはエージェントのインストールからです。

SSM Run Commandを準備する

SSMでは、複数のマネージドインスタンスに一括で同じコマンドを実行するRunCommandという機能が存在します。
（OSが異なっていても一括で命令できるため、実際には宣言型の命令が可能なイメージ）

Run Commandをクリックします

目的のドキュメントを検索する

SSMでは、インスタンスへの命令は「ドキュメント」という単位で管理されています。
今回は、「AWS-ConfigureAWSPackage」というドキュメントを実行させます。

参考）

検索ボックスに「configure」を入力してフィルタしていきます

ドキュメントを選択すると、ドキュメントの説明が表示されます

ディストリビューターパッケージをインストールまたはアンインストールします。最新バージョン、デフォルトバージョン、または指定したパッケージのバージョンをインストールできます。AmazonCloudWatchAgent、AwsEnaNetworkDriver、AWSPVDriverなどのAWSが提供するパッケージもサポートされています。

よさそうですね！

Run Commandのオプションを設定する

Run Commandにはオプションを設定できます
ドキュメントによって、特定のインプット情報が必要だったり、
ドキュメントを問わず、結果をS3にアップロードしたりなど、です

installするパッケージ名に「AmazonCloudWatchAgent」を入力します
そのほかの設定はデフォルトのままで問題なさそうなので、次のオプションに進みます。

RunCommandの対象となるマネージドインスタンスを指定します。

今回は手で設定しましたが、タグやリソースグループ単位で指定できるのはかなり便利そうですね！！

その他のパラメータも埋めていきます。

S3へのアップロードがデフォルトで有効化されていましたが、不要に感じたので無効にしました。

その他の設定もデフォルトで無効になっており、問題はなさそうだったので、実行してみます！

Run Commandの実行結果を確認する

実行をクリックすると、RunCommandが正常に開始されました！

10秒ほど待つと、どちらのインスタンスもRunCommandが成功していることが確認できました

インスタンスIdが結果詳細画面へのリンクになっているので、クリックしてみます

フェーズごとに細かくログが確認できそうです！

ステップ2を確認してみます

アウトプットタブを開くと、無事CloudWatchエージェントがインストールできてそうです

他方のインスタンスも確認してみます

簡単！！凄い！！

CloudWatch エージェントの設定を確認する

RunCommandが成功しているのが確認できたので、インスタンスに接続し、設定状況を確認します。

参考）

Linux サーバーで、次のように入力します。
sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -m ec2 -a status

インストールしただけで、まだ設定・起動は行っていないので、stoppedでnot configured 状態なのが確認できました
良い感じですね！

CloudWatch エージェントのログ配信設定を行う

同じくRunCommand機能を使ってCloudWatch エージェントのログ配信設定を行ってみます

参考）

CloudWatchエージェントの配信設定jsonを用意する

CloudWatchエージェントの配信設定は、jsonで定義されています
この定義用jsonを保存、使いまわすことで、複数のインスタンスに同じ設定でログなどを出力させることができます。凄い！

今回は以下のようなjsonを用意しました

config.json

{
  "logs": {
    "logs_collected": {
      "files": {
        "collect_list": [
          {
            "file_path": "/var/log/apache2/access.log",
            "log_group_name": "/ec2/agent",
            "log_stream_name": "{instance_id}-access"
          },
          {
            "file_path": "/var/log/apache2/error.log",
            "log_group_name": "/ec2/agent",
            "log_stream_name": "{instance_id}-error"
          }
        ]
      }
    },
   "log_stream_name": "{instance_id}-default"
  }
}