Datakit Operator のインストール¶

概念¶

フィールド説明

namespaces、selectors enabled_namespaces と enabled_labelselectors は ddtrace 専用であり、オブジェクト配列です。namespace と language を指定する必要があります。配列間は「または」の関係です。現在、言語は java のみサポートしています。
Pod が enabled_namespaces ルールと enabled_labelselectors の両方を満たす場合、enabled_labelselectors の設定が優先されます。

DDTrace コレクターを有効にする¶

datakit.yaml ファイルを編集し、デフォルトで有効になっているコレクター設定に DDTrace を追加します。

 - name: ENV_DEFAULT_ENABLED_INPUTS
   value: cpu,disk,diskio,mem,swap,system,hostobject,net,host_processes,container,ddtrace

アプリケーションを再起動します：

kubectl apply -f datakit.yaml

DataKit Operator のインストール¶

Datakit Operator は、アプリケーションとサービスのデプロイを自動化し、DDTrace SDK を自動注入して、起動時に検出を行います。

最新の datakit-operator.yaml ファイルをダウンロードします：

$ kubectl create namespace datakit
$ wget https://static.guance.com/datakit-operator/datakit-operator.yaml

設定ファイルの更新¶

注意

バージョン番号（release）とダイジェスト（digest）を使用して Java init イメージを固定してください。

バージョン固有の法的文書、チェックサム、およびソースコード/変更情報については、Guance Java Tracer 拡張宣言を参照してください。

Datakit Operator の設定は JSON 形式で、Kubernetes では ConfigMap として個別に格納され、環境変数としてコンテナに読み込まれます。

{
    "server_listen": "0.0.0.0:9543",
    "log_level":     "info",
    "admission_inject": {
        "ddtrace": { 
           "enabled_namespaces":     [],
           "enabled_labelselectors": [],
           "images": {
                "java_agent_image":   "pubrepo.guance.com/datakit-operator/dd-lib-java-init:latest"
            },
            "envs": {
              "DD_JMXFETCH_STATSD_HOST": "datakit-service.datakit.svc",
              "DD_JMXFETCH_STATSD_PORT": "8125",
              "POD_NAME": "{fieldRef:metadata.name}",
              "POD_NAMESPACE": "{fieldRef:metadata.namespace}",
              "NODE_NAME": "{fieldRef:spec.nodeName}",
              "DD_SERVICE": "{fieldRef:metadata.labels['service']}",
              "DD_AGENT_HOST": "datakit-service.datakit.svc",
              "DD_TRACE_AGENT_PORT": "9529",
              "DD_TAGS": "pod_name:$(POD_NAME),pod_namespace:$(POD_NAMESPACE),host:$(NODE_NAME)"
            }
        },
        "logfwd": {
            "options": {
                "reuse_exist_volume": "false"
            },
            "images": {
                "logfwd_image": "pubrepo.guance.com/datakit/logfwd:1.28.1"
            }
        }
    }
}

パラメータ設定：

service：サービス名；
env：アプリケーションサービスの環境情報；
DataKit のリスンアドレスをカスタマイズします。設定しない場合はデフォルトアドレスに従います；
プロファイリングデータを収集：有効にすると、アプリケーション実行時の詳細情報を確認できます；
namespaces を設定；
selectors を設定。

インストールコマンドの実行¶

kubectl apply -f datakit-operator.yaml

アプリケーションの再起動¶

インストールが完了したら、アプリケーション Pod を再起動してください。