New Relicエージェントでの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. New Relic OpenTelemetryサポートを有効にする

システムプロパティ：

$
-Dnewrelic.config.opentelemetry.enabled=true

環境変数：

$
NEW_RELIC_OPENTELEMETRY_ENABLED=true

YAML 設定 (newrelic.yml):

opentelemetry:
  enabled: true

サポートされている計装タイプ

手動計測器

OpenTelemetry 、メトリクス、またはログ API を使用したカスタムインストゥルメンテーションは、エージェントによって自動的にキャプチャされます。

ライブラリとネイティブ計装

OpenTelemetryスタンドアロン ライブラリ計装とライブラリに直接組み込まれたネイティブ計装はNew Relicエージェントで動作します。 ただし、 OpenTelemetryバイトコードベースの自動インストゥルメンテーションはNew Relicエージェントによって検出されません。

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顧客にとって最も便利な機能です。 これにより、メトリクスの収集機能が拡張され、頻繁に要求される機能である次元メトリクスが追加されます。

OpenTelemetryメトリクスAPIを使用してカスタムメトリックを記録します。 OpenTelemetry Node.js例を参照してください。

ログAPI

JavaScript OpenTelemetry APIまだ開発中ですが、 Node.jsエージェントはそれをサポートしています。 API を使用して、New Relic に送信されるログを出力できます。

OpenTelemetry Node.js ログの例を参照してください。

サポートされている計装タイプ

手動計装（推奨）

OpenTelemetry APIを使用してアプリケーションを計測した顧客は、エージェントがそのデータを正しく処理して送信していることがわかります。

ネイティブおよびライブラリ計装（限定）

OpenTelemetry計装のリストには、 Node.jsエージェントのサポートされているモジュールとかなりの重複があります。 New Relicエージェントでまだカバーされていない計装は次の可能性があります。

• エージェント内部との競合
• 十分な顧客需要がない

既知の制限

• 自動計装なし: エージェントは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計装が組み込まれたライブラリの場合、エージェントは自動的にNew Relicのフックを無効にし、代わりにネイティブOpenTelemetry計装を使用します。

2. ライブラリ計装: OpenTelemetry計装ライブラリが検出された場合、エージェントはNew Relicの計装フックの代わりにOpenTelemetry計装を自動的に使用します。

利用可能なPython計装の現在のリストについては、 公式のOpenTelemetry Python計装リストを参照してください。

手動計測器

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 Pythonエージェントで有効になっていません

ログAPI

✅すでに動作：エージェントはすでにログ記録モジュールをサポートしています。Python でログに記録するための OpenTelemetry API はありません (SDK のみが存在します)。OpenTelemetry がログ記録用に設定するのは、ログ記録が有効かどうかと、どのエンドポイントにデータを送信するかです。

使い方

OpenTelemetry サポートが有効になっている場合:

1. エージェントはシステムを検索して、 OpenTelemetry計装ライブラリがインストールされているかどうかを判断します
2. 自動切り替え: 見つかった場合、エージェントはNew Relicのフックの代わりにOpenTelemetryライブラリの計装を使用します
3. シームレスな統合: OpenTelemetryスパンはNew Relicに統合されています

既知の制限

• メトリクスはサポートされていません: OpenTelemetryメトリクスAPIはまだ有効になっていません
• 一部のAWSとgRPCライブラリは除外: 引き続きNew Relic計装を使用します
• AI ライブラリが無効になっています: AI ライブラリのネイティブOpenTelemetry計装は現在無効になっています
• 含める/除外設定: 微調整オプションは将来のリリースで計画されていますが、現在は有効化/無効化のみが機能します。

OpenTelemetry APIサポートを有効にする

Rubyエージェントで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

❌サポートされていないAPI OpenTelemetry

スパリンク

❌サポートされていません: スパンリンク

Spans のイベント

❌サポートされていない: Spans 上のイベント

使い方

OpenTelemetry サポートが有効になっている場合、New Relic Ruby エージェントは次の処理を実行します。

1. OpenTelemetry トレース API への呼び出しをリッスンします
2. これらの呼び出しをNew Relicデータモデルに変換します
3. OpenTelemetry スパンを New Relic トレースに組み込む

既知の制限

• 限定的なAPIサポート: このリリースではAPIのみがサポートされています
• メトリクスとログ: 利用できません
• Span リンクとイベント: 現在サポートされていません

エージェント設定をチェックして、 OpenTelemetryサポートが有効になっていることを確認します。

• 環境変数または設定ファイルを確認する
• エージェントログをチェックして、OpenTelemetry サポートがアクティブであることを確認します。
• 設定を変更した後は、アプリケーションを再起動してください。

OpenTelemetry API をサポートする最低限必要なエージェント バージョンを実行していることを確認します。上記のサポートされている言語の表を参照してください。