Agent

Agent v7 が利用可能です。最新バージョンにアップグレードして、すべての新機能を利用してください。

概要

Datadog Agent は、ホスト上で動作するソフトウェアです。ホストからイベントとメトリクスを収集して Datadog に送信します。Datadog 上でモニタリングおよびパフォーマンスデータを分析できます。Datadog Agent はオープンソースであり、そのソースコードは GitHub の DataDog/datadog-agent で公開されています。

Agentをインストールして開始するために、プラットフォームを選択してください。

Datadog では、マイナーリリースやパッチリリースのたびに、あるいは少なくとも毎月、Datadog Agent を更新することをお勧めしています。

最新の Agent 機能と修正を入手するためにサポートされている唯一の方法は、Datadog Agent をメジャーバージョンにアップグレードし、常に最新の状態に保つことです。

Agent をフルインストールすることをお勧めします。ただし、Amazon Linux、CentOS、Debian、Fedora、Red Hat、SUSE、Ubuntu では、スタンドアロンの DogStatsD パッケージを利用できます。このパッケージは、DogStatsD がサイドカーとして動作するコンテナ環境や、フル機能の Agent を使用せずに DogStatsD サーバーを実行する環境で使用されます。

Agent の管理

Fleet Automation による Agent の管理 (推奨)

Fleet Automation は、Datadog Agent のインストール、アップグレード、設定、トラブルシューティングを大規模に行うための、主要なアプリ内ワークフローです。

Fleet Automation ビューを使用すると、Datadog Agent を 1 か所で一元管理できます。

設定と履歴の表示: フリート内のすべての Agent、そのバージョン、有効な製品、設定ファイル、および変更履歴を単一のページで表示します。
古い Agent のアップグレード: 数回クリックするだけで Agent のリモートアップグレードを実行し、フリートを最新の状態に保ちます。
サポートへのフレアの送信: ホストの [Support] (サポート) タブから、コマンドラインを使用せずにフレアを生成し、既存または新規のサポートケースに添付します。
API キー使用状況の監査: 特定の API キーを使用している Agent を特定し、安全にキーをローテーションします。

###Datadog Agent Manager GUI {#datadog-agent-manager-gui}

Agent GUI は 32 ビットの Windows プラットフォームではサポートされていません。

Datadog Agent Manager GUI を使用して下記の操作ができます。

Agent のステータス情報の表示
実行中のすべてのチェックの表示
Agent ログの表示
Agent 設定ファイル (datadog.yaml) の編集
Agent チェックの追加または編集
フレアの送信

Datadog Agent Manager GUI は Windows と macOS ではデフォルトで有効になっており、ポート 5002 で動作します。datadog-agent launch-gui コマンドを使用して、デフォルトの Web ブラウザで GUI を開きます。

GUI のデフォルトポートは、datadog.yaml 設定ファイルで変更できます。GUI を無効にするには、ポートの値を -1 に設定します。Linux では、GUI はデフォルトで無効になっています。

GUI の要件:

ブラウザで Cookie が有効になっている必要があります。GUI はブラウザ内にトークンを生成して保存します。このトークンは GUI サーバーとのすべての通信の認証に使用されます。 -GUI を起動するには、ユーザーに必要な権限が必要です。datadog.yaml を開くことができれば、GUI を使用できます。 -セキュリティ上の理由から、GUI にはローカルネットワークインターフェイス (localhost/127.0.0.1) からのみアクセスできます。そのため、Agent が動作しているホスト上で操作する必要があります。VM やコンテナ上で Agent を実行し、それをホストマシンからアクセスすることはできません。

###コマンドラインインターフェイス {#command-line-interface}

Agent 6 以降、Agent のコマンドラインインターフェイスはサブコマンドに基づいています。Agent サブコマンドの全リストについては、Agent コマンドを参照してください。

##Datadog Agent の詳細情報 {#getting-further-with-the-datadog-agent}

Agent の更新

特定のホスト上で Datadog Agent コアを 2 つのマイナーバージョン間で手動更新するには、使用しているプラットフォームに対応するインストールコマンドを実行します。

注: 特定の Agent インテグレーションを手動で更新する場合は、インテグレーション管理ガイドを参照してください。

###設定ファイル {#configuration-files}

Agent 設定ファイルのドキュメントを参照してください。

###Datadog サイト {#datadog-site}

Agent のメイン設定ファイルである datadog.yaml を編集して、site パラメーター (デフォルトは datadoghq.com) を設定します。

site:

注: site パラメーターの詳細については、Datadog サイトの概要ドキュメントを参照してください。

###ログの場所 {#log-location}

Agent ログファイルのドキュメントを参照してください。

##Agent のオーバーヘッド {#agent-overhead}

Datadog Agent のリソース消費量の例を下記に示します。テストは Amazon EC2 マシン c5.xlarge インスタンス (4 VCPU、8GB RAM) で行われ、同様のリソースを持つ ARM64 ベースのインスタンスでも同等のパフォーマンスが確認されました。バニラ状態の datadog-agent は、Agent 自体をモニタリングするためのプロセスチェックが実行されている状態で動作していました。有効にするインテグレーションを増やすと、Agent のリソース消費量が増加する可能性があります。 JMX チェックを有効にすると、モニタリング対象の JVM によって公開される Bean の数に応じて、Agent がより多くのメモリを使用するようになります。Trace Agent や Process Agent を有効にすることでも、リソース消費量は増加します。

*Agent テストバージョン: 7.34.0