뉴렐릭 에이전트의 OpenTelemetry API 지원

전제 조건

필수 OpenTelemetry 의존성/종속성을 제작에 추가하세요.

implementation(platform("io.opentelemetry:opentelemetry-bom:1.44.1"))
implementation("io.opentelemetry:opentelemetry-sdk-extension-autoconfigure")
implementation("io.opentelemetry:opentelemetry-exporter-otlp")

OpenTelemetry API 지원을 활성화합니다.

1. OpenTelemetry SDK 자동 구성을 활성화합니다.

다음 방법 중 하나를 사용하십시오.

시스템 속성:

$
-Dotel.java.global-autoconfigure.enabled=true

환경 변수:

$
export OTEL_JAVA_GLOBAL_AUTOCONFIGURE_ENABLED=true

2. 뉴럴릭 OpenTelemetry 지원 활성화

시스템 속성:

$
-Dnewrelic.config.opentelemetry.enabled=true

환경 변수:

$
NEW_RELIC_OPENTELEMETRY_ENABLED=true

YAML 설정(newrelic.yml):

opentelemetry:
  enabled: true

지원되는 측정, 로그 유형

수동 계측

OpenTelemetry 트레이스, 지표 또는 로그 API를 사용하는 사용자 정의 측정은 에이전트에 의해 자동으로 캡처됩니다.

라이브러리 및 네이티브 측정, 로그

OpenTelemetry 독립 실행형 측정 라이브러리, 리소스 및 네이티브 측정 리소스, 라이브러리에 직접 내장되어 뉴렐릭 에이전트와 함께 작동합니다. 하지만 OpenTelemetry 바이트코드 기반 자동 측정, 자동 리소스는 뉴렐릭 에이전트에 의해 감지되지 않습니다.

OpenTelemetry API 지원을 활성화합니다.

newrelic.js 설정 파일에서 OpenTelemetry API 지원을 활성화하세요.

exports.config = {
  // ... other config
  opentelemetry: {
    enabled: true,
    traces: {
      enabled: true
    }
  }
  // ... other config
}

지원되는 OpenTelemetry API

OpenTelemetry 지원이 활성화되면 Node.js 에이전트는 다음을 완벽하게 지원합니다.

트레이스 API

OpenTelemetry Tracing API를 사용하여 사용자 지정 스팬을 생성하고 속성을 추가합니다. OpenTelemetry Node.js 추적 예제를 참조하세요.

메트릭 API

지표 API는 Node.js 고객에게 API 유용한 기능입니다. 이는 자주 요청되었던 기능인 차원 메트릭을 포함하도록 메트릭 수집 기능을 확장합니다.

OpenTelemetry 지표 API 사용하여 사용자 정의 지표를 기록합니다. OpenTelemetry Node.js 메트릭 예제를 참조하세요.

로그 API

JavaScript OpenTelemetry 로그 API 아직 개발 중이지만 Node.js 에이전트가 이를 지원합니다. API 사용하여 뉴렐릭으로 전송될 로그를 생성할 수 있습니다.

OpenTelemetry Node.js 로그 예제를 참조하세요.

지원되는 측정, 로그 유형

수동 측정, 로그(권장)

OpenTelemetry API 사용하여 인력을 추가하는 고객은 에이전트가 해당 데이터를 올바르게 처리하고 배송한다는 것을 알게 될 것입니다.

네이티브 및 라이브러리 측정, 로그(제한적)

OpenTelemetry 측정 측정 목록은 Node.js 에이전트의 지원 모듈과 상당히 중복됩니다. 아직 뉴렐릭 에이전트 측정에서 다루지 않은 로그는 다음과 같습니다.

• 에이전트 내부와의 충돌
• 고객 수요가 충분하지 않습니다.

알려진 제한 사항

• 자동 측정, 도구 없음: 에이전트는 OpenTelemetry 측정, 로그를 자동으로 활성화하지 않습니다. 고객은 OpenTelemetry API를 사용하여 코드를 수동으로 업로드해야 합니다.

OpenTelemetry API 지원을 활성화합니다.

환경 변수 또는 newrelic.config XML 설정 파일을 사용하여 OpenTelemetry API 지원을 활성화하십시오.

환경 변수 사용:

$
NEW_RELIC_OPENTELEMETRY_ENABLED=true

newrelic.config 사용:

<configuration>
  <openTelemetry enabled="true" />
</configuration>

지원되는 네이티브 측정, 로그

OpenTelemetry API 지원을 활성화하면 .NET 에이전트는 OpenTelemetry-계측팀에서 텔레메트리를 캡처할 수 있습니다.

트레이스 측정, 실행

에이전트는 네이티브 OpenTelemetry 추적 측정, 리소스를 지원합니다. OpenTelemetry Tracing API 사용하여 작성된 맞춤형 측정도 지원됩니다.

측정값, 사용률

지표가 활성화되면 에이전트는 OpenTelemetry 메트릭 측정, 라이브러리 및 프레임워크를 지원합니다. OpenTelemetry 지표 API 사용하여 작성된 맞춤형 측정도 지원됩니다.

로그 측정, 사용

.NET 에이전트는 이미 로그 데이터용 OpenTelemetry API 된 로깅 라이브러리를 포함하고 있습니다. OpenTelemetry API 지원을 활성화할 때 로그를 변경할 필요는 없습니다. 이전 버전과의 호환성을 위해, 로그아웃, 로그아웃은 이전과 같이 계속 작동합니다.

OpenTelemetry API 지원을 활성화합니다.

newrelic.ini 설정 파일 또는 환경 변수를 사용하여 OpenTelemetry API 지원을 활성화하세요.

newrelic.ini 사용:

[newrelic]
opentelemetry.enabled = true

환경 변수 사용:

$
NEW_RELIC_OPENTELEMETRY_ENABLED=true

작동 원리

OpenTelemetry 지원이 활성화되고 에이전트가 opentelemetry-api 설치되어 있음을 감지하면 다음과 같습니다.

1. 네이티브 측정, 리소스: 네이티브 OpenTelemetry 측정, 리소스가 내장된 라이브러리의 경우 에이전트는 자동으로 뉴렐릭 후크를 비활성화하고 대신 네이티브 OpenTelemetry 측정, 리소스를 사용합니다.

2. 측정, 리소스: OpenTelemetry 측정, 리소스 라이브러리가 감지되면 에이전트는 뉴렐릭의 측정, 리소스 후크 대신 자동으로 OpenTelemetry 측정 라이브러리를 사용합니다.

현재 사용 가능한 수축 수축, 리소스 목록은 공식 OpenTelemetry 수축 수축, 리소스 목록을 참조하세요.

수동 계측

OpenTelemetry Tracing API 사용하여 작성된 모든 맞춤형 측정은 에이전트에 의해 캡처됩니다.

예시:

from opentelemetry import trace

tracer = trace.get_tracer(__name__)

with tracer.start_as_current_span("my-custom-span") as span:
    span.set_attribute("custom.attribute", "value")
    # Your code here

지원되는 기능

트레이스 API

✅ 완벽 지원: OpenTelemetry Tracing API를 사용하여 사용자 지정 스팬을 생성하고 속성을 추가할 수 있습니다.

메트릭 API

❌ 아직 지원되지 않음: 끌어당김 에이전트에서는 OpenTelemetry 지표 API 활성화되지 않습니다.

로그 API

✅ 이미 작동함: 에이전트가 이미 로깅 모듈을 지원합니다. 파이썬용 OpenTelemetry 로깅 API는 존재하지 않습니다(SDK만 있습니다). OpenTelemetry에서 로깅을 위해 설정하는 것은 로깅 활성화 여부와 데이터를 전송할 엔드포인트입니다.

작동 원리

OpenTelemetry 지원이 활성화된 경우:

1. 에이전트는 시스템을 검색하여 OpenTelemetry 측정, 로그 라이브러리가 설치되어 있는지 확인합니다.
2. 자동 전환: 에이전트가 발견되면 뉴렐릭 후크 대신 OpenTelemetry 라이브러리의 측정, 로그를 사용합니다.
3. 원활한 통합: OpenTelemetry 스팬이 블루렐릭 트레이스에 통합되었습니다.

알려진 제한 사항

• 지원되지 않음: OpenTelemetry API 아직 활성화되지 않았습니다.
• 일부 AWS 및 gRPC 라이브러리 제외: 계속해서 뉴렐릭 측정, 로그를 사용할 예정입니다.
• AI 라이브러리 비활성화됨: 현재 AI 라이브러리에 대한 네이티브 OpenTelemetry 측정, 로그가 비활성화되어 있습니다.
• 포함/제외 설정: 세부 조정 옵션은 향후 릴리스에서 제공될 예정이며, 현재는 활성화/비활성화 기능만 작동합니다.

OpenTelemetry API 지원을 활성화합니다.

루비 에이전트에서 OpenTelemetry API 지원을 활성화하려면 newrelic.yml 설정 파일에 다음을 추가하세요.

opentelemetry:
  enabled: true

또는 환경 변수를 설정하세요.

$
NEW_RELIC_OPENTELEMETRY_ENABLED=true

수동 계측

OpenTelemetry Tracing API 사용하여 작성된 모든 맞춤형 측정은 에이전트에 의해 캡처됩니다.

예시:

require 'opentelemetry'

APP_TRACER = OpenTelemetry.tracer_provider.tracer('my-app', '1.0.0')

APP_TRACER.in_span("my-custom-span") do |span|
  span.set_attribute("test.attribute", "value")
  # Your code here
end

지원되는 기능

트레이스 API

✅ 지원됨: OpenTelemetry Tracing API를 사용하여 사용자 지정 스팬을 생성하고 속성을 추가할 수 있습니다.

메트릭 API

❌ 지원되지 않음: OpenTelemetry API

로그 API

❌ 지원되지 않음: OpenTelemetry 로그 API

스팬 링크

❌ 지원되지 않음: 스팬 링크

Spans의 이벤트

❌ 지원되지 않음: 스팬의 이벤트

작동 원리

OpenTelemetry 지원이 활성화되면 뉴렐릭 루비 에이전트는 다음을 수행합니다.

1. OpenTelemetry 추적 API에 대한 호출을 수신합니다.
2. 해당 호출을 뉴럴릭 데이터 모델로 변환합니다.
3. OpenTelemetry 범위를 블루렐릭 트레이스에 통합합니다.

알려진 제한 사항

• API 지원 제한: 이번 릴리스에서는 TRAS API 만 지원됩니다.
• 지표 및 기록: 해당사항 없음
• Span 링크 및 이벤트: 현재 지원되지 않습니다.

OpenTelemetry 지원이 활성화되어 있는지 확인하려면 에이전트 설정을 확인하세요.

• 환경 변수 또는 설정 파일을 검토하세요.
• OpenTelemetry 지원이 활성화되었는지 확인하려면 에이전트 로그를 확인하십시오.
• 설정을 변경한 후에는 애플리케이션을 다시 시작했는지 확인하십시오.

OpenTelemetry API를 지원하는 최소 필수 에이전트 버전이 실행 중인지 확인하십시오. 위의 지원 언어 표를 참조하십시오.