datadoghq.v2alpha1.datadogAgent

"DatadogAgent Deployment with the Datadog Operator."

Index

fn new(name)
obj metadata
obj spec

Fields

fn new

new(name)

new returns an instance of DatadogAgent

obj metadata

"ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create."

fn metadata.withAnnotations

withAnnotations(annotations)

"Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations"

fn metadata.withAnnotationsMixin

withAnnotationsMixin(annotations)

"Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations"

Note: This function appends passed data to existing values

fn metadata.withClusterName

withClusterName(clusterName)

"The name of the cluster which the object belongs to. This is used to distinguish resources with same name and namespace in different clusters. This field is not set anywhere right now and apiserver is going to ignore it if set in create or update request."

fn metadata.withCreationTimestamp

withCreationTimestamp(creationTimestamp)

"Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers."

fn metadata.withDeletionGracePeriodSeconds

withDeletionGracePeriodSeconds(deletionGracePeriodSeconds)

"Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only."

fn metadata.withDeletionTimestamp

withDeletionTimestamp(deletionTimestamp)

"Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers."

fn metadata.withFinalizers

withFinalizers(finalizers)

"Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list."

fn metadata.withFinalizersMixin

withFinalizersMixin(finalizers)

"Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order. Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list."

Note: This function appends passed data to existing values

fn metadata.withGenerateName

withGenerateName(generateName)

"GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.\n\nIf this field is specified and the generated name exists, the server will NOT return a 409 - instead, it will either return 201 Created or 500 with Reason ServerTimeout indicating a unique name could not be found in the time allotted, and the client should retry (optionally after the time indicated in the Retry-After header).\n\nApplied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency"

fn metadata.withGeneration

withGeneration(generation)

"A sequence number representing a specific generation of the desired state. Populated by the system. Read-only."

fn metadata.withLabels

withLabels(labels)

"Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels"

fn metadata.withLabelsMixin

withLabelsMixin(labels)

"Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels"

Note: This function appends passed data to existing values

fn metadata.withName

withName(name)

"Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names"

fn metadata.withNamespace

withNamespace(namespace)

"Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the \"default\" namespace, but \"default\" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.\n\nMust be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces"

fn metadata.withOwnerReferences

withOwnerReferences(ownerReferences)

"List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller."

fn metadata.withOwnerReferencesMixin

withOwnerReferencesMixin(ownerReferences)

"List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller."

Note: This function appends passed data to existing values

fn metadata.withResourceVersion

withResourceVersion(resourceVersion)

"An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.\n\nPopulated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency"

fn metadata.withSelfLink

withSelfLink(selfLink)

"SelfLink is a URL representing this object. Populated by the system. Read-only.\n\nDEPRECATED Kubernetes will stop propagating this field in 1.20 release and the field is planned to be removed in 1.21 release."

fn metadata.withUid

withUid(uid)

"UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.\n\nPopulated by the system. Read-only. More info: http://kubernetes.io/docs/user-guide/identifiers#uids"

obj spec

"DatadogAgentSpec defines the desired state of DatadogAgent"

fn spec.withOverride

withOverride(override)

"Override the default configurations of the agents"

fn spec.withOverrideMixin

withOverrideMixin(override)

"Override the default configurations of the agents"

Note: This function appends passed data to existing values

obj spec.features

"Features running on the Agent and Cluster Agent"

obj spec.features.admissionController

"AdmissionController configuration."

fn spec.features.admissionController.withAgentCommunicationMode

withAgentCommunicationMode(agentCommunicationMode)

"AgentCommunicationMode corresponds to the mode used by the Datadog application libraries to communicate with the Agent.\nIt can be \"hostip\", \"service\", or \"socket\"."

fn spec.features.admissionController.withEnabled

withEnabled(enabled)

"Enabled enables the Admission Controller.\nDefault: true"

fn spec.features.admissionController.withFailurePolicy

withFailurePolicy(failurePolicy)

"FailurePolicy determines how unrecognized and timeout errors are handled."

fn spec.features.admissionController.withMutateUnlabelled

withMutateUnlabelled(mutateUnlabelled)

"MutateUnlabelled enables config injection without the need of pod label 'admission.datadoghq.com/enabled=\"true\"'.\nDefault: false"

fn spec.features.admissionController.withRegistry

withRegistry(registry)

"Registry defines an image registry for the admission controller."

fn spec.features.admissionController.withServiceName

withServiceName(serviceName)

"ServiceName corresponds to the webhook service name."

fn spec.features.admissionController.withWebhookName

withWebhookName(webhookName)

"WebhookName is a custom name for the MutatingWebhookConfiguration.\nDefault: \"datadog-webhook\

obj spec.features.admissionController.agentSidecarInjection

"AgentSidecarInjection contains Agent sidecar injection configurations."

fn spec.features.admissionController.agentSidecarInjection.withClusterAgentCommunicationEnabled

withClusterAgentCommunicationEnabled(clusterAgentCommunicationEnabled)

"ClusterAgentCommunicationEnabled enables communication between Agent sidecars and the Cluster Agent.\nDefault : true"

fn spec.features.admissionController.agentSidecarInjection.withEnabled

withEnabled(enabled)

"Enabled enables Sidecar injections.\nDefault: false"

fn spec.features.admissionController.agentSidecarInjection.withProfiles

withProfiles(profiles)

"Profiles define the sidecar configuration override. Only one profile is supported."

fn spec.features.admissionController.agentSidecarInjection.withProfilesMixin

withProfilesMixin(profiles)

"Profiles define the sidecar configuration override. Only one profile is supported."

Note: This function appends passed data to existing values

fn spec.features.admissionController.agentSidecarInjection.withProvider

withProvider(provider)

"Provider is used to add infrastructure provider-specific configurations to the Agent sidecar.\nCurrently only \"fargate\" is supported.\nTo use the feature in other environments (including local testing) omit the config.\nSee also: https://docs.datadoghq.com/integrations/eks_fargate"

fn spec.features.admissionController.agentSidecarInjection.withRegistry

withRegistry(registry)

"Registry overrides the default registry for the sidecar Agent."

fn spec.features.admissionController.agentSidecarInjection.withSelectors

withSelectors(selectors)

"Selectors define the pod selector for sidecar injection. Only one rule is supported."

fn spec.features.admissionController.agentSidecarInjection.withSelectorsMixin

withSelectorsMixin(selectors)

"Selectors define the pod selector for sidecar injection. Only one rule is supported."

Note: This function appends passed data to existing values

obj spec.features.admissionController.agentSidecarInjection.image

"Image overrides the default Agent image name and tag for the Agent sidecar."

fn spec.features.admissionController.agentSidecarInjection.image.withJmxEnabled

withJmxEnabled(jmxEnabled)

"Define whether the Agent image should support JMX.\nTo be used if the Name field does not correspond to a full image string."

fn spec.features.admissionController.agentSidecarInjection.image.withName

withName(name)

"Defines the Agent image name for the pod. You can provide this as:\n <NAME> - Use agent for the Datadog Agent, cluster-agent for the Datadog Cluster Agent, or dogstatsd\nfor DogStatsD. The full image string is derived from global.registry, [key].image.tag, and [key].image.jmxEnabled.\n <NAME>:<TAG> - For example, agent:latest. The registry is derived from global.registry. [key].image.tag\nand [key].image.jmxEnabled are ignored.\n* <REGISTRY>/<NAME>:<TAG> - For example, gcr.io/datadoghq/agent:latest. If the full image string is specified\n like this, then global.registry, [key].image.tag, and [key].image.jmxEnabled are ignored."

fn spec.features.admissionController.agentSidecarInjection.image.withPullPolicy

withPullPolicy(pullPolicy)

"The Kubernetes pull policy:\nUse Always, Never, or IfNotPresent."

fn spec.features.admissionController.agentSidecarInjection.image.withPullSecrets

withPullSecrets(pullSecrets)

"It is possible to specify Docker registry credentials.\nSee https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod"

fn spec.features.admissionController.agentSidecarInjection.image.withPullSecretsMixin

withPullSecretsMixin(pullSecrets)

"It is possible to specify Docker registry credentials.\nSee https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod"

Note: This function appends passed data to existing values

fn spec.features.admissionController.agentSidecarInjection.image.withTag

withTag(tag)

"Define the image tag to use.\nTo be used if the Name field does not correspond to a full image string."

obj spec.features.admissionController.agentSidecarInjection.image.pullSecrets

"It is possible to specify Docker registry credentials.\nSee https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod"

fn spec.features.admissionController.agentSidecarInjection.image.pullSecrets.withName

withName(name)

"Name of the referent.\nThis field is effectively required, but due to backwards compatibility is\nallowed to be empty. Instances of this type with an empty value here are\nalmost certainly wrong.\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"

obj spec.features.admissionController.agentSidecarInjection.profiles

"Profiles define the sidecar configuration override. Only one profile is supported."

fn spec.features.admissionController.agentSidecarInjection.profiles.withEnv

withEnv(env)

"EnvVars specifies the environment variables for the profile."

fn spec.features.admissionController.agentSidecarInjection.profiles.withEnvMixin

withEnvMixin(env)

"EnvVars specifies the environment variables for the profile."

Note: This function appends passed data to existing values

obj spec.features.admissionController.agentSidecarInjection.profiles.env

"EnvVars specifies the environment variables for the profile."

fn spec.features.admissionController.agentSidecarInjection.profiles.env.withName

withName(name)

"Name of the environment variable. Must be a C_IDENTIFIER."

fn spec.features.admissionController.agentSidecarInjection.profiles.env.withValue

withValue(value)

"Variable references $(VAR_NAME) are expanded\nusing the previously defined environment variables in the container and\nany service environment variables. If a variable cannot be resolved,\nthe reference in the input string will be unchanged. Double $$ are reduced\nto a single $, which allows for escaping the $(VAR_NAME) syntax: i.e.\n\"$$(VAR_NAME)\" will produce the string literal \"$(VAR_NAME)\".\nEscaped references will never be expanded, regardless of whether the variable\nexists or not.\nDefaults to \"\"."

obj spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom

"Source for the environment variable's value. Cannot be used if value is not empty."

obj spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.configMapKeyRef

"Selects a key of a ConfigMap."

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.configMapKeyRef.withKey

withKey(key)

"The key to select."

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.configMapKeyRef.withName

withName(name)

"Name of the referent.\nThis field is effectively required, but due to backwards compatibility is\nallowed to be empty. Instances of this type with an empty value here are\nalmost certainly wrong.\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.configMapKeyRef.withOptional

withOptional(optional)

"Specify whether the ConfigMap or its key must be defined"

obj spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.fieldRef

"Selects a field of the pod: supports metadata.name, metadata.namespace, metadata.labels['<KEY>'], metadata.annotations['<KEY>'],\nspec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs."

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.fieldRef.withApiVersion

withApiVersion(apiVersion)

"Version of the schema the FieldPath is written in terms of, defaults to \"v1\"."

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.fieldRef.withFieldPath

withFieldPath(fieldPath)

"Path of the field to select in the specified API version."

obj spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.resourceFieldRef

"Selects a resource of the container: only resources limits and requests\n(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage) are currently supported."

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.resourceFieldRef.withContainerName

withContainerName(containerName)

"Container name: required for volumes, optional for env vars"

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.resourceFieldRef.withDivisor

withDivisor(divisor)

"Specifies the output format of the exposed resources, defaults to \"1\

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.resourceFieldRef.withResource

withResource(resource)

"Required: resource to select"

obj spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.secretKeyRef

"Selects a key of a secret in the pod's namespace"

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.secretKeyRef.withKey

withKey(key)

"The key of the secret to select from. Must be a valid secret key."

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.secretKeyRef.withName

withName(name)

"Name of the referent.\nThis field is effectively required, but due to backwards compatibility is\nallowed to be empty. Instances of this type with an empty value here are\nalmost certainly wrong.\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"

fn spec.features.admissionController.agentSidecarInjection.profiles.env.valueFrom.secretKeyRef.withOptional

withOptional(optional)

"Specify whether the Secret or its key must be defined"

obj spec.features.admissionController.agentSidecarInjection.profiles.resources

"ResourceRequirements specifies the resource requirements for the profile."

fn spec.features.admissionController.agentSidecarInjection.profiles.resources.withClaims

withClaims(claims)

"Claims lists the names of resources, defined in spec.resourceClaims,\nthat are used by this container.\n\nThis is an alpha field and requires enabling the\nDynamicResourceAllocation feature gate.\n\nThis field is immutable. It can only be set for containers."

fn spec.features.admissionController.agentSidecarInjection.profiles.resources.withClaimsMixin

withClaimsMixin(claims)

"Claims lists the names of resources, defined in spec.resourceClaims,\nthat are used by this container.\n\nThis is an alpha field and requires enabling the\nDynamicResourceAllocation feature gate.\n\nThis field is immutable. It can only be set for containers."

Note: This function appends passed data to existing values

fn spec.features.admissionController.agentSidecarInjection.profiles.resources.withLimits

withLimits(limits)

"Limits describes the maximum amount of compute resources allowed.\nMore info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/"

fn spec.features.admissionController.agentSidecarInjection.profiles.resources.withLimitsMixin

withLimitsMixin(limits)

"Limits describes the maximum amount of compute resources allowed.\nMore info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/"

Note: This function appends passed data to existing values

fn spec.features.admissionController.agentSidecarInjection.profiles.resources.withRequests

withRequests(requests)

"Requests describes the minimum amount of compute resources required.\nIf Requests is omitted for a container, it defaults to Limits if that is explicitly specified,\notherwise to an implementation-defined value. Requests cannot exceed Limits.\nMore info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/"

fn spec.features.admissionController.agentSidecarInjection.profiles.resources.withRequestsMixin

withRequestsMixin(requests)

"Requests describes the minimum amount of compute resources required.\nIf Requests is omitted for a container, it defaults to Limits if that is explicitly specified,\notherwise to an implementation-defined value. Requests cannot exceed Limits.\nMore info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/"

Note: This function appends passed data to existing values

obj spec.features.admissionController.agentSidecarInjection.profiles.resources.claims

"Claims lists the names of resources, defined in spec.resourceClaims,\nthat are used by this container.\n\nThis is an alpha field and requires enabling the\nDynamicResourceAllocation feature gate.\n\nThis field is immutable. It can only be set for containers."

fn spec.features.admissionController.agentSidecarInjection.profiles.resources.claims.withName

withName(name)

"Name must match the name of one entry in pod.spec.resourceClaims of\nthe Pod where this field is used. It makes that resource available\ninside a container."

fn spec.features.admissionController.agentSidecarInjection.profiles.resources.claims.withRequest

withRequest(request)

"Request is the name chosen for a request in the referenced claim.\nIf empty, everything from the claim is made available, otherwise\nonly the result of this request."

obj spec.features.admissionController.agentSidecarInjection.profiles.securityContext

"SecurityContext specifies the security context for the profile."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.withAllowPrivilegeEscalation

withAllowPrivilegeEscalation(allowPrivilegeEscalation)

"AllowPrivilegeEscalation controls whether a process can gain more\nprivileges than its parent process. This bool directly controls if\nthe no_new_privs flag will be set on the container process.\nAllowPrivilegeEscalation is true always when the container is:\n1) run as Privileged\n2) has CAP_SYS_ADMIN\nNote that this field cannot be set when spec.os.name is windows."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.withPrivileged

withPrivileged(privileged)

"Run container in privileged mode.\nProcesses in privileged containers are essentially equivalent to root on the host.\nDefaults to false.\nNote that this field cannot be set when spec.os.name is windows."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.withProcMount

withProcMount(procMount)

"procMount denotes the type of proc mount to use for the containers.\nThe default value is Default which uses the container runtime defaults for\nreadonly paths and masked paths.\nThis requires the ProcMountType feature flag to be enabled.\nNote that this field cannot be set when spec.os.name is windows."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.withReadOnlyRootFilesystem

withReadOnlyRootFilesystem(readOnlyRootFilesystem)

"Whether this container has a read-only root filesystem.\nDefault is false.\nNote that this field cannot be set when spec.os.name is windows."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.withRunAsGroup

withRunAsGroup(runAsGroup)

"The GID to run the entrypoint of the container process.\nUses runtime default if unset.\nMay also be set in PodSecurityContext. If set in both SecurityContext and\nPodSecurityContext, the value specified in SecurityContext takes precedence.\nNote that this field cannot be set when spec.os.name is windows."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.withRunAsNonRoot

withRunAsNonRoot(runAsNonRoot)

"Indicates that the container must run as a non-root user.\nIf true, the Kubelet will validate the image at runtime to ensure that it\ndoes not run as UID 0 (root) and fail to start the container if it does.\nIf unset or false, no such validation will be performed.\nMay also be set in PodSecurityContext. If set in both SecurityContext and\nPodSecurityContext, the value specified in SecurityContext takes precedence."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.withRunAsUser

withRunAsUser(runAsUser)

"The UID to run the entrypoint of the container process.\nDefaults to user specified in image metadata if unspecified.\nMay also be set in PodSecurityContext. If set in both SecurityContext and\nPodSecurityContext, the value specified in SecurityContext takes precedence.\nNote that this field cannot be set when spec.os.name is windows."

obj spec.features.admissionController.agentSidecarInjection.profiles.securityContext.appArmorProfile

"appArmorProfile is the AppArmor options to use by this container. If set, this profile\noverrides the pod's appArmorProfile.\nNote that this field cannot be set when spec.os.name is windows."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.appArmorProfile.withLocalhostProfile

withLocalhostProfile(localhostProfile)

"localhostProfile indicates a profile loaded on the node that should be used.\nThe profile must be preconfigured on the node to work.\nMust match the loaded name of the profile.\nMust be set if and only if type is \"Localhost\"."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.appArmorProfile.withType

withType(type)

"type indicates which kind of AppArmor profile will be applied.\nValid options are:\n Localhost - a profile pre-loaded on the node.\n RuntimeDefault - the container runtime's default profile.\n Unconfined - no AppArmor enforcement."

obj spec.features.admissionController.agentSidecarInjection.profiles.securityContext.capabilities

"The capabilities to add/drop when running containers.\nDefaults to the default set of capabilities granted by the container runtime.\nNote that this field cannot be set when spec.os.name is windows."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.capabilities.withAdd

withAdd(add)

"Added capabilities"

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.capabilities.withAddMixin

withAddMixin(add)

"Added capabilities"

Note: This function appends passed data to existing values

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.capabilities.withDrop

withDrop(drop)

"Removed capabilities"

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.capabilities.withDropMixin

withDropMixin(drop)

"Removed capabilities"

Note: This function appends passed data to existing values

obj spec.features.admissionController.agentSidecarInjection.profiles.securityContext.seLinuxOptions

"The SELinux context to be applied to the container.\nIf unspecified, the container runtime will allocate a random SELinux context for each\ncontainer. May also be set in PodSecurityContext. If set in both SecurityContext and\nPodSecurityContext, the value specified in SecurityContext takes precedence.\nNote that this field cannot be set when spec.os.name is windows."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.seLinuxOptions.withLevel

withLevel(level)

"Level is SELinux level label that applies to the container."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.seLinuxOptions.withRole

withRole(role)

"Role is a SELinux role label that applies to the container."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.seLinuxOptions.withType

withType(type)

"Type is a SELinux type label that applies to the container."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.seLinuxOptions.withUser

withUser(user)

"User is a SELinux user label that applies to the container."

obj spec.features.admissionController.agentSidecarInjection.profiles.securityContext.seccompProfile

"The seccomp options to use by this container. If seccomp options are\nprovided at both the pod & container level, the container options\noverride the pod options.\nNote that this field cannot be set when spec.os.name is windows."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.seccompProfile.withLocalhostProfile

withLocalhostProfile(localhostProfile)

"localhostProfile indicates a profile defined in a file on the node should be used.\nThe profile must be preconfigured on the node to work.\nMust be a descending path, relative to the kubelet's configured seccomp profile location.\nMust be set if type is \"Localhost\". Must NOT be set for any other type."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.seccompProfile.withType

withType(type)

"type indicates which kind of seccomp profile will be applied.\nValid options are:\n\nLocalhost - a profile defined in a file on the node should be used.\nRuntimeDefault - the container runtime default profile should be used.\nUnconfined - no profile should be applied."

obj spec.features.admissionController.agentSidecarInjection.profiles.securityContext.windowsOptions

"The Windows specific settings applied to all containers.\nIf unspecified, the options from the PodSecurityContext will be used.\nIf set in both SecurityContext and PodSecurityContext, the value specified in SecurityContext takes precedence.\nNote that this field cannot be set when spec.os.name is linux."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.windowsOptions.withGmsaCredentialSpec

withGmsaCredentialSpec(gmsaCredentialSpec)

"GMSACredentialSpec is where the GMSA admission webhook\n(https://github.com/kubernetes-sigs/windows-gmsa) inlines the contents of the\nGMSA credential spec named by the GMSACredentialSpecName field."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.windowsOptions.withGmsaCredentialSpecName

withGmsaCredentialSpecName(gmsaCredentialSpecName)

"GMSACredentialSpecName is the name of the GMSA credential spec to use."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.windowsOptions.withHostProcess

withHostProcess(hostProcess)

"HostProcess determines if a container should be run as a 'Host Process' container.\nAll of a Pod's containers must have the same effective HostProcess value\n(it is not allowed to have a mix of HostProcess containers and non-HostProcess containers).\nIn addition, if HostProcess is true then HostNetwork must also be set to true."

fn spec.features.admissionController.agentSidecarInjection.profiles.securityContext.windowsOptions.withRunAsUserName

withRunAsUserName(runAsUserName)

"The UserName in Windows to run the entrypoint of the container process.\nDefaults to the user specified in image metadata if unspecified.\nMay also be set in PodSecurityContext. If set in both SecurityContext and\nPodSecurityContext, the value specified in SecurityContext takes precedence."

obj spec.features.admissionController.agentSidecarInjection.selectors

"Selectors define the pod selector for sidecar injection. Only one rule is supported."

obj spec.features.admissionController.agentSidecarInjection.selectors.namespaceSelector

"NamespaceSelector specifies the label selector for namespaces."

fn spec.features.admissionController.agentSidecarInjection.selectors.namespaceSelector.withMatchExpressions

withMatchExpressions(matchExpressions)

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

fn spec.features.admissionController.agentSidecarInjection.selectors.namespaceSelector.withMatchExpressionsMixin

withMatchExpressionsMixin(matchExpressions)

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

Note: This function appends passed data to existing values

fn spec.features.admissionController.agentSidecarInjection.selectors.namespaceSelector.withMatchLabels

withMatchLabels(matchLabels)

"matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels\nmap is equivalent to an element of matchExpressions, whose key field is \"key\", the\noperator is \"In\", and the values array contains only \"value\". The requirements are ANDed."

fn spec.features.admissionController.agentSidecarInjection.selectors.namespaceSelector.withMatchLabelsMixin

withMatchLabelsMixin(matchLabels)

"matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels\nmap is equivalent to an element of matchExpressions, whose key field is \"key\", the\noperator is \"In\", and the values array contains only \"value\". The requirements are ANDed."

Note: This function appends passed data to existing values

obj spec.features.admissionController.agentSidecarInjection.selectors.namespaceSelector.matchExpressions

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

fn spec.features.admissionController.agentSidecarInjection.selectors.namespaceSelector.matchExpressions.withKey

withKey(key)

"key is the label key that the selector applies to."

fn spec.features.admissionController.agentSidecarInjection.selectors.namespaceSelector.matchExpressions.withOperator

withOperator(operator)

"operator represents a key's relationship to a set of values.\nValid operators are In, NotIn, Exists and DoesNotExist."

fn spec.features.admissionController.agentSidecarInjection.selectors.namespaceSelector.matchExpressions.withValues

withValues(values)

"values is an array of string values. If the operator is In or NotIn,\nthe values array must be non-empty. If the operator is Exists or DoesNotExist,\nthe values array must be empty. This array is replaced during a strategic\nmerge patch."

fn spec.features.admissionController.agentSidecarInjection.selectors.namespaceSelector.matchExpressions.withValuesMixin

withValuesMixin(values)

"values is an array of string values. If the operator is In or NotIn,\nthe values array must be non-empty. If the operator is Exists or DoesNotExist,\nthe values array must be empty. This array is replaced during a strategic\nmerge patch."

Note: This function appends passed data to existing values

obj spec.features.admissionController.agentSidecarInjection.selectors.objectSelector

"ObjectSelector specifies the label selector for objects."

fn spec.features.admissionController.agentSidecarInjection.selectors.objectSelector.withMatchExpressions

withMatchExpressions(matchExpressions)

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

fn spec.features.admissionController.agentSidecarInjection.selectors.objectSelector.withMatchExpressionsMixin

withMatchExpressionsMixin(matchExpressions)

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

Note: This function appends passed data to existing values

fn spec.features.admissionController.agentSidecarInjection.selectors.objectSelector.withMatchLabels

withMatchLabels(matchLabels)

"matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels\nmap is equivalent to an element of matchExpressions, whose key field is \"key\", the\noperator is \"In\", and the values array contains only \"value\". The requirements are ANDed."

fn spec.features.admissionController.agentSidecarInjection.selectors.objectSelector.withMatchLabelsMixin

withMatchLabelsMixin(matchLabels)

"matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels\nmap is equivalent to an element of matchExpressions, whose key field is \"key\", the\noperator is \"In\", and the values array contains only \"value\". The requirements are ANDed."

Note: This function appends passed data to existing values

obj spec.features.admissionController.agentSidecarInjection.selectors.objectSelector.matchExpressions

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

fn spec.features.admissionController.agentSidecarInjection.selectors.objectSelector.matchExpressions.withKey

withKey(key)

"key is the label key that the selector applies to."

fn spec.features.admissionController.agentSidecarInjection.selectors.objectSelector.matchExpressions.withOperator

withOperator(operator)

"operator represents a key's relationship to a set of values.\nValid operators are In, NotIn, Exists and DoesNotExist."

fn spec.features.admissionController.agentSidecarInjection.selectors.objectSelector.matchExpressions.withValues

withValues(values)

"values is an array of string values. If the operator is In or NotIn,\nthe values array must be non-empty. If the operator is Exists or DoesNotExist,\nthe values array must be empty. This array is replaced during a strategic\nmerge patch."

fn spec.features.admissionController.agentSidecarInjection.selectors.objectSelector.matchExpressions.withValuesMixin

withValuesMixin(values)

"values is an array of string values. If the operator is In or NotIn,\nthe values array must be non-empty. If the operator is Exists or DoesNotExist,\nthe values array must be empty. This array is replaced during a strategic\nmerge patch."

Note: This function appends passed data to existing values

obj spec.features.admissionController.cwsInstrumentation

"CWSInstrumentation holds the CWS Instrumentation endpoint configuration"

fn spec.features.admissionController.cwsInstrumentation.withEnabled

withEnabled(enabled)

"Enable the CWS Instrumentation admission controller endpoint.\nDefault: false"

fn spec.features.admissionController.cwsInstrumentation.withMode

withMode(mode)

"Mode defines the behavior of the CWS Instrumentation endpoint, and can be either \"init_container\" or \"remote_copy\".\nDefault: \"remote_copy\

obj spec.features.admissionController.kubernetesAdmissionEvents

"KubernetesAdmissionEvents holds the Kubernetes Admission Events configuration."

fn spec.features.admissionController.kubernetesAdmissionEvents.withEnabled

withEnabled(enabled)

"Enable the Kubernetes Admission Events feature.\nDefault: false"

obj spec.features.admissionController.mutation

"Mutation contains Admission Controller mutation configurations."

fn spec.features.admissionController.mutation.withEnabled

withEnabled(enabled)

"Enabled enables the Admission Controller mutation webhook.\nDefault: true"

obj spec.features.admissionController.validation

"Validation contains Admission Controller validation configurations."

fn spec.features.admissionController.validation.withEnabled

withEnabled(enabled)

"Enabled enables the Admission Controller validation webhook.\nDefault: true"

obj spec.features.apm

"APM (Application Performance Monitoring) configuration."

fn spec.features.apm.withEnabled

withEnabled(enabled)

"Enabled enables Application Performance Monitoring.\nDefault: true"

obj spec.features.apm.errorTrackingStandalone

"ErrorTrackingStandalone contains the configuration for the Error Tracking standalone feature.\nFeature is in preview."

fn spec.features.apm.errorTrackingStandalone.withEnabled

withEnabled(enabled)

"Enables Error Tracking for backend services.\nDefault: false"

obj spec.features.apm.hostPortConfig

"HostPortConfig contains host port configuration.\nEnabled Default: false\nPort Default: 8126"

fn spec.features.apm.hostPortConfig.withEnabled

withEnabled(enabled)

"Enabled enables host port configuration"

fn spec.features.apm.hostPortConfig.withHostPort

withHostPort(hostPort)

"Port takes a port number (0 < x < 65536) to expose on the host. (Most containers do not need this.)\nIf HostNetwork is enabled, this value must match the ContainerPort."

obj spec.features.apm.instrumentation

"SingleStepInstrumentation allows the agent to inject the Datadog APM libraries into all pods in the cluster.\nFeature is in beta.\nSee also: https://docs.datadoghq.com/tracing/trace_collection/single-step-apm\nEnabled Default: false"

fn spec.features.apm.instrumentation.withDisabledNamespaces

withDisabledNamespaces(disabledNamespaces)

"DisabledNamespaces disables injecting the Datadog APM libraries into pods in specific namespaces."

fn spec.features.apm.instrumentation.withDisabledNamespacesMixin

withDisabledNamespacesMixin(disabledNamespaces)

"DisabledNamespaces disables injecting the Datadog APM libraries into pods in specific namespaces."

Note: This function appends passed data to existing values

fn spec.features.apm.instrumentation.withEnabled

withEnabled(enabled)

"Enabled enables injecting the Datadog APM libraries into all pods in the cluster.\nDefault: false"

fn spec.features.apm.instrumentation.withEnabledNamespaces

withEnabledNamespaces(enabledNamespaces)

"EnabledNamespaces enables injecting the Datadog APM libraries into pods in specific namespaces."

fn spec.features.apm.instrumentation.withEnabledNamespacesMixin

withEnabledNamespacesMixin(enabledNamespaces)

"EnabledNamespaces enables injecting the Datadog APM libraries into pods in specific namespaces."

Note: This function appends passed data to existing values

fn spec.features.apm.instrumentation.withLibVersions

withLibVersions(libVersions)

"LibVersions configures injection of specific tracing library versions with Single Step Instrumentation.\n: \nex: \"java\": \"v1.18.0\

fn spec.features.apm.instrumentation.withLibVersionsMixin

withLibVersionsMixin(libVersions)

"LibVersions configures injection of specific tracing library versions with Single Step Instrumentation.\n: \nex: \"java\": \"v1.18.0\

Note: This function appends passed data to existing values

fn spec.features.apm.instrumentation.withTargets

withTargets(targets)

"Targets is a list of targets to apply the auto instrumentation to. The first target that matches the pod will be\nused. If no target matches, the auto instrumentation will not be applied.\n(Requires Cluster Agent 7.64.0+)"

fn spec.features.apm.instrumentation.withTargetsMixin

withTargetsMixin(targets)

"Targets is a list of targets to apply the auto instrumentation to. The first target that matches the pod will be\nused. If no target matches, the auto instrumentation will not be applied.\n(Requires Cluster Agent 7.64.0+)"

Note: This function appends passed data to existing values

obj spec.features.apm.instrumentation.injector

"Injector configures the APM Injector."

fn spec.features.apm.instrumentation.injector.withImageTag

withImageTag(imageTag)

"Set the image tag to use for the APM Injector.\n(Requires Cluster Agent 7.57.0+)"

obj spec.features.apm.instrumentation.languageDetection

"LanguageDetection detects languages and adds them as annotations on Deployments, but does not use these languages for injecting libraries to workload pods.\n(Requires Agent 7.52.0+ and Cluster Agent 7.52.0+)"

fn spec.features.apm.instrumentation.languageDetection.withEnabled

withEnabled(enabled)

"Enabled enables Language Detection to automatically detect languages of user workloads (beta).\nRequires SingleStepInstrumentation.Enabled to be true.\nDefault: true"

obj spec.features.apm.instrumentation.targets

"Targets is a list of targets to apply the auto instrumentation to. The first target that matches the pod will be\nused. If no target matches, the auto instrumentation will not be applied.\n(Requires Cluster Agent 7.64.0+)"

fn spec.features.apm.instrumentation.targets.withDdTraceConfigs

withDdTraceConfigs(ddTraceConfigs)

"TracerConfigs is a list of configuration options to use for the installed tracers. These options will be added\nas environment variables in addition to the injected tracer."

fn spec.features.apm.instrumentation.targets.withDdTraceConfigsMixin

withDdTraceConfigsMixin(ddTraceConfigs)

"TracerConfigs is a list of configuration options to use for the installed tracers. These options will be added\nas environment variables in addition to the injected tracer."

Note: This function appends passed data to existing values

fn spec.features.apm.instrumentation.targets.withDdTraceVersions

withDdTraceVersions(ddTraceVersions)

"TracerVersions is a map of tracer versions to inject for workloads that match the target. The key is the tracer\nname and the value is the version to inject."

fn spec.features.apm.instrumentation.targets.withDdTraceVersionsMixin

withDdTraceVersionsMixin(ddTraceVersions)

"TracerVersions is a map of tracer versions to inject for workloads that match the target. The key is the tracer\nname and the value is the version to inject."

Note: This function appends passed data to existing values

fn spec.features.apm.instrumentation.targets.withName

withName(name)

"Name is the name of the target. It will be appended to the pod annotations to identify the target that was used."

obj spec.features.apm.instrumentation.targets.ddTraceConfigs

"TracerConfigs is a list of configuration options to use for the installed tracers. These options will be added\nas environment variables in addition to the injected tracer."

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.withName

withName(name)

"Name of the environment variable. Must be a C_IDENTIFIER."

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.withValue

withValue(value)

"Variable references $(VAR_NAME) are expanded\nusing the previously defined environment variables in the container and\nany service environment variables. If a variable cannot be resolved,\nthe reference in the input string will be unchanged. Double $$ are reduced\nto a single $, which allows for escaping the $(VAR_NAME) syntax: i.e.\n\"$$(VAR_NAME)\" will produce the string literal \"$(VAR_NAME)\".\nEscaped references will never be expanded, regardless of whether the variable\nexists or not.\nDefaults to \"\"."

obj spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom

"Source for the environment variable's value. Cannot be used if value is not empty."

obj spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.configMapKeyRef

"Selects a key of a ConfigMap."

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.configMapKeyRef.withKey

withKey(key)

"The key to select."

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.configMapKeyRef.withName

withName(name)

"Name of the referent.\nThis field is effectively required, but due to backwards compatibility is\nallowed to be empty. Instances of this type with an empty value here are\nalmost certainly wrong.\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.configMapKeyRef.withOptional

withOptional(optional)

"Specify whether the ConfigMap or its key must be defined"

obj spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.fieldRef

"Selects a field of the pod: supports metadata.name, metadata.namespace, metadata.labels['<KEY>'], metadata.annotations['<KEY>'],\nspec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs."

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.fieldRef.withApiVersion

withApiVersion(apiVersion)

"Version of the schema the FieldPath is written in terms of, defaults to \"v1\"."

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.fieldRef.withFieldPath

withFieldPath(fieldPath)

"Path of the field to select in the specified API version."

obj spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.resourceFieldRef

"Selects a resource of the container: only resources limits and requests\n(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage) are currently supported."

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.resourceFieldRef.withContainerName

withContainerName(containerName)

"Container name: required for volumes, optional for env vars"

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.resourceFieldRef.withDivisor

withDivisor(divisor)

"Specifies the output format of the exposed resources, defaults to \"1\

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.resourceFieldRef.withResource

withResource(resource)

"Required: resource to select"

obj spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.secretKeyRef

"Selects a key of a secret in the pod's namespace"

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.secretKeyRef.withKey

withKey(key)

"The key of the secret to select from. Must be a valid secret key."

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.secretKeyRef.withName

withName(name)

"Name of the referent.\nThis field is effectively required, but due to backwards compatibility is\nallowed to be empty. Instances of this type with an empty value here are\nalmost certainly wrong.\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"

fn spec.features.apm.instrumentation.targets.ddTraceConfigs.valueFrom.secretKeyRef.withOptional

withOptional(optional)

"Specify whether the Secret or its key must be defined"

obj spec.features.apm.instrumentation.targets.namespaceSelector

"NamespaceSelector is the namespace selector to match the namespaces to apply the auto instrumentation to. It will\nbe used in conjunction with the Selector to match the pods."

fn spec.features.apm.instrumentation.targets.namespaceSelector.withMatchExpressions

withMatchExpressions(matchExpressions)

"MatchExpressions is a list of label selector requirements to match the labels of the namespace. The labels and\nexpressions are ANDed. This cannot be used with MatchNames."

fn spec.features.apm.instrumentation.targets.namespaceSelector.withMatchExpressionsMixin

withMatchExpressionsMixin(matchExpressions)

"MatchExpressions is a list of label selector requirements to match the labels of the namespace. The labels and\nexpressions are ANDed. This cannot be used with MatchNames."

Note: This function appends passed data to existing values

fn spec.features.apm.instrumentation.targets.namespaceSelector.withMatchLabels

withMatchLabels(matchLabels)

"MatchLabels is a map of key-value pairs to match the labels of the namespace. The labels and expressions are\nANDed. This cannot be used with MatchNames."

fn spec.features.apm.instrumentation.targets.namespaceSelector.withMatchLabelsMixin

withMatchLabelsMixin(matchLabels)

"MatchLabels is a map of key-value pairs to match the labels of the namespace. The labels and expressions are\nANDed. This cannot be used with MatchNames."

Note: This function appends passed data to existing values

fn spec.features.apm.instrumentation.targets.namespaceSelector.withMatchNames

withMatchNames(matchNames)

"MatchNames is a list of namespace names to match. If empty, all namespaces are matched."

fn spec.features.apm.instrumentation.targets.namespaceSelector.withMatchNamesMixin

withMatchNamesMixin(matchNames)

"MatchNames is a list of namespace names to match. If empty, all namespaces are matched."

Note: This function appends passed data to existing values

obj spec.features.apm.instrumentation.targets.namespaceSelector.matchExpressions

"MatchExpressions is a list of label selector requirements to match the labels of the namespace. The labels and\nexpressions are ANDed. This cannot be used with MatchNames."

fn spec.features.apm.instrumentation.targets.namespaceSelector.matchExpressions.withKey

withKey(key)

"key is the label key that the selector applies to."

fn spec.features.apm.instrumentation.targets.namespaceSelector.matchExpressions.withOperator

withOperator(operator)

"operator represents a key's relationship to a set of values.\nValid operators are In, NotIn, Exists and DoesNotExist."

fn spec.features.apm.instrumentation.targets.namespaceSelector.matchExpressions.withValues

withValues(values)

"values is an array of string values. If the operator is In or NotIn,\nthe values array must be non-empty. If the operator is Exists or DoesNotExist,\nthe values array must be empty. This array is replaced during a strategic\nmerge patch."

fn spec.features.apm.instrumentation.targets.namespaceSelector.matchExpressions.withValuesMixin

withValuesMixin(values)

"values is an array of string values. If the operator is In or NotIn,\nthe values array must be non-empty. If the operator is Exists or DoesNotExist,\nthe values array must be empty. This array is replaced during a strategic\nmerge patch."

Note: This function appends passed data to existing values

obj spec.features.apm.instrumentation.targets.podSelector

"PodSelector is the pod selector to match the pods to apply the auto instrumentation to. It will be used in\nconjunction with the NamespaceSelector to match the pods."

fn spec.features.apm.instrumentation.targets.podSelector.withMatchExpressions

withMatchExpressions(matchExpressions)

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

fn spec.features.apm.instrumentation.targets.podSelector.withMatchExpressionsMixin

withMatchExpressionsMixin(matchExpressions)

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

Note: This function appends passed data to existing values

fn spec.features.apm.instrumentation.targets.podSelector.withMatchLabels

withMatchLabels(matchLabels)

"matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels\nmap is equivalent to an element of matchExpressions, whose key field is \"key\", the\noperator is \"In\", and the values array contains only \"value\". The requirements are ANDed."

fn spec.features.apm.instrumentation.targets.podSelector.withMatchLabelsMixin

withMatchLabelsMixin(matchLabels)

"matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels\nmap is equivalent to an element of matchExpressions, whose key field is \"key\", the\noperator is \"In\", and the values array contains only \"value\". The requirements are ANDed."

Note: This function appends passed data to existing values

obj spec.features.apm.instrumentation.targets.podSelector.matchExpressions

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

fn spec.features.apm.instrumentation.targets.podSelector.matchExpressions.withKey

withKey(key)

"key is the label key that the selector applies to."

fn spec.features.apm.instrumentation.targets.podSelector.matchExpressions.withOperator

withOperator(operator)

"operator represents a key's relationship to a set of values.\nValid operators are In, NotIn, Exists and DoesNotExist."

fn spec.features.apm.instrumentation.targets.podSelector.matchExpressions.withValues

withValues(values)

"values is an array of string values. If the operator is In or NotIn,\nthe values array must be non-empty. If the operator is Exists or DoesNotExist,\nthe values array must be empty. This array is replaced during a strategic\nmerge patch."

fn spec.features.apm.instrumentation.targets.podSelector.matchExpressions.withValuesMixin

withValuesMixin(values)

"values is an array of string values. If the operator is In or NotIn,\nthe values array must be non-empty. If the operator is Exists or DoesNotExist,\nthe values array must be empty. This array is replaced during a strategic\nmerge patch."

Note: This function appends passed data to existing values

obj spec.features.apm.unixDomainSocketConfig

"UnixDomainSocketConfig contains socket configuration.\nSee also: https://docs.datadoghq.com/agent/kubernetes/apm/?tab=helm#agent-environment-variables\nEnabled Default: true\nPath Default: /var/run/datadog/apm.socket"

fn spec.features.apm.unixDomainSocketConfig.withEnabled

withEnabled(enabled)

"Enabled enables Unix Domain Socket.\nDefault: true"

fn spec.features.apm.unixDomainSocketConfig.withPath

withPath(path)

"Path defines the socket path used when enabled."

obj spec.features.asm

"ASM (Application Security Management) configuration."

obj spec.features.asm.iast

"IAST configures Interactive Application Security Testing.\nEnabled Default: false"

fn spec.features.asm.iast.withEnabled

withEnabled(enabled)

"Enabled enables Interactive Application Security Testing (IAST).\nDefault: false"

obj spec.features.asm.sca

"SCA configures Software Composition Analysis.\nEnabled Default: false"

fn spec.features.asm.sca.withEnabled

withEnabled(enabled)

"Enabled enables Software Composition Analysis (SCA).\nDefault: false"

obj spec.features.asm.threats

"Threats configures ASM App & API Protection.\nEnabled Default: false"

fn spec.features.asm.threats.withEnabled

withEnabled(enabled)

"Enabled enables ASM App & API Protection.\nDefault: false"

obj spec.features.autoscaling

"Autoscaling configuration."

obj spec.features.autoscaling.workload

"Workload contains the configuration for the workload autoscaling product."

fn spec.features.autoscaling.workload.withEnabled

withEnabled(enabled)

"Enabled enables the workload autoscaling product.\nDefault: false"

obj spec.features.clusterChecks

"ClusterChecks configuration."

fn spec.features.clusterChecks.withEnabled

withEnabled(enabled)

"Enables Cluster Checks scheduling in the Cluster Agent.\nDefault: true"

fn spec.features.clusterChecks.withUseClusterChecksRunners

withUseClusterChecksRunners(useClusterChecksRunners)

"Enabled enables Cluster Checks Runners to run all Cluster Checks.\nDefault: false"

obj spec.features.controlPlaneMonitoring

"ControlPlaneMonitoring configuration."

fn spec.features.controlPlaneMonitoring.withEnabled

withEnabled(enabled)

"Enabled enables control plane monitoring checks in the cluster agent.\nDefault: true"

obj spec.features.cspm

"CSPM (Cloud Security Posture Management) configuration."

fn spec.features.cspm.withCheckInterval

withCheckInterval(checkInterval)

"CheckInterval defines the check interval."

fn spec.features.cspm.withEnabled

withEnabled(enabled)

"Enabled enables Cloud Security Posture Management.\nDefault: false"

obj spec.features.cspm.customBenchmarks

"CustomBenchmarks contains CSPM benchmarks.\nThe content of the ConfigMap will be merged with the benchmarks bundled with the agent.\nAny benchmarks with the same name as those existing in the agent will take precedence."

fn spec.features.cspm.customBenchmarks.withConfigData

withConfigData(configData)

"ConfigData corresponds to the configuration file content."

obj spec.features.cspm.customBenchmarks.configMap

"ConfigMap references an existing ConfigMap with the configuration file content."

fn spec.features.cspm.customBenchmarks.configMap.withItems

withItems(items)

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.cspm.customBenchmarks.configMap.withItemsMixin

withItemsMixin(items)

"Items maps a ConfigMap data key to a file path mount."

Note: This function appends passed data to existing values

fn spec.features.cspm.customBenchmarks.configMap.withName

withName(name)

"Name is the name of the ConfigMap."

obj spec.features.cspm.customBenchmarks.configMap.items

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.cspm.customBenchmarks.configMap.items.withKey

withKey(key)

"key is the key to project."

fn spec.features.cspm.customBenchmarks.configMap.items.withMode

withMode(mode)

"mode is Optional: mode bits used to set permissions on this file.\nMust be an octal value between 0000 and 0777 or a decimal value between 0 and 511.\nYAML accepts both octal and decimal values, JSON requires decimal values for mode bits.\nIf not specified, the volume defaultMode will be used.\nThis might be in conflict with other options that affect the file\nmode, like fsGroup, and the result can be other mode bits set."

fn spec.features.cspm.customBenchmarks.configMap.items.withPath

withPath(path)

"path is the relative path of the file to map the key to.\nMay not be an absolute path.\nMay not contain the path element '..'.\nMay not start with the string '..'."

obj spec.features.cspm.hostBenchmarks

"HostBenchmarks contains configuration for host benchmarks."

fn spec.features.cspm.hostBenchmarks.withEnabled

withEnabled(enabled)

"Enabled enables host benchmarks.\nDefault: true"

obj spec.features.cws

"CWS (Cloud Workload Security) configuration."

fn spec.features.cws.withDirectSendFromSystemProbe

withDirectSendFromSystemProbe(directSendFromSystemProbe)

"DirectSendFromSystemProbe configures CWS to send payloads directly from the system-probe, without using the security-agent.\nThis is an experimental feature. Contact support before using.\nDefault: false"

fn spec.features.cws.withEnabled

withEnabled(enabled)

"Enabled enables Cloud Workload Security.\nDefault: false"

fn spec.features.cws.withSyscallMonitorEnabled

withSyscallMonitorEnabled(syscallMonitorEnabled)

"SyscallMonitorEnabled enables Syscall Monitoring (recommended for troubleshooting only).\nDefault: false"

obj spec.features.cws.customPolicies

"CustomPolicies contains security policies.\nThe content of the ConfigMap will be merged with the policies bundled with the agent.\nAny policies with the same name as those existing in the agent will take precedence."

fn spec.features.cws.customPolicies.withConfigData

withConfigData(configData)

"ConfigData corresponds to the configuration file content."

obj spec.features.cws.customPolicies.configMap

"ConfigMap references an existing ConfigMap with the configuration file content."

fn spec.features.cws.customPolicies.configMap.withItems

withItems(items)

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.cws.customPolicies.configMap.withItemsMixin

withItemsMixin(items)

"Items maps a ConfigMap data key to a file path mount."

Note: This function appends passed data to existing values

fn spec.features.cws.customPolicies.configMap.withName

withName(name)

"Name is the name of the ConfigMap."

obj spec.features.cws.customPolicies.configMap.items

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.cws.customPolicies.configMap.items.withKey

withKey(key)

"key is the key to project."

fn spec.features.cws.customPolicies.configMap.items.withMode

withMode(mode)

"mode is Optional: mode bits used to set permissions on this file.\nMust be an octal value between 0000 and 0777 or a decimal value between 0 and 511.\nYAML accepts both octal and decimal values, JSON requires decimal values for mode bits.\nIf not specified, the volume defaultMode will be used.\nThis might be in conflict with other options that affect the file\nmode, like fsGroup, and the result can be other mode bits set."

fn spec.features.cws.customPolicies.configMap.items.withPath

withPath(path)

"path is the relative path of the file to map the key to.\nMay not be an absolute path.\nMay not contain the path element '..'.\nMay not start with the string '..'."

obj spec.features.cws.network

fn spec.features.cws.network.withEnabled

withEnabled(enabled)

"Enabled enables Cloud Workload Security Network detections.\nDefault: true"

obj spec.features.cws.remoteConfiguration

fn spec.features.cws.remoteConfiguration.withEnabled

withEnabled(enabled)

"Enabled enables Remote Configuration for Cloud Workload Security.\nDefault: true"

obj spec.features.cws.securityProfiles

fn spec.features.cws.securityProfiles.withEnabled

withEnabled(enabled)

"Enabled enables Security Profiles collection for Cloud Workload Security.\nDefault: true"

obj spec.features.dogstatsd

"Dogstatsd configuration."

fn spec.features.dogstatsd.withNonLocalTraffic

withNonLocalTraffic(nonLocalTraffic)

"NonLocalTraffic enables non-local traffic for Dogstatsd.\nDefault: true"

fn spec.features.dogstatsd.withOriginDetectionEnabled

withOriginDetectionEnabled(originDetectionEnabled)

"OriginDetectionEnabled enables origin detection for container tagging.\nSee also: https://docs.datadoghq.com/developers/dogstatsd/unix_socket/#using-origin-detection-for-container-tagging"

fn spec.features.dogstatsd.withTagCardinality

withTagCardinality(tagCardinality)

"TagCardinality configures tag cardinality for the metrics collected using origin detection (low, orchestrator or high).\nSee also: https://docs.datadoghq.com/getting_started/tagging/assigning_tags/?tab=containerizedenvironments#environment-variables\nCardinality default: low"

obj spec.features.dogstatsd.hostPortConfig

"HostPortConfig contains host port configuration.\nEnabled Default: false\nPort Default: 8125"

fn spec.features.dogstatsd.hostPortConfig.withEnabled

withEnabled(enabled)

"Enabled enables host port configuration"

fn spec.features.dogstatsd.hostPortConfig.withHostPort

withHostPort(hostPort)

"Port takes a port number (0 < x < 65536) to expose on the host. (Most containers do not need this.)\nIf HostNetwork is enabled, this value must match the ContainerPort."

obj spec.features.dogstatsd.mapperProfiles

"Configure the Dogstasd Mapper Profiles.\nCan be passed as raw data or via a json encoded string in a config map.\nSee also: https://docs.datadoghq.com/developers/dogstatsd/dogstatsd_mapper/"

fn spec.features.dogstatsd.mapperProfiles.withConfigData

withConfigData(configData)

"ConfigData corresponds to the configuration file content."

obj spec.features.dogstatsd.mapperProfiles.configMap

"ConfigMap references an existing ConfigMap with the configuration file content."

fn spec.features.dogstatsd.mapperProfiles.configMap.withItems

withItems(items)

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.dogstatsd.mapperProfiles.configMap.withItemsMixin

withItemsMixin(items)

"Items maps a ConfigMap data key to a file path mount."

Note: This function appends passed data to existing values

fn spec.features.dogstatsd.mapperProfiles.configMap.withName

withName(name)

"Name is the name of the ConfigMap."

obj spec.features.dogstatsd.mapperProfiles.configMap.items

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.dogstatsd.mapperProfiles.configMap.items.withKey

withKey(key)

"key is the key to project."

fn spec.features.dogstatsd.mapperProfiles.configMap.items.withMode

withMode(mode)

"mode is Optional: mode bits used to set permissions on this file.\nMust be an octal value between 0000 and 0777 or a decimal value between 0 and 511.\nYAML accepts both octal and decimal values, JSON requires decimal values for mode bits.\nIf not specified, the volume defaultMode will be used.\nThis might be in conflict with other options that affect the file\nmode, like fsGroup, and the result can be other mode bits set."

fn spec.features.dogstatsd.mapperProfiles.configMap.items.withPath

withPath(path)

"path is the relative path of the file to map the key to.\nMay not be an absolute path.\nMay not contain the path element '..'.\nMay not start with the string '..'."

obj spec.features.dogstatsd.unixDomainSocketConfig

"UnixDomainSocketConfig contains socket configuration.\nSee also: https://docs.datadoghq.com/agent/kubernetes/apm/?tab=helm#agent-environment-variables\nEnabled Default: true\nPath Default: /var/run/datadog/dsd.socket"

fn spec.features.dogstatsd.unixDomainSocketConfig.withEnabled

withEnabled(enabled)

"Enabled enables Unix Domain Socket.\nDefault: true"

fn spec.features.dogstatsd.unixDomainSocketConfig.withPath

withPath(path)

"Path defines the socket path used when enabled."

obj spec.features.ebpfCheck

"EBPFCheck configuration."

fn spec.features.ebpfCheck.withEnabled

withEnabled(enabled)

"Enables the eBPF check.\nDefault: false"

obj spec.features.eventCollection

"EventCollection configuration."

fn spec.features.eventCollection.withCollectKubernetesEvents

withCollectKubernetesEvents(collectKubernetesEvents)

"CollectKubernetesEvents enables Kubernetes event collection.\nDefault: true"

fn spec.features.eventCollection.withCollectedEventTypes

withCollectedEventTypes(collectedEventTypes)

"CollectedEventTypes defines the list of events to collect when UnbundleEvents is enabled.\nDefault:\n[\n{\"kind\":\"Pod\",\"reasons\":[\"Failed\",\"BackOff\",\"Unhealthy\",\"FailedScheduling\",\"FailedMount\",\"FailedAttachVolume\"]},\n{\"kind\":\"Node\",\"reasons\":[\"TerminatingEvictedPod\",\"NodeNotReady\",\"Rebooted\",\"HostPortConflict\"]},\n{\"kind\":\"CronJob\",\"reasons\":[\"SawCompletedJob\"]}\n]"

fn spec.features.eventCollection.withCollectedEventTypesMixin

withCollectedEventTypesMixin(collectedEventTypes)

"CollectedEventTypes defines the list of events to collect when UnbundleEvents is enabled.\nDefault:\n[\n{\"kind\":\"Pod\",\"reasons\":[\"Failed\",\"BackOff\",\"Unhealthy\",\"FailedScheduling\",\"FailedMount\",\"FailedAttachVolume\"]},\n{\"kind\":\"Node\",\"reasons\":[\"TerminatingEvictedPod\",\"NodeNotReady\",\"Rebooted\",\"HostPortConflict\"]},\n{\"kind\":\"CronJob\",\"reasons\":[\"SawCompletedJob\"]}\n]"

Note: This function appends passed data to existing values

fn spec.features.eventCollection.withUnbundleEvents

withUnbundleEvents(unbundleEvents)

"UnbundleEvents enables collection of Kubernetes events as individual events.\nDefault: false"

obj spec.features.eventCollection.collectedEventTypes

"CollectedEventTypes defines the list of events to collect when UnbundleEvents is enabled.\nDefault:\n[\n{\"kind\":\"Pod\",\"reasons\":[\"Failed\",\"BackOff\",\"Unhealthy\",\"FailedScheduling\",\"FailedMount\",\"FailedAttachVolume\"]},\n{\"kind\":\"Node\",\"reasons\":[\"TerminatingEvictedPod\",\"NodeNotReady\",\"Rebooted\",\"HostPortConflict\"]},\n{\"kind\":\"CronJob\",\"reasons\":[\"SawCompletedJob\"]}\n]"

fn spec.features.eventCollection.collectedEventTypes.withKind

withKind(kind)

"Kind is the kind of event to collect. (ex: Pod, Node, CronJob)"

fn spec.features.eventCollection.collectedEventTypes.withReasons

withReasons(reasons)

"Reasons is a list of event reasons to collect. (ex: Failed, BackOff, Unhealthy)"

fn spec.features.eventCollection.collectedEventTypes.withReasonsMixin

withReasonsMixin(reasons)

"Reasons is a list of event reasons to collect. (ex: Failed, BackOff, Unhealthy)"

Note: This function appends passed data to existing values

obj spec.features.externalMetricsServer

"ExternalMetricsServer configuration."

fn spec.features.externalMetricsServer.withEnabled

withEnabled(enabled)

"Enabled enables the External Metrics Server.\nDefault: false"

fn spec.features.externalMetricsServer.withPort

withPort(port)

"Port specifies the metricsProvider External Metrics Server service port.\nDefault: 8443"

fn spec.features.externalMetricsServer.withRegisterAPIService

withRegisterAPIService(registerAPIService)

"RegisterAPIService registers the External Metrics endpoint as an APIService\nDefault: true"

fn spec.features.externalMetricsServer.withUseDatadogMetrics

withUseDatadogMetrics(useDatadogMetrics)

"UseDatadogMetrics enables usage of the DatadogMetrics CRD (allowing one to scale on arbitrary Datadog metric queries).\nDefault: true"

fn spec.features.externalMetricsServer.withWpaController

withWpaController(wpaController)

"WPAController enables the informer and controller of the Watermark Pod Autoscaler.\nNOTE: The Watermark Pod Autoscaler controller needs to be installed.\nSee also: https://github.com/DataDog/watermarkpodautoscaler.\nDefault: false"

obj spec.features.externalMetricsServer.endpoint

"Override the API endpoint for the External Metrics Server.\nURL Default: \"https://app.datadoghq.com\"."

fn spec.features.externalMetricsServer.endpoint.withUrl

withUrl(url)

"URL defines the endpoint URL."

obj spec.features.externalMetricsServer.endpoint.credentials

"Credentials defines the Datadog credentials used to submit data to/query data from Datadog."

fn spec.features.externalMetricsServer.endpoint.credentials.withApiKey

withApiKey(apiKey)

"APIKey configures your Datadog API key.\nSee also: https://app.datadoghq.com/account/settings#agent/kubernetes"

fn spec.features.externalMetricsServer.endpoint.credentials.withAppKey

withAppKey(appKey)

"AppKey configures your Datadog application key.\nIf you are using features.externalMetricsServer.enabled = true, you must set\na Datadog application key for read access to your metrics."

obj spec.features.externalMetricsServer.endpoint.credentials.apiSecret

"APISecret references an existing Secret which stores the API key instead of creating a new one.\nIf set, this parameter takes precedence over \"APIKey\"."

fn spec.features.externalMetricsServer.endpoint.credentials.apiSecret.withKeyName

withKeyName(keyName)

"KeyName is the key of the secret to use."

fn spec.features.externalMetricsServer.endpoint.credentials.apiSecret.withSecretName

withSecretName(secretName)

"SecretName is the name of the secret."

obj spec.features.externalMetricsServer.endpoint.credentials.appSecret

"AppSecret references an existing Secret which stores the application key instead of creating a new one.\nIf set, this parameter takes precedence over \"AppKey\"."

fn spec.features.externalMetricsServer.endpoint.credentials.appSecret.withKeyName

withKeyName(keyName)

"KeyName is the key of the secret to use."

fn spec.features.externalMetricsServer.endpoint.credentials.appSecret.withSecretName

withSecretName(secretName)

"SecretName is the name of the secret."

obj spec.features.gpu

"GPU monitoring"

fn spec.features.gpu.withEnabled

withEnabled(enabled)

"Enabled enables GPU monitoring core check.\nDefault: false"

fn spec.features.gpu.withPatchCgroupPermissions

withPatchCgroupPermissions(patchCgroupPermissions)

"PatchCgroupPermissions enables the patch of cgroup permissions for GPU monitoring, in case\nthe container runtime is not properly configured and the Agent containers lose access to GPU devices.\nDefault: false"

fn spec.features.gpu.withPrivilegedMode

withPrivilegedMode(privilegedMode)

"PrivilegedMode enables GPU Probe module in System Probe.\nDefault: false"

fn spec.features.gpu.withRequiredRuntimeClassName

withRequiredRuntimeClassName(requiredRuntimeClassName)

"PodRuntimeClassName specifies the runtime class name required for the GPU monitoring feature.\nIf the value is an empty string, the runtime class is not set.\nDefault: nvidia"

obj spec.features.helmCheck

"HelmCheck configuration."

fn spec.features.helmCheck.withCollectEvents

withCollectEvents(collectEvents)

"CollectEvents set to true enables event collection in the Helm check\n(Requires Agent 7.36.0+ and Cluster Agent 1.20.0+)\nDefault: false"

fn spec.features.helmCheck.withEnabled

withEnabled(enabled)

"Enabled enables the Helm check.\nDefault: false"

fn spec.features.helmCheck.withValuesAsTags

withValuesAsTags(valuesAsTags)

"ValuesAsTags collects Helm values from a release and uses them as tags\n(Requires Agent and Cluster Agent 7.40.0+).\nDefault: {}"

fn spec.features.helmCheck.withValuesAsTagsMixin

withValuesAsTagsMixin(valuesAsTags)

"ValuesAsTags collects Helm values from a release and uses them as tags\n(Requires Agent and Cluster Agent 7.40.0+).\nDefault: {}"

Note: This function appends passed data to existing values

obj spec.features.kubeStateMetricsCore

"KubeStateMetricsCore check configuration."

fn spec.features.kubeStateMetricsCore.withEnabled

withEnabled(enabled)

"Enabled enables Kube State Metrics Core.\nDefault: true"

obj spec.features.kubeStateMetricsCore.conf

"Conf overrides the configuration for the default Kubernetes State Metrics Core check.\nThis must point to a ConfigMap containing a valid cluster check configuration."

fn spec.features.kubeStateMetricsCore.conf.withConfigData

withConfigData(configData)

"ConfigData corresponds to the configuration file content."

obj spec.features.kubeStateMetricsCore.conf.configMap

"ConfigMap references an existing ConfigMap with the configuration file content."

fn spec.features.kubeStateMetricsCore.conf.configMap.withItems

withItems(items)

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.kubeStateMetricsCore.conf.configMap.withItemsMixin

withItemsMixin(items)

"Items maps a ConfigMap data key to a file path mount."

Note: This function appends passed data to existing values

fn spec.features.kubeStateMetricsCore.conf.configMap.withName

withName(name)

"Name is the name of the ConfigMap."

obj spec.features.kubeStateMetricsCore.conf.configMap.items

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.kubeStateMetricsCore.conf.configMap.items.withKey

withKey(key)

"key is the key to project."

fn spec.features.kubeStateMetricsCore.conf.configMap.items.withMode

withMode(mode)

"mode is Optional: mode bits used to set permissions on this file.\nMust be an octal value between 0000 and 0777 or a decimal value between 0 and 511.\nYAML accepts both octal and decimal values, JSON requires decimal values for mode bits.\nIf not specified, the volume defaultMode will be used.\nThis might be in conflict with other options that affect the file\nmode, like fsGroup, and the result can be other mode bits set."

fn spec.features.kubeStateMetricsCore.conf.configMap.items.withPath

withPath(path)

"path is the relative path of the file to map the key to.\nMay not be an absolute path.\nMay not contain the path element '..'.\nMay not start with the string '..'."

obj spec.features.liveContainerCollection

"LiveContainerCollection configuration."

fn spec.features.liveContainerCollection.withEnabled

withEnabled(enabled)

"Enables container collection for the Live Container View.\nDefault: true"

obj spec.features.liveProcessCollection

"LiveProcessCollection configuration."

fn spec.features.liveProcessCollection.withEnabled

withEnabled(enabled)

"Enabled enables Process monitoring.\nDefault: false"

fn spec.features.liveProcessCollection.withScrubProcessArguments

withScrubProcessArguments(scrubProcessArguments)

"ScrubProcessArguments enables scrubbing of sensitive data in process command-lines (passwords, tokens, etc. ).\nDefault: true"

fn spec.features.liveProcessCollection.withStripProcessArguments

withStripProcessArguments(stripProcessArguments)

"StripProcessArguments enables stripping of all process arguments.\nDefault: false"

obj spec.features.logCollection

"LogCollection configuration."

fn spec.features.logCollection.withAutoMultiLineDetection

withAutoMultiLineDetection(autoMultiLineDetection)

"AutoMultiLineDetection allows the Agent to detect and aggregate common multi-line logs automatically.\nSee also: https://docs.datadoghq.com/agent/logs/auto_multiline_detection/"

fn spec.features.logCollection.withContainerCollectAll

withContainerCollectAll(containerCollectAll)

"ContainerCollectAll enables Log collection from all containers.\nDefault: false"

fn spec.features.logCollection.withContainerCollectUsingFiles

withContainerCollectUsingFiles(containerCollectUsingFiles)

"ContainerCollectUsingFiles enables log collection from files in /var/log/pods instead of using the container runtime API.\nCollecting logs from files is usually the most efficient way of collecting logs.\nSee also: https://docs.datadoghq.com/agent/basic_agent_usage/kubernetes/#log-collection-setup\nDefault: true"

fn spec.features.logCollection.withContainerLogsPath

withContainerLogsPath(containerLogsPath)

"ContainerLogsPath allows log collection from the container log path.\nSet to a different path if you are not using the Docker runtime.\nSee also: https://docs.datadoghq.com/agent/kubernetes/daemonset_setup/?tab=k8sfile#create-manifest\nDefault: /var/lib/docker/containers"

fn spec.features.logCollection.withContainerSymlinksPath

withContainerSymlinksPath(containerSymlinksPath)

"ContainerSymlinksPath allows log collection to use symbolic links in this directory to validate container ID -> pod.\nDefault: /var/log/containers"

fn spec.features.logCollection.withEnabled

withEnabled(enabled)

"Enabled enables Log collection.\nDefault: false"

fn spec.features.logCollection.withOpenFilesLimit

withOpenFilesLimit(openFilesLimit)

"OpenFilesLimit sets the maximum number of log files that the Datadog Agent tails.\nIncreasing this limit can increase resource consumption of the Agent.\nSee also: https://docs.datadoghq.com/agent/basic_agent_usage/kubernetes/#log-collection-setup\nDefault: 100"

fn spec.features.logCollection.withPodLogsPath

withPodLogsPath(podLogsPath)

"PodLogsPath allows log collection from a pod log path.\nDefault: /var/log/pods"

fn spec.features.logCollection.withTempStoragePath

withTempStoragePath(tempStoragePath)

"TempStoragePath (always mounted from the host) is used by the Agent to store information about processed log files.\nIf the Agent is restarted, it starts tailing the log files immediately.\nDefault: /var/lib/datadog-agent/logs"

obj spec.features.npm

"NPM (Network Performance Monitoring) configuration."

fn spec.features.npm.withCollectDNSStats

withCollectDNSStats(collectDNSStats)

"CollectDNSStats enables DNS stat collection.\nDefault: false"

fn spec.features.npm.withEnableConntrack

withEnableConntrack(enableConntrack)

"EnableConntrack enables the system-probe agent to connect to the netlink/conntrack subsystem to add NAT information to connection data.\nSee also: http://conntrack-tools.netfilter.org/\nDefault: false"

fn spec.features.npm.withEnabled

withEnabled(enabled)

"Enabled enables Network Performance Monitoring.\nDefault: false"

obj spec.features.oomKill

"OOMKill configuration."

fn spec.features.oomKill.withEnabled

withEnabled(enabled)

"Enables the OOMKill eBPF-based check.\nDefault: false"

obj spec.features.orchestratorExplorer

"OrchestratorExplorer check configuration."

fn spec.features.orchestratorExplorer.withCustomResources

withCustomResources(customResources)

"CustomResources defines custom resources for the orchestrator explorer to collect.\nEach item should follow the convention group/version/kind. For example, datadoghq.com/v1alpha1/datadogmetrics."

fn spec.features.orchestratorExplorer.withCustomResourcesMixin

withCustomResourcesMixin(customResources)

"CustomResources defines custom resources for the orchestrator explorer to collect.\nEach item should follow the convention group/version/kind. For example, datadoghq.com/v1alpha1/datadogmetrics."

Note: This function appends passed data to existing values

fn spec.features.orchestratorExplorer.withDdUrl

withDdUrl(ddUrl)

"Override the API endpoint for the Orchestrator Explorer.\nURL Default: \"https://orchestrator.datadoghq.com\"."

fn spec.features.orchestratorExplorer.withEnabled

withEnabled(enabled)

"Enabled enables the Orchestrator Explorer.\nDefault: true"

fn spec.features.orchestratorExplorer.withExtraTags

withExtraTags(extraTags)

"Additional tags to associate with the collected data in the form of a b c.\nThis is a Cluster Agent option distinct from DD_TAGS that is used in the Orchestrator Explorer."

fn spec.features.orchestratorExplorer.withExtraTagsMixin

withExtraTagsMixin(extraTags)

"Additional tags to associate with the collected data in the form of a b c.\nThis is a Cluster Agent option distinct from DD_TAGS that is used in the Orchestrator Explorer."

Note: This function appends passed data to existing values

fn spec.features.orchestratorExplorer.withScrubContainers

withScrubContainers(scrubContainers)

"ScrubContainers enables scrubbing of sensitive container data (passwords, tokens, etc. ).\nDefault: true"

obj spec.features.orchestratorExplorer.conf

"Conf overrides the configuration for the default Orchestrator Explorer check.\nThis must point to a ConfigMap containing a valid cluster check configuration."

fn spec.features.orchestratorExplorer.conf.withConfigData

withConfigData(configData)

"ConfigData corresponds to the configuration file content."

obj spec.features.orchestratorExplorer.conf.configMap

"ConfigMap references an existing ConfigMap with the configuration file content."

fn spec.features.orchestratorExplorer.conf.configMap.withItems

withItems(items)

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.orchestratorExplorer.conf.configMap.withItemsMixin

withItemsMixin(items)

"Items maps a ConfigMap data key to a file path mount."

Note: This function appends passed data to existing values

fn spec.features.orchestratorExplorer.conf.configMap.withName

withName(name)

"Name is the name of the ConfigMap."

obj spec.features.orchestratorExplorer.conf.configMap.items

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.orchestratorExplorer.conf.configMap.items.withKey

withKey(key)

"key is the key to project."

fn spec.features.orchestratorExplorer.conf.configMap.items.withMode

withMode(mode)

"mode is Optional: mode bits used to set permissions on this file.\nMust be an octal value between 0000 and 0777 or a decimal value between 0 and 511.\nYAML accepts both octal and decimal values, JSON requires decimal values for mode bits.\nIf not specified, the volume defaultMode will be used.\nThis might be in conflict with other options that affect the file\nmode, like fsGroup, and the result can be other mode bits set."

fn spec.features.orchestratorExplorer.conf.configMap.items.withPath

withPath(path)

"path is the relative path of the file to map the key to.\nMay not be an absolute path.\nMay not contain the path element '..'.\nMay not start with the string '..'."

obj spec.features.otelCollector

"OtelCollector configuration."

fn spec.features.otelCollector.withEnabled

withEnabled(enabled)

"Enabled enables the OTel Agent.\nDefault: false"

fn spec.features.otelCollector.withPorts

withPorts(ports)

"Ports contains the ports for the otel-agent.\nDefaults: otel-grpc:4317 / otel-http:4318. Note: setting 4317\nor 4318 manually is only supported if name match default names (otel-grpc, otel-http).\nIf not, this will lead to a port conflict.\nThis limitation will be lifted once annotations support is removed."

fn spec.features.otelCollector.withPortsMixin

withPortsMixin(ports)

"Ports contains the ports for the otel-agent.\nDefaults: otel-grpc:4317 / otel-http:4318. Note: setting 4317\nor 4318 manually is only supported if name match default names (otel-grpc, otel-http).\nIf not, this will lead to a port conflict.\nThis limitation will be lifted once annotations support is removed."

Note: This function appends passed data to existing values

obj spec.features.otelCollector.conf

"Conf overrides the configuration for the default Kubernetes State Metrics Core check.\nThis must point to a ConfigMap containing a valid cluster check configuration.\nWhen passing a configmap, file name must be otel-config.yaml."

fn spec.features.otelCollector.conf.withConfigData

withConfigData(configData)

"ConfigData corresponds to the configuration file content."

obj spec.features.otelCollector.conf.configMap

"ConfigMap references an existing ConfigMap with the configuration file content."

fn spec.features.otelCollector.conf.configMap.withItems

withItems(items)

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.otelCollector.conf.configMap.withItemsMixin

withItemsMixin(items)

"Items maps a ConfigMap data key to a file path mount."

Note: This function appends passed data to existing values

fn spec.features.otelCollector.conf.configMap.withName

withName(name)

"Name is the name of the ConfigMap."

obj spec.features.otelCollector.conf.configMap.items

"Items maps a ConfigMap data key to a file path mount."

fn spec.features.otelCollector.conf.configMap.items.withKey

withKey(key)

"key is the key to project."

fn spec.features.otelCollector.conf.configMap.items.withMode

withMode(mode)

"mode is Optional: mode bits used to set permissions on this file.\nMust be an octal value between 0000 and 0777 or a decimal value between 0 and 511.\nYAML accepts both octal and decimal values, JSON requires decimal values for mode bits.\nIf not specified, the volume defaultMode will be used.\nThis might be in conflict with other options that affect the file\nmode, like fsGroup, and the result can be other mode bits set."

fn spec.features.otelCollector.conf.configMap.items.withPath

withPath(path)

"path is the relative path of the file to map the key to.\nMay not be an absolute path.\nMay not contain the path element '..'.\nMay not start with the string '..'."

obj spec.features.otelCollector.coreConfig

"OTelCollector Config Relevant to the Core agent"

fn spec.features.otelCollector.coreConfig.withEnabled

withEnabled(enabled)

"Enabled marks otelcollector as enabled in core agent."

fn spec.features.otelCollector.coreConfig.withExtensionTimeout

withExtensionTimeout(extensionTimeout)

"Extension URL provides the timout of the ddflareextension to\nthe core agent."

fn spec.features.otelCollector.coreConfig.withExtensionURL

withExtensionURL(extensionURL)

"Extension URL provides the URL of the ddflareextension to\nthe core agent."

obj spec.features.otelCollector.ports

"Ports contains the ports for the otel-agent.\nDefaults: otel-grpc:4317 / otel-http:4318. Note: setting 4317\nor 4318 manually is only supported if name match default names (otel-grpc, otel-http).\nIf not, this will lead to a port conflict.\nThis limitation will be lifted once annotations support is removed."

fn spec.features.otelCollector.ports.withContainerPort

withContainerPort(containerPort)

"Number of port to expose on the pod's IP address.\nThis must be a valid port number, 0 < x < 65536."

fn spec.features.otelCollector.ports.withHostIP

withHostIP(hostIP)

"What host IP to bind the external port to."

fn spec.features.otelCollector.ports.withHostPort

withHostPort(hostPort)

"Number of port to expose on the host.\nIf specified, this must be a valid port number, 0 < x < 65536.\nIf HostNetwork is specified, this must match ContainerPort.\nMost containers do not need this."

fn spec.features.otelCollector.ports.withName

withName(name)

"If specified, this must be an IANA_SVC_NAME and unique within the pod. Each\nnamed port in a pod must have a unique name. Name for the port that can be\nreferred to by services."

fn spec.features.otelCollector.ports.withProtocol

withProtocol(protocol)

"Protocol for port. Must be UDP, TCP, or SCTP.\nDefaults to \"TCP\"."

obj spec.features.otlp

"OTLP ingest configuration"

obj spec.features.otlp.receiver

"Receiver contains configuration for the OTLP ingest receiver."

obj spec.features.otlp.receiver.protocols

"Protocols contains configuration for the OTLP ingest receiver protocols."

obj spec.features.otlp.receiver.protocols.grpc

"GRPC contains configuration for the OTLP ingest OTLP/gRPC receiver."

fn spec.features.otlp.receiver.protocols.grpc.withEnabled

withEnabled(enabled)

"Enable the OTLP/gRPC endpoint. Host port is enabled by default and can be disabled."

fn spec.features.otlp.receiver.protocols.grpc.withEndpoint

withEndpoint(endpoint)

"Endpoint for OTLP/gRPC.\ngRPC supports several naming schemes: https://github.com/grpc/grpc/blob/master/doc/naming.md\nThe Datadog Operator supports only 'host:port' (usually 0.0.0.0:port).\nDefault: 0.0.0.0:4317."

obj spec.features.otlp.receiver.protocols.grpc.hostPortConfig

"Enable hostPort for OTLP/gRPC\nDefault: true"

fn spec.features.otlp.receiver.protocols.grpc.hostPortConfig.withEnabled

withEnabled(enabled)

"Enabled enables host port configuration"

fn spec.features.otlp.receiver.protocols.grpc.hostPortConfig.withHostPort

withHostPort(hostPort)

"Port takes a port number (0 < x < 65536) to expose on the host. (Most containers do not need this.)\nIf HostNetwork is enabled, this value must match the ContainerPort."

obj spec.features.otlp.receiver.protocols.http

"HTTP contains configuration for the OTLP ingest OTLP/HTTP receiver."

fn spec.features.otlp.receiver.protocols.http.withEnabled

withEnabled(enabled)

"Enable the OTLP/HTTP endpoint. Host port is enabled by default and can be disabled."

fn spec.features.otlp.receiver.protocols.http.withEndpoint

withEndpoint(endpoint)

"Endpoint for OTLP/HTTP.\nDefault: '0.0.0.0:4318'."

obj spec.features.otlp.receiver.protocols.http.hostPortConfig

"Enable hostPorts for OTLP/HTTP\nDefault: true"

fn spec.features.otlp.receiver.protocols.http.hostPortConfig.withEnabled

withEnabled(enabled)

"Enabled enables host port configuration"

fn spec.features.otlp.receiver.protocols.http.hostPortConfig.withHostPort

withHostPort(hostPort)

"Port takes a port number (0 < x < 65536) to expose on the host. (Most containers do not need this.)\nIf HostNetwork is enabled, this value must match the ContainerPort."

obj spec.features.processDiscovery

"ProcessDiscovery configuration."

fn spec.features.processDiscovery.withEnabled

withEnabled(enabled)

"Enabled enables the Process Discovery check in the Agent.\nDefault: true"

obj spec.features.prometheusScrape

"PrometheusScrape configuration."

fn spec.features.prometheusScrape.withAdditionalConfigs

withAdditionalConfigs(additionalConfigs)

"AdditionalConfigs allows adding advanced Prometheus check configurations with custom discovery rules."

fn spec.features.prometheusScrape.withEnableServiceEndpoints

withEnableServiceEndpoints(enableServiceEndpoints)

"EnableServiceEndpoints enables generating dedicated checks for service endpoints.\nDefault: false"

fn spec.features.prometheusScrape.withEnabled

withEnabled(enabled)

"Enable autodiscovery of pods and services exposing Prometheus metrics.\nDefault: false"

fn spec.features.prometheusScrape.withVersion

withVersion(version)

"Version specifies the version of the OpenMetrics check.\nDefault: 2"

obj spec.features.remoteConfiguration

"Remote Configuration configuration."

fn spec.features.remoteConfiguration.withEnabled

withEnabled(enabled)

"Enable this option to activate Remote Configuration.\nDefault: true"

obj spec.features.sbom

"SBOM collection configuration."

fn spec.features.sbom.withEnabled

withEnabled(enabled)

"Enable this option to activate SBOM collection.\nDefault: false"

obj spec.features.sbom.containerImage

"SBOMTypeConfig contains configuration for a SBOM collection type."

fn spec.features.sbom.containerImage.withAnalyzers

withAnalyzers(analyzers)

"Analyzers to use for SBOM collection."

fn spec.features.sbom.containerImage.withAnalyzersMixin

withAnalyzersMixin(analyzers)

"Analyzers to use for SBOM collection."

Note: This function appends passed data to existing values

fn spec.features.sbom.containerImage.withEnabled

withEnabled(enabled)

"Enable this option to activate SBOM collection.\nDefault: false"

fn spec.features.sbom.containerImage.withOverlayFSDirectScan

withOverlayFSDirectScan(overlayFSDirectScan)

"Enable this option to enable experimental overlayFS direct scan.\nDefault: false"

fn spec.features.sbom.containerImage.withUncompressedLayersSupport

withUncompressedLayersSupport(uncompressedLayersSupport)

"Enable this option to enable support for uncompressed layers.\nDefault: false"

obj spec.features.sbom.host

"SBOMTypeConfig contains configuration for a SBOM collection type."

fn spec.features.sbom.host.withAnalyzers

withAnalyzers(analyzers)

"Analyzers to use for SBOM collection."

fn spec.features.sbom.host.withAnalyzersMixin

withAnalyzersMixin(analyzers)

"Analyzers to use for SBOM collection."

Note: This function appends passed data to existing values

fn spec.features.sbom.host.withEnabled

withEnabled(enabled)

"Enable this option to activate SBOM collection.\nDefault: false"

obj spec.features.serviceDiscovery

"ServiceDiscovery"

fn spec.features.serviceDiscovery.withEnabled

withEnabled(enabled)

"Enables the service discovery check.\nDefault: false"

obj spec.features.serviceDiscovery.networkStats

"Enables the service discovery network stats collection.\nDefault: true"

fn spec.features.serviceDiscovery.networkStats.withEnabled

withEnabled(enabled)

"Enables the Service Discovery Network Stats feature.\nDefault: true"

obj spec.features.tcpQueueLength

"TCPQueueLength configuration."

fn spec.features.tcpQueueLength.withEnabled

withEnabled(enabled)

"Enables the TCP queue length eBPF-based check.\nDefault: false"

obj spec.features.usm

"USM (Universal Service Monitoring) configuration."

fn spec.features.usm.withEnabled

withEnabled(enabled)

"Enabled enables Universal Service Monitoring.\nDefault: false"

obj spec.global

"Global settings to configure the agents"

fn spec.global.withChecksTagCardinality

withChecksTagCardinality(checksTagCardinality)

"ChecksTagCardinality configures tag cardinality for the metrics collected by integrations (low, orchestrator or high).\nSee also: https://docs.datadoghq.com/getting_started/tagging/assigning_tags/?tab=containerizedenvironments#tags-cardinality.\nNot set by default to avoid overriding existing DD_CHECKS_TAG_CARDINALITY configurations, the default value in the Agent is low.\nRef: https://github.com/DataDog/datadog-agent/blob/856cf4a66142ce91fd4f8a278149436eb971184a/pkg/config/setup/config.go#L625."

fn spec.global.withClusterAgentToken

withClusterAgentToken(clusterAgentToken)

"ClusterAgentToken is the token for communication between the NodeAgent and ClusterAgent."

fn spec.global.withClusterName

withClusterName(clusterName)

"ClusterName sets a unique cluster name for the deployment to easily scope monitoring data in the Datadog app."

fn spec.global.withContainerStrategy

withContainerStrategy(containerStrategy)

"ContainerStrategy determines whether agents run in a single or multiple containers.\nDefault: 'optimized'"

fn spec.global.withCriSocketPath

withCriSocketPath(criSocketPath)

"Path to the container runtime socket (if different from Docker)."

fn spec.global.withDisableNonResourceRules

withDisableNonResourceRules(disableNonResourceRules)

"Set DisableNonResourceRules to exclude NonResourceURLs from default ClusterRoles.\nRequired 'true' for Google Cloud Marketplace."

fn spec.global.withDockerSocketPath

withDockerSocketPath(dockerSocketPath)

"Path to the docker runtime socket."

fn spec.global.withEnv

withEnv(env)

"Env contains a list of environment variables that are set for all Agents."

fn spec.global.withEnvMixin

withEnvMixin(env)

"Env contains a list of environment variables that are set for all Agents."

Note: This function appends passed data to existing values

fn spec.global.withKubernetesResourcesAnnotationsAsTags

withKubernetesResourcesAnnotationsAsTags(kubernetesResourcesAnnotationsAsTags)

"Provide a mapping of Kubernetes Resource Groups to annotations mapping to Datadog Tags.\n:\n\t\t: \nKUBERNETES_RESOURCE_GROUP should be in the form {resource}.{group} or {resource} (example: deployments.apps, pods)"

fn spec.global.withKubernetesResourcesAnnotationsAsTagsMixin

withKubernetesResourcesAnnotationsAsTagsMixin(kubernetesResourcesAnnotationsAsTags)

"Provide a mapping of Kubernetes Resource Groups to annotations mapping to Datadog Tags.\n:\n\t\t: \nKUBERNETES_RESOURCE_GROUP should be in the form {resource}.{group} or {resource} (example: deployments.apps, pods)"

Note: This function appends passed data to existing values

fn spec.global.withKubernetesResourcesLabelsAsTags

withKubernetesResourcesLabelsAsTags(kubernetesResourcesLabelsAsTags)

"Provide a mapping of Kubernetes Resource Groups to labels mapping to Datadog Tags.\n:\n\t\t: \nKUBERNETES_RESOURCE_GROUP should be in the form {resource}.{group} or {resource} (example: deployments.apps, pods)"

fn spec.global.withKubernetesResourcesLabelsAsTagsMixin

withKubernetesResourcesLabelsAsTagsMixin(kubernetesResourcesLabelsAsTags)

"Provide a mapping of Kubernetes Resource Groups to labels mapping to Datadog Tags.\n:\n\t\t: \nKUBERNETES_RESOURCE_GROUP should be in the form {resource}.{group} or {resource} (example: deployments.apps, pods)"

Note: This function appends passed data to existing values

fn spec.global.withLogLevel

withLogLevel(logLevel)

"LogLevel sets logging verbosity. This can be overridden by container.\nValid log levels are: trace, debug, info, warn, error, critical, and off.\nDefault: 'info'"

fn spec.global.withNamespaceAnnotationsAsTags

withNamespaceAnnotationsAsTags(namespaceAnnotationsAsTags)

"Provide a mapping of Kubernetes Namespace Annotations to Datadog Tags.\n: "

fn spec.global.withNamespaceAnnotationsAsTagsMixin

withNamespaceAnnotationsAsTagsMixin(namespaceAnnotationsAsTags)

"Provide a mapping of Kubernetes Namespace Annotations to Datadog Tags.\n: "

Note: This function appends passed data to existing values

fn spec.global.withNamespaceLabelsAsTags

withNamespaceLabelsAsTags(namespaceLabelsAsTags)

"Provide a mapping of Kubernetes Namespace Labels to Datadog Tags.\n: "

fn spec.global.withNamespaceLabelsAsTagsMixin

withNamespaceLabelsAsTagsMixin(namespaceLabelsAsTags)

"Provide a mapping of Kubernetes Namespace Labels to Datadog Tags.\n: "

Note: This function appends passed data to existing values

fn spec.global.withNodeLabelsAsTags

withNodeLabelsAsTags(nodeLabelsAsTags)

"Provide a mapping of Kubernetes Node Labels to Datadog Tags.\n: "

fn spec.global.withNodeLabelsAsTagsMixin

withNodeLabelsAsTagsMixin(nodeLabelsAsTags)

"Provide a mapping of Kubernetes Node Labels to Datadog Tags.\n: "

Note: This function appends passed data to existing values

fn spec.global.withPodAnnotationsAsTags

withPodAnnotationsAsTags(podAnnotationsAsTags)

"Provide a mapping of Kubernetes Annotations to Datadog Tags.\n: "

fn spec.global.withPodAnnotationsAsTagsMixin

withPodAnnotationsAsTagsMixin(podAnnotationsAsTags)

"Provide a mapping of Kubernetes Annotations to Datadog Tags.\n: "

Note: This function appends passed data to existing values

fn spec.global.withPodLabelsAsTags

withPodLabelsAsTags(podLabelsAsTags)

"Provide a mapping of Kubernetes Labels to Datadog Tags.\n: "

fn spec.global.withPodLabelsAsTagsMixin

withPodLabelsAsTagsMixin(podLabelsAsTags)

"Provide a mapping of Kubernetes Labels to Datadog Tags.\n: "

Note: This function appends passed data to existing values

fn spec.global.withRegistry

withRegistry(registry)

"Registry is the image registry to use for all Agent images.\nUse 'public.ecr.aws/datadog' for AWS ECR.\nUse 'datadoghq.azurecr.io' for Azure Container Registry.\nUse 'gcr.io/datadoghq' for Google Container Registry.\nUse 'eu.gcr.io/datadoghq' for Google Container Registry in the EU region.\nUse 'asia.gcr.io/datadoghq' for Google Container Registry in the Asia region.\nUse 'docker.io/datadog' for DockerHub.\nDefault: 'gcr.io/datadoghq'"

fn spec.global.withRunProcessChecksInCoreAgent

withRunProcessChecksInCoreAgent(runProcessChecksInCoreAgent)

"Configure whether the Process Agent or core Agent collects process and/or container information (Linux only).\nIf no other checks are running, the Process Agent container will not initialize.\n(Requires Agent 7.60.0+)\nDefault: 'true'\nDeprecated: Functionality now handled automatically. Use env var DD_PROCESS_CONFIG_RUN_IN_CORE_AGENT_ENABLED to override."

fn spec.global.withSite

withSite(site)

"Site is the Datadog intake site Agent data are sent to.\nSet to 'datadoghq.com' to send data to the US1 site (default).\nSet to 'datadoghq.eu' to send data to the EU site.\nSet to 'us3.datadoghq.com' to send data to the US3 site.\nSet to 'us5.datadoghq.com' to send data to the US5 site.\nSet to 'ddog-gov.com' to send data to the US1-FED site.\nSet to 'ap1.datadoghq.com' to send data to the AP1 site.\nDefault: 'datadoghq.com'"

fn spec.global.withTags

withTags(tags)

"Tags contains a list of tags to attach to every metric, event and service check collected.\nLearn more about tagging: https://docs.datadoghq.com/tagging/"

fn spec.global.withTagsMixin

withTagsMixin(tags)

"Tags contains a list of tags to attach to every metric, event and service check collected.\nLearn more about tagging: https://docs.datadoghq.com/tagging/"

Note: This function appends passed data to existing values

fn spec.global.withUseFIPSAgent

withUseFIPSAgent(useFIPSAgent)

"UseFIPSAgent enables the FIPS flavor of the Agent. If 'true', the FIPS proxy will always be disabled.\nDefault: 'false'"

obj spec.global.clusterAgentTokenSecret

"ClusterAgentTokenSecret is the secret containing the Cluster Agent token."

fn spec.global.clusterAgentTokenSecret.withKeyName

withKeyName(keyName)

"KeyName is the key of the secret to use."

fn spec.global.clusterAgentTokenSecret.withSecretName

withSecretName(secretName)

"SecretName is the name of the secret."

obj spec.global.credentials

"Credentials defines the Datadog credentials used to submit data to/query data from Datadog."

fn spec.global.credentials.withApiKey

withApiKey(apiKey)

"APIKey configures your Datadog API key.\nSee also: https://app.datadoghq.com/account/settings#agent/kubernetes"

fn spec.global.credentials.withAppKey

withAppKey(appKey)

"AppKey configures your Datadog application key.\nIf you are using features.externalMetricsServer.enabled = true, you must set\na Datadog application key for read access to your metrics."

obj spec.global.credentials.apiSecret

"APISecret references an existing Secret which stores the API key instead of creating a new one.\nIf set, this parameter takes precedence over \"APIKey\"."

fn spec.global.credentials.apiSecret.withKeyName

withKeyName(keyName)

"KeyName is the key of the secret to use."

fn spec.global.credentials.apiSecret.withSecretName

withSecretName(secretName)

"SecretName is the name of the secret."

obj spec.global.credentials.appSecret

"AppSecret references an existing Secret which stores the application key instead of creating a new one.\nIf set, this parameter takes precedence over \"AppKey\"."

fn spec.global.credentials.appSecret.withKeyName

withKeyName(keyName)

"KeyName is the key of the secret to use."

fn spec.global.credentials.appSecret.withSecretName

withSecretName(secretName)

"SecretName is the name of the secret."

obj spec.global.csi

"CSI contains configuration for Datadog CSI Driver"

fn spec.global.csi.withEnabled

withEnabled(enabled)

"Enables the usage of CSI driver in Datadog Agent.\nRequires installation of Datadog CSI Driver https://github.com/DataDog/helm-charts/tree/main/charts/datadog-csi-driver\nDefault: false"

obj spec.global.endpoint

"Endpoint is the Datadog intake URL the Agent data are sent to.\nOnly set this option if you need the Agent to send data to a custom URL.\nOverrides the site setting defined in Site."

fn spec.global.endpoint.withUrl

withUrl(url)

"URL defines the endpoint URL."

obj spec.global.endpoint.credentials

"Credentials defines the Datadog credentials used to submit data to/query data from Datadog."

fn spec.global.endpoint.credentials.withApiKey

withApiKey(apiKey)

"APIKey configures your Datadog API key.\nSee also: https://app.datadoghq.com/account/settings#agent/kubernetes"

fn spec.global.endpoint.credentials.withAppKey

withAppKey(appKey)

"AppKey configures your Datadog application key.\nIf you are using features.externalMetricsServer.enabled = true, you must set\na Datadog application key for read access to your metrics."

obj spec.global.endpoint.credentials.apiSecret

"APISecret references an existing Secret which stores the API key instead of creating a new one.\nIf set, this parameter takes precedence over \"APIKey\"."

fn spec.global.endpoint.credentials.apiSecret.withKeyName

withKeyName(keyName)

"KeyName is the key of the secret to use."

fn spec.global.endpoint.credentials.apiSecret.withSecretName

withSecretName(secretName)

"SecretName is the name of the secret."

obj spec.global.endpoint.credentials.appSecret

"AppSecret references an existing Secret which stores the application key instead of creating a new one.\nIf set, this parameter takes precedence over \"AppKey\"."

fn spec.global.endpoint.credentials.appSecret.withKeyName

withKeyName(keyName)

"KeyName is the key of the secret to use."

fn spec.global.endpoint.credentials.appSecret.withSecretName

withSecretName(secretName)

"SecretName is the name of the secret."

obj spec.global.env

"Env contains a list of environment variables that are set for all Agents."

fn spec.global.env.withName

withName(name)

"Name of the environment variable. Must be a C_IDENTIFIER."

fn spec.global.env.withValue

withValue(value)

"Variable references $(VAR_NAME) are expanded\nusing the previously defined environment variables in the container and\nany service environment variables. If a variable cannot be resolved,\nthe reference in the input string will be unchanged. Double $$ are reduced\nto a single $, which allows for escaping the $(VAR_NAME) syntax: i.e.\n\"$$(VAR_NAME)\" will produce the string literal \"$(VAR_NAME)\".\nEscaped references will never be expanded, regardless of whether the variable\nexists or not.\nDefaults to \"\"."

obj spec.global.env.valueFrom

"Source for the environment variable's value. Cannot be used if value is not empty."

obj spec.global.env.valueFrom.configMapKeyRef

"Selects a key of a ConfigMap."

fn spec.global.env.valueFrom.configMapKeyRef.withKey

withKey(key)

"The key to select."

fn spec.global.env.valueFrom.configMapKeyRef.withName

withName(name)

"Name of the referent.\nThis field is effectively required, but due to backwards compatibility is\nallowed to be empty. Instances of this type with an empty value here are\nalmost certainly wrong.\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"

fn spec.global.env.valueFrom.configMapKeyRef.withOptional

withOptional(optional)

"Specify whether the ConfigMap or its key must be defined"

obj spec.global.env.valueFrom.fieldRef

"Selects a field of the pod: supports metadata.name, metadata.namespace, metadata.labels['<KEY>'], metadata.annotations['<KEY>'],\nspec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs."

fn spec.global.env.valueFrom.fieldRef.withApiVersion

withApiVersion(apiVersion)

"Version of the schema the FieldPath is written in terms of, defaults to \"v1\"."

fn spec.global.env.valueFrom.fieldRef.withFieldPath

withFieldPath(fieldPath)

"Path of the field to select in the specified API version."

obj spec.global.env.valueFrom.resourceFieldRef

"Selects a resource of the container: only resources limits and requests\n(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage) are currently supported."

fn spec.global.env.valueFrom.resourceFieldRef.withContainerName

withContainerName(containerName)

"Container name: required for volumes, optional for env vars"

fn spec.global.env.valueFrom.resourceFieldRef.withDivisor

withDivisor(divisor)

"Specifies the output format of the exposed resources, defaults to \"1\

fn spec.global.env.valueFrom.resourceFieldRef.withResource

withResource(resource)

"Required: resource to select"

obj spec.global.env.valueFrom.secretKeyRef

"Selects a key of a secret in the pod's namespace"

fn spec.global.env.valueFrom.secretKeyRef.withKey

withKey(key)

"The key of the secret to select from. Must be a valid secret key."

fn spec.global.env.valueFrom.secretKeyRef.withName

withName(name)

"Name of the referent.\nThis field is effectively required, but due to backwards compatibility is\nallowed to be empty. Instances of this type with an empty value here are\nalmost certainly wrong.\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"

fn spec.global.env.valueFrom.secretKeyRef.withOptional

withOptional(optional)

"Specify whether the Secret or its key must be defined"

obj spec.global.fips

"FIPS contains configuration used to customize the FIPS proxy sidecar."

fn spec.global.fips.withEnabled

withEnabled(enabled)

"Enable FIPS sidecar."

fn spec.global.fips.withLocalAddress

withLocalAddress(localAddress)

"Set the local IP address.\nDefault: 127.0.0.1"

fn spec.global.fips.withPort

withPort(port)

"Port specifies which port is used by the containers to communicate to the FIPS sidecar.\nDefault: 9803"

fn spec.global.fips.withPortRange

withPortRange(portRange)

"PortRange specifies the number of ports used.\nDefault: 15"

fn spec.global.fips.withUseHTTPS

withUseHTTPS(useHTTPS)

"UseHTTPS enables HTTPS.\nDefault: false"

obj spec.global.fips.customFIPSConfig

"CustomFIPSConfig configures a custom configMap to provide the FIPS configuration.\nSpecify custom contents for the FIPS proxy sidecar container config\n(/etc/datadog-fips-proxy/datadog-fips-proxy.cfg). If empty, the default FIPS\nproxy sidecar container config is used."

fn spec.global.fips.customFIPSConfig.withConfigData

withConfigData(configData)

"ConfigData corresponds to the configuration file content."

obj spec.global.fips.customFIPSConfig.configMap

"ConfigMap references an existing ConfigMap with the configuration file content."

fn spec.global.fips.customFIPSConfig.configMap.withItems

withItems(items)

"Items maps a ConfigMap data key to a file path mount."

fn spec.global.fips.customFIPSConfig.configMap.withItemsMixin

withItemsMixin(items)

"Items maps a ConfigMap data key to a file path mount."

Note: This function appends passed data to existing values

fn spec.global.fips.customFIPSConfig.configMap.withName

withName(name)

"Name is the name of the ConfigMap."

obj spec.global.fips.customFIPSConfig.configMap.items

"Items maps a ConfigMap data key to a file path mount."

fn spec.global.fips.customFIPSConfig.configMap.items.withKey

withKey(key)

"key is the key to project."

fn spec.global.fips.customFIPSConfig.configMap.items.withMode

withMode(mode)

"mode is Optional: mode bits used to set permissions on this file.\nMust be an octal value between 0000 and 0777 or a decimal value between 0 and 511.\nYAML accepts both octal and decimal values, JSON requires decimal values for mode bits.\nIf not specified, the volume defaultMode will be used.\nThis might be in conflict with other options that affect the file\nmode, like fsGroup, and the result can be other mode bits set."

fn spec.global.fips.customFIPSConfig.configMap.items.withPath

withPath(path)

"path is the relative path of the file to map the key to.\nMay not be an absolute path.\nMay not contain the path element '..'.\nMay not start with the string '..'."

obj spec.global.fips.image

"The container image of the FIPS sidecar."

fn spec.global.fips.image.withJmxEnabled

withJmxEnabled(jmxEnabled)

"Define whether the Agent image should support JMX.\nTo be used if the Name field does not correspond to a full image string."

fn spec.global.fips.image.withName

withName(name)

"Defines the Agent image name for the pod. You can provide this as:\n <NAME> - Use agent for the Datadog Agent, cluster-agent for the Datadog Cluster Agent, or dogstatsd\nfor DogStatsD. The full image string is derived from global.registry, [key].image.tag, and [key].image.jmxEnabled.\n <NAME>:<TAG> - For example, agent:latest. The registry is derived from global.registry. [key].image.tag\nand [key].image.jmxEnabled are ignored.\n* <REGISTRY>/<NAME>:<TAG> - For example, gcr.io/datadoghq/agent:latest. If the full image string is specified\n like this, then global.registry, [key].image.tag, and [key].image.jmxEnabled are ignored."

fn spec.global.fips.image.withPullPolicy

withPullPolicy(pullPolicy)

"The Kubernetes pull policy:\nUse Always, Never, or IfNotPresent."

fn spec.global.fips.image.withPullSecrets

withPullSecrets(pullSecrets)

"It is possible to specify Docker registry credentials.\nSee https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod"

fn spec.global.fips.image.withPullSecretsMixin

withPullSecretsMixin(pullSecrets)

"It is possible to specify Docker registry credentials.\nSee https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod"

Note: This function appends passed data to existing values

fn spec.global.fips.image.withTag

withTag(tag)

"Define the image tag to use.\nTo be used if the Name field does not correspond to a full image string."

obj spec.global.fips.image.pullSecrets

"It is possible to specify Docker registry credentials.\nSee https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod"

fn spec.global.fips.image.pullSecrets.withName

withName(name)

"Name of the referent.\nThis field is effectively required, but due to backwards compatibility is\nallowed to be empty. Instances of this type with an empty value here are\nalmost certainly wrong.\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"

obj spec.global.fips.resources

"Resources is the requests and limits for the FIPS sidecar container."

fn spec.global.fips.resources.withClaims

withClaims(claims)

"Claims lists the names of resources, defined in spec.resourceClaims,\nthat are used by this container.\n\nThis is an alpha field and requires enabling the\nDynamicResourceAllocation feature gate.\n\nThis field is immutable. It can only be set for containers."

fn spec.global.fips.resources.withClaimsMixin

withClaimsMixin(claims)

"Claims lists the names of resources, defined in spec.resourceClaims,\nthat are used by this container.\n\nThis is an alpha field and requires enabling the\nDynamicResourceAllocation feature gate.\n\nThis field is immutable. It can only be set for containers."

Note: This function appends passed data to existing values

fn spec.global.fips.resources.withLimits

withLimits(limits)

"Limits describes the maximum amount of compute resources allowed.\nMore info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/"

fn spec.global.fips.resources.withLimitsMixin

withLimitsMixin(limits)

"Limits describes the maximum amount of compute resources allowed.\nMore info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/"

Note: This function appends passed data to existing values

fn spec.global.fips.resources.withRequests

withRequests(requests)

"Requests describes the minimum amount of compute resources required.\nIf Requests is omitted for a container, it defaults to Limits if that is explicitly specified,\notherwise to an implementation-defined value. Requests cannot exceed Limits.\nMore info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/"

fn spec.global.fips.resources.withRequestsMixin

withRequestsMixin(requests)

"Requests describes the minimum amount of compute resources required.\nIf Requests is omitted for a container, it defaults to Limits if that is explicitly specified,\notherwise to an implementation-defined value. Requests cannot exceed Limits.\nMore info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/"

Note: This function appends passed data to existing values

obj spec.global.fips.resources.claims

"Claims lists the names of resources, defined in spec.resourceClaims,\nthat are used by this container.\n\nThis is an alpha field and requires enabling the\nDynamicResourceAllocation feature gate.\n\nThis field is immutable. It can only be set for containers."

fn spec.global.fips.resources.claims.withName

withName(name)

"Name must match the name of one entry in pod.spec.resourceClaims of\nthe Pod where this field is used. It makes that resource available\ninside a container."

fn spec.global.fips.resources.claims.withRequest

withRequest(request)

"Request is the name chosen for a request in the referenced claim.\nIf empty, everything from the claim is made available, otherwise\nonly the result of this request."

obj spec.global.kubelet

"Kubelet contains the kubelet configuration parameters."

fn spec.global.kubelet.withAgentCAPath

withAgentCAPath(agentCAPath)

"AgentCAPath is the container path where the kubelet CA certificate is stored.\nDefault: '/var/run/host-kubelet-ca.crt' if hostCAPath is set, else '/var/run/secrets/kubernetes.io/serviceaccount/ca.crt'"

fn spec.global.kubelet.withHostCAPath

withHostCAPath(hostCAPath)

"HostCAPath is the host path where the kubelet CA certificate is stored."

fn spec.global.kubelet.withPodResourcesSocketPath

withPodResourcesSocketPath(podResourcesSocketPath)

"PodResourcesSocketPath is the host path where the pod resources socket is stored.\nDefault: /var/lib/kubelet/pod-resources/"

fn spec.global.kubelet.withTlsVerify

withTlsVerify(tlsVerify)

"TLSVerify toggles kubelet TLS verification.\nDefault: true"

obj spec.global.kubelet.host

"Host overrides the host used to contact kubelet API (default to status.hostIP)."

obj spec.global.kubelet.host.configMapKeyRef

"Selects a key of a ConfigMap."

fn spec.global.kubelet.host.configMapKeyRef.withKey

withKey(key)

"The key to select."

fn spec.global.kubelet.host.configMapKeyRef.withName

withName(name)

"Name of the referent.\nThis field is effectively required, but due to backwards compatibility is\nallowed to be empty. Instances of this type with an empty value here are\nalmost certainly wrong.\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"

fn spec.global.kubelet.host.configMapKeyRef.withOptional

withOptional(optional)

"Specify whether the ConfigMap or its key must be defined"

obj spec.global.kubelet.host.fieldRef

"Selects a field of the pod: supports metadata.name, metadata.namespace, metadata.labels['<KEY>'], metadata.annotations['<KEY>'],\nspec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs."

fn spec.global.kubelet.host.fieldRef.withApiVersion

withApiVersion(apiVersion)

"Version of the schema the FieldPath is written in terms of, defaults to \"v1\"."

fn spec.global.kubelet.host.fieldRef.withFieldPath

withFieldPath(fieldPath)

"Path of the field to select in the specified API version."

obj spec.global.kubelet.host.resourceFieldRef

"Selects a resource of the container: only resources limits and requests\n(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage) are currently supported."

fn spec.global.kubelet.host.resourceFieldRef.withContainerName

withContainerName(containerName)

"Container name: required for volumes, optional for env vars"

fn spec.global.kubelet.host.resourceFieldRef.withDivisor

withDivisor(divisor)

"Specifies the output format of the exposed resources, defaults to \"1\

fn spec.global.kubelet.host.resourceFieldRef.withResource

withResource(resource)

"Required: resource to select"

obj spec.global.kubelet.host.secretKeyRef

"Selects a key of a secret in the pod's namespace"

fn spec.global.kubelet.host.secretKeyRef.withKey

withKey(key)

"The key of the secret to select from. Must be a valid secret key."

fn spec.global.kubelet.host.secretKeyRef.withName

withName(name)

"Name of the referent.\nThis field is effectively required, but due to backwards compatibility is\nallowed to be empty. Instances of this type with an empty value here are\nalmost certainly wrong.\nMore info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names"

fn spec.global.kubelet.host.secretKeyRef.withOptional

withOptional(optional)

"Specify whether the Secret or its key must be defined"

obj spec.global.localService

"LocalService contains configuration to customize the internal traffic policy service."

fn spec.global.localService.withForceEnableLocalService

withForceEnableLocalService(forceEnableLocalService)

"ForceEnableLocalService forces the creation of the internal traffic policy service to target the agent running on the local node.\nThis parameter only applies to Kubernetes 1.21, where the feature is in alpha and is disabled by default.\n(On Kubernetes 1.22+, the feature entered beta and the internal traffic service is created by default, so this parameter is ignored.)\nDefault: false"

fn spec.global.localService.withNameOverride

withNameOverride(nameOverride)

"NameOverride defines the name of the internal traffic service to target the agent running on the local node."

obj spec.global.networkPolicy

"NetworkPolicy contains the network configuration."

fn spec.global.networkPolicy.withCreate

withCreate(create)

"Create defines whether to create a NetworkPolicy for the current deployment."

fn spec.global.networkPolicy.withDnsSelectorEndpoints

withDnsSelectorEndpoints(dnsSelectorEndpoints)

"DNSSelectorEndpoints defines the cilium selector of the DNS\u202fserver entity."

fn spec.global.networkPolicy.withDnsSelectorEndpointsMixin

withDnsSelectorEndpointsMixin(dnsSelectorEndpoints)

"DNSSelectorEndpoints defines the cilium selector of the DNS\u202fserver entity."

Note: This function appends passed data to existing values

fn spec.global.networkPolicy.withFlavor

withFlavor(flavor)

"Flavor defines Which network policy to use."

obj spec.global.networkPolicy.dnsSelectorEndpoints

"DNSSelectorEndpoints defines the cilium selector of the DNS\u202fserver entity."

fn spec.global.networkPolicy.dnsSelectorEndpoints.withMatchExpressions

withMatchExpressions(matchExpressions)

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

fn spec.global.networkPolicy.dnsSelectorEndpoints.withMatchExpressionsMixin

withMatchExpressionsMixin(matchExpressions)

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

Note: This function appends passed data to existing values

fn spec.global.networkPolicy.dnsSelectorEndpoints.withMatchLabels

withMatchLabels(matchLabels)

"matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels\nmap is equivalent to an element of matchExpressions, whose key field is \"key\", the\noperator is \"In\", and the values array contains only \"value\". The requirements are ANDed."

fn spec.global.networkPolicy.dnsSelectorEndpoints.withMatchLabelsMixin

withMatchLabelsMixin(matchLabels)

"matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels\nmap is equivalent to an element of matchExpressions, whose key field is \"key\", the\noperator is \"In\", and the values array contains only \"value\". The requirements are ANDed."

Note: This function appends passed data to existing values

obj spec.global.networkPolicy.dnsSelectorEndpoints.matchExpressions

"matchExpressions is a list of label selector requirements. The requirements are ANDed."

fn spec.global.networkPolicy.dnsSelectorEndpoints.matchExpressions.withKey

withKey(key)

"key is the label key that the selector applies to."

fn spec.global.networkPolicy.dnsSelectorEndpoints.matchExpressions.withOperator

withOperator(operator)

"operator represents a key's relationship to a set of values.\nValid operators are In, NotIn, Exists and DoesNotExist."

fn spec.global.networkPolicy.dnsSelectorEndpoints.matchExpressions.withValues

withValues(values)

"values is an array of string values. If the operator is In or NotIn,\nthe values array must be non-empty. If the operator is Exists or DoesNotExist,\nthe values array must be empty. This array is replaced during a strategic\nmerge patch."

fn spec.global.networkPolicy.dnsSelectorEndpoints.matchExpressions.withValuesMixin

withValuesMixin(values)

"values is an array of string values. If the operator is In or NotIn,\nthe values array must be non-empty. If the operator is Exists or DoesNotExist,\nthe values array must be empty. This array is replaced during a strategic\nmerge patch."

Note: This function appends passed data to existing values

obj spec.global.originDetectionUnified

"OriginDetectionUnified defines the origin detection unified mechanism behavior."

fn spec.global.originDetectionUnified.withEnabled

withEnabled(enabled)

"Enabled enables unified mechanism for origin detection.\nDefault: false"

obj spec.global.secretBackend

"Configure the secret backend feature https://docs.datadoghq.com/agent/guide/secrets-management\nSee also: https://github.com/DataDog/datadog-operator/blob/main/docs/secret_management.md"

fn spec.global.secretBackend.withArgs

withArgs(args)

"List of arguments to pass to the command (space-separated strings)."

fn spec.global.secretBackend.withCommand

withCommand(command)

"The secret backend command to use. Datadog provides a pre-defined binary /readsecret_multiple_providers.sh.\nRead more about /readsecret_multiple_providers.sh at https://docs.datadoghq.com/agent/configuration/secrets-management/?tab=linux#script-for-reading-from-multiple-secret-providers."

fn spec.global.secretBackend.withEnableGlobalPermissions

withEnableGlobalPermissions(enableGlobalPermissions)

"Whether to create a global permission allowing Datadog agents to read all Kubernetes secrets.\nDefault: false."

fn spec.global.secretBackend.withRefreshInterval

withRefreshInterval(refreshInterval)

"The refresh interval for secrets (0 disables refreshing).\nDefault: 0."

fn spec.global.secretBackend.withRoles

withRoles(roles)

"Roles for Datadog to read the specified secrets, replacing enableGlobalPermissions.\nThey are defined as a list of namespace/secrets.\nEach defined namespace needs to be present in the DatadogAgent controller using WATCH_NAMESPACE or DD_AGENT_WATCH_NAMESPACE.\nSee also: https://github.com/DataDog/datadog-operator/blob/main/docs/secret_management.md#how-to-deploy-the-agent-components-using-the-secret-backend-feature-with-datadogagent."

fn spec.global.secretBackend.withRolesMixin

withRolesMixin(roles)

"Roles for Datadog to read the specified secrets, replacing enableGlobalPermissions.\nThey are defined as a list of namespace/secrets.\nEach defined namespace needs to be present in the DatadogAgent controller using WATCH_NAMESPACE or DD_AGENT_WATCH_NAMESPACE.\nSee also: https://github.com/DataDog/datadog-operator/blob/main/docs/secret_management.md#how-to-deploy-the-agent-components-using-the-secret-backend-feature-with-datadogagent."

Note: This function appends passed data to existing values

fn spec.global.secretBackend.withTimeout

withTimeout(timeout)

"The command timeout in seconds.\nDefault: 30."

obj spec.global.secretBackend.roles

"Roles for Datadog to read the specified secrets, replacing enableGlobalPermissions.\nThey are defined as a list of namespace/secrets.\nEach defined namespace needs to be present in the DatadogAgent controller using WATCH_NAMESPACE or DD_AGENT_WATCH_NAMESPACE.\nSee also: https://github.com/DataDog/datadog-operator/blob/main/docs/secret_management.md#how-to-deploy-the-agent-components-using-the-secret-backend-feature-with-datadogagent."

fn spec.global.secretBackend.roles.withNamespace

withNamespace(namespace)

"Namespace defines the namespace in which the secrets reside."

fn spec.global.secretBackend.roles.withSecrets

withSecrets(secrets)

"Secrets defines the list of secrets for which a role should be created."

fn spec.global.secretBackend.roles.withSecretsMixin

withSecretsMixin(secrets)

"Secrets defines the list of secrets for which a role should be created."

Note: This function appends passed data to existing values