자바 에이전트 OpenTelemetry 설정

OpenTelemetry 설정은 OpenTelemetry 계측과의 에이전트 통합 및 OTLP 데이터 내보내기를 구성합니다.

팁

전체 설정 인덱스로 돌아가기: 자바 에이전트 설정

오픈 텔레메트리

자바 에이전트 버전 9.1.0부터는 OpenTelemetry Tracing, 메트릭 및 로그 API 호환성이 추가되어, 뉴렐릭의 심층적인 가시성과 OpenTelemetry 신호의 이점을 두루 활용할 수 있습니다.

이 기능을 사용하면, 뉴렐릭 자바 에이전트 API와 OpenTelemetry Tracing, 메트릭 및 로그 API를 결합하여 애플리케이션을 바로 원하는 대로 계측할 수 있습니다. 자바 에이전트는 이 모든 것을 익숙한 APM 환경으로 결합해줍니다. 또한 OpenTelemetry 네이티브를 지원하는 라이브러리나 독립 실행형 라이브러리를 사용하여 애플리케이션에 대해 더 나은 가시성을 확보할 수 있습니다.

다음은 어떤 OpenTelemetry 신호를 포착해 뉴렐릭 APM 환경에 통합할지 결정하는 설정 옵션입니다.

opentelemetry:
    enabled: false
    logs:
      enabled: true
    metrics:
      enabled: true
      include: "MeterName1,MeterName2"
      exclude: "MeterName3,MeterName4"
    traces:
      enabled: true
      include: "TracerName1,TracerName2"
      exclude: "TracerName3,TracerName4"

유형	부울
기본값	`false`

개별 OpenTelemetry 신호를 활성화하려면 true로 설정하고, 모든 OpenTelemetry 신호를 비활성화하려면 false로 설정합니다. 기본값은 false입니다.

시스템 속성을 통해 설정할 수 있습니다.

-Dnewrelic.config.opentelemetry.enabled=false

환경 변수를 통해 설정 가능:

NEW_RELIC_OPENTELEMETRY_ENABLED

유형	부울
기본값	`true`

opentelemetry.enabled=true일 때 OpenTelemetry 로그 신호를 활성화하려면 true로 설정합니다. 기본값은 true입니다.

시스템 속성을 통해 설정할 수 있습니다.

-Dnewrelic.config.opentelemetry.logs.enabled=true

환경 변수를 통해 설정 가능:

NEW_RELIC_OPENTELEMETRY_LOGS_ENABLED

유형	부울
기본값	`true`

opentelemetry.enabled=true일 때 OpenTelemetry 신호를 활성화하려면 true로 설정합니다. 기본값은 true입니다.

시스템 속성을 통해 설정할 수 있습니다.

-Dnewrelic.config.opentelemetry.metrics.enabled=true

환경 변수를 통해 설정 가능:

NEW_RELIC_OPENTELEMETRY_METRICS_ENABLED

유형	문자열
기본값	(없음)

쉼표로 구분된 OpenTelemetry 미터 문자열(예: "MeterName1,MeterName2")로 그 신호가 포함됩니다. 기본적으로 모든 미터가 포함됩니다. 이렇게 하면 에이전트의 기본 미터 제외 설정이 재정의되어 미터가 다시 활성화됩니다.

기본 값은 빈 문자열입니다.

시스템 속성을 통해 설정할 수 있습니다.

-Dnewrelic.config.opentelemetry.metrics.include=MeterName1,MeterName2

환경 변수를 통해 설정 가능:

NEW_RELIC_OPENTELEMETRY_METRICS_INCLUDE

유형	문자열
기본값	(없음)

쉼표로 구분된 OpenTelemetry 미터 문자열(예: "MeterName3,MeterName4")로, 그 신호가 제외됩니다. 이는 다른 모든 포함/제외 소스보다 우선순위가 높으므로, 사실상 나열된 미터가 비활성화됩니다.

기본 값은 빈 문자열입니다.

시스템 속성을 통해 설정할 수 있습니다.

-Dnewrelic.config.opentelemetry.metrics.exclude=MeterName3,MeterName4

환경 변수를 통해 설정 가능:

NEW_RELIC_OPENTELEMETRY_METRICS_EXCLUDE

유형	부울
기본값	`true`

opentelemetry.enabled=true일 때 OpenTelemetry 트레이스 신호를 활성화하려면 true로 설정합니다. 기본값은 true입니다.

시스템 속성을 통해 설정할 수 있습니다.

-Dnewrelic.config.opentelemetry.traces.enabled=true

환경 변수를 통해 설정 가능:

NEW_RELIC_OPENTELEMETRY_TRACES_ENABLED

유형	문자열
기본값	(없음)

OpenTelemetry 트레이서의 쉼표로 구분된 문자열(예: "TracerName1,TracerName2")로 그 신호가 포함됩니다. 기본적으로 모든 트레이서가 포함됩니다. 이렇게 하면 에이전트의 기본 트레이서 제외 설정이 재정의되어 트레이서가 다시 활성화됩니다.

기본 값은 빈 문자열입니다.

시스템 속성을 통해 설정할 수 있습니다.

-Dnewrelic.config.opentelemetry.traces.include=TracerName1,TracerName2

환경 변수를 통해 설정 가능:

NEW_RELIC_OPENTELEMETRY_TRACES_INCLUDE

유형	문자열
기본값	(없음)

OpenTelemetry 트레이서의 쉼표로 구분된 문자열(예: "TracerName3,TracerName4")로 그 신호가 제외됩니다. 이는 다른 모든 포함/제외 소스보다 우선순위가 높으므로, 나열된 트레이서가 사실상 비활성화됩니다.

기본 값은 빈 문자열입니다.

시스템 속성을 통해 설정할 수 있습니다.

-Dnewrelic.config.opentelemetry.traces.exclude=TracerName3,TracerName4

환경 변수를 통해 설정 가능:

NEW_RELIC_OPENTELEMETRY_TRACES_EXCLUDE

사용자의 편의를 위해 제공되는 기계 번역입니다.

자바 에이전트 OpenTelemetry 설정

팁

오픈 텔레메트리 .css-21sua1{background:none;border:none;width:0;padding:0;}

logs.enabled

metrics.enabled

metrics.include

metrics.exclude

traces.enabled

traces.include

traces.exclude

오픈 텔레메트리