OpenTelemetryの設定では、エージェントのOpenTelemetry計装およびOTLPデータエクスポートとのインテグレーションを構成します。
OpenTelemetry
Javaエージェントバージョン9.1.0以降、OpenTelemetry Tracing、メトリクス、およびログAPIの互換性が追加されました。New Relicの強力な可視性とOpenTelemetryシグナルを組み合わせることで「両方の長所」を兼ね備えたエクスペリエンスを実現できます。
この機能を使用すると、 OpenTelemetry Tracing、メトリクス、ログAPIをNew Relic JavaエージェントAPIと組み合わせることでアプリケーションを直接カスタム計装できるようになり、また、Javaエージェントとこれらすべてを組み合わせて使い慣れたAPMエクスペリエンスを実現できるようになります。さらに、 OpenTelemetryネイティブまたは独立のライブラリ計装を提供する一部のライブラリを使用して、アプリケーションの可視性を向上させることができます。
次の設定オプションを使用して、どのOpenTelemetryシグナルをキャプチャしてNew Relic APMエクスペリエンスに組み込むかを決定します。
include: "MeterName1,MeterName2"
exclude: "MeterName3,MeterName4"
include: "TracerName1,TracerName2"
exclude: "TracerName3,TracerName4"
各OpenTelemetryシグナルを有効にするには「true」に設定し、すべての OpenTelemetryシグナルを無効にするには「false」に設定します。デフォルトは「false」です。
システムプロパティを介して設定できます。
-Dnewrelic.config.opentelemetry.enabled=false
以下の環境変数を使って設定できます:
NEW_RELIC_OPENTELEMETRY_ENABLED
opentelemetry.enabled=trueの場合にOpenTelemetry Logsシグナルを有効にするには「true」に設定します。デフォルトは「true」です。
システムプロパティを介して設定できます。
-Dnewrelic.config.opentelemetry.logs.enabled=true
以下の環境変数を使って設定できます:
NEW_RELIC_OPENTELEMETRY_LOGS_ENABLED
opentelemetry.enabled=trueの場合にOpenTelemetry Metricsのシグナルを有効にするには「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
opentelemetry.enabled=true場合にOpenTelemetry Tracesのシグナルを有効にするには「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