Installation Precautions

Target Platforms: All Linux-based systems, Docker, K8s 

Datadog console - Integration > Agent Select the corresponding OS from the menu and proceed with the installation and upgrade using the generated Command Script, taking note of the following considerations.

With the introduction of a new feature for automatically installing APM (Single Step APM Instrumentation) in beta (August 2023), an Additional Options – Enable APM Instrumentation toggle has been added, affecting whether the environment variable is included/excluded in the Command Script.

The default setting for this feature is ON, meaning it is automatically included in the Command Script environment variables.

If you install with the default ON setting, APM-related features will be automatically installed and configured, potentially leading to unintended APM charges. Additionally, as this is still in beta, unforeseen issues may arise.
When installing the Agent via script, if the Command includes DD_APM_INSTRUMENTATION_ENABLED, ensure this environment variable is removed before proceeding.

Related Issues

If specific errors or issues occur in the following path, please verify if the Agent was installed as described above.

/opt/datadog/apm/library/

This path is created when the DD_APM_INSTRUMENTATION_ENABLED environment variable is included in the script-based Agent installation Command for Single Step APM Instrumentation.

If issues related to this path arise, please follow the guide below to resolve them.

• Linux host or VM

  • Delete the library.

    dd-host-install --uninstall

  • Restart the host.

• Docker

  • Delete the library.

    dd-container-install --uninstall

  • Restart Docker.

    systemctl restart docker

    Alternatively, restart Docker using the appropriate command for your environment.

• Kubernetes (helm)

  • Remove the instrumentation: entry under apm in Datadog's value.yaml.

  • Reapply value.yaml using the following command:

    helm upgrade datadog-agent -f datadog-values.yaml datadog/datadog

  • Restart the service.

https://docs.datadoghq.com/ko/tracing/trace_collection/automatic_instrumentation/single-step-apm/?tab=linuxhostorvm#removing-apm-for-all-services-on-the-infrastructure