コンテナでのホスト名検出

Datadog の多くの機能は、監視するホストの正確なホスト名を提供するために、Agent に依存しています。Agent がホスト上で直接実行される場合、これは簡単ですが、Agent がコンテナ化された環境で実行される場合、ホスト名解決プロセスは異なっています。

バージョン 7.40 以降、Agent はコンテナ環境でのホスト名解決に失敗したことを適切に認識するようになりました。解決されたホスト名がない場合、Agent は起動後すぐにエラーで終了します。

そのような場合、ログに以下のような ERROR メッセージが出力されます。

Error while getting hostname, exiting: unable to reliably determine the host name. You can define one in the agent config file or in your hosts file

このエラーが発生するのは、通常、Agent の構成の一部が正しくないことを意味します。この誤構成の様々な一般的なケースを解決するために、次の情報を使用してください。

Kubernetes のホスト名エラー

Kubernetes では、ホスト名エラーは通常、Agent が少なくとも次のいずれかにアクセスできないことを意味します。

  • Kubelet API
  • クラウドプロバイダーのメタデータエンドポイント
  • コンテナランタイム API

Kubernetes ディストリビューションによっては、専用の構成が必要なものもありますので、Kubernetes の推奨構成に沿った構成であることを確認してください。

Kubelet API へのアクセス

Agent が Kubelet API にアクセスできることを確認します。アクセスできると、Agent はこのログを出力します。

Successful configuration found for Kubelet, using URL: ******

Kubernetes の RBAC 権限は、Datadog 公式のヘルムチャート、Datadog Operator、Datadog 公式のマニフェストで自動的に設定されます。Agent のデプロイに別のソリューションを使用する場合は、Agent サービスアカウントにバインドされる Role または ClusterRole に以下の権限が存在することを確認してください。

rules:
  - apiGroups: # Kubelet の接続性
      - ""
    resources:
      - nodes/metrics
      - nodes/spec
      - nodes/proxy
      - nodes/stats
    verbs:
      - get

Kubelet API への接続を妨げる最も一般的なエラーは、Kubelet の TLS 証明書の検証です。多くの Kubernetes ディストリビューションでは、Kubelet の証明書は以下のどちらかです。

  • クラスター CA によって署名されていない。
  • 到達可能なアドレスに対応する SAN が含まれていない。

これは、TLS 検証がデフォルトで有効になっているため、Agent が HTTPS で Kubelet API に接続できないようにするためです。

専用のパラメーターを使用するか、Agent マニフェストのすべてのコンテナに対して DD_KUBELET_TLS_VERIFY 変数を設定することにより、TLS 検証を無効化することができます。

    DatadogAgent Kubernetes Resource:

    apiVersion: datadoghq.com/v2alpha1
metadata:
  name: datadog
spec:
  global:
    kubelet:
      tlsVerify: false

    Custom datadog-values.yaml:

    datadog:
  kubelet:
    tlsVerify: false

    DaemonSet manifest:

    apiVersion: apps/v1
metadata:
  name: datadog
spec:
  template:
    spec:
      containers:
        - name: agent
          env:
            - name: DD_KUBELET_TLS_VERIFY
              value: "false"

    クラウドプロバイダーのメタデータエンドポイントへのアクセス

    AWS、Google Cloud、または Azure で実行する場合、Agent はホスト名を取得するためにメタデータエンドポイントを使用することができます。

    クラウドプロバイダーのメタデータエンドポイントにアクセスすることで、Datadog は Agent データとアプリケーション内のクラウドインテグレーションデータを適切に照合することができます。

    この問題に遭遇することは、通常、メタデータエンドポイントへのアクセスが制限されていることを意味します。 例えば AWS の場合、ホップ制限の設定が原因である可能性があります。

    コンテナランタイム API へのアクセス

    このソリューションは、Agent が Kubelet API に接続することを明示的に望まない場合、および上記のサポートされるクラウドプロバイダーで実行していない場合にのみ使用してください。

    この場合、Download API を使用して DD_HOSTNAME を設定することができます。

      DatadogAgent Kubernetes Resource:

      apiVersion: datadoghq.com/v2alpha1
metadata:
  name: datadog
spec:
  override:
    nodeAgent:
      env:
        - name: DD_HOSTNAME
          valueFrom:
            fieldRef:
              fieldPath: spec.nodeName

      Custom datadog-values.yaml:

      datadog:
  env:
    - name: DD_HOSTNAME
      valueFrom:
        fieldRef:
          fieldPath: spec.nodeName

      DaemonSet manifest:

      apiVersion: apps/v1
metadata:
  name: datadog
spec:
  template:
    spec:
      containers:
        - name: agent
          env:
            - name: DD_HOSTNAME
              valueFrom:
                fieldRef:
                  fieldPath: spec.nodeName

      Amazon ECS and Docker VM hostname errors

      クラウドプロバイダー上の Docker で Agent を実行する場合、ホスト名エラーは通常、Agent が少なくとも次のいずれかにアクセスできないことを意味します。

      • コンテナランタイム API
      • クラウドプロバイダーのメタデータエンドポイント

      コンテナランタイム API へのアクセス

      Agent が Docker ソケットに接続できるようにします。

        タスク定義で Docker ソケットがマウントされていることを確認します。

        docker run コマンドで Docker ソケットがマウントされていることを確認します。

        -v /var/run/docker.sock:/var/run/docker.sock:ro

        クラウドプロバイダーのメタデータエンドポイントへのアクセス

        AWS、Google Cloud、または Azure で実行する場合、Agent はホスト名を取得するためにメタデータエンドポイントを使用することができます。

        クラウドプロバイダーのメタデータエンドポイントにアクセスすることで、Datadog は Agent データとアプリケーション内のクラウドインテグレーションデータを適切に照合することができます。

        この問題に遭遇することは、通常、メタデータエンドポイントへのアクセスが制限されていることを意味します。 例えば AWS の場合、ホップ制限の設定が原因である可能性があります。

        CI 環境、サイドカーセットアップ、およびコンテナランタイムにアクセスできない環境でのホスト名エラー

        Agent を CI 環境 (つまり Agent はエフェメラル) またはホスト情報にアクセスできないサイドカーとして実行する場合、2 つのオプションがあります。

        • DD_HOSTNAME (datadog.yaml の hostname) を明示的にホスト名に設定する。
        -e DD_HOSTNAME=$(hostname)
        • DD_HOSTNAME_TRUST_UTS_NAMESPACE (datadog.yaml の hostname_trust_uts_namespace) を設定する。

        このオプションは、Datadog Agent 7.42.0 から利用可能です。

        -e DD_HOSTNAME_TRUST_UTS_NAMESPACE=true

        これを設定すると、Agent はコンテナ内のホスト名 (通常はコンテナ名またはポッド名) を使用します。

        注: Fargate のようなサーバーレスソリューションには適用されません。

        上記の解決策で Agent の設定がうまくいかない場合は、Datadog サポートチームまでご連絡ください。

        PREVIEWING: may/unit-testing