DynaKube parameters for Dynatrace Operator

This page will help you to understand and configure the Kubernetes Custom Resource "DynaKube", enabling you to optimize your Dynatrace Operator setup according to your specific requirements.

The following table lists the minimum required Dynatrace Operator versions for each DynaKube API version.

DynaKube API version

Minimum Dynatrace Operator version

v1beta3

1.4.0+

v1beta2

1.2.0+

v1beta1

All versions

Dynatrace Operator version 1.4.0+

`.spec`

apiUrl parameter is required.
All other parameters are optional.

Parameter

Description

Default value

Data type

apiUrl

Dynatrace apiUrl, including the /api path at the end.
- For SaaS, set YOUR_ENVIRONMENT_ID to your environment ID.
- For Managed, change the apiUrl address.
For instructions on how to determine the environment ID and how to configure the apiUrl address, see Environment ID

string

customPullSecret

Defines a custom pull secret in case you use a private registry when pulling images from the Dynatrace environment.
To define a custom pull secret and learn about the expected behavior, see Configure customPullSecret.

string

dynatraceApiRequestThreshold

Minimum minutes between Dynatrace API requests.

integer

enableIstio

When enabled, and if Istio is installed on the Kubernetes environment, Dynatrace Operator will create the corresponding VirtualService and ServiceEntry objects to allow access to the Dynatrace Cluster from the OneAgent or ActiveGate.
Disabled by default.

boolean

networkZone

Sets a network zone for the OneAgent and ActiveGate pods.

string

proxy

Set custom proxy settings either directly or from a secret with the field proxy.
Applies to Dynatrace Operator, ActiveGate, and OneAgents.

DynaKubeProxy

skipCertCheck

Disable certificate check for the connection between Dynatrace Operator and the Dynatrace Cluster.
Set to true if you want to skip certification validation checks.

boolean

tokens

Name of the secret holding the tokens used for connecting to Dynatrace.

string

trustedCAs

Adds custom RootCAs from a configmap.
The key to the data must be certs.
This applies to Dynatrace Operator, OneAgent, and ActiveGate.

string

`.spec.oneAgent`

Parameter

Description

Default value

Data type

hostGroup

Specify the name of the group to which you want to assign the host. This method is preferred over the now obsolete --set-host-group argument. If both settings are used, this field takes precedence over the --set-host-group argument.

string

`.spec.oneAgent.cloudNativeFullStack`

All parameters are optional.

recommended

Parameter

Description

Default value

Data type

annotations

Add custom OneAgent annotations.

map[string]string

args

Set additional arguments to the OneAgent installer.
For available options, see Linux custom installation.
For the list of limitations, see Limitations.

[]string

autoUpdate

Disables automatic restarts of OneAgent pods in case a new version is available. Enabled by default.

true

boolean

codeModulesImage

The OneAgent image that is used to inject into Pods

string

dnsPolicy

Set the DNS Policy for OneAgent pods.
For details, see Pods DNS Policy.

ClusterFirstWithHostNet

string

env

Set additional environment variables for the OneAgent pods.

[]EnvVar

image

Use a custom OneAgent Docker image.

The image from the Dynatrace cluster.

string

initResources

Define resources requests and limits for the initContainer. For details, see Managing resources for containers.

ResourceRequirements

labels

Your defined labels for OneAgent pods in order to structure workloads as desired.

map[string]string

namespaceSelector

The namespaces where you want Dynatrace Operator to inject.
For more information, see Configure monitoring for namespaces and pods.

LabelSelector

nodeSelector

Specify the node selector that controls on which nodes OneAgent will be deployed.

map[string]string

oneAgentResources

Resource settings for OneAgent container. Consumption of the OneAgent heavily depends on the workload to monitor. You can use the default settings in the CR.
resource.requests shows the values needed to run; resource.limits shows the maximum limits for the pod.

ResourceRequirements

priorityClassName

Assign a priority class to the OneAgent pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

secCompProfile

The SecComp Profile that will be configured in order to run in secure computing mode.

string

tolerations

Tolerations to include with the OneAgent DaemonSet.
For details, see Taints and Tolerations.

[]Toleration

version

The OneAgent version to be used for host monitoring OneAgents running in the dedicated pod. This setting doesn't affect the OneAgent version used for application monitoring.

The latest version is used by default.

string

`.spec.oneAgent.classicFullStack`

All parameters are optional.

Parameter

Description

Default value

Data type

annotations

Add custom OneAgent annotations.

map[string]string

args

Set additional arguments to the OneAgent installer.
For available options, see Linux custom installation.
For the list of limitations, see Limitations.

[]string

autoUpdate

Disables automatic restarts of OneAgent pods in case a new version is available. Enabled by default.

true

boolean

dnsPolicy

Set the DNS Policy for OneAgent pods.
For details, see Pods DNS Policy.

ClusterFirstWithHostNet

string

env

Set additional environment variables for the OneAgent pods.

[]EnvVar

image

Use a custom OneAgent Docker image. Defaults to the image from the Dynatrace cluster.

Name of the image.

string

labels

Your defined labels for OneAgent pods in order to structure workloads as desired.

map[string]string

nodeSelector

Specify the node selector that controls on which nodes OneAgent will be deployed.

map[string]string

oneAgentResources

ResourceRequirements

priorityClassName

Assign a priority class to the OneAgent pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

secCompProfile

The SecComp Profile that will be configured in order to run in secure computing mode.

string

tolerations

Tolerations to include with the OneAgent DaemonSet.
For details, see Taints and Tolerations.

[]Toleration

version

The OneAgent version to be used.

The latest version is used by default.

string

`.spec.oneAgent.applicationMonitoring`

All parameters are optional.

Parameter

Description

Default value

Data type

codeModulesImage

The OneAgent image that is used to inject into Pods

string

initResources

Define resources requests and limits for the initContainer. For details, see Managing resources for containers.

ResourceRequirements

namespaceSelector

The namespaces where you want Dynatrace Operator to inject.
For more information, see Configure monitoring for namespaces and pods.

LabelSelector

version

The OneAgent version to be used.

The latest version is used by default.

string

`.spec.oneAgent.hostMonitoring`

All parameters are optional.

Parameter

Description

Default value

Data type

annotations

Add custom OneAgent annotations.

map[string]string

args

Set additional arguments to the OneAgent installer.
For available options, see Linux custom installation.
For the list of limitations, see Limitations.

[]string

autoupdate

Disables automatic restarts of OneAgent pods in case a new version is available. Enabled by default.

true

boolean

dnsPolicy

Set the DNS Policy for OneAgent pods.
For details, see Pods DNS Policy.

ClusterFirstWithHostNet

string

env

Set additional environment variables for the OneAgent pods.

[]EnvVar

image

Use a custom OneAgent Docker image.

The image from the Dynatrace cluster.

string

labels

Your defined labels for OneAgent pods in order to structure workloads as desired.

map[string]string

nodeSelector

Specify the node selector that controls on which nodes OneAgent will be deployed.

map[string]string

oneAgentResources

ResourceRequirements

priorityClassName

Assign a priority class to the OneAgent pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

secCompProfile

The SecComp Profile that will be configured in order to run in secure computing mode.

string

tolerations

Tolerations to include with the OneAgent DaemonSet.
For details, see Taints and Tolerations.

[]Toleration

version

The OneAgent version to be used.

The latest version is used by default.

string

`.spec.activeGate`

capabilities parameter is required.
resources and group parameters are recommended.
All other parameters are optional.

Parameter

Description

Default value

Data type

annotations

Add custom ActiveGate annotations.

map[string]string

capabilities

Defines the ActiveGate pod capabilities: what functionality should be enabled.
Possible values:
- routing enables OneAgent routing.
- kubernetes-monitoring enables Kubernetes API monitoring.
- metrics-ingest¹ opens the metrics ingest endpoint on the DynaKube ActiveGate and redirects all pods to it.
- dynatrace-api¹ enables calling the Dynatrace API via ActiveGate.

string

customProperties

Add a custom properties file by providing it as a value or by referencing it from a secret.
When referencing a custom properties file from a secret, make sure that the key is named customProperties. See How to add a custom properties file for details.

string

dnsPolicy

Set the DNS policy for ActiveGate pods.

ClusterFirstWithHostNet

string

env

Set additional environment variables for the ActiveGate pods.

[]EnvVar

group

Set activation group for ActiveGate. See Customize ActiveGate properties for details.

string

image

Use a custom ActiveGate image. Defaults to the latest ActiveGate image from the Dynatrace cluster.

string

labels

Your defined labels for ActiveGate pods in order to structure workloads as desired.

map[string]string

nodeSelector

Specify the node selector that controls on which nodes ActiveGate will be deployed.

map[string]string

priorityClassName

Assign a priority class to the ActiveGate pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

replicas

Amount of replicas of ActiveGate pods.

int

resources

Resource settings for ActiveGate container. Consumption of the ActiveGate heavily depends on the workload to monitor; adjust values accordingly.

ResourceRequirements

tlsSecretName

Name of a secret containing ActiveGate TLS certificate, key, and password. If not set, a self-signed certificate is used. For details, see How to add a custom certificate for ActiveGate.

string

tolerations

Set tolerations for the ActiveGate pods.
For details, see Taints and Tolerations.

[]Toleration

topologySpreadConstraints

Adds topology spread constraints to the ActiveGate pods.

[]corev1.TopologySpreadConstraint

A custom certificate is required for this capability. See the tlsSecretName parameter for details.

`.spec.metadataEnrichment`

All parameters are optional.

Parameter

Description

Default value

Data type

enabled

Enables MetadataEnrichment, true by default.

true

boolean

namespaceSelector

The namespaces where you want Dynatrace Operator to inject. For more information, see Configure monitoring for namespaces and pods.

LabelSelector

`.spec.extensions`

Available with a future Dynatrace version (CQ2/2025).

Adding this section enables extension support in Kubernetes.

`.spec.kspm`

Adding this section enables Kubernetes Security Posture Management (KSPM).

`.spec.logMonitoring`

Available with Dynatrace version 1.306 and OneAgent 1.305

All parameters in .spec.logMonitoring are optional.

Parameter

Description

Default value

Data type

ingestRuleMatchers

Specifies the rules and conditions for matching ingest attributes.

[]IngestRuleMatchers

`.spec.logMonitoring.ingestRuleMatchers`

Parameter

Description

Default value

Data type

attribute

Specifies the attribute name for matching ingest rules.

string

values

Lists the values that the attribute must match for an ingest rule to apply.

[]string

Example:

  ingestRuleMatchers:
    - attribute: "k8s.namespace.name"
      values:
      - "kube-system"
      - "dynatrace"
      - "default"
    - attribute: "k8s.pod.annotation",
      values:
      - "logs.dynatrace.com/ingest=true"
      - "category=security"

`.spec.templates`

`.spec.templates.kspmNodeConfigurationCollector`

Parameter

Description

Default value

Data type

updateStrategy

Define the Node Configuration Collector daemonSet updateStrategy

DaemonSetUpdateStrategy

labels

Add custom labels to the Node Configuration Collector pods.

map[string]string

annotations

Add custom annotations to the Node Configuration Collector pods.

map[string]string

nodeSelector

Specify the node selector that controls on which nodes the Node Configuration Collector pods will be deployed.

map[string]string

imageRef

Overrides the default image.

imageRef

priorityClassName

If specified, indicates the pod's priority. Name must be defined by creating a PriorityClass object wiht that name. If not specified the setting will be removed from the DaemonSet.

string

resources

Define resource requests and limits for Node Configuration Collector pods.

ResourceRequirements

nodeAffinity

Define the nodeAffinity for the DaemonSet of the Node Configuration Collector

NodeAffinity

tolerations

Set tolerations for the Node Configuration Collector pods.
For details, see Taints and Tolerations.

[]Toleration

args

Set additional arguments for the Node Configuration Collector main container.

[]string

env

Set additional environment variables for the Node Configuration Collector main container.

[]string

`.spec.templates.kspmNodeConfigurationCollector.imageRef`

Parameter

Description

Default value

Data type

repository

URL of Node Configuration Collector image.

string

tag

Tag for Node Configuration Collector image.

string

`.spec.templates.logMonitoring`

Available with Dynatrace version 1.306 and OneAgent 1.305

imageRef parameter is required.

Parameter

Description

Default value

Data type

annotations

Add custom annotations to the LogMonitoring pods.

map[string]string

labels

Add custom labels to the LogMonitoring pods.

map[string]string

nodeSelector

Specify the node selector that controls on which nodes the LogMonitoring pods will be deployed.

map[string]string

imageRef

Overrides the default image for the LogMonitoring pods.

imageRef

dnsPolicy

Set the DNS policy for LogMonitoring pods.

ClusterFirst

string

priorityClassName

Assign a priority class to the LogMonitoring pods. By default, no class is set.

string

secCompProfile

Configures a SecComp profile to enable secure computing mode for the LogMonitoring pods.

string

resources

Define resource requests and limits for LogMonitoring pods.

ResourceRequirements

tolerations

Set tolerations for the LogMonitoring pods.
For details, see Taints and Tolerations.

[]Toleration

args

Set additional arguments for the LogMonitoring main container.

[]string

`.spec.templates.logMonitoring.imageRef`

Available with Dynatrace version 1.306 and OneAgent 1.305

Parameter

Description

Default value

Data type

repository

URL of LogMonitoring image.

string

tag

Tag for LogMonitoring image.

string

`.spec.templates.extensionExecutionController`

Available with a future Dynatrace version in (CQ2/2025).

imageRef parameter is required.
All other parameters are optional.

Parameter

Description

Default value

Data type

imageRef

Image that is used for Extension Execution Controller. This field is mandatory.

imageRef

persistentVolumeClaim

PVC for the Extension Execution Controller. If not specified a default PVC is used.

PersistentVolumeClaim

labels

Lables applied to Extension Execution Controller pod.

map[string]string

annotations

Annotations applied to Extension Execution Controller pod.

map[string]string

tlsRefName

Secret containing a TLS certificate for communication between Extension Execution Controller and OpenTelemetry Collector.

string

customConfig

ConfigMap holding a custom Extension Execution Controller configuration.

string

customExtensionCertificates

Secret holding certificates that have been used to sign custom extensions. Needed for extensions signature validation by Extension Execution Controller.

string

resources

Resource settings for Extension Execution Controller pod.

ResourceRequirements

tolerations

Tolerations for Extension Execution Controller pod.
For details, see Taints and Tolerations.

[]Toleration

topologySpreadConstraints

Topology spread constraints for Extension Execution Controller pod.

[]corev1.TopologySpreadConstraint

`.spec.templates.extensionExecutionController.imageRef`

Available with a future Dynatrace version (CQ2/2025).

Parameter

Description

Default value

Data type

repository

URL of Extension Execution Controller image.

string

tag

Tag for Extension Execution Controller image.

string

`.spec.templates.openTelemetryCollector`

Available with a future Dynatrace version (CQ2/2025).

All parameters are optional.

Parameter

Description

Default value

Data type

imageRef

Image that is used for OpenTelemetry Collector.

imageRef

replicas

Number of OpenTelemetry Collector replicas.

int32

labels

Labels applied to OpenTelemetry Collector pod.

map[string]string

annotations

Annotations applied to OpenTelemetry Collector pod.

map[string]string

tlsRefName

Secret containing a TLS certificate used by OpenTelemetry Collector to verify connections to endpoints of other components.

string

resources

Resource settings for OpenTelemetry Collector pod.

ResourceRequirements

tolerations

Tolerations for OpenTelemetry Collector pod.
For details, see Taints and Tolerations.

[]Toleration

topologySpreadConstraints

Topology spread constraints for OpenTelemetry Collector pod.

[]corev1.TopologySpreadConstraint

`.spec.templates.openTelemetryCollector.imageRef`

Available with a future Dynatrace version (CQ2/2025).

Parameter

Description

Default value

Data type

repository

URL of OpenTelemetry Collector image.

public.ecr.aws/dynatrace/dynatrace-otel-collector

string

tag

Tag for OpenTelemetry Collector image.

latest

string

Dynatrace Operator version 1.2.0+

`.spec`

apiUrl parameter is required.
All other parameters are optional.

Parameter

Description

Default value

Data type

apiUrl

string

customPullSecret

string

dynatraceApiRequestThreshold

Minimum minutes between Dynatrace API requests.

integer

enableIstio

boolean

networkZone

Sets a network zone for the OneAgent and ActiveGate pods.

string

proxy

Set custom proxy settings either directly or from a secret with the field proxy.
Applies to Dynatrace Operator, ActiveGate, and OneAgents.

DynaKubeProxy

skipCertCheck

Disable certificate check for the connection between Dynatrace Operator and the Dynatrace Cluster.
Set to true if you want to skip certification validation checks.

boolean

tokens

Name of the secret holding the tokens used for connecting to Dynatrace.

string

trustedCAs

Adds custom RootCAs from a configmap.
The key to the data must be certs.
This applies to Dynatrace Operator, OneAgent, and ActiveGate.

string

`.spec.oneAgent`

Parameter

Description

Default value

Data type

hostGroup

string

`.spec.oneAgent.cloudNativeFullStack`

All parameters are optional.

recommended

Parameter

Description

Default value

Data type

annotations

Add custom OneAgent annotations.

map[string]string

args

Set additional arguments to the OneAgent installer.
For available options, see Linux custom installation.
For the list of limitations, see Limitations.

[]string

autoUpdate

Disables automatic restarts of OneAgent pods in case a new version is available. Enabled by default.

true

boolean

codeModulesImage

The OneAgent image that is used to inject into Pods

string

dnsPolicy

Set the DNS Policy for OneAgent pods.
For details, see Pods DNS Policy.

ClusterFirstWithHostNet

string

env

Set additional environment variables for the OneAgent pods.

[]EnvVar

image

Use a custom OneAgent Docker image.

The image from the Dynatrace cluster.

string

initResources

Define resources requests and limits for the initContainer. For details, see Managing resources for containers.

ResourceRequirements

labels

Your defined labels for OneAgent pods in order to structure workloads as desired.

map[string]string

namespaceSelector

The namespaces where you want Dynatrace Operator to inject.
For more information, see Configure monitoring for namespaces and pods.

LabelSelector

nodeSelector

Specify the node selector that controls on which nodes OneAgent will be deployed.

map[string]string

oneAgentResources

ResourceRequirements

priorityClassName

Assign a priority class to the OneAgent pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

secCompProfile

The SecComp Profile that will be configured in order to run in secure computing mode.

string

tolerations

Tolerations to include with the OneAgent DaemonSet.
For details, see Taints and Tolerations.

[]Toleration

version

The OneAgent version to be used for host monitoring OneAgents running in the dedicated pod. This setting doesn't affect the OneAgent version used for application monitoring.

The latest version is used by default.

string

`.spec.oneAgent.classicFullStack`

All parameters are optional.

Parameter

Description

Default value

Data type

annotations

Add custom OneAgent annotations.

map[string]string

args

Set additional arguments to the OneAgent installer.
For available options, see Linux custom installation.
For the list of limitations, see Limitations.

[]string

autoUpdate

Disables automatic restarts of OneAgent pods in case a new version is available. Enabled by default.

true

boolean

dnsPolicy

Set the DNS Policy for OneAgent pods.
For details, see Pods DNS Policy.

ClusterFirstWithHostNet

string

env

Set additional environment variables for the OneAgent pods.

[]EnvVar

image

Use a custom OneAgent Docker image. Defaults to the image from the Dynatrace cluster.

Name of the image.

string

labels

Your defined labels for OneAgent pods in order to structure workloads as desired.

map[string]string

nodeSelector

Specify the node selector that controls on which nodes OneAgent will be deployed.

map[string]string

oneAgentResources

ResourceRequirements

priorityClassName

Assign a priority class to the OneAgent pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

secCompProfile

The SecComp Profile that will be configured in order to run in secure computing mode.

string

tolerations

Tolerations to include with the OneAgent DaemonSet.
For details, see Taints and Tolerations.

[]Toleration

version

The OneAgent version to be used.

The latest version is used by default.

string

`.spec.oneAgent.applicationMonitoring`

All parameters are optional.

Parameter

Description

Default value

Data type

codeModulesImage

The OneAgent image that is used to inject into Pods

string

initResources

Define resources requests and limits for the initContainer. For details, see Managing resources for containers.

ResourceRequirements

namespaceSelector

The namespaces where you want Dynatrace Operator to inject.
For more information, see Configure monitoring for namespaces and pods.

LabelSelector

useCSIDriver

Set if you want to use the CSIDriver. Don't enable it if you do not have access to Kubernetes nodes or if you lack privileges.

false

boolean

version

The OneAgent version to be used.

The latest version is used by default.

string

`.spec.oneAgent.hostMonitoring`

All parameters are optional.

Parameter

Description

Default value

Data type

annotations

Add custom OneAgent annotations.

map[string]string

args

Set additional arguments to the OneAgent installer.
For available options, see Linux custom installation.
For the list of limitations, see Limitations.

[]string

autoupdate

Disables automatic restarts of OneAgent pods in case a new version is available. Enabled by default.

true

boolean

dnsPolicy

Set the DNS Policy for OneAgent pods.
For details, see Pods DNS Policy.

ClusterFirstWithHostNet

string

env

Set additional environment variables for the OneAgent pods.

[]EnvVar

image

Use a custom OneAgent Docker image.

The image from the Dynatrace cluster.

string

labels

Your defined labels for OneAgent pods in order to structure workloads as desired.

map[string]string

nodeSelector

Specify the node selector that controls on which nodes OneAgent will be deployed.

map[string]string

oneAgentResources

ResourceRequirements

priorityClassName

Assign a priority class to the OneAgent pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

secCompProfile

The SecComp Profile that will be configured in order to run in secure computing mode.

string

tolerations

Tolerations to include with the OneAgent DaemonSet.
For details, see Taints and Tolerations.

[]Toleration

version

The OneAgent version to be used.

The latest version is used by default.

string

`.spec.activeGate`

capabilities parameter is required.
resources and group parameters are recommended.
All other parameters are optional.

Parameter

Description

Default value

Data type

annotations

Add custom ActiveGate annotations.

map[string]string

capabilities

string

customProperties

string

dnsPolicy

Set the DNS policy for ActiveGate pods.

ClusterFirstWithHostNet

string

env

Set additional environment variables for the ActiveGate pods.

[]EnvVar

group

Set activation group for ActiveGate. See Customize ActiveGate properties for details.

string

image

Use a custom ActiveGate image. Defaults to the latest ActiveGate image from the Dynatrace cluster.

string

labels

Your defined labels for ActiveGate pods in order to structure workloads as desired.

map[string]string

nodeSelector

Specify the node selector that controls on which nodes ActiveGate will be deployed.

map[string]string

priorityClassName

Assign a priority class to the ActiveGate pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

replicas

Amount of replicas of ActiveGate pods.

int

resources

Resource settings for ActiveGate container. Consumption of the ActiveGate heavily depends on the workload to monitor; adjust values accordingly.

ResourceRequirements

tlsSecretName

Name of a secret containing ActiveGate TLS certificate, key, and password. If not set, a self-signed certificate is used. For details, see How to add a custom certificate for ActiveGate.

string

tolerations

Set tolerations for the ActiveGate pods.
For details, see Taints and Tolerations.

[]Toleration

topologySpreadConstraints

Adds topology spread constraints to the ActiveGate pods.

[]corev1.TopologySpreadConstraint

A custom certificate is required for this capability. See the tlsSecretName parameter for details.

`.spec.metadataEnrichment`

All parameters are optional.

Parameter

Description

Default value

Data type

enabled

Enables MetadataEnrichment, true by default.

true

boolean

namespaceSelector

The namespaces where you want Dynatrace Operator to inject. For more information, see Configure monitoring for namespaces and pods.

LabelSelector

`.spec`

apiUrl parameter is required.
All other parameters are optional.

Parameter

Description

Default value

Data type

apiUrl

string

tokens

Name of the secret holding the tokens.

Name of custom resource (.metadata.name) if unset

string

skipCertCheck

Disable certificate check for the connection between Dynatrace Operator and the Dynatrace Cluster.
Set to true if you want to skip certification validation checks.

false

boolean

proxy

Set custom proxy settings either directly or from a secret with the field proxy.
Applies to Dynatrace Operator, ActiveGate, and OneAgents.

string

trustedCAs

Adds custom RootCAs from a configmap. Put the certificate under certs within your configmap.
This applies to Dynatrace Operator, OneAgent, and ActiveGate.

string

networkZone

Sets a network zone for the OneAgent and ActiveGate pods.

string

customPullSecret

Defines a custom pull secret in case you use a private registry when pulling images from the Dynatrace environment. To define a custom pull secret and learn about the expected behavior, see Configure customPullSecret.

string

enableIstio

false

boolean

namespaceSelector

Applicable only for applicationMonitoring or cloudNativeFullStack configuration types. The namespaces where you want Dynatrace Operator to inject. For more information, see Configure monitoring for namespaces and pods.

LabelSelector

`.spec.oneAgent`

Parameter

Description

Default value

Data type

hostGroup

string

`.spec.oneAgent.cloudNativeFullStack`

All parameters are optional.

recommended

Parameter

Description

Default value

Data type

image

Use a custom OneAgent Docker image.

The image from the Dynatrace cluster.

string

codeModulesImage

The OneAgent image that is used to inject into Pods

string

version

The OneAgent version to be used for host monitoring OneAgents running in the dedicated pod. This setting doesn't affect the OneAgent version used for application monitoring.

The latest version is used by default.

string

tolerations

Tolerations to include with the OneAgent DaemonSet.
For details, see Taints and Tolerations.

[]Toleration

nodeSelector

Specify the node selector that controls on which nodes OneAgent will be deployed.

map[string]string

priorityClassName

Assign a priority class to the OneAgent pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

oneAgentResources

ResourceRequirements

autoUpdate

Disables automatic restarts of OneAgent pods in case a new version is available. Enabled by default.

true

boolean

dnsPolicy

Set the DNS Policy for OneAgent pods.
For details, see Pods DNS Policy.

ClusterFirstWithHostNet

string

annotations

Add custom OneAgent annotations.

map[string]string

labels

Your defined labels for OneAgent pods in order to structure workloads as desired.

map[string]string

env

Set additional environment variables for the OneAgent pods.

[]EnvVar

args

Set additional arguments to the OneAgent installer.
For available options, see Linux custom installation.
For the list of limitations, see Limitations.

[]string

initResources

Define resources requests and limits for the initContainer. For details, see Managing resources for containers.

ResourceRequirements

namespaceSelector

The namespaces where you want Dynatrace Operator to inject. For more information, see Configure monitoring for namespaces and pods.

LabelSelector

`.spec.oneAgent.classicFullStack`

All parameters are optional.

Parameter

Description

Default value

Data type

version

The OneAgent version to be used.

The latest version is used by default.

string

image

Use a custom OneAgent Docker image. Defaults to the image from the Dynatrace cluster.

Name of the image.

string

tolerations

Tolerations to include with the OneAgent DaemonSet.
For details, see Taints and Tolerations.

[]Toleration

autoUpdate

Disables automatic restarts of OneAgent pods in case a new version is available. Enabled by default.

true

boolean

dnsPolicy

Set the DNS Policy for OneAgent pods.
For details, see Pods DNS Policy.

ClusterFirstWithHostNet

string

annotations

Add custom OneAgent annotations.

map[string]string

labels

Your defined labels for OneAgent pods in order to structure workloads as desired.

map[string]string

env

Set additional environment variables for the OneAgent pods.

[]EnvVar

args

Set additional arguments to the OneAgent installer.
For available options, see Linux custom installation.
For the list of limitations, see Limitations.

[]string

nodeSelector

Specify the node selector that controls on which nodes OneAgent will be deployed.

map[string]string

priorityClassName

Assign a priority class to the OneAgent pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

oneAgentResources

ResourceRequirements

`.spec.oneAgent.applicationMonitoring`

All parameters are optional.

Parameter

Description

Default value

Data type

codeModulesImage

The OneAgent image that is used to inject into Pods

string

version

The OneAgent version to be used.

The latest version is used by default.

string

useCSIDriver

Set if you want to use the CSI driver. Don't enable it if you do not have access to Kubernetes nodes or if you lack privileges.

false

boolean

initResources

Define resources requests and limits for the initContainer. For details, see Managing resources for containers.

ResourceRequirements

hostGroup

string

namespaceSelector

The namespaces where you want Dynatrace Operator to inject. For more information, see Configure monitoring for namespaces and pods.

LabelSelector

`.spec.oneAgent.hostMonitoring`

All parameters are optional.

Parameter

Description

Default value

Data type

version

The OneAgent version to be used.

The latest version is used by default.

string

image

Use a custom OneAgent Docker image.

The image from the Dynatrace cluster.

string

nodeSelector

Specify the node selector that controls on which nodes OneAgent will be deployed.

map[string]string

priorityClassName

Assign a priority class to the OneAgent pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

tolerations

Tolerations to include with the OneAgent DaemonSet.
For details, see Taints and Tolerations.

[]Toleration

oneAgentResources

ResourceRequirements

autoupdate

Disables automatic restarts of OneAgent pods in case a new version is available. Enabled by default.

true

boolean

dnsPolicy

Set the DNS Policy for OneAgent pods.
For details, see Pods DNS Policy.

ClusterFirstWithHostNet

string

annotations

Add custom OneAgent annotations.

map[string]string

labels

Your defined labels for OneAgent pods in order to structure workloads as desired.

map[string]string

env

Set additional environment variables for the OneAgent pods.

[]EnvVar

args

Set additional arguments to the OneAgent installer.
For available options, see Linux custom installation.
For the list of limitations, see Limitations.

[]string

`.spec.activeGate`

capabilities parameter is required.
resources and group parameters are recommended.
All other parameters are optional.

Parameter

Description

Default value

Data type

capabilities

string

image

Use a custom ActiveGate image. Defaults to the latest ActiveGate image from the Dynatrace cluster.

string

replicas

Amount of replicas of ActiveGate pods.

int

tolerations

Set tolerations for the ActiveGate pods.
For details, see Taints and Tolerations.

[]Toleration

nodeSelector

Specify the node selector that controls on which nodes ActiveGate will be deployed.

map[string]string

resources

Resource settings for ActiveGate container. Consumption of the ActiveGate heavily depends on the workload to monitor; adjust values accordingly.

ResourceRequirements

labels

Your defined labels for ActiveGate pods in order to structure workloads as desired.

map[string]string

env

Set additional environment variables for the ActiveGate pods.

[]EnvVar

group

Set activation group for ActiveGate. See Customize ActiveGate properties for details.

string

customProperties

string

tlsSecretName

Name of a secret containing ActiveGate TLS certificate, key, and password. If not set, a self-signed certificate is used. For details, see How to add a custom certificate for ActiveGate.

string

dnsPolicy

Set the DNS policy for ActiveGate pods.

ClusterFirstWithHostNet

string

priorityClassName

Assign a priority class to the ActiveGate pods. By default, no class is set.
For details, see Pod Priority and Preemption.

string

annotations

Add custom ActiveGate annotations.

map[string]string

topologySpreadConstraints

Adds topology spread constraints to the ActiveGate pods.

[]corev1.TopologySpreadConstraint

A custom certificate is required for this capability. See the tlsSecretName parameter for details.