ライブコンテナの構成

公式の Datadog Helm チャートを使用している場合、

• バージョン 2.10.0 以降のチャートを使用します。 注: Agent および Cluster Agent のバージョンが、Helm チャート values.yaml ファイルで必要最低限以上のバージョンでハードコードされるようにしてください。

• Process Agent が有効になっていることを確認してください。これを行うには、datadog-values.yaml ファイルを変更して次の値を含めるようにします。

  datadog:
      # (...)
      processAgent:
          enabled: true
  

• 新しいリリースをデプロイします。

一部のセットアップでは、Process Agent と Cluster Agent で Kubernetes クラスター名が自動検出されません。この場合、機能は起動せず、Cluster Agent ログで以下のような警告が表示されます。Orchestrator explorer enabled but no cluster name set: disabling。この場合、datadog.clusterName を values.yaml でクラスター名に設定する必要があります。

Cluster Agent バージョン >= 1.11.0 は、DaemonSet を構成する前に必要となります。Cluster Agent が実行中で Agent と通信できることを確認してください。コンフィギュレーションの詳細は、Cluster Agent のセットアップを参照してください。

1. 以下の環境変数を使用して、Cluster Agent コンテナを設定します。

     - name: DD_ORCHESTRATOR_EXPLORER_ENABLED
       value: "true"
   

2. 以下の RBAC アクセス許可を使用して、Cluster Agent ClusterRole を設定します。

   特に apps および batch apiGroups の場合は、ライブコンテナに　 一般的な Kubernetes リソース (``pods、services、 nodes など) を収集する権限が必要です。これは、[Cluster Agent のセットアップ][2]に従っていれば、すでに RBAC にあります。ない場合は、 追加されていることを確認してください (deployments、replicasets` の後):

     ClusterRole:
     - apiGroups:  # To create the datadog-cluster-id ConfigMap
       - ""
       resources:
       - configmaps
       verbs:
       - create
       - get
       - update
     ...
     - apiGroups:  # Required to get the kube-system namespace UID and generate a cluster ID
       - ""
       resources:
       - namespaces
       verbs:
       - get
     ...
     - apiGroups:  # To collect new resource types
       - "apps"
       resources:
       - deployments
       - replicasets
       verbs:
       - list
       - get
       - watch
     - apiGroups:
       - "batch"
       resources:
       - cronjobs
       - jobs
       verbs:
       - list
       - get
       - watch
     ...
   

   これらのアクセス許可は、Agent DaemonSet や Cluster Agent Deployment と同じネームスペースに datadog-cluster-id ConfigMap を作成したり、サポート対象の Kubernetes リソースを収集するために必要です。

   Cluster Agent により cluster-id ConfigMap が作成されない場合、Agent ポッドはリソースを収集することができません。この場合は Cluster Agent のアクセス許可を更新し、ポッドを再起動して ConfigMap を作成した後、Agent ポッドを再起動します。

3. Agent DaemonSet で実行される Process Agent は、有効かつ実行中（プロセス収集を実行する必要はありません）であり、かつ以下のオプションで構成されている必要があります。

   - name: DD_ORCHESTRATOR_EXPLORER_ENABLED
     value: "true"
   

一部のセットアップでは、Process Agent と Cluster Agent で Kubernetes クラスター名が自動検出されません。この場合、機能は起動せず、Cluster Agent ログで以下のような警告が表示されます。Orchestrator explorer enabled but no cluster name set: disabling。この場合、Cluster Agent と Process Agent の両方の env セクションに以下のオプションを追加する必要があります。

- name: DD_CLUSTER_NAME
  value: "<YOUR_CLUSTER_NAME>"

公式の Datadog Helm チャートを使用している場合、

• チャートのバージョンは 2.4.5 以上、2.10.0 以前を使用してください。チャートバージョン 2.10.0 以降をお使いの場合は、最新のコンフィギュレーション手順を参照してください。 注: Agent および Cluster Agent のバージョンが、Helm チャート values.yaml ファイルで必要最低限以上のバージョンでハードコードされるようにしてください。
• values.yaml で datadog.orchestratorExplorer.enabled を true に設定します
• 新しいリリースをデプロイします。

一部のセットアップでは、Process Agent と Cluster Agent で Kubernetes クラスター名が自動検出されません。この場合、機能は起動せず、Cluster Agent ログで以下のような警告が表示されます。Orchestrator explorer enabled but no cluster name set: disabling。この場合、datadog.clusterName を values.yaml でクラスター名に設定する必要があります。

Cluster Agent が動作していて、Agent が通信可能である必要があります。コンフィギュレーションについては、Cluster Agent のセットアップを参照してください。

1. 以下の環境変数を使用して、Cluster Agent コンテナを設定します。

     - name: DD_ORCHESTRATOR_EXPLORER_ENABLED
       value: "true"
   

2. 以下の RBAC アクセス許可を使用して、Cluster Agent ClusterRole を設定します。

   注: apps apiGroups の場合は、ライブコンテナに 一般的な Kubernetes リソース (pods、services、nodes など) を収集する権限が必要です。 これは、Cluster Agent のセットアップに従っていれば、すでに RBAC にあります。ない場合は、追加されていることを確認してください (deployments、replicasets の後):

     ClusterRole:
     - apiGroups:  # To create the datadog-cluster-id ConfigMap
       - ""
       resources:
       - configmaps
       verbs:
       - create
       - get
       - update
     ...
     - apiGroups:  # Required to get the kube-system namespace UID and generate a cluster ID
       - ""
       resources:
       - namespaces
       verbs:
       - get
     ...
     - apiGroups:  # To collect new resource types
       - "apps"
       resources:
       - deployments
       - replicasets
       - daemonsets
       - statefulsets
       verbs:
       - list
       - get
       - watch
    - apiGroups:
      - networking.k8s.io
      resources:
      - ingresses
      verbs:
      - list
      - watch
   

   これらのアクセス許可は、Agent DaemonSet や Cluster Agent Deployment と同じネームスペースに datadog-cluster-id ConfigMap を作成したり、デプロイや ReplicaSets を収集するために必要です。

   Cluster Agent により cluster-id ConfigMap が作成されない場合、Agent ポッドは起動せず、CreateContainerConfigError ステータスに陥ります。この ConfigMap が存在しないために Agent ポッドが動かない場合は、Cluster Agent アクセス許可を更新しポッドを再起動して ConfigMap を作成すると、Agent ポッドは自動的に回復します。

3. Agent DaemonSet で実行される Process Agent は、有効かつ実行中（プロセス収集を実行する必要はありません）であり、かつ以下のオプションで構成されている必要があります。

   - name: DD_ORCHESTRATOR_EXPLORER_ENABLED
     value: "true"
   - name: DD_ORCHESTRATOR_CLUSTER_ID
     valueFrom:
       configMapKeyRef:
         name: datadog-cluster-id
         key: id
   

一部のセットアップでは、Process Agent と Cluster Agent で Kubernetes クラスター名が自動検出されません。この場合、機能は起動せず、Cluster Agent ログで以下のような警告が表示されます。Orchestrator explorer enabled but no cluster name set: disabling。この場合、Cluster Agent と Process Agent の両方の env セクションに以下のオプションを追加する必要があります。

- name: DD_CLUSTER_NAME
  value: "<YOUR_CLUSTER_NAME>"

公式の Helm チャートを使用している場合、values.yaml にそれぞれ agents.containers.processAgent.env および clusterAgent.env を設定して Process Agent と Cluster Agent の両方に環境変数を追加します。

  agents:
    containers:
      processAgent:
        env:
          - name: "DD_ORCHESTRATOR_EXPLORER_EXTRA_TAGS"
            value: "tag1:value1 tag2:value2"
  clusterAgent:
    env:
      - name: "DD_ORCHESTRATOR_EXPLORER_EXTRA_TAGS"
        value: "tag1:value1 tag2:value2"

次に、新しいリリースをデプロイします。

Process Agent と Cluster Agent の両コンテナに環境変数を設定します。

- name: DD_ORCHESTRATOR_EXPLORER_EXTRA_TAGS
  value: "tag1:value1 tag2:value2"