Custom Instrumentation

이 페이지는 아직 한국어로 제공되지 않으며 번역 작업 중입니다. 번역에 관한 질문이나 의견이 있으시면 언제든지 저희에게 연락해 주십시오.

Overview

Custom instrumentation allows for precise monitoring of specific components in your application. It allows you to capture observability data from in-house code or complex functions that aren’t captured by automatic instrumentation. Automatic instrumentation includes Single Step Instrumentation or using Datadog tracing libraries.

Custom instrumentation involves embedding tracing code directly into your application code. This allows for the programmatic creation, modification, or deletion of traces to send to Datadog.

Use cases

Some situations when you might use custom instrumentation include:

  • Collecting observability data from custom code with unique or complex business logic.
  • Providing deeper visibility and context into spans, including adding span tags.
  • Precisely monitoring specific sequences of operations or user interactions that require fine-grained control.
  • Removing unwanted spans from traces.

Getting started

Before you begin, make sure you’ve already installed and configured the Agent.

Follow the relevant documentation for your custom instrumentation approach to learn more:

    Use the Datadog API to add custom instrumentation that allows you to programmatically create, modify, or delete traces to send to Datadog. This is useful for tracing in-house code not captured by automatic instrumentation, removing unwanted spans from traces, and for providing deeper visibility and context into spans, including adding span tags.

    Java
    Python
    Ruby
    go
    Node.js
    PHP
    C++
    .Net

    Datadog tracing libraries provide an implementation of the OpenTelemetry API for instrumenting your code. This means you can maintain vendor-neutral instrumentation of all your services, while still taking advantage of Datadog’s native implementation, features, and products. You can configure it to generate Datadog-style spans and traces to be processed by the Datadog tracing library for your language, and send those to Datadog.

    Java
    Python
    Ruby
    go
    Node.js
    PHP
    .Net
    iOS

    If OpenTelemetry or ddtrace custom instrumentation doesn’t work for you, each of the supported languages also has support for sending OpenTracing data to Datadog. OpenTracing is archived and the project is unsupported.

    Java
    Python
    Node.js

    Ruby
    go
    .Net
    PHP

    Further reading

    Additional helpful documentation, links, and articles:

    Instrument a custom method to get deep visibility into your business logic more more Connect your Logs and Traces together more more Explore your services, resources, and traces more more Learn More about Datadog and the OpenTelemetry initiative more more