diff --git a/content/en/tracing/troubleshooting/connection_errors.md b/content/en/tracing/troubleshooting/connection_errors.md index f2e93fc867d..7ba41192f41 100644 --- a/content/en/tracing/troubleshooting/connection_errors.md +++ b/content/en/tracing/troubleshooting/connection_errors.md @@ -171,6 +171,8 @@ APM Agent Status: Not running or unreachable on localhost:8126. ``` +**Note**: On Linux, starting with Agent 7.80.0, the trace-agent starts only after receiving trace data. This reduces memory usage, but means `agent status` may show APM as not running or unreachable even when APM is correctly configured. If no traces have been sent yet, this is expected behavior. To disable this behavior, set `apm_config.socket_activation.enabled: false` in `datadog.yaml`, or set `DD_APM_SOCKET_ACTIVATION_ENABLED=false` in your environment. + ## Troubleshooting the connection problem Whether it's the SDK or the Datadog Agent displaying the error, there are a few ways to troubleshoot. @@ -235,6 +237,8 @@ If your setup is not on Fargate, you can `exec` into the Datadog Agent container Look for the APM Agent section to confirm whether it is running: +**Note:** On Linux, starting with Agent 7.80.0, the trace-agent starts only after receiving trace data. This reduces memory usage, but means the APM Agent section may show as not running or unreachable even when APM is correctly configured. If no traces have been sent yet, this is expected behavior. To disable this behavior, set `apm_config.socket_activation.enabled: false` in `datadog.yaml`, or set `DD_APM_SOCKET_ACTIVATION_ENABLED=false` in your environment. + ```text ========= APM Agent @@ -282,4 +286,4 @@ If the configuration is correct, but you're still seeing connection errors, [con [18]: /tracing/trace_collection/dd_libraries/php/?tab=containers#apache [19]: /tracing/trace_collection/dd_libraries/php/?tab=containers#nginx [20]: /agent/troubleshooting/send_a_flare/?tab=agentv6v7#trace-agent -[21]: https://kubernetes.io/docs/concepts/services-networking/network-policies/ \ No newline at end of file +[21]: https://kubernetes.io/docs/concepts/services-networking/network-policies/