Datadog Agent配下で複数のチェックプログラムを動作させている場合に、特定のプログラムのみ無効にする方法を示す。なお、Agentのバージョンは7.45.0 for Linuxを使用する。

ここではプログラム名を「monitor-test」とする。

  • 現状確認
$ ls -1 /etc/datadog-agent/checks.d/monitor-test.py /etc/datadog-agent/conf.d/monitor-test.d/monitor-test.yaml
/etc/datadog-agent/checks.d/monitor-test.py
/etc/datadog-agent/conf.d/monitor-test.d/monitor-test.yaml

$ sudo -u dd-agent datadog-agent check monitor-test
=========
Collector
=========

  Running Checks
  ==============

    monitor-test (1.0.0)
    --------------------
      Instance ID: monitor-test:xxxxxxxxxxxxxxxx [OK]
      Configuration Source: file:/etc/datadog-agent/conf.d/monitor-test.d/monitor-test.yaml
      Total Runs: 1
      Metric Samples: Last Run: 0, Total: 0
      Events: Last Run: 0, Total: 0
      Service Checks: Last Run: 0, Total: 0
      Average Execution Time : 1ms
      Last Execution Date : 2025-03-25 20:55:44 JST / 2025-03-25 11:55:44 UTC (1742903744000)
      Last Successful Execution Date : 2025-03-25 20:55:44 JST / 2025-03-25 11:55:44 UTC (1742903744000)


Check has run only once, if some metrics are missing you can try again with --check-rate to see any other metric if available.

(*) 上記コマンド実行時に「Check has run only once」と書いてある通りスクリプトが1回だけ実行される

  • 無効化

設定ファイルを別名に変更してDatadog Agentを再起動する。(ここでは別名の拡張子を「.disable」としているが、なんでもよい)

$ sudo mv /etc/datadog-agent/conf.d/monitor-test.d/monitor-test.yaml{,.disable}

$ sudo systemctl restart datadog-agent

$ sudo -u dd-agent datadog-agent check monitor-test
Error: no valid check found
  • 有効化

無効化したプログラムを再度有効化するには設定ファイルのファイル名を元に戻してDatadog Agentを再起動する。

$ sudo mv /etc/datadog-agent/conf.d/monitor-test.d/monitor-test.yaml{.disable,}

$ sudo systemctl restart datadog-agent

$ sudo -u dd-agent datadog-agent check monitor-test
=========
Collector
=========

  Running Checks
  ==============

    monitor-test (1.0.0)
    --------------------
      Instance ID: monitor-test:xxxxxxxxxxxxxxxx [OK]
      Configuration Source: file:/etc/datadog-agent/conf.d/monitor-test.d/monitor-test.yaml
      Total Runs: 1
      Metric Samples: Last Run: 0, Total: 0
      Events: Last Run: 0, Total: 0
      Service Checks: Last Run: 0, Total: 0
      Average Execution Time : 1ms
      Last Execution Date : 2025-03-25 20:59:26 JST / 2025-03-25 11:59:26 UTC (1742903966000)
      Last Successful Execution Date : 2025-03-25 20:59:26 JST / 2025-03-25 11:59:26 UTC (1742903966000)


Check has run only once, if some metrics are missing you can try again with --check-rate to see any other metric if available.
  • 注意点

プログラムがDatadogにカスタムメトリクスを送信している場合、プログラムを無効にするとメトリクス自体が送信されなくなり監視モニター側で評価が行われなくなるため、監視モニター側でエラーになっている状態でプログラムを無効にするとエラー状態のままとなる。この場合は手動で当該モニターの「Resove」を実施してエラー状態をクリアする必要がある。

  • ログ

期待通りの動作をしない場合はDatadog Agentのログを確認する。

/var/log/datadog/agent.log

  • 関連ドキュメント

Agent チェックのトラブルシューティング – Datadog