By default, the Datadog Helm chart uses the Agent 7 image that embeds the Python 3 runtime.

To keep the Datadog Agent updated, edit your datadog-values.yaml to remove any information under the agent.image and the clusterChecksRunner.image sections.

To use a specific container registry, set it with agent.image.repository and clusterChecksRunner.image.repository. Ensure that agents.image.tag and clusterChecksRunner.image.tag are undefined.

When the image repository is unset, the Helm chart derives it from datadog.site, cluster type, and registryMigrationMode.

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

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

To set the Agent to a specific version, set agents.image.tag and clusterChecksRunner.image.tag. All image tags starting with 7.* embed the Python 3 runtime.

agent:
  image:
    tag: 7.34.0

clusterChecksRunner:
  image:
    tag: 7.34.0

You can use both options at the same time.

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

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

By default, the Datadog Operator uses an agent:7.*.* image that embeds the Python 3 runtime.

If the image information is not specified in the DatadogAgent resource, the Operator deploys a Python 3 Datadog Agent image.

If you have previously pinned the image version:

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

or you are using 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

Use spec.global.registry if you need to change the registry selected from your Datadog site, cluster type, and registryMigrationMode.

Then, pin the Agent 7 image tag in spec.override.nodeAgent.image.tag.

If you have enabled cluster check runners deployment, also pin the Agent 7 image tag in 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

Note: Datadog recommends that you do not set the *.image.tag. Instead, let the Datadog Operator keep the Agent image tag up-to-date with an Agent 7 image.

If you need to use an Agent JMX image, you can set it without specifying the 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

In your DaemonSet manifest, update the image tag in each container definition:

• Each spec.template.spec.containers[*].image value
• Each spec.template.spec.initContainers[*].image value

For example, if your previous image value was gcr.io/datadoghq/agent:6.33.0, update it to registry.datadoghq.com/agent:7.33.0.

Before:

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

After:

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

Use the extra_config field to set the python_version field to 3:

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

Use the agent_extra_config field to set the python_versionfield to 3:

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

Set the python_version to 3 inside of your datadog_config:

datadog_config:
  python_version: 3