이 문서에서는 다음과 같이 널리 사용되는 비동기 프레임워크에서 Java 에이전트 계측을 비활성화하는 방법을 설명합니다.
- 스칼라
- 네티
- 아카
- 플레이 2
보고된 메트릭이 귀하에게 가치가 없다고 판단되거나 계측이 원하는 것보다 더 많은 오버헤드를 발생시키는 경우 이 계측의 일부 또는 전체를 비활성화하도록 선택할 수 있습니다. 일부 계측을 선택적으로 비활성화하면 활동의 일부 세그먼트가 보고되지 않고 총 시간이 과소 평가됩니다.
Java 에이전트 버전 3.21 이하
저항 에이전트 버전 3.22 이하를 사용하는 경우 newrelic.yml 설정의 class_transformer
섹션에 다음을 추가하세요.
# This section is for settings common to all environments.# Do not add anything above this next line.common: &default_settings
class_transformer: akka_instrumentation: enabled: false netty_instrumenation: enabled: false play2_instrumentation: enabled: false scala_instrumentation: enabled: false
Java 에이전트 버전 3.22 이상
이전 Scala, Netty, Akka 및 Play 2 프레임워크 기능 설정 이름은 포커스 에이전트 버전 3.22에서 더 이상 사용되지 않습니다. 해상 에이전트 3.22 이상을 사용하는 경우 newrelic.yml 설정의 class_transformer
섹션에 다음을 추가하세요.
common: &default_settings
class_transformer: # Disable all Akka instrumentations com.newrelic.instrumentation.akka-2.0: enabled: false com.newrelic.instrumentation.akka-2.1: enabled: false # Disabling 2.2 also disables higher versions com.newrelic.instrumentation.akka-2.2: enabled: false
# Disable all Netty instrumentations com.newrelic.instrumentation.netty-3.4: enabled: false com.newrelic.instrumentation.netty-3.8: enabled: false com.newrelic.instrumentation.netty-4.0.0: enabled: false com.newrelic.instrumentation.netty-4.0.8: enabled: false
# Disable all Play 2 instrumentations com.newrelic.instrumentation.play-2.1: enabled: false com.newrelic.instrumentation.play-2.2: enabled: false com.newrelic.instrumentation.play-2.3: enabled: false # New in Release 3.22, the Play 2.4 instrumentation does not respect # the older play2_instrumentation configuration setting com.newrelic.instrumentation.play-2.4: enabled: false
# Disable all Scala-language instrumentations com.newrelic.instrumentation.scala-2.9.3: enabled: false
3.22 이전 계측 이름은 한동안 존중되지만 향후 릴리스에서 제거됩니다. 이전 또는 새 계측 구성에 의해 비활성화된 경우 계측이 비활성화됩니다.
더 이상 사용되지 않는 구성 설정 확인
3.22 이전 계측 이름의 사용은 다음과 유사한 메시지와 함께 기록됩니다.
INFO: Using deprecated configuration setting akka_instrumentation for instrumentation com.newrelic.instrumentation.akka-2.2
또는
INFO: The configuration setting akka_instrumentation is deprecated, please update the class_transformer config to use com.newrelic.instrumentation.akka-2.2 instead
더 이상 사용되지 않는 설정을 사용한다고 해서 더 이상 사용되지 않는 계측이 로드되었거나 사용 중임을 나타내지는 않습니다. 이 메시지는 구성 설정을 업데이트할 시간임을 사용자에게 알리는 것입니다.
Play 2.4는 새로운 계측이므로 이전 play2_instrumentation
구성 설정을 존중하지 않습니다. 모든 경우에 Java 에이전트 버전 3.22 이상을 사용하는 경우 newrelic.yml에서 Scala, Netty, Akka 및 Play 2 프레임워크에 대한 새 계측 이름을 사용해야 합니다.