Agent

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

概要

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

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

Datadog は、マイナーおよびパッチリリースごとに Datadog Agent を更新すること、または最低でも月に一度は更新することを推奨しています。

Datadog Agent のメジャーバージョンにアップグレードし、それを最新の状態に保つことが、最新の 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 を一か所で一元管理できます。

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

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 コマンドを使用して、デフォルトのウェブブラウザで GUI を開きます。

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

GUI の要件:

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

コマンドラインインターフェイス

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

Datadog Agent をさらに使いこなす

エージェントのアップデート

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

注: 特定のエージェントインテグレーションを手動でアップデートするには、インテグレーション管理ガイドを参照してください。

構成ファイル

Agent コンフィギュレーションファイルに関するドキュメントを参照してください。

Datadog サイト

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

site:

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

ログの場所

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

Agent のオーバーヘッド

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

エージェントテストのバージョン: 7.34.0
CPU: 平均で CPU の約 0.08% を使用
メモリ: 約 130MB の RAM を使用 (RSS メモリ)
ネットワーク帯域幅: 約 140 B/秒 ▼ | 800 B/秒 ▲
ディスク:
- Linux: ディストリビューションによって 830MB ～ 880MB
- Windows: 870MB

ログ収集:

下記の結果は、HTTP フォワーダーが有効なファイルからの毎秒 110KB のログの収集から取得したものです。異なる圧縮レベルにおけるリソース使用率の推移を示しています。