From 64cb3afc0093ffb698f05ad5ffe49cd06391e420 Mon Sep 17 00:00:00 2001 From: Heston Hoffman Date: Tue, 5 May 2026 15:31:59 -0700 Subject: [PATCH 1/5] Use dynamic region-param for global.site description Replace the hardcoded list of Datadog sites in the global.site parameter description with a dynamic region-param shortcode. This renders the correct site value per the reader's selected region on docs.datadoghq.com, and automatically covers new data centers without requiring manual updates to this file. Related: DataDog/documentation#36153 (DOCS-14086) Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/configuration_public.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration_public.md b/docs/configuration_public.md index 90bd94a11d..ec00f4a79d 100644 --- a/docs/configuration_public.md +++ b/docs/configuration_public.md @@ -571,7 +571,7 @@ spec: : The built-in secret backend type to use (e.g., `k8s.secrets`, `docker.secrets`, `aws.secrets`). Alternative to Command; when Type is set, the Agent uses the built-in backend to resolve secrets. Requires Agent 7.70+. `global.site` -: Is the Datadog intake site Agent data are sent to. Set to 'datadoghq.com' to send data to the US1 site (default). Set to 'datadoghq.eu' to send data to the EU site. Set to 'us3.datadoghq.com' to send data to the US3 site. Set to 'us5.datadoghq.com' to send data to the US5 site. Set to 'ddog-gov.com' to send data to the US1-FED site. Set to 'ap1.datadoghq.com' to send data to the AP1 site. Default: 'datadoghq.com' +: Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' `global.tags` : Contains a list of tags to attach to every metric, event and service check collected. Learn more about tagging: https://docs.datadoghq.com/tagging/ From 34aff31db3f20b08cea9b014e0a69db863250cc4 Mon Sep 17 00:00:00 2001 From: Heston Hoffman Date: Tue, 5 May 2026 15:51:46 -0700 Subject: [PATCH 2/5] Add overide and generate --- docs/configuration.v2alpha1.md | 2 +- docs/configuration_public.md | 2 +- hack/generate-docs/updated_descriptions.json | 3 ++- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/configuration.v2alpha1.md b/docs/configuration.v2alpha1.md index ef3b02c5b9..2f3964cc99 100644 --- a/docs/configuration.v2alpha1.md +++ b/docs/configuration.v2alpha1.md @@ -294,7 +294,7 @@ spec: | global.secretBackend.roles | For Datadog to read the specified secrets, replacing `enableGlobalPermissions`. They are defined as a list of namespace/secrets. Each defined namespace needs to be present in the DatadogAgent controller using `WATCH_NAMESPACE` or `DD_AGENT_WATCH_NAMESPACE`. See 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. | | global.secretBackend.timeout | The command timeout in seconds. Default: `30`. | | global.secretBackend.type | The built-in secret backend type to use (e.g., `k8s.secrets`, `docker.secrets`, `aws.secrets`). Alternative to Command; when Type is set, the Agent uses the built-in backend to resolve secrets. Requires Agent 7.70+. | -| global.site | Is the Datadog intake site Agent data are sent to. Set to 'datadoghq.com' to send data to the US1 site (default). Set to 'datadoghq.eu' to send data to the EU site. Set to 'us3.datadoghq.com' to send data to the US3 site. Set to 'us5.datadoghq.com' to send data to the US5 site. Set to 'ddog-gov.com' to send data to the US1-FED site. Set to 'ap1.datadoghq.com' to send data to the AP1 site. Default: 'datadoghq.com' | +| global.site | Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: ‘datadoghq.com’ | | global.tags | Contains a list of tags to attach to every metric, event and service check collected. Learn more about tagging: https://docs.datadoghq.com/tagging/ | | global.useFIPSAgent | UseFIPSAgent enables the FIPS flavor of the Agent. If 'true', the FIPS proxy will always be disabled. Default: 'false' | | global.useVSock | UseVSock allows the use of VSock communication between the Agent and containerized workloads. Default: 'false' | diff --git a/docs/configuration_public.md b/docs/configuration_public.md index ec00f4a79d..42828f1d3f 100644 --- a/docs/configuration_public.md +++ b/docs/configuration_public.md @@ -571,7 +571,7 @@ spec: : The built-in secret backend type to use (e.g., `k8s.secrets`, `docker.secrets`, `aws.secrets`). Alternative to Command; when Type is set, the Agent uses the built-in backend to resolve secrets. Requires Agent 7.70+. `global.site` -: Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' +: Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: ‘datadoghq.com’ `global.tags` : Contains a list of tags to attach to every metric, event and service check collected. Learn more about tagging: https://docs.datadoghq.com/tagging/ diff --git a/hack/generate-docs/updated_descriptions.json b/hack/generate-docs/updated_descriptions.json index e6e7dfd53e..0c087e3772 100644 --- a/hack/generate-docs/updated_descriptions.json +++ b/hack/generate-docs/updated_descriptions.json @@ -7,5 +7,6 @@ "global.fips.resources.limits": "Resource limits for the FIPS sidecar. See https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-requests-and-limits-of-pod-and-container .", "global.fips.resources.requests": "Resource requests for the FIPS sidecar. If undefined, defaults to global.fips.resources.limits (if set), then to an implementation-defined value. See https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-requests-and-limits-of-pod-and-container .", "global.fips.useHTTPS": "If true, enables HTTPS on the FIPS sidecar. Default: false", - "[key].containers.[key].livenessProbe.terminationGracePeriodSeconds": "Duration (in seconds) the pod needs to terminate gracefully after the liveness probe fails. This value sets how long to wait after the processes running in the pod are sent a termination signal, before forcibly halting the processes with a kill signal. Set this value longer than the expected cleanup time for your process. Must be a non-negative integer. If 0, a kill signal is sent immediately when the liveness probe fails, giving no opportunity for the processes to shut down. Defaults to the pod’s terminationGracePeriodSeconds." + "[key].containers.[key].livenessProbe.terminationGracePeriodSeconds": "Duration (in seconds) the pod needs to terminate gracefully after the liveness probe fails. This value sets how long to wait after the processes running in the pod are sent a termination signal, before forcibly halting the processes with a kill signal. Set this value longer than the expected cleanup time for your process. Must be a non-negative integer. If 0, a kill signal is sent immediately when the liveness probe fails, giving no opportunity for the processes to shut down. Defaults to the pod’s terminationGracePeriodSeconds.", + "global.site": "Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key=\"dd_site\" code=\"true\" >}}). Default: ‘datadoghq.com’" } From 7e49ebbdc7cd24c2034a9ce0e2462200b44911aa Mon Sep 17 00:00:00 2001 From: Heston Hoffman Date: Tue, 5 May 2026 15:56:01 -0700 Subject: [PATCH 3/5] Fix curly quotes --- docs/configuration.v2alpha1.md | 4 ++-- docs/configuration_public.md | 2 +- hack/generate-docs/updated_descriptions.json | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/configuration.v2alpha1.md b/docs/configuration.v2alpha1.md index 2f3964cc99..6f9dc9d754 100644 --- a/docs/configuration.v2alpha1.md +++ b/docs/configuration.v2alpha1.md @@ -294,7 +294,7 @@ spec: | global.secretBackend.roles | For Datadog to read the specified secrets, replacing `enableGlobalPermissions`. They are defined as a list of namespace/secrets. Each defined namespace needs to be present in the DatadogAgent controller using `WATCH_NAMESPACE` or `DD_AGENT_WATCH_NAMESPACE`. See 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. | | global.secretBackend.timeout | The command timeout in seconds. Default: `30`. | | global.secretBackend.type | The built-in secret backend type to use (e.g., `k8s.secrets`, `docker.secrets`, `aws.secrets`). Alternative to Command; when Type is set, the Agent uses the built-in backend to resolve secrets. Requires Agent 7.70+. | -| global.site | Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: ‘datadoghq.com’ | +| global.site | Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' | | global.tags | Contains a list of tags to attach to every metric, event and service check collected. Learn more about tagging: https://docs.datadoghq.com/tagging/ | | global.useFIPSAgent | UseFIPSAgent enables the FIPS flavor of the Agent. If 'true', the FIPS proxy will always be disabled. Default: 'false' | | global.useVSock | UseVSock allows the use of VSock communication between the Agent and containerized workloads. Default: 'false' | @@ -357,7 +357,7 @@ In the table, `spec.override.nodeAgent.image.name` and `spec.override.nodeAgent. | [key].containers.[key].livenessProbe.successThreshold | Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness and startup. Minimum value is 1. | | [key].containers.[key].livenessProbe.tcpSocket.host | Optional: Host name to connect to, defaults to the pod IP. | | [key].containers.[key].livenessProbe.tcpSocket.port | Number or name of the port to access on the container. Number must be in the range 1 to 65535. Name must be an IANA_SVC_NAME. | -| [key].containers.[key].livenessProbe.terminationGracePeriodSeconds | Duration (in seconds) the pod needs to terminate gracefully after the liveness probe fails. This value sets how long to wait after the processes running in the pod are sent a termination signal, before forcibly halting the processes with a kill signal. Set this value longer than the expected cleanup time for your process. Must be a non-negative integer. If 0, a kill signal is sent immediately when the liveness probe fails, giving no opportunity for the processes to shut down. Defaults to the pod’s terminationGracePeriodSeconds. | +| [key].containers.[key].livenessProbe.terminationGracePeriodSeconds | Duration (in seconds) the pod needs to terminate gracefully after the liveness probe fails. This value sets how long to wait after the processes running in the pod are sent a termination signal, before forcibly halting the processes with a kill signal. Set this value longer than the expected cleanup time for your process. Must be a non-negative integer. If 0, a kill signal is sent immediately when the liveness probe fails, giving no opportunity for the processes to shut down. Defaults to the pod's terminationGracePeriodSeconds. | | [key].containers.[key].livenessProbe.timeoutSeconds | Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes | | [key].containers.[key].logLevel | LogLevel sets logging verbosity (overrides global setting). Valid log levels are: trace, debug, info, warn, error, critical, and off. Default: 'info' | | [key].containers.[key].name | Name of the container that is overridden | diff --git a/docs/configuration_public.md b/docs/configuration_public.md index 42828f1d3f..ec00f4a79d 100644 --- a/docs/configuration_public.md +++ b/docs/configuration_public.md @@ -571,7 +571,7 @@ spec: : The built-in secret backend type to use (e.g., `k8s.secrets`, `docker.secrets`, `aws.secrets`). Alternative to Command; when Type is set, the Agent uses the built-in backend to resolve secrets. Requires Agent 7.70+. `global.site` -: Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: ‘datadoghq.com’ +: Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' `global.tags` : Contains a list of tags to attach to every metric, event and service check collected. Learn more about tagging: https://docs.datadoghq.com/tagging/ diff --git a/hack/generate-docs/updated_descriptions.json b/hack/generate-docs/updated_descriptions.json index 0c087e3772..f844ab0e84 100644 --- a/hack/generate-docs/updated_descriptions.json +++ b/hack/generate-docs/updated_descriptions.json @@ -7,6 +7,6 @@ "global.fips.resources.limits": "Resource limits for the FIPS sidecar. See https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-requests-and-limits-of-pod-and-container .", "global.fips.resources.requests": "Resource requests for the FIPS sidecar. If undefined, defaults to global.fips.resources.limits (if set), then to an implementation-defined value. See https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-requests-and-limits-of-pod-and-container .", "global.fips.useHTTPS": "If true, enables HTTPS on the FIPS sidecar. Default: false", - "[key].containers.[key].livenessProbe.terminationGracePeriodSeconds": "Duration (in seconds) the pod needs to terminate gracefully after the liveness probe fails. This value sets how long to wait after the processes running in the pod are sent a termination signal, before forcibly halting the processes with a kill signal. Set this value longer than the expected cleanup time for your process. Must be a non-negative integer. If 0, a kill signal is sent immediately when the liveness probe fails, giving no opportunity for the processes to shut down. Defaults to the pod’s terminationGracePeriodSeconds.", - "global.site": "Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key=\"dd_site\" code=\"true\" >}}). Default: ‘datadoghq.com’" + "[key].containers.[key].livenessProbe.terminationGracePeriodSeconds": "Duration (in seconds) the pod needs to terminate gracefully after the liveness probe fails. This value sets how long to wait after the processes running in the pod are sent a termination signal, before forcibly halting the processes with a kill signal. Set this value longer than the expected cleanup time for your process. Must be a non-negative integer. If 0, a kill signal is sent immediately when the liveness probe fails, giving no opportunity for the processes to shut down. Defaults to the pod's terminationGracePeriodSeconds.", + "global.site": "Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key=\"dd_site\" code=\"true\" >}}). Default: 'datadoghq.com'" } From d79a13f44ee3be24ebb7e02066f13b1ddf554cb6 Mon Sep 17 00:00:00 2001 From: Heston Hoffman Date: Tue, 5 May 2026 16:51:13 -0700 Subject: [PATCH 4/5] Apply suggestions from code review Co-authored-by: Bryce Eadie --- docs/configuration.v2alpha1.md | 2 +- docs/configuration_public.md | 2 +- hack/generate-docs/updated_descriptions.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/configuration.v2alpha1.md b/docs/configuration.v2alpha1.md index 6f9dc9d754..ac37902a31 100644 --- a/docs/configuration.v2alpha1.md +++ b/docs/configuration.v2alpha1.md @@ -294,7 +294,7 @@ spec: | global.secretBackend.roles | For Datadog to read the specified secrets, replacing `enableGlobalPermissions`. They are defined as a list of namespace/secrets. Each defined namespace needs to be present in the DatadogAgent controller using `WATCH_NAMESPACE` or `DD_AGENT_WATCH_NAMESPACE`. See 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. | | global.secretBackend.timeout | The command timeout in seconds. Default: `30`. | | global.secretBackend.type | The built-in secret backend type to use (e.g., `k8s.secrets`, `docker.secrets`, `aws.secrets`). Alternative to Command; when Type is set, the Agent uses the built-in backend to resolve secrets. Requires Agent 7.70+. | -| global.site | Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' | +| global.site | Is the Datadog intake site Agent data is sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' | | global.tags | Contains a list of tags to attach to every metric, event and service check collected. Learn more about tagging: https://docs.datadoghq.com/tagging/ | | global.useFIPSAgent | UseFIPSAgent enables the FIPS flavor of the Agent. If 'true', the FIPS proxy will always be disabled. Default: 'false' | | global.useVSock | UseVSock allows the use of VSock communication between the Agent and containerized workloads. Default: 'false' | diff --git a/docs/configuration_public.md b/docs/configuration_public.md index ec00f4a79d..8a52c36e86 100644 --- a/docs/configuration_public.md +++ b/docs/configuration_public.md @@ -571,7 +571,7 @@ spec: : The built-in secret backend type to use (e.g., `k8s.secrets`, `docker.secrets`, `aws.secrets`). Alternative to Command; when Type is set, the Agent uses the built-in backend to resolve secrets. Requires Agent 7.70+. `global.site` -: Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' +: Is the Datadog intake site Agent data is sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' `global.tags` : Contains a list of tags to attach to every metric, event and service check collected. Learn more about tagging: https://docs.datadoghq.com/tagging/ diff --git a/hack/generate-docs/updated_descriptions.json b/hack/generate-docs/updated_descriptions.json index f844ab0e84..0a00c2afbf 100644 --- a/hack/generate-docs/updated_descriptions.json +++ b/hack/generate-docs/updated_descriptions.json @@ -8,5 +8,5 @@ "global.fips.resources.requests": "Resource requests for the FIPS sidecar. If undefined, defaults to global.fips.resources.limits (if set), then to an implementation-defined value. See https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#resource-requests-and-limits-of-pod-and-container .", "global.fips.useHTTPS": "If true, enables HTTPS on the FIPS sidecar. Default: false", "[key].containers.[key].livenessProbe.terminationGracePeriodSeconds": "Duration (in seconds) the pod needs to terminate gracefully after the liveness probe fails. This value sets how long to wait after the processes running in the pod are sent a termination signal, before forcibly halting the processes with a kill signal. Set this value longer than the expected cleanup time for your process. Must be a non-negative integer. If 0, a kill signal is sent immediately when the liveness probe fails, giving no opportunity for the processes to shut down. Defaults to the pod's terminationGracePeriodSeconds.", - "global.site": "Is the Datadog intake site Agent data are sent to. Set this to your Datadog site ({{< region-param key=\"dd_site\" code=\"true\" >}}). Default: 'datadoghq.com'" + "global.site": "Is the Datadog intake site Agent data is sent to. Set this to your Datadog site ({{< region-param key=\"dd_site\" code=\"true\" >}}). Default: 'datadoghq.com'" } From 2da577e920be4f9d21e67d3d89327e487ba7ca6d Mon Sep 17 00:00:00 2001 From: Heston Hoffman Date: Tue, 5 May 2026 16:52:56 -0700 Subject: [PATCH 5/5] Regenerate docs --- docs/configuration.v2alpha1.md | 2 +- docs/configuration_public.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/configuration.v2alpha1.md b/docs/configuration.v2alpha1.md index ac37902a31..c79ee7c4af 100644 --- a/docs/configuration.v2alpha1.md +++ b/docs/configuration.v2alpha1.md @@ -294,7 +294,7 @@ spec: | global.secretBackend.roles | For Datadog to read the specified secrets, replacing `enableGlobalPermissions`. They are defined as a list of namespace/secrets. Each defined namespace needs to be present in the DatadogAgent controller using `WATCH_NAMESPACE` or `DD_AGENT_WATCH_NAMESPACE`. See 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. | | global.secretBackend.timeout | The command timeout in seconds. Default: `30`. | | global.secretBackend.type | The built-in secret backend type to use (e.g., `k8s.secrets`, `docker.secrets`, `aws.secrets`). Alternative to Command; when Type is set, the Agent uses the built-in backend to resolve secrets. Requires Agent 7.70+. | -| global.site | Is the Datadog intake site Agent data is sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' | +| global.site | Is the Datadog intake site Agent data is sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' | | global.tags | Contains a list of tags to attach to every metric, event and service check collected. Learn more about tagging: https://docs.datadoghq.com/tagging/ | | global.useFIPSAgent | UseFIPSAgent enables the FIPS flavor of the Agent. If 'true', the FIPS proxy will always be disabled. Default: 'false' | | global.useVSock | UseVSock allows the use of VSock communication between the Agent and containerized workloads. Default: 'false' | diff --git a/docs/configuration_public.md b/docs/configuration_public.md index 8a52c36e86..b0e3d5a635 100644 --- a/docs/configuration_public.md +++ b/docs/configuration_public.md @@ -571,7 +571,7 @@ spec: : The built-in secret backend type to use (e.g., `k8s.secrets`, `docker.secrets`, `aws.secrets`). Alternative to Command; when Type is set, the Agent uses the built-in backend to resolve secrets. Requires Agent 7.70+. `global.site` -: Is the Datadog intake site Agent data is sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' +: Is the Datadog intake site Agent data is sent to. Set this to your Datadog site ({{< region-param key="dd_site" code="true" >}}). Default: 'datadoghq.com' `global.tags` : Contains a list of tags to attach to every metric, event and service check collected. Learn more about tagging: https://docs.datadoghq.com/tagging/