Python のバージョン管理

Agent v6 を使用している場合、Datadog は Agent v7 へのアップグレードを推奨しています。Agent v7 は、Python 3 のみのサポートとなります。

ただし、Python 3 にアップデートしても Agent v6 を使い続けたい場合があります。Datadog Agent v6.14.0 以降、Agent v6 は Python 2 および Python 3 ランタイムと互換性を持ちます。つまり、Agent のコンフィギュレーションにより、Python 2 または Python 3 のいずれでも Agent チェックを実行できます。

Datadog Agent v6 で Python 3 を使用する

デフォルトでは、Agent v6 は Python 2 ランタイムを使用します。以下は、Python 3 ランタイムを使用するように Agent v6 を構成する方法です。

この構成は、Azure VM Extensionではサポートされていません。

ホスト Agent

  1. datadog.yaml コンフィギュレーションファイルで python_version コンフィギュレーションオプションを設定します。

    python_version: 3

  2. Agent を再起動します。

または、環境変数 DD_PYTHON_VERSION に 2 または 3 を設定して、どの Python ランタイムを使用するかを指定します。環境変数は datadog.yaml 内の構成オプションよりも優先されます。例えば、環境変数 DD_PYTHON_VERSION を設定すると、 datadog.yaml にある python_version オプションは無視されます。

これは、Agent 全体のコンフィギュレーションオプションです。Agent により起動されたすべての Python チェックは、同じ Python ランタイムを使用します。

コンテナ Agent

Datadog は、Python 2 および Python 3 用の Agent コンテナイメージを提供しています。

  • 6.34.0 や 6.34.0-jmx のような 6. で始まるイメージタグは、Python 2 ランタイムを含むイメージです。
  • 7.34.0 や 7.34.0-jmx のような 7. で始まるイメージタグは、Python 3 ランタイムを含むイメージです。

Python 2 から Python 3 に変更するには、Agent のデプロイに使用するイメージタグを更新します。

    デフォルトでは、Datadog Helm チャートは、Python 3 ランタイムを埋め込んだ Agent 7 イメージを使用します。

    Datadog Agent を更新し続けるには、datadog-values.yaml を編集して agent.image と clusterChecksRunner.image セクション以下の情報を削除してください。

    特定のコンテナレジストリを使用する場合は、agent.image.repository と clusterChecksRunner.image.repository で設定します。agents.image.tag と clusterChecksRunner.image.tag が未定義であることを確認してください。

    デフォルトのレジストリは、gcr.io/datadoghq/agent です。

    agent:
  image:
    repository: public.ecr.aws/datadog/agent

clusterChecksRunner:
  image:
    repository: public.ecr.aws/datadog/agent

    Agent を特定のバージョンに設定するには、agents.image.tag と clusterChecksRunner.image.tag を設定します。7.* で始まるすべてのイメージタグは Python 3 ランタイムを埋め込みます。

    agent:
  image:
    tag: 7.34.0

clusterChecksRunner:
  image:
    tag: 7.34.0

    両方のオプションを同時に使用することができます。

    agent:
  image:
    repository: public.ecr.aws/datadog/agent
    tag: 7.34.0

clusterChecksRunner:
  image:
    repository: public.ecr.aws/datadog/agent
    tag: 7.34.0

    デフォルトでは、Datadog Operator は、Python 3 ランタイムを埋め込んだ agent:7.*.* イメージを使用します。

    イメージ情報が DatadogAgent リソースに指定されていない場合、Operator は Python 3 Datadog Agent イメージをデプロイします。

    以前にイメージバージョンを固定したことがある場合

    apiVersion: datadoghq.com/v2alpha1
metadata:
  name: datadog
spec:
  override:
    clusterChecksRunner:
      image:
        tag: 6.33.0
    nodeAgent:
      image:
        tag: 6.33.0

    または image.name を使用している場合

    apiVersion: datadoghq.com/v2alpha1
metadata:
  name: datadog
spec:
  global:
    credentials:
      apiKey: <DATADOG_API_KEY>
      appKey: <DATADOG_APP_KEY>
  override:
    # ...
    nodeAgent:
      image:
        name: gcr.io/datadoghq/agent:6.33.0
    # ...
    clusterChecksRunner:
      image:
        name: gcr.io/datadoghq/agent:6.33.0

    デフォルトのレジストリを変更する必要がある場合は、spec.global.registry を使用します。デフォルトは gcr.io/datadoghq/agent です。

    次に、Agent 7 のイメージタグを spec.override.nodeAgent.image.tag で固定します。

    クラスターチェックランナーのデプロイメントを有効にした場合、Agent 7 のイメージタグも spec.override.clusterChecksRunner.image.tag で固定します。

    apiVersion: datadoghq.com/v2alpha1
metadata:
  name: datadog
spec:
  # ...
  global:
    registry: public.ecr.aws/datadog
  override:
    # ...
    nodeAgent:
      image:
        tag: 7.33.0
    # ...
    clusterChecksRunner:
      image:
        tag: 7.33.0

    注: Datadog では、*.image.tag を設定しないことを推奨しています。代わりに、Datadog Operator に Agent 7 のイメージタグを最新に保つようにさせます。

    Agent JMX イメージを使用する必要がある場合、Agent *.image.tag を指定せずに設定することができます。

    apiVersion: datadoghq.com/v2alpha1
metadata:
  name: datadog
spec:
  # ...
  global:
    registry: public.ecr.aws/datadog
  override:
    # ...
    nodeAgent:
      image:
        jmxEnabled: true
    clusterChecksRunner:
      image:
        jmxEnabled: true

    DaemonSet マニフェストで、各コンテナ定義のイメージタグを更新します。

    • 各 spec.template.spec.containers[*].image の値
    • 各 spec.template.spec.initContainers[*].image の値

    例えば、以前のイメージ値が gcr.io/datadoghq/agent:6.33.0 だった場合、gcr.io/datadoghq/agent:7.33.0 に更新します。

    前:

    apiVersion: apps/v1
spec:
  template:
    spec:
      containers:
      - name: agent
        image: gcr.io/datadoghq/agent:6.33.0
        # ...

    後:

    apiVersion: apps/v1
spec:
  template:
    spec:
      containers:
      - name: agent
        image: gcr.io/datadoghq/agent:7.33.0
        # ...

    デプロイメントツール

      extra_config フィールドを使用して、 python_version フィールドを 3 に設定します。

      default_attributes(
   'datadog' => {
     'extra_config' => {
       'python_version' => '3'
     }
   }
 )

      agent_extra_config フィールドを使用して、python_version フィールドを 3 に設定します。

      class { "datadog_agent":
    agent_extra_options => {
        python_version => 3,
    },
}

      datadog_config 内で、python_version を 3 に設定します。

      datadog_config:
  python_version: 3

      その他の参考資料

      お役に立つドキュメント、リンクや記事:

      Agent バージョン7へアップグレードドキュメント more more