Application Real-Time Monitoring Service:トレースエクスプローラー

HTTP ステータスコードの色

棒グラフは、HTTP ステータスクラスによってレスポンスを色分けします。

ステータスコードは、attributes.http.status_code または attributes.http.response.status_code から派生します。HTTP ステータスコードとスパンステータスの両方が存在する場合、HTTP ステータスコードが優先されます。

スパンステータスのインジケーター

[TraceId] 列の左側にあるカラーバーは、スパンのステータスを示します。

カラーバー	ステータスコード	意味
	statusCode=0	Unset
	statusCode=1	OK
	statusCode=2	Error

[Status] 列では、アイコンを使用してスパンの状態を示します。

アイコン	状態	条件
	正常	statusCode=0 (unset) または statusCode=1 (OK)
	エラー	statusCode=2
	例外	attributes.excep.ids に値が含まれている

トレースリストのアクション

• トレース ID または [Actions] 列の [Details] をクリックして、トレースの詳細とトポロジーを表示します。

• [Actions] 列の [Logs] をクリックして、トレース相関ログを表示します。

• アイコンをクリックして、トレース ID の下のすべてのスパンを展開します。デフォルトでは、トレースごとにルートスパンのみが表示されます。

• 右上隅の アイコンをクリックして、リストに表示する列をカスタマイズします。

• スパンにカーソルを合わせ、 アイコンをクリックして、その値をフィルター条件として追加します。

集計メトリック

集計例

スパン A がスパン B とスパン C を呼び出すトレースを考えてみましょう。

このテーブルの読み方：

• リクエストの分布：10 件すべてのリクエストがスパン A を通過しますが、スパン B に到達するのは 4 件、スパン C に到達するのは 1 件のみです。残りのリクエストは、条件付きロジックまたは例外のためにこれらの子スパンをスキップします。

• スパンの頻度：スパン A はリクエストごとに 1 回呼び出されます (倍率 = 1.00)。スパン B はリクエストごとに平均 2 回呼び出されます (8 スパン / 4 リクエスト = 2.00)。これは、ループまたはリトライパターンを示しています。

• 時間の分布：スパン A のセルフタイムは 5 ms (合計所要時間 20 ms の 25%) で、75% の時間は子スパンで費やされていることを意味します。スパン B とスパン C には子がないため、セルフタイムは 100% です。

• 例外の分布：スパン B では 4 件のリクエストで 2 件の例外が発生しています (例外率 50%)。各リクエストはスパン B を 2 回呼び出すため、考えられるパターンは、2 件のリクエストは完全に成功し、他の 2 件は最初の呼び出しで失敗するものの、リトライで成功するというものです。

青色のスパン名にカーソルを合わせると、推奨されるトレース ID が表示されます。トレース ID をクリックすると、その詳細が表示されます。

低速トレース分析

ARMS は、最も所要時間の長い 1,000 件のトレースを選択し、パフォーマンスの低下と最も強く相関する 5 つのディメンションを特定します。

低速トレースの詳細

ARMS は、設定可能なしきい値を超える最も所要時間の長い 1,000 件のトレースと、それを下回る 1,000 件のトレースをサンプリングします。2 つのグループを比較することで、高レイテンシーと最も強く相関する 3 つの特性を明らかにします。

しきい値はパフォーマンス要件に基づいて設定します。たとえば、1 分より遅いトレースを分析するには、しきい値を 60000 ミリ秒に設定します。

失敗トレース分析

ARMS は、失敗したトレースをランダムに 1,000 件選択し、失敗と最も強く相関する 5 つのディメンションを特定します。

失敗トレースの詳細

ARMS は、失敗したトレースを正常なトレースと比較し、エラーと最も強く相関する 3 つの特性を明らかにします。

コンポーネントタグ

ビューの上部にあるタグは、attributes.component.name フィールドで定義された呼び出しタイプごとにスパンをグループ化します。各タグには、呼び出しタイプ名とそのスパン数が表示されます。タグをクリックすると、そのタイプのスパンの表示/非表示を切り替えることができます。

トレースタイムラインの棒グラフ

水平棒グラフは、トレース全体の視覚的な概要を提供します。

• 各バーはスパンを表します。トレースの合計所要時間の 1% を超えるスパンのみが表示されます。

• 色はアプリケーションを区別します。たとえば、青は opentelemetry-demo-adservice を表す場合があります。

• バー内の黒い線分はセルフタイムを示します。これは、子スパンを除いたスパン自体の処理時間です。スパン A の所要時間が 10 ms で、その子スパン B の所要時間が 8 ms の場合、スパン A のセルフタイムは 2 ms です。

• タイムライン軸は、トレースの時間範囲を示します。

スパンツリーとナビゲーション

スパンツリーは各スパンを 1 行で表示し、インデントによって親子関係を示します。各親スパンの前の数字は、それが含む子スパンの数を示します。

利用可能なコントロール：

• 折りたたみ/展開： アイコンをクリックして、スパンの子を折りたたんだり展開したりします。

• フォーカス： アイコンをクリックして、スパンとその下流の呼び出しを分離します。

• フォーカス解除： アイコンをクリックして、全体のビューに戻します。

• フィルター：検索ボックスにスパン名、アプリケーション名、または属性を入力して、ツリーをフィルタリングします。ビューには、一致するスパンと、そのエントリスパンに至るまでのすべての祖先スパンが表示されます。検索ボックスをクリアして検索アイコンをクリックすると、フィルターが解除されます。

• ズーム： アイコンをクリックしてズームインし、棒グラフを非表示にします。 アイコンをクリックすると、棒グラフが復元されます。

スパン詳細パネル

スパンを選択すると、右側のパネルにその詳細が表示されます。

• 追加情報：スパンの属性、リソース、詳細、イベントをタイプ別にグループ化して表示します。フィールド定義については、「トレースエクスプローラーのパラメーター」をご参照ください。

• メトリック：スパン関連のメトリックを表示します。ARMS によって監視されている Java アプリケーションの場合、これには JVM とホストのメトリックが含まれます。オープンソースエージェントからのトレースの場合、これには RED メソッドのメトリック (レート、エラー、所要時間) が含まれます。

  

• ログ：このトレースと相関するビジネスログ。アプリケーションに Simple Log Service (SLS) の Logstore が設定されている場合、クリックしてトレース ID でログをクエリできます。

• 例外：選択したスパンの例外詳細 (もしあれば)。

• イベント設定：1 つ以上のスパン属性に対してカスタムインタラクションイベントを設定します。これらのイベントを使用して、トレースデータを関連するログ、メトリック、または外部システムにリンクします。設定手順については、「トレースのカスタムインタラクションイベントの設定」をご参照ください。

ARMS トレースにおける予期しない POST /ingest スパン

ARMS トレースで API 名が POST /ingest のスパンが表示される場合、考えられる原因は次のとおりです。

• 存在しない URL にリクエストが送信されました。

• アプリケーションが、ベア Netty のようなルーティングメカニズムのない HTTP サーバーを使用しています。

• リクエストがルーティングステージに到達する前にスロットリングされました。

• ARMS アプリケーションの Spring プラグインが無効になっています。

これらのスパンを非表示にするには、アプリケーション設定でスパンフィルタリングルールを設定します。