デュアルシッピング

複数の Datadog 組織にデータを送信している場合、デュアルシッピングは請求に影響を与える可能性があります。この構成の影響について詳しくは、Datadog サポートにお問い合わせください。

概要

2 つ目の Datadog 組織や他の内部インフラストラクチャーなど、複数の宛先にデータを送信したい場合、追加のエンドポイントにデータを送信するように Agent を構成することができます。複数のエンドポイントまたは API キーに異なる種類のデータを送信するように Agent を設定するには、次の構成を使用します。

メトリクス、APM、ライブプロセス、オーケストレーター、CI Visibility

YAML 構成を datadog.yaml に追加するか、適切な環境変数で Agent を起動します。

Agent バージョン >= 6.17 または 7.17 が必要です。

YAML 構成

datadog.yaml で:

additional_endpoints:
  "https://app.datadoghq.com":
  - apikey2
  - apikey3
  "https://app.datadoghq.eu":
  - apikey4

環境変数コンフィギュレーション

Agent バージョン >= 6.18 または 7.18 が必要です。
DD_ADDITIONAL_ENDPOINTS='{\"https://app.datadoghq.com\": [\"apikey2\", \"apikey3\"], \"https://app.datadoghq.eu\": [\"apikey4\"]}'
Agent バージョン >= 6.7.0 が必要です。

YAML 構成

datadog.yaml で:

apm_config:
  [...]
  additional_endpoints:
    "https://trace.agent.datadoghq.com":
    - apikey2
    - apikey3
    "https://trace.agent.datadoghq.eu":
    - apikey4

  profiling_additional_endpoints:
    "https://trace.agent.datadoghq.com":
    - apikey2
    - apikey3
    "https://trace.agent.datadoghq.eu":
    - apikey4

環境変数コンフィギュレーション

Agent バージョン >= 6.19 または 7.19 が必要です。
DD_APM_ADDITIONAL_ENDPOINTS='{\"https://trace.agent.datadoghq.com\": [\"apikey2\", \"apikey3\"], \"https://trace.agent.datadoghq.eu\": [\"apikey4\"]}'

DD_APM_PROFILING_ADDITIONAL_ENDPOINTS='{\"https://trace.agent.datadoghq.com\": [\"apikey2\", \"apikey3\"], \"https://trace.agent.datadoghq.eu\": [\"apikey4\"]}'
Agent バージョン >= 6.4.0 が必要です。

YAML 構成

datadog.yaml で:

process_config:
  [...]
  additional_endpoints:
    "https://process.datadoghq.com":
    - apikey2
    - apikey3
    "https://process.datadoghq.eu":
    - apikey4

環境変数コンフィギュレーション

Agent バージョン >= 6.20 または 7.20 が必要です。
DD_PROCESS_ADDITIONAL_ENDPOINTS='{\"https://process.datadoghq.com\": [\"apikey2\", \"apikey3\"], \"https://process.datadoghq.eu\": [\"apikey4\"]}'

YAML 構成

datadog.yaml で:

orchestrator_explorer:
  [...]
  orchestrator_additional_endpoints:
    "https://orchestrator.datadoghq.com":
    - apikey2
    - apikey3
    "https://orchestrator.datadoghq.eu":
    - apikey4

環境変数コンフィギュレーション

DD_ORCHESTRATOR_EXPLORER_ORCHESTRATOR_ADDITIONAL_ENDPOINTS='{\"https://orchestrator.datadoghq.com\": [\"apikey2\", \"apikey3\"], \"https://orchestrator.datadoghq.eu\": [\"apikey4\"]}'
Agent >= 6.38 または 7.38 が必要です。

YAML 構成

datadog.yaml で:

evp_proxy_config:
  [...]
  additional_endpoints:
    "https://mydomain.datadoghq.com":
    - apikey2
    - apikey3
    "https://mydomain.datadoghq.eu":
    - apikey4

環境変数コンフィギュレーション

DD_EVP_PROXY_CONFIG_ADDITIONAL_ENDPOINTS='{\"https://mydomain.datadoghq.com\": [\"apikey2\", \"apikey3\"], \"https://mydomain.datadoghq.eu\": [\"apikey4\"]}'

ログ、データベースモニタリング、ネットワークデバイス、CSPM、ランタイムセキュリティ

TCP には Agent バージョン >= 6.6 が必要です。
HTTPS には Agent バージョン >= 6.13 が必要です。

YAML 構成

datadog.yaml で:

logs_config:
  use_http: true
  additional_endpoints:
  - api_key: "apiKey2"
    Host: "agent-http-intake.logs.datadoghq.com"
    Port: 443
    is_reliable: true

環境変数コンフィギュレーション

Agent >= 6.18 または 7.18 が必要です。
DD_LOGS_CONFIG_USE_HTTP=true
DD_LOGS_CONFIG_ADDITIONAL_ENDPOINTS="[{\"api_key\": \"apiKey2\", \"Host\": \"agent-http-intake.logs.datadoghq.com\", \"Port\": 443, \"is_reliable\": true}]"
Agent >= 6.29 または 7.29 が必要です。

YAML 構成

datadog.yaml で:

database_monitoring:
  samples:
    use_http: true
    additional_endpoints:
    - api_key: "apiKey2"
      Host: "dbm-metrics-intake.datadoghq.com"
      Port: 443
      is_reliable: true
  activity:
    use_http: true
    additional_endpoints:
    - api_key: "apiKey2"
      Host: "dbquery-intake.datadoghq.com"
      Port: 443
      is_reliable: true
  metrics:
    use_http: true
    additional_endpoints:
    - api_key: "apiKey2"
      Host: "dbm-metrics-intake.datadoghq.com"
      Port: 443
      is_reliable: true

環境変数コンフィギュレーション

DD_DATABASE_MONITORING_SAMPLES_USE_HTTP=true
DD_DATABASE_MONITORING_SAMPLES_ADDITIONAL_ENDPOINTS="[{\"api_key\": \"apiKey2\", \"Host\": \"dbm-metrics-intake.datadoghq.com\", \"Port\": 443, \"is_reliable\": true}]"
DD_DATABASE_MONITORING_ACTIVITY_USE_HTTP=true
DD_DATABASE_MONITORING_ACTIVITY_ADDITIONAL_ENDPOINTS="[{\"api_key\": \"apiKey2\", \"Host\": \"dbquery-intake.datadoghq.com\", \"Port\": 443, \"is_reliable\": true}]"
DD_DATABASE_MONITORING_METRICS_USE_HTTP=true
DD_DATABASE_MONITORING_METRICS_ADDITIONAL_ENDPOINTS="[{\"api_key\": \"apiKey2\", \"Host\": \"dbm-metrics-intake.datadoghq.com\", \"Port\": 443, \"is_reliable\": true}]"
Agent >= 6.29 または 7.29 が必要です。

YAML 構成

datadog.yaml で:

network_devices:
  metadata:
    use_http: true
    additional_endpoints:
    - api_key: "apiKey2"
      Host: "ndm-intake.datadoghq.com"
      Port: 443
      is_reliable: true
  snmp_traps:
    forwarder:
      use_http: true
      additional_endpoints:
      - api_key: "apiKey2"
        Host: "ndm-intake.datadoghq.com"
        Port: 443
        is_reliable: true
  netflow:
    forwarder:
      use_http: true
      additional_endpoints:
      - api_key: "apiKey2"
        Host: "ndm-intake.datadoghq.com"
        Port: 443
        is_reliable: true

環境変数コンフィギュレーション

DD_NETWORK_DEVICES_METADATA_USE_HTTP=true
DD_NETWORK_DEVICES_METADATA_ADDITIONAL_ENDPOINTS="[{\"api_key\": \"apiKey2\", \"Host\": \"ndm-intake.datadoghq.com\", \"Port\": 443, \"is_reliable\": true}]"

YAML 構成

datadog.yaml で:

​​compliance_config:
  endpoints:
    use_http: true
    additional_endpoints:
    - api_key: "apiKey2"
      Host: "mydomain.datadoghq.com"
      Port: 443
      is_reliable: true

環境変数コンフィギュレーション

DD_​​COMPLIANCE_CONFIG_ENDPOINTS_USE_HTTP=true
DD_​​COMPLIANCE_CONFIG_ENDPOINTS_ADDITIONAL_ENDPOINTS="[{\"api_key\": \"apiKey2\", \"Host\": \"mydomain.datadoghq.com\", \"Port\": 443, \"is_reliable\": true}]"

YAML 構成

datadog.yaml で:

runtime_security_config:
  endpoints:
    use_http: true
    additional_endpoints:
    - api_key: "apiKey2"
      Host: "mydomain.datadoghq.com"
      Port: 443
      is_reliable: true

環境変数コンフィギュレーション

DD_​​RUNTIME_SECURITY_CONFIG_ENDPOINTS_USE_HTTP=true
DD_​​RUNTIME_SECURITY_CONFIG_ENDPOINTS_ADDITIONAL_ENDPOINTS="[{\"api_key\": \"apiKey2\", \"Host\": \"mydomain.datadoghq.com\", \"Port\": 443, \"is_reliable\": true}]"

これらの製品からのデータについては、追加のエンドポイントを設定する際に、Agent に使用するトランスポートを伝えるため、明示的に use_http を設定する必要があります。追加したすべてのエンドポイントにおいて、同じトランスポート構成が共有されます。

is_reliable 設定 (Agent 7.34.0 で初めて利用可能になりました) は、このエンドポイントをプライマリーエンドポイントと同じ優先度で扱うように Agent に指示します。プライマリーエンドポイントは常に信頼性があります。これにより、宛先が利用できなくなった場合でも、データを見逃すことがなくなります。

例えば、is_reliable: true でメインのエンドポイントと追加のエンドポイントにデータを送信している場合、一方のエンドポイントが使用不能になると、もう一方のエンドポイントにデータが流れ続けます。両方のエンドポイントが利用できなくなった場合、少なくとも一方のエンドポイントが回復するまで、Agent はデータの読み込みと送信を停止します。これにより、すべてのデータが少なくとも 1 つの信頼できるエンドポイントに到達することが保証されます。

Agent 7.37.0+ では、is_reliable の設定のデフォルトは true です。信頼性のないエンドポイントは、少なくとも 1 つの信頼性のあるエンドポイントが利用可能な場合にのみデータを送信します。is_reliable 値の使用量が混在する複数の追加エンドポイントを定義することができます。Datadogでは、デフォルトの is_reliable 設定を使用することを推奨しています。

YAML 構成を datadog.yaml に追加するか、適切な環境変数で Agent を起動します。

Kubernetes のデュアルシッピング

Datadog Agent Helm チャートを使用している場合、これらの設定を configmap で構成する必要があります。values.yamluseConfigMap: true を設定し、customAgentConfig に該当の設定を追加します。

# agents.useConfigMap -- Agent 構成を提供するために、configmap を構成します。これは `agents.customAgentConfig` パラメーターと組み合わせて使用します。
  useConfigMap:  true

  # agents.customAgentConfig -- Datadog Agent 構成 (datadog.yaml) のカスタムコンテンツを指定します。 
  ## ref: https://docs.datadoghq.com/agent/guide/agent-configuration-files/?tab=agentv6
  ## ref: https://github.com/DataDog/datadog-agent/blob/main/pkg/config/config_template.yaml
  ## このパラメーターを考慮するには `agents.useConfigMap` が `true` に設定されている必要があることに注意してください。
  customAgentConfig:
    additional_endpoints:
      "https://app.datadoghq.com":
      - apikey2
      - apikey3
      "https://app.datadoghq.eu":
      - apikey4

    logs_config:
      use_http: true
      additional_endpoints:
      - api_key: "apiKey2"
        Host: "agent-http-intake.logs.datadoghq.com"
        Port: 443
        is_reliable: true

Datadog Agent オペレーターを使用している場合は、同様に、agent.customConfig.configData キーを設定することができます。全ての構成可能キーは v1v2 で文書化されています。