Kubernetes

カスタムリリース名でチャートをインストールするには、<RELEASE_NAME> (例 datadog-agent):

1. Helm のインストール
2. Datadog values.yaml コンフィギュレーションファイルを参照として使用して、values.yaml を作成します。Datadog では、チャートのバージョンをアップグレードするときにスムーズなエクスペリエンスを実現できるため、values.yaml にオーバーライドする必要のある値のみを含めることをお勧めします。
3. これが新規インストールの場合は、Helm の Datadog リポジトリを追加します。

   helm repo add datadog https://helm.datadoghq.com
   helm repo update
   

4. Agent のインストール手順から Datadog API キーを取得し、次を実行します:

• Helm v3+

  helm install <RELEASE_NAME> -f values.yaml  --set datadog.apiKey=<DATADOG_API_KEY> datadog/datadog --set targetSystem=<TARGET_SYSTEM>
  

  <対象システム> を OS 名（linux または windows）で置き換えます。

• Helm v1/v2

  helm install -f values.yaml --name <RELEASE_NAME> --set datadog.apiKey=<DATADOG_API_KEY> datadog/datadog
  

このチャートは、DaemonSet 経由でクラスター内のすべてのノードに Datadog Agent を追加します。また、オプションで、kube-state-metrics チャートをデプロイし、それをクラスターに関するメトリクスの追加ソースとして使用します。インストール後数分すると、Datadog はホストとメトリクスの報告を開始します。

次に、使用する Datadog の機能を有効にします: APM, Logs

注:

• Datadog チャートの構成可能なパラメーターとそのデフォルト値の完全なリストについては、Datadog Helm リポジトリの README を参照してください。

• 現在のデプロイリージョンで Google Container Registry (gcr.io/datadoghq) にアクセスが不可能な場合は、values.yaml ファイルで下記のコンフィギュレーションで イメージ datadog/agent および datadog/cluster-agent とともに Docker Hub レジストリを使用します。

  agents:
    image:
      repository: datadog/agent
  
  clusterAgent:
    image:
      repository: datadog/cluster-agent
  
  clusterChecksRunner:
    image:
      repository: datadog/agent
  

チャート v1 からのアップグレード

v2.0 では、Datadog のチャートはリファクタリングされており、values.yaml パラメーターがより論理的に再グループ化されています。

現在、デプロイされているチャートバージョンが v2.0.0 以前の場合は、移行ガイドに従って設定を新しいフィールドにマッピングしてください。

非特権

(オプション) 非特権インストールを実行するには、values.yaml ファイルに以下を追加します。

datadog:
  securityContext:
      runAsUser: <USER_ID>
      supplementalGroups:
        - <DOCKER_GROUP_ID>

<USER_ID> が、Agent を実行する UID で、<DOCKER_GROUP_ID> が、Docker または Containerd ソケットを所有するグループ ID の場合。

DaemonSet を利用して、すべてのノード (または nodeSelectors を使用して特定のノード) に Datadog Agent をデプロイします。

Datadog Agent を Kubernetes クラスターにインストールするには:

1. Agent のアクセス許可を構成: Kubernetes で RBAC (ロールベースのアクセス制御) が有効になっている場合は、Datadog Agent サービスアカウントに対する RBAC アクセス許可を構成します。Kubernetes 1.6 以降では、RBAC はデフォルトで有効になっています。適切な ClusterRole、ServiceAccount、および ClusterRoleBinding を、以下のコマンドで作成します。

   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/clusterrole.yaml"
   
   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/serviceaccount.yaml"
   
   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/clusterrolebinding.yaml"
   

   注: RBAC 構成は、デフォルトで default ネームスペースに設定されています。カスタムネームスペースを使用している場合、適用する前に namespace パラメーターを更新します。

2. Datadog API キーを含むシークレットを作成: 下の<DATADOG_API_KEY> を組織の API キーに置き換えます。このシークレットはマニフェストで Datadog Agent をデプロイするために使用されます。

   kubectl create secret generic datadog-agent --from-literal='api-key=<DATADOG_API_KEY>' --namespace="default"
   

   注: これにより、default ネームスペースでシークレットが作成されます。カスタムネームスペースを使用している場合、実行前にコマンドの namespace パラメーターを更新します。

3. Datadog Agent マニフェストを作成。以下のテンプレートを使用して、datadog-agent.yaml マニフェストを作成します。

   メトリクス	ログ	APM	プロセス	NPM	Linux	Windows
   					マニフェストテンプレート	マニフェストテンプレート
   					マニフェストテンプレート	マニフェストテンプレート
   					マニフェストテンプレート	マニフェストテンプレート
   					マニフェストテンプレート	マニフェストテンプレート
   					マニフェストテンプレート	テンプレートなし
   					マニフェストテンプレート	マニフェストテンプレート

   トレース収集を完全に有効にするには、アプリケーションのポッドコンフィギュレーションで追加の手順が必要となります。それぞれの機能を個別に有効にする方法については、ログ、APM、プロセス、ネットワークパフォーマンスモニタリングに関するドキュメントページを参照してください。

   注: これらのマニフェストは、デフォルトで default ネームスペースに設定されています。カスタムネームスペースを使用している場合、適用する前に metadata.namespace パラメーターを更新します。

4. datadog-agent.yaml マニフェストで、DD_SITE 環境変数を使用して Datadog サイトを に設定します。

   注: DD_SITE 環境変数が明示的に設定されていない場合、値はデフォルトで US サイトの datadog.com に設定されます。その他のサイト (EU、US3、または US1-FED) のいずれかを使用している場合は、API キーのメッセージが無効になります。ドキュメントのサイト選択ドロップダウンを使用して、使用中のサイトに適したドキュメントを確認してください。

5. 次のコマンドで DaemonSet をデプロイします。

   kubectl apply -f datadog-agent.yaml
   

6. 検証: 現在の環境で Datadog Agent が DaemonSet として動作していることを検証するには、次を実行します。

   kubectl get daemonset
   

   Agent がデプロイされた場合は、以下のようなテキスト出力が表示されます。DESIRED と CURRENT はクラスター内で実行中のノードの数と等しくなります。

   NAME            DESIRED   CURRENT   READY     UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   datadog-agent   2         2         2         2            2           <none>          10s
   

7. 任意 - Kubernetes State メトリクスの設定: Kube-State マニフェストフォルダーをダウンロードし、それを Kubernetes クラスターに適用して kube-state メトリクスを自動収集します:

   kubectl apply -f <NAME_OF_THE_KUBE_STATE_MANIFESTS_FOLDER>
   

非特権

(オプション) 非特権インストールを実行するには、ポッドテンプレートに以下を追加します。

  spec:
    securityContext:
      runAsUser: <USER_ID>
      supplementalGroups:
        - <DOCKER_GROUP_ID>

<USER_ID> が、Agent を実行する UID で、<DOCKER_GROUP_ID> が、Docker または Containerd ソケットを所有するグループ ID の場合。

Datadog Operator は Kubernetes や OpenShift にDatadog Agent をデプロイする方法です。カスタムリソースステータスでデプロイ状況、健全性、エラーを報告し、高度なコンフィギュレーションオプションでコンフィギュレーションミスのリスクを抑えます。

前提条件

Datadog Operator を使用するには、次の前提条件が必要です。

• Kubernetes Cluster バージョン >= v1.14.X: テストはバージョン >= 1.14.0 で行われましたが、バージョン >= v1.11.0 で動作するはずです。以前のバージョンでは、CRD サポートが制限されているため、Operator が期待どおりに機能しない場合があります。
• datadog-operator をデプロイするための Helm。
• datadog-agent をインストールするための Kubectl CLI。

Operator を使用して Agent をデプロイする

最小限のステップ数で Operator を使用して Datadog Agent をデプロイするには、datadog-operato Helm チャートを使用します。手順は次のとおりです。

1. Datadog Operator をインストールします:

   helm repo add datadog https://helm.datadoghq.com
   helm install my-datadog-operator datadog/datadog-operator
   

2. お使いの API とアプリキーで Kubernetes シークレットを作成します

   kubectl create secret generic datadog-secret --from-literal api-key=<DATADOG_API_KEY> --from-literal app-key=<DATADOG_APP_KEY>
   

   <DATADOG_API_KEY> と <DATADOG_APP_KEY> を Datadog API とアプリケーションキーに置き換えます

3. Datadog Agent のデプロイコンフィギュレーションを使用してファイルを作成します。最も単純なコンフィギュレーションは次のとおりです。

   apiVersion: datadoghq.com/v1alpha1
   kind: DatadogAgent
   metadata:
     name: datadog
   spec:
     credentials:
       apiSecret:
         secretName: datadog-secret
         keyName: api-key
       appSecret:
         secretName: datadog-secret
         keyName: app-key
     agent:
       image:
         name: "gcr.io/datadoghq/agent:latest"
     clusterAgent:
       image:
         name: "gcr.io/datadoghq/cluster-agent:latest"
   

4. 上記のコンフィギュレーションファイルを使用して Datadog Agent をデプロイします。

   kubectl apply -f /path/to/your/datadog-agent.yaml
   

クリーンアップ

次のコマンドは、上記の手順で作成されたすべての Kubernetes リソースを削除します。

kubectl delete datadogagent datadog
helm delete my-datadog-operator

許容範囲の使用に関する情報を含む、Operator の設定の詳細については、Datadog Operator の高度な設定ガイドを参照してください。

非特権

(オプション) 非特権インストールを実行するには、Datadog カスタムリソース (CR) に以下を追加します。

agent:
  config:
    securityContext:
      runAsUser: <USER_ID>
      supplementalGroups:
        - <DOCKER_GROUP_ID>

<USER_ID> が、Agent を実行する UID で、<DOCKER_GROUP_ID> が、Docker または Containerd ソケットを所有するグループ ID の場合。

Kubernetes イベント収集を有効にするには、value.yaml ファイルの順序で datadog.leaderElection、datadog.collectEvents、agents.rbac.create オプションを true に設定します。

Kubernetes クラスターからイベントを収集する場合は、Agent マニフェストで環境変数 DD_COLLECT_KUBERNETES_EVENTS と DD_LEADER_ELECTION を true に設定します。または、Datadog Cluster Agent イベント収集を使用します

datadog-agent.yaml マニフェストで agent.config.collectEvents を true に設定します。

例:

agent:
  config:
    collectEvents: true