개요

런타임 메트릭은 애플리케이션의 메모리 사용량, 가비지 컬렉션 및 병렬화를 모니터링합니다. Datadog SDK는 지원되는 환경에서 이러한 메트릭을 자동으로 수집하며 Datadog Agent로 전송합니다.

이 메트릭은 병목 현상을 식별하고 성능 문제를 해결하며 리소스 사용을 최적화하는 데 도움을 줍니다. 트레이스 및 로그와 함께 런타임 메트릭을 확인하면 애플리케이션 상태와 성능에 대한 종합적인 가시성을 확보할 수 있습니다.

Datadog 트레이싱 라이브러리 대신 OpenTelemetry를 사용하는 경우 OpenTelemetry 런타임 메트릭을 참조하여 설정하세요.

호환성

런타임 메트릭은 여러 프로그래밍 언어와 런타임에서 사용할 수 있으며, 지원 및 구성 옵션의 수준이 다릅니다.

net localgroup "Performance Monitor Users" "IIS APPPOOL\DefaultAppPool" /add

설정 지침

런타임 메트릭을 설정하려면 Datadog Agent와 애플리케이션을 모두 구성해야 합니다.

1. Datadog Agent 구성

Agent에서 DogStatsD를 활성화합니다. 기본적으로 Datadog Agent는 포트 8125를 통해 메트릭을 수집하도록 구성되어 있습니다.

컨테이너 전용 구성

컨테이너화된 환경에서 Datadog Agent를 실행할 때 추가 구성이 필요합니다.

1. DogStatsD 비로컬 트래픽이 활성화되어 있는지 확인합니다. 이 설정은 기본적으로 활성화되어 있습니다. 이전에 비활성화한 경우, 주 datadog.yaml 구성 파일에서 dogstatsd_non_local_traffic: true를 설정하거나 환경 변수 DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true를 설정합니다.
2. 다음의 컨테이너 전용 설정 지침을 따릅니다.

3. Datadog Agent의 DD_SITE를 로 설정하여 Agent가 데이터를 올바른 Datadog 위치에 전송되도록 보장합니다.

2. 애플리케이션 구성

환경 변수를 사용하여 애플리케이션에서 런타임 메트릭을 구성합니다. 일부 언어는 코드에서 직접 런타임 메트릭을 구성하는 것도 지원합니다.

환경 변수

다음 환경 변수를 사용하여 애플리케이션에서 런타임 메트릭을 구성합니다.

DD_RUNTIME_METRICS_ENABLED

기본값: Java 및 .NET 6 이상(v3.40.0 이상)인 경우 true, 다른 모든 언어 및 런타임의 경우 false.
설명: 런타임 메트릭 수집을 활성화합니다. 메트릭은 계측된 애플리케이션에 대해 구성된 대로 Datadog Agent로 전송됩니다.

DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED

기본값: Java의 경우 true, Node.js, Ruby 및 Python의 경우 false. .NET 및 Go에는 존재하지 않으며, runtime_id가 항상 보고됩니다.
설명: 향상된 런타임 메트릭을 활성화하여 모든 메트릭과 함께 runtime_id 태그를 제공합니다. runtime_id가 애플리케이션의 프로세스 식별자를 나타내며, 런타임 메트릭을 개별 실행 중인 애플리케이션과 직접 연관시킬 수 있습니다.

DD_AGENT_HOST

기본값: localhost
설명: SDK의 메트릭 제출을 위한 호스트 주소를 설정합니다. 호스트 이름 또는 IP 주소일 수 있습니다.

DD_DOGSTATSD_PORT

기본값: 8125
설명: SDK의 메트릭 제출을 위한 포트를 설정합니다.

DD_RUNTIME_METRICS_DIAGNOSTICS_METRICS_API_ENABLED

기본값: .NET 8 이상에서 tracer v3.40.0 이상이면(그리고 NET 6/7에서 DD_RUNTIME_METRICS_ENABLED가 명시적으로 설정되지 않은 경우) true, 그 외는 false
설명: .NET 6부터 사용할 수 있는 설정입니다. .NET 트레이서가 System.Diagnostics.Metrics API를 사용하여 메트릭을 수집할지, 아니면 EventListener 기반 컬렉터를 사용할지를 제어합니다.

코드 기반 구성

환경 변수 외에도 일부 언어는 코드에서 직접 런타임 메트릭을 구성하는 것을 지원합니다.

from ddtrace.runtime import RuntimeMetrics
RuntimeMetrics.enable()

# config/initializers/datadog.rb
require 'datadog/statsd'
require 'datadog' # Use 'ddtrace' if you're using v1.x

Datadog.configure do |c|
  c.runtime_metrics.enabled = true

  # Optionally, you can configure the DogStatsD instance used for sending runtime metrics.
  # DogStatsD is automatically configured with default settings if `dogstatsd-ruby` is available.
  # You can configure with host and port of Datadog agent; defaults to 'localhost:8125'.
  c.runtime_metrics.statsd = Datadog::Statsd.new
end

// Basic configuration
tracer.Start(tracer.WithRuntimeMetrics())

// With custom DogStatsD address
tracer.Start(
  tracer.WithRuntimeMetrics(),
  tracer.WithDogstatsdAddr("custom-host:8125")
)

const tracer = require('dd-trace').init({
  // Other tracer options...
  runtimeMetrics: true
})

대시보드

설정이 완료되면 런타임 메트릭을 볼 수 있습니다.

• 계측된 서비스의 세부 정보 페이지
• 플레임 그래프의 Metrics 탭
• 기본 런타임 대시보드

문제 해결

• 플레임 그래프 내에서 런타임 메트릭을 연결하려면 env 태그(대소문자 구분)가 설정되어 있고 환경과 일치하는지 확인하세요.
• Fargate를 사용할 때 서비스 페이지에 런타임 메트릭이 표시되도록 하려면 DD_DOGSTATSD_TAGS가 Agent 작업에 설정되어 있고 구성된 env 태그가 계측된 서비스의 env와 일치하는지 확인하세요.

수집된 데이터

지원되는 각 언어는 메모리 사용량, 가비지 컬렉션, CPU 사용률 및 기타 성능 지표에 대한 인사이트를 제공하는 런타임 메트릭 세트를 수집합니다.

jvm.gc.cms.count   => jvm.gc.minor_collection_count
                      jvm.gc.major_collection_count
jvm.gc.parnew.time => jvm.gc.minor_collection_time
                      jvm.gc.major_collection_time

추가 자료

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

OpenTelemetry 런타임 메트릭설명서 로그와 트레이스 상호 연결설명서 애플리케이션을 수동으로 계측하여 트레이스를 생성합니다.설명서 서비스, 리소스, 트레이스 둘러보기설명서