• /
  • ログイン
  • 無料アカウント

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

Scala、Netty、Akka、およびPlay 2 Instrumentationの無効化

このドキュメントでは、これらの一般的な非同期フレームワークでJavaエージェントのインスツルメンテーションを無効にする方法について説明します。

  • Scala
  • Netty
  • Akka
  • プレイ2

報告されるメトリクスに価値がないと判断した場合や、計測機器が必要以上にオーバーヘッドを発生させている場合は、この計測機器の一部または全部を無効にすることができます。一部の機器を選択的に無効にした場合、アクティビティの一部が報告されず、合計時間が少なくなります。

Javaエージェントバージョン3.21以下

Java agent version 3.22以下を使用している場合は、 class_transformer newrelic.yml 設定のセクションに以下を追加してください。

# 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 Frameworkのインストゥルメンテーション設定名は、Java Agentバージョン3.22から非推奨となりました。Java Agent 3.22以降をお使いの方は、 class_transformer newrelic.yml 設定のセクションに以下を追加してください。

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フレームワークの新しいインストルメンテーション名を使用する必要があります。

問題を作成する
Copyright © 2022 New Relic Inc.