このチェックは Mesos マスターのメトリクスを収集します。Mesos スレーブのメトリクスについては、Mesos スレーブインテグレーションのドキュメントを参照してください。

概要

このチェックは、Mesos マスターから以下の情報に関するメトリクスを収集します。

• クラスターリソース
• スレーブ (登録済み、アクティブ、非アクティブ、接続済み、切断済みなど)
• タスクの数 (失敗、終了、ステージング済み、実行中など)
• フレームワークの数 (アクティブ、非アクティブ、接続済み、切断済み)

その他にも多数あります。

セットアップ

インストール

DC/OS の有無にかかわらず、Mesos でのインストールは同じです。各 Mesos マスターノードで datadog-agent コンテナを実行します。

docker run -d --name datadog-agent \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc/:ro \
  -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
  -e DD_API_KEY=<YOUR_DATADOG_API_KEY> \
  -e MESOS_MASTER=true \
  -e MARATHON_URL=http://leader.mesos:8080 \
  gcr.io/datadoghq/agent:latest

上のコマンドの Datadog API キーと Mesos Master の API URL は、適切な値に置き換えてください。

コンフィグレーション

正しい Master URL を渡して datadog-agent を起動した場合、Agent は、既にデフォルトの mesos_master.d/conf.yaml を使用してマスターからメトリクスを収集しています。ほかに必要な構成はありません。使用可能なすべての構成オプションの詳細については、サンプル mesos_master.d/conf.yaml を参照してください。

ただし、マスターの API が自己署名証明書を使用しない場合は、mesos_master.d/conf.yaml で disable_ssl_validation: true を設定してください。

ログの収集

1. Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。

   logs_enabled: true
   

2. Mesos のログの収集を開始するには、次の構成ブロックを mesos_master.d/conf.yaml ファイルに追加します。

   logs:
     - type: file
       path: /var/log/mesos/*
       source: mesos
   

   path パラメーターの値を環境に合わせて変更するか、デフォルトの Docker stdout を使用します。

   logs:
     - type: docker
       source: mesos
   

   使用可能なすべての構成オプションの詳細については、サンプル mesos_master.d/conf.yaml を参照してください。

3. Agent を再起動します。

Kubernetes 環境でログを収集する Agent を構成する追加の情報に関しては、Datadog ドキュメントを参照してください。

検証

Datadog で、メトリクスエクスプローラーを使用して mesos.cluster を検索します。

収集データ

メトリクス

イベント

Mesos-master チェックには、イベントは含まれません。

サービスのチェック

mesos_master.can_connect
Returns CRITICAL if the Agent cannot connect to the Mesos Master API to collect metrics, UNKNOWN if the master is not detected as the leader, otherwise OK.
Statuses: ok, critical, unknown

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。

その他の参考資料

• DC/OS を使用した Mesos への Datadog のインストール

Mesos Slave インテグレーション

概要

この Agent チェックは、Mesos スレーブから以下の情報に関するメトリクスを収集します。

• システム負荷
• タスクの数 (失敗、終了、ステージング済み、実行中など)
• エグゼキューターの数 (実行中、途中終了など)

その他にも多数あります。

このチェックは、エグゼキュータータスクごとにサービスチェックも作成します。

セットアップ

インストール

このブログ記事の手順に従って、DC/OS Web UI から各 Mesos エージェントノードに Datadog Agent をインストールします。

コンフィギュレーション

DC/OS

1. DC/OS Web UI で、Universe タブをクリックします。datadog パッケージを見つけ、Install ボタンをクリックします。
2. Advanced Installation ボタンをクリックします。
3. 最初のフィールドに Datadog API キーを入力します。
4. Instances フィールドに、クラスター内のスレーブノードの数を入力します (クラスター内のノードの数は、DC/OS Web UI の左側にある Nodes タブをクリックすると確認できます)。
5. Review and Install をクリックし、Install をクリックします。

Marathon

DC/OS を使用していない場合は、Marathon Web UI を使用するか、次の JSON を API URL にポストして、Datadog Agent アプリケーションを定義します。<YOUR_DATADOG_API_KEY> をご使用の API キーに置き換え、インスタンスの数をクラスター内のスレーブノードの数に置き換える必要があります。また、使用される Docker イメージを最新のタグに更新する必要があります。最新のイメージは Docker Hub にあります。

{
  "id": "/datadog-agent",
  "cmd": null,
  "cpus": 0.05,
  "mem": 256,
  "disk": 0,
  "instances": 1,
  "constraints": [
    ["hostname", "UNIQUE"],
    ["hostname", "GROUP_BY"]
  ],
  "acceptedResourceRoles": ["slave_public", "*"],
  "container": {
    "type": "DOCKER",
    "volumes": [
      {
        "containerPath": "/var/run/docker.sock",
        "hostPath": "/var/run/docker.sock",
        "mode": "RO"
      },
      { "containerPath": "/host/proc", "hostPath": "/proc", "mode": "RO" },
      {
        "containerPath": "/host/sys/fs/cgroup",
        "hostPath": "/sys/fs/cgroup",
        "mode": "RO"
      }
    ],
    "docker": {
      "image": "gcr.io/datadoghq/agent:latest",
      "network": "BRIDGE",
      "portMappings": [
        {
          "containerPort": 8125,
          "hostPort": 8125,
          "servicePort": 10000,
          "protocol": "udp",
          "labels": {}
        }
      ],
      "privileged": false,
      "parameters": [
        { "key": "name", "value": "datadog-agent" },
        { "key": "env", "value": "DD_API_KEY=<YOUR_DATADOG_API_KEY>" },
        { "key": "env", "value": "MESOS_SLAVE=true" }
      ],
      "forcePullImage": false
    }
  },
  "healthChecks": [
    {
      "protocol": "COMMAND",
      "command": { "value": "/probe.sh" },
      "gracePeriodSeconds": 300,
      "intervalSeconds": 60,
      "timeoutSeconds": 20,
      "maxConsecutiveFailures": 3
    }
  ],
  "portDefinitions": [
    { "port": 10000, "protocol": "tcp", "name": "default", "labels": {} },
    { "port": 10001, "protocol": "tcp", "labels": {} }
  ]
}

カスタム mesos_slave.d/conf.yaml を構成する場合を除き (通常は disable_ssl_validation：true を設定する必要があります)、エージェントのインストール後に必要な作業はありません。

ログの収集

1. Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。

   logs_enabled: true
   

2. Mesos のログの収集を開始するには、次の構成ブロックを mesos_slave.d/conf.yaml ファイルに追加します。

   logs:
     - type: file
       path: /var/log/mesos/*
       source: mesos
   

   path パラメーターの値を環境に合わせて変更するか、デフォルトの Docker stdout を使用します。

   logs:
     - type: docker
       source: mesos
   

   使用可能なすべての構成オプションの詳細については、sample mesos_slave.d/conf.yamlを参照してください。

3. Agent を再起動します。

Kubernetes 環境でログを収集する Agent を構成する追加の情報に関しては、Datadog ドキュメントを参照してください。

検証

DC/OS

DC/OS Web UI の Services タブに、Datadog Agent が表示されます。Datadog で、メトリクスエクスプローラーを使用して mesos.slave を検索します。

Marathon

DC/OS を使用していない場合は、正常に実行中のアプリケーションの一覧に datadog-agent が表示されます。Datadog で、メトリクスエクスプローラーを使用して mesos.slave を検索します。

収集データ

メトリクス

イベント

Mesos スレーブチェックには、イベントは含まれません。

サービスのチェック

mesos_slave.can_connect
Returns CRITICAL if the Agent cannot connect to the Mesos slave metrics endpoint, otherwise OK.
Statuses: ok, critical

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。

その他の参考資料

• DC/OS を使用した Mesos への Datadog のインストール