ECS Fargate で Mackerel コンテナエージェントによる監視設定をする

タダです.

業務で ECS Fargate の監視をしていく時に Mackerel のコンテナエージェントをセットアップするやり方を確認しました.設定方法をこの記事でまとめていきます.

確認した環境
コンテナエージェントのセットアップ
まとめ

確認した環境

今回のセットアップを確認した環境はコンテナエージェントのバージョンが1.4.0 で確認しています.

コンテナエージェントのセットアップ

コンテナエージェントのセットアップについてはドキュメントの記載があり,サイドカーとして ECS クラスターの中で動作させます.コンテナエージェントを動作させるには,Fargate のプラットフォームバージョンが 1.3.0以降である必要があります.

AWS Fargate プラットフォームバージョン 1.3.0以降

mackerel.io mackerel.io

また,サイドカーとして動かすコンテナはタスク定義で以下の設定が必要です.

コンテナ名:mackerel-container-agent
コンテナイメージ: mackerel/mackerel-container-agent:latest
メモリ制限: ハード制限: 128
環境変数: MACKEREL_CONTAINER_PLATFORM: "ecs",MACKEREL_APIKEY: Mackerel API キー

Systems Manager Parmeter Store に Mackerel API キーを保管

Mackerel API キーは直に環境変数に設定するのではなく Systems Manager Paramater Store に Secure String として Mackerel API キーの文字列を入れてコンテナ起動時に読み込むよう事前準備で設定しておきます.

f:id:sadayoshi_tada:20210420230701p:plain

ECS Fargate のタスク定義にコンテナエージェントの設定を追加

そして,アプリケーションのコンテナのタスク定義と一緒に次のような定義を追加していきます.また,タスクの実行ロールで Systems Manager Paramater Store の読み取り権限も付与して準備が完了です.

      {
        "name":"mackerel-container-agent",
        "image":"mackerel/mackerel-container-agent:latest",
        "memoryReservation": 128,
        "essential":true,
        "environment": [
          {
            "value": "ecs",
            "name": "MACKEREL_CONTAINER_PLATFORM"
          }
        ],
        "secrets": [
          {
            "valueFrom": "mackerel_agent_apikey",
            "name": "MACKEREL_APIKEY"
          }
        ]     
      }