Single Step APM Instrumentation

이 페이지는 아직 영어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우 언제든지 연락주시기 바랍니다.

Overview

Single Step Instrumentation (SSI) automatically installs the Datadog SDKs with no additional configuration required, reducing onboarding time from days to minutes.

To learn more about how it works, see the injector guide for Single Step Instrumentation.

Instrument SDKs across applications

When you install or update the Datadog Agent with APM Instrumentation enabled, the Agent instruments your applications by loading the Datadog SDK into supported processes. This enables distributed tracing by capturing and sending trace data from your services without requiring code changes.

After instrumentation, you can optionally:

Follow the relevant documentation to learn more about Single Step Instrumentation for your deployment type:

linux
docker
kubernetes

To see requirements for compatible languages, operating systems, and architectures, see Single Step Instrumentation compatibility.

Configure Unified Service Tags

Unified Service Tags (USTs) connect traces, metrics, and logs by applying consistent tags across your telemetry. This makes it easier to navigate your observability data.

Learn how to set USTs for:

  • Linux

  • Docker

  • Kubernetes

    Note: In Kubernetes, USTs must be set on both the Deployment object and the Pod template spec.

Enable SDK-dependent products and features

Once SSI loads the Datadog SDK into your applications and enables distributed tracing, you can configure additional products that rely on the SDK. These include capabilities such as Continuous Profiler, Application Security Monitoring, and trace ingestion controls.

The available setup methods depend on your platform:

    Configuration methodDescriptionSupported platforms
    Configure in application_monitoring.yamlEnable products across all services on a host without modifying application command lines.Linux only
    Set environment variablesEnable products by setting environment variables directly in your application configuration.Linux, Kubernetes, Windows, Docker
    Configuration methodDescriptionSupported platforms
    Set environment variablesEnable products by setting environment variables directly in your application configuration.Linux, Kubernetes, Windows, Docker
    Configuration methodDescriptionSupported platforms
    Configure with workload targetingBy default, Single Step Instrumentation instruments all services in all namespaces. Use workload targeting to limit instrumentation to specific namespaces, pods, or workloads, and apply custom configurations.Kubernetes only
    Set environment variablesEnable products by setting environment variables directly in your application configuration.Linux, Kubernetes, Windows, Docker

    Troubleshooting

    Single Step Instrumentation automatically disables when it detects custom instrumentation in your application. If you want to use SSI, you’ll need to:

    1. Remove any existing custom instrumentation code.
    2. Restart your application.

    Further reading

    추가 유용한 문서, 링크 및 기사:

    Enable Runtime MetricsDOCUMENTATION more more Understanding injector behavior with Single Step InstrumentationDOCUMENTATION more more