New Relic の OpenTelemetry トレース

OpenTelemetry 、トレーステレメトリを記録するためのAPI 、スパンデータをエクスポートするためのSDK 、アプリケーション境界を越えてトレースするためのコンテキストトレースなど、豊富なトレースエコシステムを提供します。

このページでは、New Relic が New Relic OTLP エンドポイント経由で受信した OpenTelemetry スパンをどのように処理するかについて説明します。 OpenTelemetryをNew Relicに送信するには、OTLP エンドポイント経由でNew Relic OpenTelemetryにデータをエクスポートするように Trace ソースを設定する必要があります。次のページを参照してください。

エンドポイント設定の要件については、 New Relic OTLP エンドポイントを参照してください。
OpenTelemetryを使用してサービスを構成する手順については、 OpenTelemetry APM監視」を参照してください。

OTLPスパンマッピング

New Relic は OTLP スパンをSpanデータ型にマッピングします。次の表は、トレースプロトコルメッセージ定義のフィールドがどのように解釈されるかを示しています。

OTLPプロトフィールド	New Relic `Span`フィールド
`ResourceSpans.Resource.attributes`	各キー値は`Span`の属性である[1]
`ScopeSpans.InstrumentationScope.name`	`otel.library.name`
`ScopeSpans.InstrumentationScope.version`	`otel.library.version`
`ScopeSpans.InstrumentationScope.attributes`	各キー値は`Span`の属性である[1]
`Span.trace_id`	`trace.id`
`Span.span_id`	`id`
`Span.trace_state`	`w3c.tracestate`
`Span.parent_span_id`	`parent.id`
`Span.name`	`name`
`Span.kind`	`span.kind`
`Span.start_time_unix_nano`	`timestamp`
`Span.end_time_unix_nano`	`duration.ms` ( `Span.start_time_unix_nano`で計算)
`Span.attributes`	各キー値は`Span`の属性である[1]
`Span.dropped_attribute_count`	`otel.dropped_attributes_count`
`Span.events`	各イベントは`SpanEvent`として記録され、 `span.id` / `trace.id`はソーススパンを参照し、カウントは次のように保存されます。 `nr.spanEventCount`
`Span.events[*].time_unix_nano`	`timestamp`として保存 `SpanEvent`
`Span.events[*].name`	`name`として保存 `SpanEvent`
`Span.events[*].attributes`	各キー値は、 `SpanEvent`
`Span.events[*].dropped_attributes_count`	`ote.dropped_Attributes_count`として保存 `SpanEvent`
`Span.dropped_events_count`	`otel.dropped_events_count`
`Span.status.message`	`otel.status_description`
`Span.status.code`	`otel.status_code`

表の脚注

[1]リソース属性、スコープ属性、スパン属性、および最上位のスパンフィールドで競合が発生した場合、優先順位（最高から最低）は、最上位のSpan.*フィールド> Span.attributes > ScopeSpans.InstrumentationScope.attributes > ResourceSpans.Resource.attributesとなります。

OTLP New Relicエンドポイントでサポートされるプロパティタイプの詳細については「OTLP プロパティタイプ」を、プロパティに対して実行される検証の詳細については「OTLP プロパティ制限」を参照してください。

スパリンクのサポート

OpenTelemetryスパンのリンクは現在 New Relic ではサポートされていません。

この機械翻訳は、参考として提供されています。

New Relic の OpenTelemetry トレース

OTLPスパンマッピング .css-21sua1{background:none;border:none;width:0;padding:0;}

表の脚注

スパリンクのサポート

OTLPスパンマッピング