Agent の概要
Datadog の調査レポート: サーバーレスの状態 レポート: サーバーレスの状態

Agent の概要

概要

Agent は軽量なソフトウェアで、ホストにインストールされます。インテグレーションDogStatsD、または API を介して、ホストのメトリクスとイベントを Datadog に報告します。追加のセットアップを行うと、Agent からライブプロセスログ、およびトレースを報告できるようになります。

セットアップ

Datadog アカウントをまだ作成していない場合は作成します。

インストール

Agent はさまざまなプラットフォームにインストールでき、インストール方法には、ホストへの直接インストールとコンテナバージョンによるものがあります。ほとんどのシステムで、1 行のインストールオプションがあります。

Choose your platform to see installation instructions:

コンフィグレーション

Agent のメイン構成ファイルdatadog.yaml です。必須パラメーターは Datadog API キーだけで、Agent のデータをオーガニゼーションに関連付けるために使用されます。使用可能なすべての構成オプションの詳細については、config_template.yaml のサンプルを参照してください。

Container Agent では、datadog.yaml 構成オプションは環境変数で渡されます。たとえば、Datadog API キーの環境変数は DD_API_KEY です。

Agent のメイン構成ファイルdatadog.yaml です。必須パラメーターは Datadog API キーで、これを使用して Agent のデータをオーガニゼーションと Datadog サイト (datadoghq.eu) に関連付けます。使用可能なすべての構成オプションの詳細については、config_template.yaml のサンプルを参照してください。

Container Agent では、datadog.yaml 構成オプションは環境変数で渡されます。たとえば以下のとおりです。

  • DD_API_KEY は Datadog API キー用
  • DD_SITE は Datadog サイト用

検証

インストールを検証するには、Agent のステータスコマンドを実行します。

コマンド

Agent を起動停止 または 再起動する方法については、Agent のコマンドページを参照してください。

収集データ

メトリクス

Agent

Agent v6 で使用できるメトリクスを下記に示します。Agent v5 については、Agent メトリクスインテグレーションを参照してください。

メトリクス説明
datadog.agent.python.versionAgent が現在 Datadog に報告中の場合は、値 1 が表示されます。メトリクスには python_version がタグ付けされています。
datadog.agent.runningAgent が現在 Datadog に報告中の場合は、値 1 が表示されます。
datadog.agent.startedAgent 起動時に値 1 で送信されるカウント (v6.12 以上で使用可能)。

Checks

一部のプラットフォームの Agent では、メトリクスを収集するいくつかのコアチェックがデフォルトで有効になっています。

Checkメトリクスプラットフォーム
CPUシステムすべて
Diskディスクすべて
DockerDockerDocker
ファイルハンドルシステムMac 以外のすべて
IOシステムすべて
LoadシステムWindows 以外のすべて
メモリシステムすべて
ネットワークネットワークすべて
NTPNTPすべて
アップタイムシステムすべて
WinprocシステムWindows

他のテクノロジーからメトリクスを収集する方法については、インテグレーションのページを参照してください。

イベント

Agent の起動または再起動の際に、Agent はイベントを Datadog に送信します。

サービスのチェック

datadog.agent.up: Agent が Datadog に接続できない場合は、CRITICAL を返します。それ以外の場合は、OK を返します。

datadog.agent.check_status: Agent チェックが Datadog にメトリクスを送信できない場合は、CRITICAL を返します。それ以外の場合は、OK を返します。

トラブルシューティング

Agent のトラブルシューティングに関するヘルプ

その他の参考資料

次のステップ