Agent の概要

概要

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

セットアップ

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

インストール

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

Choose your platform to see installation instructions:

integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration
integration

コンフィグレーション

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

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

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

検証

インストールを検証するには、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 以上で使用可能)。

チェック

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

チェックメトリクスプラットフォーム
CPUSystemすべて
ディスクDiskすべて
DockerDockerDocker
ファイル処理SystemMac 以外のすべて
IOSystemすべて
ロードSystemWindows 以外のすべて
メモリSystemすべて
ネットワークNetworkすべて
NTPNTPすべて
アップタイムSystemすべて
WinprocSystemWindows

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

イベント

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

サービスチェック

datadog.agent.up: Agent が Datadog に接続できる場合は、OK を返します。

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

トラブルシューティング

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

その他の参考資料

次のステップ

Agent をインストールしたら、次のドキュメントを参照してください