- 重要な情報
- はじめに
- 用語集
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
このページでは、古い Agent バージョンのライブコンテナをセットアップするための手順を説明します。これらの手順は、Datadog Agent バージョン 7.21.1 から 7.27.0 および Cluster Agent 1.9.0 から 1.11.0 に適用されます。
公式の Datadog Helm チャートを使用している場合、
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 のセットアップを参照してください。
以下の環境変数を使用して、Cluster Agent コンテナを設定します。
- name: DD_ORCHESTRATOR_EXPLORER_ENABLED
value: "true"
以下の 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 ポッドは自動的に回復します。
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>"