DatadogでDocker Integrationを有効化する方法

11月 1, 2019AWS,Datadog,運用監視

概要

はじめに

• 今回は、DatadogのDocker Integrationを有効化する方法をご紹介します。
• Datadog の概要は、下記のログミーTechで公開されている服部さんの記事を参照ください。

クラウド時代のサーバー監視における、良いメトリックの4要素 - Part1 - ログミーTech

2018年9月22日、Japan Azure User Groupが主催するイベント「Japan Azure User Group 8周年イベント」 ...

 https://logmi.jp/tech/articles/320138

Datadogで実現するDockerの監視

• DatadogのIntegrationを利用して、Dockerデーモンおよびコンテナの死活監視が可能です。Datadogのドキュメントは、以下を参照。
• Dockerの場合は “docker.d" のconf を使用します。

Docker Daemon

Datadogが大規模なクラウドのモニタリングサービスをリードします。

 https://docs.datadoghq.com/ja/integrations/docker_daemon/

Docker Integrationのインストール

• 先ず、Integrations → Integrations にて、Availableの一覧から「Docker」を選択して、「Install」を押します。
• Integrationをインストールしただけでは、「No data received」となり、まだ監視対象のサーバーから情報を取得できていません。

• DockerのIntegrationには、下記の説明があります。dd-agentユーザーの設定変更、conf.yamlの作成が必要となる様ですね。

• 以下は実際のIntegrationの説明画面です。

dd-agentユーザーの設定変更

• idコマンドを実行し、dd-agentユーザーの所属するグループを確認します。現在プライマリグループにdd-agentのみ所属しています。
• usermodコマンドを使用して、dd-agentユーザーのセカンダリグループを設定します。
• /etc/group, idコマンドより、セカンダリグループが追加されていることを確認します。

$ id -a dd-agent
uid=498(dd-agent) gid=496(dd-agent) groups=496(dd-agent)
$ grep docker /etc/group
docker:x:497:
$ sudo usermod -a -G docker dd-agent
$ grep docker /etc/group
docker:x:497:dd-agent
$ id -a dd-agent
uid=498(dd-agent) gid=496(dd-agent) groups=496(dd-agent),497(docker)

conf.yamlを作成する

• conf.yamlを作成します。以下に、サンプルを記載します。

init_config:
instances:
    - url: "unix://var/run/docker.sock"
      new_tag_names: true

conf.yamlを配置する

• conf.yaml を/etc/datadog-agent/conf.d/docker.d配下に配置します。
• datadog-agent.serviceを再起動します。

$ cd /etc/datadog-agent/conf.d/docker.d
$ sudo vi conf.yaml
$ sudo systemctl restart datadog-agent.service

Datadogでmonitor を作成する

• monitor typeに「Metric」を選択し、monitorを作成します。
• メトリクスの候補から「docker.service_up」、「docker.container_health」を選択します。
• 以下、メトリクスの説明です。
  • docker.service_up: Agent が Docker デーモンからコンテナのリストを収集できない場合は、CRITICAL を返します。それ以外の場合は、OK を返します。
  • docker.container_health: このサービスチェックは、Agent v5 でのみ使用できます。コンテナが正常でない場合は CRITICAL、健全性が不明な場合は UNKNOWN、それ以外の場合は OK を返します。
  • docker.exit: コンテナが 0 以外の終了コードで終了した場合は、CRITICAL を返します。それ以外の場合は、OK を返します。