애플리케이션 분석은 자바 트레이싱 클라이언트 버전 0.25.0부터 사용할 수 있습니다. 트레이싱 클라이언트에 있는 단일 설정 파라미터를 사용해 모든 웹 서버 통합을 글로벌 활성화할 수 있습니다.

• 시스템 속성: -Ddd.trace.analytics.enabled=true
• 환경 변수: DD_TRACE_ANALYTICS_ENABLED=true

애플리케이션 분석은 파이썬(Python) 트레이싱 클라이언트 버전 0.19.0부터 사용할 수 있습니다. 트레이싱 클라이언트에 있는 단일 설정 파라미터를 사용해 모든 웹 통합에 대해 애플리케이션 분석을 글로벌 활성화할 수 있습니다.

• 트레이서 설정: ddtrace.config.analytics_enabled = True
• 환경 변수: DD_TRACE_ANALYTICS_ENABLED=true

애플리케이션 분석은 루비(Ruby) 트레이싱 클라이언트 버전 0.19.0부터 사용할 수 있습니다. 글로벌 플래그를 통해 모든 웹 통합에 대해 활성화할 수 있습니다.

그러려면 환경에서 DD_TRACE_ANALYTICS_ENABLED=true를 설정하거나 다음을 설정합니다.

Datadog.configure { |c| c.tracing.analytics.enabled = true }

• true는 모든 웹 프레임워크에 대한 분석을 활성화합니다.
• false 또는 nil는 명백히 활성화한 통합을 제외하고 분석을 비활성화합니다(기본값).

애플리케이션 분석은 고(Go) 트레이싱 클라이언트 1.11.0 버전부터 사용할 수 있으며 다음을 사용해 모든 웹 통합을 글로벌 활성화할 수 있습니다.

• WithAnalytics 트레이서 시작 옵션 예:

  tracer.Start(tracer.WithAnalytics(true))
  

• DD_TRACE_ANALYTICS_ENABLED=true 환경 변수를 사용하는 1.26.0 버전부터

애플리케이션 분석은 Node.js 트레이싱 클라이언트 버전 0.10.0부터 사용할 수 있으며 트레이싱 클라이언트에 있는 단일 설정 파라미터를 사용해 모든 웹 통합을 글로벌 활성화할 수 있습니다.

tracer.init({
  analytics: true
})

또한 다음 설정 파라미터를 사용할 수 있습니다.

• 환경 변수: DD_TRACE_ANALYTICS_ENABLED=true

애플리케이션 분석은 .NET 트레이싱 클라이언트 버전 1.1.0부터 사용할 수 있으며 트레이싱 클라이언트에 있는 단일 설정 파라미터를 사용해 모든 웹 통합을 글로벌 활성화할 수 있습니다.

• 환경 변수 또는 앱 설정: DD_TRACE_ANALYTICS_ENABLED=true

이 설정은 또한 코드로 설정할 수 있습니다.

Tracer.Instance.Settings.AnalyticsEnabled = true;

애플리케이션 분석은 PHP 트레이싱 클라이언트의 버전 0.17.0부터 사용할 수 있으며 트레이싱 클라이언트에 있는 단일 설정 파라미터를 사용해 모든 웹 통합을 글로벌 활성화할 수 있습니다.

• 환경 변수: DD_TRACE_ANALYTICS_ENABLED=true

애플리케이션 분석은 C++ 트레이싱 클라이언트 버전 1.0.0부터 사용할 수 있으며 환경 변수 DD_TRACE_ANALYTICS_ENABLED를 true로 설정해 모든 서비스 엔트리 스팬을 글로벌 활성화할 수 있습니다. 참고: 이 설정은 또한 직접 코드로 설정할 수 있습니다.

datadog::opentracing::TracerOptions tracer_options;
  tracer_options.agent_host = "dd-agent";
  tracer_options.service = "<SERVICE_NAME>";
  tracer_options.analytics_rate = 1.0;
  auto tracer = datadog::opentracing::makeTracer(tracer_options);

Nginx용 애플리케이션 분석을 활성화:

1. 환경 변수 DD_TRACE_ANALYTICS_ENABLED를 true로 설정합니다.

2. nginx.conf 파일과 함께 env DD_TRACE_ANALYTICS_ENABLED;를 추가합니다.

글로벌 설정과 더불어, 다음 설정을 사용해 개별 통합에 대한 애플리케이션 분석을 활성화하거나 비활성화할 수 있습니다.

• System Property: -Ddd.<integration>.analytics.enabled=true
• 환경 변수: DD_<INTEGRATION>_ANALYTICS_ENABLED=true

커스텀 서비스를 제출하는 모든 통합에 대한 글로벌 설정과 더불어 이를 사용하세요. 예를 들어, 커스텀 서비스로 제공되는 JMS 스팬의 경우 다음을 설정하여 애플리케이션 분석에서 모든 JMS 트레이싱을 활성화합니다.

• 시스템 속성: -Ddd.jms.analytics.enabled=true
• 환경 변수: DD_JMS_ANALYTICS_ENABLED=true

통합 이름은 통합 표에서 찾을 수 있습니다.

전 세계 설정과 더불어, 다음 설정을 사용해 개별 통합에 대한 애플리케이션 분석을 활성화하거나 비활성화할 수 있습니다.

• 트레이서 설정: ddtrace.config.<INTEGRATION>.analytics_enabled = True
• 환경 변수: DD_<INTEGRATION>_ANALYTICS_ENABLED=true

커스텀 서비스를 제출하는 모든 통합을 위한 글로벌 설정과 더불어 이를 사용하세요. 예를 들어, 커스텀 서비스로 제공되는 보토(Boto) 스팬의 경우 다음을 설정해 애플리케이션 분석에서 모든 보토 트레이싱을 활성화하세요.

• 트레이서 설정: ddtrace.config.boto.analytics_enabled = True
• 환경 변수: DD_BOTO_ANALYTICS_ENABLED=true

참고: 여러 통합의 경우 트레이서의 통합별 구현에 따라 비표준 설정을 필요로 합니다. 자세한 정보는 애플리케이션 분석에 있는 라이브러리 설명서를 참조하세요.

애플리케이션 분석은 특정 통합에 대해 활성화할 수 있습니다.

그러려면 환경에서 DD_<INTEGRATION>_ANALYTICS_ENABLED=true를 설정하거나 다음을 설정하세요.

Datadog.configure { |c| c.tracing.instrument :integration, analytics_enabled: true }

integration이 통합 이름인 경우 옵션으로 사용 가능한 통합 목록을 참조하세요.

• true는 글로벌 설정과 관계없이 이 통합에 대한 분석을 활성화합니다.
• false는 글로벌 설정에 관계없이 이 통합에 대한 분석을 비활성화합니다.
• nil은 분석에 대한 글로벌 설정을 보류합니다.

글로벌 설정과 더불어 각 통합에 대해 애플리케이션 분석을 각각 활성화하거나 비활성화할 수 있습니다. 예를 들어, 표준 라이브러리의 net/http 패키지를 설정하는 경우 다음을 수행할 수 있습니다.

package main

import (
    httptrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/net/http"
    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
)

func main() {
    tracer.Start()
    defer tracer.Stop()

    mux := httptrace.NewServeMux(httptrace.WithAnalytics(true))
    // ...
}

글로벌 설정과 더불어 개별 통합에 대한 애플리케이션 분석을 활성화 또는 비활성화할 수 있습니다.

예를 들어 express에 대해 애플리케이션 분석을 활성화하는 방법:

tracer.use('express', {
  analytics: true
})

통합 이름은 통합 표에서 찾을 수 있습니다.

글로벌 설정과 더불어 개별 통합에 대한 애플리케이션 분석을 활성화 또는 비활성화할 수 있습니다.

• 환경 변수 또는 앱 설정: DD_<INTEGRATION>_ANALYTICS_ENABLED=true

또는 코드:

Tracer.Instance.Settings.Integrations["<INTEGRATION>"].AnalyticsEnabled = true;

예를 들어 ASP.NET MVC용 애플리케이션 분석을 활성화하는 방법:

• 환경 변수 또는 앱 설정: DD_ASPNETMVC_ANALYTICS_ENABLED=true

또는 코드:

Tracer.Instance.Settings.Integrations["AspNetMvc"].AnalyticsEnabled = true;

통합 이름은 통합 표에서 찾을 수 있습니다. 참고: 리눅스(Linux)에서 환경 변수의 이름은 대소문자를 구분합니다.

전 세계 설정과 더불어, 다음 설정을 사용해 개별 통합에 대한 애플리케이션 분석을 활성화하거나 비활성화할 수 있습니다.

• 환경 변수: DD_<INTEGRATION>_ANALYTICS_ENABLED=true

커스텀 서비스를 제출하는 통합에 대한 글로벌 설정과 더불어 이를 사용하세요. 예를 들어 커스텀 서비스로 제공하는 Symfony 스팬의 경우 다음을 설정해 애플리케이션 분석에서 모든 Symfony 트레이싱을 활성화할 수 있습니다.

• 환경 변수: DD_SYMFONY_ANALYTICS_ENABLED=true

통합 이름은 통합 표에서 찾을 수 있습니다.

데이터베이스 트레이싱은 기본적으로 애플리케이션 분석으로 수집되지 않습니다. 각 통합에 대해 수동으로 수집을 활성화해야 합니다. 예:

• 시스템 속성: -Ddd.jdbc.analytics.enabled=true
• 환경 변수: DD_JDBC_ANALYTICS_ENABLED=true

데이터베이스 트레이싱은 기본적으로 애플리케이션 분석으로 수집되지 않습니다. 각 통합에 대해 수동으로 수집을 활성화해야 합니다. 예:

• 트레이서 설정: ddtrace.config.psycopg.analytics_enabled = True
• 환경 변수: DD_PSYCOPG_ANALYTICS_ENABLED=true

데이터베이스 트레이싱은 기본적으로 애플리케이션 분석으로 수집되지 않습니다. 각 통합에 대해 수동으로 수집을 활성화해야 합니다. 예:

Datadog.configure { |c| c.tracing.instrument :mongo, analytics_enabled: true }

데이터베이스 트레이싱은 기본적으로 애플리케이션 분석으로 수집되지 않습니다. 각 통합에 대해 수동으로 수집을 활성화해야 합니다. 예:

// Register the database driver with Analytics enabled.
sqltrace.Register("mysql", &mysql.MySQLDriver{}, sqltrace.WithAnalytics(true))

데이터베이스 트레이싱은 기본적으로 애플리케이션 분석으로 수집되지 않습니다. 각 통합에 대해 수동으로 수집을 활성화해야 합니다. 예:

tracer.use('mysql', {
  analytics: true
})

데이터베이스 트레이싱은 기본적으로 애플리케이션 분석으로 수집되지 않습니다. 각 통합에 대해 수동으로 수집을 활성화해야 합니다. 예: ADO.NET을 위해 애플리케이션 분석을 활성화하는 방법:

• 환경 변수 또는 앱 설정: DD_AdoNet_ANALYTICS_ENABLED=true

또는 코드:

Tracer.Instance.Settings.Integrations["AdoNet"].AnalyticsEnabled = true;

통합 이름은 통합 표에서 찾을 수 있습니다. 참고: 리눅스(Linux)에서 환경 변수의 이름은 대소문자를 구분합니다.

데이터베이스 트레이싱은 기본적으로 애플리케이션 분석으로 수집되지 않습니다. 다음 설정을 사용해 개별 통합에 대한 애플리케이션 분석을 활성화 또는 비활성화할 수 있습니다.

• 환경 변수: DD_<INTEGRATION>_ANALYTICS_ENABLED=true

커스텀 서비스를 제출하는 모든 통합에 대해 글로벌 설정과 함께 이를 사용할 수 있습니다. 예: mysqli의 경우:

• 환경 변수: DD_MYSQLI_ANALYTICS_ENABLED=true

통합 이름은 통합 표에서 찾을 수 있습니다.

커스텀 계측을 포함하는 애플리케이션에서 스팬에 ANALYTICS_SAMPLE_RATE 태그를 설정하여 애플리케이션 분석을 활성화할 수 있습니다.

import datadog.trace.api.DDTags;
import datadog.trace.api.Trace;
import io.opentracing.Tracer;
import io.opentracing.util.GlobalTracer;

class MyClass {
  @Trace
  void myMethod() {
    final Span span = GlobalTracer.get().activeSpan();
    // Span provided by @Trace annotation.
    if (span != null) {
      span.setTag(DDTags.SERVICE, "<SERVICE_NAME>");
      span.setTag(DDTags.ANALYTICS_SAMPLE_RATE, 1.0);
    }
  }
}

참고: dd.trace.methods 또는 트레이스 주석 스팬에 대한 애플리케이션 분석을 -Ddd.trace-annotation.analytics.enabled=true를 설정해 활성화할 수 있습니다.

커스텀 계측을 포함하는 애플리케이션은 스팬에 ddtrace.constants.ANALYTICS_SAMPLE_RATE_KEY 태그를 설정하여 애플리케이션 분석을 활성화할 수 있습니다.

from ddtrace import tracer
from ddtrace.constants import ANALYTICS_SAMPLE_RATE_KEY

@tracer.wrap()
def my_method():
    span = tracer.current_span()
    span.set_tag(ANALYTICS_SAMPLE_RATE_KEY, True)

커스텀 계측을 포함하는 애플리케이션은 스팬에 Analytics::TAG_ENABLED 태그를 설정하여 애플리케이션 분석을 활성화할 수 있습니다.

Datadog::Tracing.trace('my.task') do |span|
  # Set the analytics sample rate to 1.0
  span.set_tag(Datadog::Tracing::Metadata::Ext::Analytics::TAG_ENABLED, true)
end

커스텀 계측의 경우 특별 태그를 추가해 아래와 같이 애플리케이션 분석을 활성화할 수 있습니다.

span.SetTag(ext.AnalyticsEvent, true)

이를 통해 스팬을 애플리케이션 분석 이벤트로 표시할 수 있습니다.

커스텀 계측을 포함하는 애플리케이션의 경우 스팬에 ANALYTICS 태그를 설정해 애플리케이션 분석을 활성화할 수 있습니다.

const { ANALYTICS } = require('dd-trace/ext/tags')

span.setTag(ANALYTICS, true)

커스텀 계측을 포함하는 애플리케이션은 스팬에서 Tags.Analytics 태그를 설정하여 애플리케이션 분석을 활성화할 수 있습니다.

using Datadog.Trace;

using(var scope = Tracer.Instance.StartActive("web.request"))
{
    // enable Analytics on this span
    scope.span.SetTag(Tags.Analytics, "true");
}

커스텀 계측을 포함하는 애플리케이션은 스팬에서 ANALYTICS_KEY 태그를 설정하여 애플리케이션 분석에서 활성화할 수 있습니다.

<?php
  // ... your existing span that you want to enable for App Analytics
  $span->setTag(Tag::ANALYTICS_KEY, true);
?>

커스텀 계측을 포함하는 애플리케이션은 스팬에서 analytics_event 태그를 설정하여 애플리케이션 분석을 활성화할 수 있습니다.

...
#include <datadog/tags.h>
...
auto tracer = ...
auto span = tracer->StartSpan("operation_name");
// A boolean value of true enables App Analytics for the span,
// with a sample rate of 1.0.
span->SetTag(datadog::tags::analytics_event, true);
// A double value between 0.0 and 1.0 enables App Analytics
// and sets the sample rate to the provided value.
span->SetTag(datadog::tags::analytics_event, 0.5);