概要

Agent のトラフィックはすべて SSL 経由で送信されます。送信先は Datadog のサービスとサイトにより異なります。使用している Datadog サイトの送信先を確認するには、右側の [DATADOG SITE](Datadog サイト) セレクターをクリックしてください。

インストール

Agent のインストールを許可するために、以下のドメインをインクルージョンリストに追加してください。

• install.datadoghq.com
• yum.datadoghq.com
• keys.datadoghq.com
• apt.datadoghq.com
• windows-agent.datadoghq.com

送信先

APM

trace.agent.
instrumentation-telemetry-intake.

LLM 可観測性

llmobs-intake.

Container Images

contimage-intake.

ライブコンテナ、Live Processes、Cloud Network Monitoring、Universal Service Monitoring

process.

Network Device Monitoring

ndm-intake.
snmp-traps-intake.
ndmflow-intake.

Network Path

netpath-intake.
Agent v7.75 以降では、Network Path が HTTPS 経由で外部サービスに接続して、ソースホストの公開 IP を解決します。これはオプションであり、この処理なしでも Network Path は機能します。ただし、ご使用のネットワークでアウトバウンドトラフィックが制限されていて、ソースの公開 IP を解決する必要がある場合は、次のものを許可リストに追加してください: icanhazip.com、ipinfo.io、checkip.amazonaws.com、api.ipify.org、whatismyip.akamai.com。詳細については、Network Path のセットアップを参照してください。

Orchestrator

orchestrator.
contlcycle-intake.

プロファイリング

intake.profile.

RUM (Real User Monitoring)

Cloud Security Vulnerabilities

sbom-intake.

Synthetic Monitoring プライベートロケーション

Synthetics Worker v1.5.0 以降:intake.synthetics. が、設定する必要がある唯一のエンドポイントです。
v0.1.6 より後の Synthetics Worker の API テスト結果: intake.synthetics.
v0.2.0 より後の Synthetics Worker のブラウザテスト結果: intake-v2.synthetics.
v0.1.5 より前の Synthetics Worker の API テスト結果: api.

ログ、HIPAA ログ

(非推奨) TCP:
HTTP:
その他: 「ログエンドポイント」を参照してください。

HIPAA ログレガシー (非推奨、TCP はサポートされていません)

メトリクス、サービスチェック、イベント、およびその他の Agent メタデータ

<VERSION>-app.agent.
たとえば、Agent v7.31.0 は 7-31-0-app.agent. に報告します。*.agent. を ファイアウォールのインクルージョンリストに追加する必要があります。
v6.1.0 以降、Agent は Datadog の API にもクエリを送信し、重要度の低い機能 (構成された API キーの有効性の表示など) を提供します:
Agent v7.18.0 または 6.18.0 以降: api.
Agent v7.18.0 または 6.18.0 より前: app.

Agent フレア

<VERSION>-flare.agent.
たとえば、Agent v7.31.0 は 7-31-0-flare.agent. にフレアデータを送信します。*.agent. を ファイアウォールのインクルージョンリストに追加する必要があります。

静的 IP アドレス

これらのドメインはすべて CNAME レコードであり、一連の静的 IP アドレスを指しています。これらのアドレスは https://ip-ranges.で確認できます。

この情報は、以下のスキーマに従って JSON として構造化されます。

{
    "version": 1,                          // <-- incremented every time this information is changed
    "modified": "YYYY-MM-DD-HH-MM-SS",     // <-- timestamp of the last modification
    "agents": {                            // <-- the IPs used by the Agent to submit metrics to Datadog
        "prefixes_ipv4": [                 // <-- list of IPv4 CIDR blocks
            "a.b.c.d/x",
            ...
        ],
        "prefixes_ipv6": [                 // <-- list of IPv6 CIDR blocks
            ...
        ]
    },
    "api": {...},                          // <-- the IPs used by the Agent for non-critical functionality (querying information from API)
    "apm": {...},                          // <-- the IPs used by the Agent to submit APM data to Datadog
    "logs": {...},                         // <-- the IPs used by the Agent to submit logs to Datadog
    "process": {...},                      // <-- the IPs used by the Agent to submit process data to Datadog
    "orchestrator": {...},                 // <-- the IPs used by the Agent to submit container data to Datadog
    "remote-configuration": {...},         // <-- the IPs used by the Agent to retrieve its dynamic configuration
    "synthetics": {...},                   // <-- the source IPs used by Synthetic workers (not used by the Agent)
    "synthetics-private-locations": {...}, // <-- the IPs used by Synthetics Private Locations workers to submit data to Datadog (not used by the Agent)
    "webhooks": {...}                      // <-- the source IPs used by Datadog to connect to 3rd party infrastructure over HTTP (not used by the Agent)
}

各セクションには専用のエンドポイントがあります。たとえば、次のようなものです。

• https://ip-ranges./logs.json (TCP 経由でログデータを受信するために使用される IP 用)。
• https://ip-ranges./apm.json (APM データを受信するために使用される IP 用)。

インクルージョン

すべての ip-ranges をインクルージョンリストに追加してください。特定の時点でアクティブなのは一部のみですが、定期的なネットワーク操作や保守により、セット全体の中では時間の経過とともにアクティブなアドレスが変化します。

ポートを開く

Agent のすべての機能を利用するには、以下のポートを開いてください。

アウトバウンド

インバウンド

ホスト内でのローカル通信のみを行う Agent サービスで使用されます。

ポートの構成

既存のサービスがネットワーク上ですでにデフォルトポートを使用しているために、受信ポートを変更する必要がある場合は、datadog.yaml 構成ファイルを編集します。ほとんどのポートは、このファイルの Advanced Configuration セクションで確認できます。

## @param expvar_port - integer - optional - default: 5000
## @env DD_EXPVAR_PORT - integer - optional - default: 5000
## The port for the go_expvar server.
#
# expvar_port: 5000

## @param cmd_port - integer - optional - default: 5001
## @env DD_CMD_PORT - integer - optional - default: 5001
## The port on which the IPC api listens.
#
# cmd_port: 5001

## @param GUI_port - integer - optional
## @env DD_GUI_PORT - integer - optional
## The port for the browser GUI to be served.
## Setting 'GUI_port: -1' turns off the GUI completely
## Default is:
##  * Windows & macOS : `5002`
##  * Linux: `-1`
##
#
# GUI_port: <GUI_PORT>

APM レシーバーのポートは datadog.yaml 構成ファイルの Trace Collection Configuration セクションで、DogStatsD ポートは DogStatsD Configuration セクションで確認できます。

## @param dogstatsd_port - integer - optional - default: 8125
## @env DD_DOGSTATSD_PORT - integer - optional - default: 8125
## Override the Agent DogStatsD port.
## Note: Make sure your client is sending to the same UDP port.
#
# dogstatsd_port: 8125

[...]

## @param receiver_port - integer - optional - default: 8126
## @env DD_APM_RECEIVER_PORT - integer - optional - default: 8126
## The port that the trace receiver should listen on.
## Set to 0 to disable the HTTP receiver.
#
# receiver_port: 8126

プロキシの使用

プロキシの設定に関する詳細な構成ガイドは、「Agent プロキシの構成」を参照してください。

データバッファリング

ネットワークが利用できなくなると、Agent はメトリクスをメモリに保存します。 メトリクスを保存するための最大メモリ使用量は、forwarder_retry_queue_payloads_max_size 構成の設定によって定義されます。この制限に達すると、メトリクスは破棄されます。

Agent v7.27.0 以降では、メモリ制限に達した場合、ディスクにメトリクスを保存します。この機能を有効にするには、forwarder_storage_max_size_in_bytes に、Agent がディスクにメトリクスを保存するために使用できる最大ストレージ容量 (バイト数) を示す正の値を設定してください。

メトリクスは、forwarder_storage_path の設定で定義されるフォルダーに保存されます。デフォルトは、Unix システムでは /opt/datadog-agent/run/transactions_to_retry、Windows では C:\ProgramData\Datadog\run\transactions_to_retry です。

ストレージ容量が不足することがないように、Agent は使用されている総ストレージ容量が 80 パーセント未満の場合にのみメトリクスをディスクに保存します。この制限は forwarder_storage_max_disk_ratio の設定によって定義されます。

Datadog Operator のインストール

接続が制限されている Kubernetes 環境に Datadog Operator をインストールする場合は、ご使用のレジストリに基づいて TCP ポート 443 の下記のエンドポイントを許可リストに追加する必要があります。

• registry.datadoghq.com (Datadog コンテナレジストリ)
  • us-docker.pkg.dev/datadog-prod/public-images (registry.datadoghq.com からのリダイレクトを受け取る場合があります)
• gcr.io/datadoghq (GCR 米国)
• eu.gcr.io/datadoghq (GCR ヨーロッパ)
• asia.gcr.io/datadoghq (GCR アジア)
• datadoghq.azurecr.io (Azure)
• public.ecr.aws/datadog (AWS)
• docker.io/datadog (DockerHub)

参考資料

役立つドキュメント、リンク、記事:

Datadog サイトについて学ぶドキュメント ログを収集するドキュメント プロセスを収集するドキュメント トレースを収集するドキュメント