OpenTelemetryデータを送信し、UIでサービス(エンティティ)を開いたら、[分散トレース]をクリックしてトレースを見つけ、スパンの詳細を調べることができます。トレースデータをNewRelicUIに表示するには、 OpenTelemetryトレースのセマンティック規則に準拠している必要があります。また、 ベストプラクティスガイドの「トレース」セクションで、トレースとスパンがNewRelicに表示されるようにするためのヒントを見つけることができます。
以下の属性は、通常、スパンに明示的に追加されることはありません。むしろ、スパンを作成するときや、OpenTelemetry SDKを使用してスパンに対して操作(エラーの記録など)を行うときに設定するのが一般的です。
属性 | 説明 |
---|---|
name | スパンの名前は通常、 スパンを開始するときに設定されます 。名前は一般的に何でも構いませんが、OpenTelemetryの仕様では、 Database spans や HTTP spans のような特定のタイプのスパンについてのガイダンスを提供しています。 |
スパンの種類は、通常、スパンを開始するときに設定されます。 New Relicは | |
otel.status_code |
|
トレースとその関連スパンの検索
ここでは、検索対象を絞るための方法をご紹介します。
欲しいトレースを見つけるには、フィルターバーで以下のようなクエリを実行します。
service.name = YOUR_SERVICE_NAME
trace.id = YOUR_TRACE_ID
興味深いトレースを見つけたら、それをクリックすると、トレースのスパンを示すウォーターフォール図が表示されます。
トレース内の特定のスパンをクリックすると、右側のパネルにスパンの詳細が表示されます。
ヒント
トレースをフィルタリングするその他の方法については、 distributed tracing UI page を参照してください。
エラーのあるスパンの表示
トレースウォーターフォールビューでスパンをクリックすると、右パネルの エラーの詳細 にスパンのエラーが表示されます。
エラーの詳細には、 otel.status_code = ERROR
を含むスパンが入力され、 otel.status_description
の内容が表示されます。
エラーのあるスパンの検索を絞り込むには、分散トレースフィルターバーに直接otel.status_code = ERROR
を入力します。
スパンのイベントを見る
OpenTelemetry 仕様 で説明されているようにスパンイベントを送信すると、New Relic UI でそのイベントを見ることができます。スパンイベントには、一般的に 2 つのタイプがあります。
- 例外
- 非例外(例えば、ログなど)
スパンイベントがある場合は、右ペインにそのリンクが表示されます。
ウォーターフォールビューでスパンをクリックします。
右ペインで、 View span events をクリックするか、 Error details を展開して、エラーの下部にあるリンクをクリックします。
スパンイベントで、例外のみを表示したい場合は、トグルをスライドさせます Only show exceptions.
ヒント
アプリ/サービスで処理されるOpenTelemetryの例外は、スパンのエラー・ステータスとは別に表示され、必ずしもスパンのエラー・ステータスとは関連しません。
他のUIページでのOpenTelemetryについては、 UIの概要を参照してください。