Remote Configuration

Java 애플리케이션에서는 버전 1.34.0부터 Ingestion Control 페이지 UI에서 서비스 및 리소스별 샘플링 속도를 설정하세요.

서비스 및 리소스별로 샘플링 속도를 원격으로 구성하는 방법에 관한 자세한 내용은 리소스 기반 샘플링 가이드를 참조하세요.

참고: 원격으로 설정된 구성이 로컬 구성보다 우선합니다.

로컬 구성

Java 애플리케이션에서는 DD_TRACE_SAMPLING_RULES 환경 변수를 사용해 서비스 및 리소스별(리소스별 샘플링의 경우 버전 v1.26.0부터) 샘플링 속도를 설정하세요.

예를 들어, 서비스 my-service에서 리소스 GET /checkout의 트레이스를 100% 캡처하고, 다른 엔드포인트의 트레이스를 20% 캡처하려면 다음과 같이 설정하세요.

# using system property
java -Ddd.trace.sampling.rules='[{"service": "my-service", "resource": "GET /checkout", "sample_rate":1},{"service": "my-service", "sample_rate":0.2}]' -javaagent:dd-java-agent.jar -jar my-app.jar

# using environment variables
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource":"GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'

서비스 이름 값은 대소문자를 구분하며 실제 서비스 이름의 대소문자와 일치해야 합니다.

환경 변수 DD_TRACE_RATE_LIMIT를 서비스 인스턴스당 최대 초당 트레이스 수로 설정하여 속도 제한을 구성하세요. DD_TRACE_RATE_LIMIT 값을 설정하지 않으면 초당 트레이스 100개의 제한이 적용됩니다.

참고: DD_TRACE_SAMPLE_RATE는 지원이 중단되었습니다. 대신 DD_TRACE_SAMPLING_RULES를 사용하세요. 예를 들어, 이미 DD_TRACE_SAMPLE_RATE를 0.1로 설정한 경우, 대신 DD_TRACE_SAMPLING_RULES를 [{"sample_rate":0.1}]로 설정하세요.

샘플링 제어에 관한 자세한 내용은 Java SDK 문서를 참조하세요.

Remote Configuration

Python 애플리케이션에서는 버전 2.9.0부터 서비스 및 리소스별 샘플링 속도를 Ingestion Control 페이지 UI에서 설정하세요.

서비스 및 리소스별로 샘플링 속도를 원격으로 구성하는 방법에 관한 자세한 내용은 리소스 기반 샘플링 가이드를 참조하세요.

참고: 원격으로 설정된 구성이 로컬 구성보다 우선합니다.

로컬 구성 Python 애플리케이션에서는 DD_TRACE_SAMPLING_RULES 환경 변수를 사용해 서비스 및 리소스별(리소스별 샘플링의 경우 버전 v2.8.0부터) 샘플링 속도를 설정하세요.

예를 들어, 서비스 my-service에서 리소스 GET /checkout의 트레이스를 100% 캡처하고, 다른 엔드포인트의 트레이스를 20% 캡처하려면 다음과 같이 설정하세요.

export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource": "GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'

환경 변수 DD_TRACE_RATE_LIMIT를 서비스 인스턴스당 최대 초당 트레이스 수로 설정하여 속도 제한을 구성하세요. DD_TRACE_RATE_LIMIT 값을 설정하지 않으면 초당 트레이스 100개의 제한이 적용됩니다.

참고: DD_TRACE_SAMPLE_RATE는 지원이 중단되었습니다. 대신 DD_TRACE_SAMPLING_RULES를 사용하세요. 예를 들어, 이미 DD_TRACE_SAMPLE_RATE를 0.1로 설정한 경우, 대신 DD_TRACE_SAMPLING_RULES를 [{"sample_rate":0.1}]로 설정하세요.

샘플링 제어에 관한 자세한 내용은 Python SDK 문서를 참조하세요.

Remote Configuration

Ruby 애플리케이션에서는 버전 2.0.0부터 서비스 및 리소스별 샘플링 속도를 Ingestion Control 페이지 UI에서 설정하세요.

서비스 및 리소스별로 샘플링 속도를 원격으로 구성하는 방법에 관한 자세한 내용은 리소스 기반 샘플링 가이드를 참조하세요.

참고: 원격으로 설정된 구성이 로컬 구성보다 우선합니다.

로컬 구성 Ruby 애플리케이션에서는 DD_TRACE_SAMPLE_RATE 환경 변수를 사용해 라이브러리의 전역 샘플링 속도를 설정하세요. DD_TRACE_SAMPLING_RULES 환경 변수를 사용하여 서비스별로 샘플링 속도를 설정하세요.

예를 들어, 이름이 my-service인 서비스의 트레이스는 50%, 나머지 트레이스는 10% 전송하려면 다음과 같이 설정하세요.

export DD_TRACE_SAMPLE_RATE=0.1
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5}]'

환경 변수 DD_TRACE_RATE_LIMIT를 서비스 인스턴스당 최대 초당 트레이스 수로 설정하여 속도 제한을 구성하세요. DD_TRACE_RATE_LIMIT 값을 설정하지 않으면 초당 트레이스 100개의 제한이 적용됩니다.

샘플링 제어에 관한 자세한 내용은 Ruby SDK 문서를 참조하세요.

Remote Configuration

Go 애플리케이션에서는 버전 1.64.0부터 서비스 및 리소스별 샘플링 속도를 Ingestion Control 페이지 UI에서 설정하세요.

서비스 및 리소스별로 샘플링 속도를 원격으로 구성하는 방법에 관한 자세한 내용은 이 문서를 참조하세요.

참고: 원격으로 설정된 구성이 로컬 구성보다 우선합니다.

로컬 구성

Go 애플리케이션에서는 DD_TRACE_SAMPLING_RULES 환경 변수를 사용해 서비스 및 리소스별(리소스별 샘플링의 경우 버전 v1.60.0부터) 샘플링 속도를 설정하세요.

예를 들어, 서비스 my-service에서 리소스 GET /checkout의 트레이스를 100% 캡처하고, 다른 엔드포인트의 트레이스를 20% 캡처하려면 다음과 같이 설정하세요.

export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource": "GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'

환경 변수 DD_TRACE_RATE_LIMIT를 서비스 인스턴스당 최대 초당 트레이스 수로 설정하여 속도 제한을 구성하세요. DD_TRACE_RATE_LIMIT 값을 설정하지 않으면 초당 트레이스 100개의 제한이 적용됩니다.

참고: DD_TRACE_SAMPLE_RATE는 지원이 중단되었습니다. 대신 DD_TRACE_SAMPLING_RULES를 사용하세요. 예를 들어, 이미 DD_TRACE_SAMPLE_RATE를 0.1로 설정한 경우, 대신 DD_TRACE_SAMPLING_RULES를 [{"sample_rate":0.1}]로 설정하세요.

샘플링 제어에 관한 자세한 내용은 Go SDK 문서를 참조하세요.

Remote Configuration

Node.js 애플리케이션에서는 버전 5.16.0부터 서비스 및 리소스별 샘플링 속도를 Ingestion Control 페이지 UI에서 설정하세요.

서비스 및 리소스별로 샘플링 속도를 원격으로 구성하는 방법에 관한 자세한 내용은 리소스 기반 샘플링 가이드를 참조하세요.

참고: 원격으로 설정된 구성이 로컬 구성보다 우선합니다.

로컬 구성

Node.js 애플리케이션에서는 DD_TRACE_SAMPLE_RATE 환경 변수를 사용해 라이브러리의 전역 샘플링 속도를 설정하세요.

서비스별 샘플링 속도도 설정할 수 있습니다. 예를 들어 이름이 my-service인 서비스의 트레이스는 50%, 나머지 트레이스는 10% 전송하려면 다음과 같이 설정하세요.

tracer.init({
    ingestion: {
        sampler: {
            sampleRate: 0.1,
            rules: [
                { sampleRate: 0.5, service: 'my-service' }
            ]
        }
    }
});

환경 변수 DD_TRACE_RATE_LIMIT를 서비스 인스턴스당 최대 초당 트레이스 수로 설정하여 속도 제한을 구성하세요. DD_TRACE_RATE_LIMIT 값을 설정하지 않으면 초당 트레이스 100개의 제한이 적용됩니다.

샘플링 제어에 관한 자세한 내용은 Node.js SDK 문서를 참조하세요.

Remote Configuration

PHP 애플리케이션에서는 버전 1.4.0부터 서비스 및 리소스별 샘플링 속도를 Ingestion Control 페이지에서 설정하세요.

서비스 및 리소스별로 샘플링 속도를 원격으로 구성하는 방법에 관한 자세한 내용은 리소스 기반 샘플링 가이드를 참조하세요.

참고: 원격으로 설정된 구성이 로컬 구성보다 우선합니다.

로컬 구성

PHP 애플리케이션에서는 DD_TRACE_SAMPLE_RATE 환경 변수를 사용해 라이브러리의 전역 샘플링 속도를 설정하세요. DD_TRACE_SAMPLING_RULES 환경 변수를 사용하여 서비스별로 샘플링 속도를 설정하세요.

예를 들어 이름이 my-service인 서비스의 트레이스는 50%, 다른 엔드포인트의 트레이스 20%, 나머지 트레이스는 10% 전송하려면 다음과 같이 설정하세요.

export DD_TRACE_SAMPLE_RATE=0.1
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "resource":"GET /checkout", "sample_rate": 1},{"service": "my-service", "sample_rate": 0.2}]'

샘플링 제어에 관한 자세한 내용은 PHP SDK 문서를 참조하세요.

Remote Configuration

C++ 애플리케이션에서는 버전 0.2.2부터 서비스 및 리소스별 샘플링 속도를 Ingestion Control 페이지 UI에서 설정하세요.

서비스 및 리소스별로 샘플링 속도를 원격으로 구성하는 방법에 관한 자세한 내용은 리소스 기반 샘플링 가이드를 참조하세요.

참고: 원격으로 설정된 구성이 로컬 구성보다 우선합니다.

로컬 구성 Datadog C++ 라이브러리는 v0.1.0부터 다음 구성을 지원합니다.

• 전역 샘플링 속도: DD_TRACE_SAMPLE_RATE 환경 변수
• 서비스별 샘플링 속도: DD_TRACE_SAMPLING_RULES 환경 변수
• 속도 제한 설정: DD_TRACE_RATE_LIMIT 환경 변수

예를 들어 이름이 my-service인 서비스의 트레이스는 50%, 나머지 트레이스는 10% 전송하려면 다음과 같이 설정하세요.

export DD_TRACE_SAMPLE_RATE=0.1
export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5}]'

C++은 자동 계측을 위한 통합 기능을 제공하지 않지만, Envoy, NGINX, Istio와 같은 프록시 트레이싱에 사용됩니다. 프록시에 대한 샘플링을 구성하는 방법에 관한 자세한 내용은 프록시 트레이싱을 참조하세요.

로컬 구성

Rust 애플리케이션에서는 DD_TRACE_SAMPLING_RULES 환경 변수를 사용하여 서비스별 샘플링 속도를 설정하세요.

예를 들어 이름이 my-service인 서비스의 트레이스는 50%, 나머지 트레이스는 10% 전송하려면 다음과 같이 설정하세요.

export DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5},{"sample_rate": 0.1}]'

환경 변수 DD_TRACE_RATE_LIMIT를 서비스 인스턴스당 최대 초당 트레이스 수로 설정하여 속도 제한을 구성하세요. DD_TRACE_RATE_LIMIT 값을 설정하지 않으면 초당 트레이스 100개의 제한이 적용됩니다.

샘플링 제어에 관한 자세한 내용은 Rust SDK 문서를 참조하세요.

.NET 애플리케이션에서는 DD_TRACE_SAMPLE_RATE 환경 변수를 사용해 라이브러리의 전역 샘플링 속도를 설정하세요. DD_TRACE_SAMPLING_RULES 환경 변수를 사용하여 서비스별로 샘플링 속도를 설정하세요.

예를 들어 이름이 my-service인 서비스의 트레이스는 50%, 나머지 트레이스는 10% 전송하려면 다음과 같이 설정하세요.

#using powershell
$env:DD_TRACE_SAMPLE_RATE=0.1
$env:DD_TRACE_SAMPLING_RULES='[{"service": "my-service", "sample_rate": 0.5}]'

#using JSON file   
{
    "DD_TRACE_SAMPLE_RATE": "0.1",
    "DD_TRACE_SAMPLING_RULES": "[{\"service\": \"my-service\", \"resource\": \"GET /checkout\", \"sample_rate\": 0.5}]"
}

환경 변수 DD_TRACE_RATE_LIMIT를 서비스 인스턴스당 최대 초당 트레이스 수로 설정하여 속도 제한을 구성하세요. DD_TRACE_RATE_LIMIT 값을 설정하지 않으면 초당 트레이스 100개의 제한이 적용됩니다.

샘플링 제어에 관한 자세한 내용은 .NET SDK 문서를 참조하세요.
.NET 환경 변수 구성에 관해 자세히 알아보세요.

SDK 버전 1.7.0부터 Java 애플리케이션에서는 DD_SPAN_SAMPLING_RULES 환경 변수를 사용하여 서비스 및 작업 이름별 스팬 샘플링 규칙을 설정하세요.

예를 들어, 이름이 my-service인 서비스에서 http.request 작업의 스팬을 100% 수집하되, 초당 최대 50개까지 수집하려면 다음과 같이 설정하세요.

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

샘플링 제어에 관한 자세한 내용은 Java SDK 문서를 참조하세요.

버전 v1.4.0부터 Python 애플리케이션에서는 DD_SPAN_SAMPLING_RULES 환경 변수를 사용하여 서비스별 및 작업 이름별 스팬 샘플링 규칙을 설정하세요.

예를 들어, 이름이 my-service인 서비스에서 http.request 작업의 스팬을 100% 수집하되, 초당 최대 50개까지 수집하려면 다음과 같이 설정하세요.

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

샘플링 제어에 관한 자세한 내용은 Python SDK 문서를 참조하세요.

버전 v1.5.0부터 Ruby 애플리케이션에서는 DD_SPAN_SAMPLING_RULES 환경 변수를 사용하여 서비스 및 작업 이름별 스팬 샘플링 규칙을 설정하세요.

예를 들어, 이름이 my-service인 서비스에서 http.request 작업의 스팬을 100% 수집하되, 초당 최대 50개까지 수집하려면 다음과 같이 설정하세요.

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

샘플링 제어에 관한 자세한 내용은 Ruby SDK 문서를 참조하세요.

버전 v1.41.0부터 Go 애플리케이션에서는 DD_SPAN_SAMPLING_RULES 환경 변수를 사용하여 서비스 및 작업 이름별 스팬 샘플링 규칙을 설정하세요.

예를 들어, 이름이 my-service인 서비스에서 http.request 작업의 스팬을 100% 수집하되, 초당 최대 50개까지 수집하려면 다음과 같이 설정하세요.

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

버전 v1.60.0부터 Go 애플리케이션에서는 DD_SPAN_SAMPLING_RULES 환경 변수를 사용하여 리소스 및 태그별 스팬 샘플링 규칙을 설정하세요.

예를 들어, 서비스에서 리소스가 POST /api/create_issue이고 태그 priority의 값이 high인 스팬을 100% 수집하려면 다음과 같이 설정하세요.

@env DD_SPAN_SAMPLING_RULES=[{"resource": "POST /api/create_issue", "tags": { "priority":"high" }, "sample_rate":1.0}]

샘플링 제어에 관한 자세한 내용은 Go SDK 문서를 참조하세요.

Node.js 애플리케이션에서는 DD_SPAN_SAMPLING_RULES 환경 변수를 사용하여 서비스 및 작업 이름별 스팬 샘플링 규칙을 설정하세요.

예를 들어, 이름이 my-service인 서비스에서 http.request 작업의 스팬을 100% 수집하되, 초당 최대 50개까지 수집하려면 다음과 같이 설정하세요.

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

샘플링 제어에 관한 자세한 내용은 Node.js SDK 문서를 참조하세요.

버전 v0.77.0부터 PHP 애플리케이션에서는 DD_SPAN_SAMPLING_RULES 환경 변수를 사용하여 서비스 및 작업 이름별 스팬 샘플링 규칙을 설정하세요.

예를 들어, 이름이 my-service인 서비스에서 http.request 작업의 스팬을 100% 수집하되, 초당 최대 50개까지 수집하려면 다음과 같이 설정하세요.

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

샘플링 제어에 관한 자세한 내용은 PHP SDK 문서를 참조하세요.

버전 v0.1.0부터 C++ 애플리케이션에서는 DD_SPAN_SAMPLING_RULES 환경 변수를 사용하여 서비스 및 작업 이름별 스팬 샘플링 규칙을 설정하세요.

예를 들어, 이름이 my-service인 서비스에서 http.request 작업의 스팬을 100% 수집하되, 초당 최대 50개까지 수집하려면 다음과 같이 설정하세요.

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

Rust 애플리케이션에서는 DD_SPAN_SAMPLING_RULES 환경 변수를 사용하여 서비스 및 작업 이름별 스팬 샘플링 규칙을 설정하세요.

예를 들어, 이름이 my-service인 서비스에서 http.request 작업의 스팬을 100% 수집하되, 초당 최대 50개까지 수집하려면 다음과 같이 설정하세요.

@env DD_SPAN_SAMPLING_RULES=[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]

버전 v2.18.0부터 .NET 애플리케이션에서는 DD_SPAN_SAMPLING_RULES 환경 변수를 사용하여 서비스 및 작업 이름별 스팬 샘플링 규칙을 설정하세요.

예를 들어, 이름이 my-service인 서비스에서 http.request 작업의 스팬을 100% 수집하되, 초당 최대 50개까지 수집하려면 다음과 같이 설정하세요.

#using powershell
$env:DD_SPAN_SAMPLING_RULES='[{"service": "my-service", "name": "http.request", "sample_rate":1.0, "max_per_second": 50}]'

#using JSON file   
{
    "DD_SPAN_SAMPLING_RULES": "[{\"service\": \"my-service\", \"name\": \"http.request\", \"sample_rate\": 1.0, \"max_per_second\": 50}]"
}

샘플링 제어에 관한 자세한 내용은 .NET SDK 문서를 참조하세요.