Application Real-Time Monitoring Service (ARMS) は、保存されたフルトレースデータを分析するためのトレースエクスプローラー機能を提供します。 トレースエクスプローラーでは、保存されたフルトレースデータに基づいて、リアルタイム分析のためのフィルター条件と集約ディメンションを組み合わせることができます。 これにより、さまざまなシナリオでのカスタム診断要件を満たすことができます。
手順
[ARMS コンソール] にログインします。
左側のナビゲーションウィンドウで、 を選択します。 上部のナビゲーションバーで、リージョンを選択します。
[トレースエクスプローラー] ページの右上隅で、クエリする時間範囲を選択します。
フィルター条件を指定します。
[クイックフィルター] セクションで、ステータス、期間、アプリケーション名、スパン名、またはホストアドレスでトレースをクエリします。
指定されたフィルター条件は、検索バーに表示されます。
検索バーをクリックします。 ドロップダウンフィルターパネルで、既存のフィルター条件を設定するか、カスタムフィルター条件を追加します。
検索バーにクエリ文を入力します。 構文の詳細については、「トレースエクスプローラーの使用方法」をご参照ください。
説明[集約ディメンション] ドロップダウンリストの右側にある
アイコンをクリックして、指定したフィルター条件をビューに保存します。 [保存済みビュー] をクリックして、保存済みビューをすべて表示するか、ビューをクリックして対応するトレースデータを表示します。
クエリされたデータを特定のディメンションに基づいて集約します。
トレースリスト
フィルター条件を指定すると、[トレースエクスプローラー] ページにトレースデータが表示されます。 トレースデータには、呼び出しと HTTP エラーの棒グラフ、期間の時系列曲線、スパンリストとトレースリストが含まれます。
凡例：
ページ上部の棒グラフの HTTP ステータスコード：
2XX （緑）
3XX （黄）
4XX （オレンジ）
5XX （赤）
attributes.http.status_codeフィールドまたはattributes.http.response.status_codeフィールドから派生しています。 両方のフィールドが存在する場合、HTTP ステータスコードはスパンの状態をオーバーライドします。リストの [TraceId] 列の左側のカラーバー：
: statusCode=0
: statusCode=1
: statusCode=2
リストの [ステータス] 列のスパン状態インジケーター：
: 正常statusCode=0(未設定)statusCode=1(正常)
: エラー (statusCode=2)
: 例外 (attributes.excep.idsに値が含まれている場合にトリガーされます)
スパンリストとトレースリストでは、次の操作を実行できます。
アイコンをクリックして、トレース ID の下のすべてのスパンを展開します。 デフォルトでは、トレースリストの各トレース ID にルートスパンが表示されます。
アイコンをクリックして、リストのパラメーターを追加または非表示にします。 
アイコンをクリックして、現在のパラメーター値をフィルター条件として追加します。
散布図
[散布図] タブでは、時点が X 軸に沿って分布し、期間が Y 軸に沿って分布します。 ポイントの上にポインターを移動してトレースの基本情報を表示し、ポイントをクリックして トレースの詳細 を表示できます。
トレース集約の詳細
トレースエクスプローラーでは、クエリされたスパンをさまざまなディメンションに基づいて分析できます。 ただし、多数のスパンで構成されるトレースを分析する必要がある場合があります。 トレース集約機能を使用すると、指定された条件を使用して最大 5,000 の分散トレースをクエリし、トレース ID に基づいて対応するスパンをクエリできます。 その後、クエリされたスパンを集約して結果を取得できます。 このプロセスでは、集約されたトレースの整合性が保証されます。
トレース集約機能を使用する場合、集約クエリは指定された条件に基づいてトレースデータに対して実行されることに注意してください。 複数のクエリ条件を指定すると、計算がリアルタイムで完了しない場合があります。 しばらくお待ちください。
パラメーター | 説明 |
spanName | スパンの名前。 |
serviceName | スパンに対応するアプリケーションの名前。 |
リクエスト数/リクエストの割合 | リクエスト比率は、現在のスパンを呼び出すリクエストの総リクエスト数に対する比率を示します。 たとえば、10% は、リクエストの 10% が現在のスパンを呼び出すことを示します。 式：リクエスト比率 = 現在のスパンを呼び出すリクエスト数/総リクエスト数 × 100% |
スパン/リクエスト倍数 | リクエスト倍数は、各リクエストによって現在のスパンが呼び出される平均回数を示します。 たとえば、1.5 は、現在のスパンが各リクエストによって 1.5 回呼び出されることを示します。 式：リクエスト倍数 = スパン数/リクエスト数 |
平均自己消費/割合 | スパンの自己時間は、子スパンで費やされた時間を除外します。 たとえば、スパン A に 10 ミリ秒かかり、その子スパン (スパン B) に 8 ミリ秒かかる場合、スパン A の平均自己時間は 2 ミリ秒です。 式：スパンの平均自己時間 = スパンの合計時間 - すべての子スパンで費やされた時間 重要 非同期呼び出しの場合、スパンの自己時間はスパンの合計時間と同じです。 |
平均期間 | スパンの平均期間。 |
例外の数/例外の割合 | 例外比率は、例外のあるリクエストの総リクエスト数に対する比率を示します。 たとえば、3% は、リクエストの 3% で例外が発生することを示します。 式：例外のあるリクエスト数/総リクエスト数 重要 例外のあるリクエストの数は、例外の数と同じではありません。 リクエスト倍数が 1 より大きい場合、リクエストに複数の例外が含まれる場合があります。 |
例：スパン A はスパン B とスパン C を呼び出します。次の表にパラメーターを示します。
spanName | serviceName | リクエスト数/リクエストの割合 | スパン/リクエスト倍数 | 平均自己消費/割合 | 平均期間 | 例外の数/例外の割合 | |
A | - | demo | 10/100.00% | 10/1.00 | 5.00ms/25.00% | 20ms | 2/20.00% |
- | B | demo | 4/40.00% | 8/2.00 | 16.00ms/100.00% | 16ms | 2/50.00% |
- | C | demo | 1/10.00% | 1/1.00 | 4.00ms/100.00% | 4ms | 1/100.00% |
スパン A の リクエスト数/リクエストの割合 パラメーターは、リクエストの総数が 10 で、リクエスト比率が 100% であることを示します。 スパン B の リクエスト数/リクエストの割合 パラメーターは、スパン B を呼び出すリクエストが 4 つだけであることを示します。 同様に、スパン C を呼び出すリクエストは 1 つだけです。 スパン B のリクエスト比率は 40% で、スパン C のリクエスト比率は 10% です。 論理的判断または例外のため、他のリクエストはスパン B とスパン C を呼び出しません。 これは、リクエストの分布を反映しています。
スパン A の スパン/リクエスト倍数 パラメーターは 10/1.00 です。これは、スパン A が各リクエストによって 1 回だけ呼び出されることを示します。 ただし、スパン B の場合、8 つのスパンが 4 つのリクエストによって呼び出されます。 したがって、スパン B は各リクエストによって 2 回呼び出されます。 これは、各リクエストのスパンの分布を反映しています。
スパン A の 平均自己消費/割合 パラメーターは 5.00 ms/25.00% です。これは、スパン A の平均自己時間 (スパン B とスパン C を除く) が 5 ミリ秒であることを示します。 スパン A の平均自己時間は、全体の平均時間のわずか 25% を占めます。 ただし、スパン B とスパン C には子スパンがないため、スパン B とスパン C の平均自己時間は全体の平均時間と同じです。 これは、平均期間の分布を反映しています。
スパン A の 例外の数/例外比率 パラメーターは 2/20.00% です。これは、スパン A に 2 つの例外があり、リクエストの総数の 20% を占めていることを示します。 スパン B の 例外の数/例外の割合 パラメーターは 2/50.00% です。 各リクエストがスパン B を 2 回呼び出し、リクエストの総数が 4 で、例外比率が 50% であることを考えると、2 つのリクエストに例外があります。 したがって、スパン B の例外の分布は次のようになります。合計 4 つのリクエストのうち、2 つのリクエストは成功しています。 残りの 2 つのリクエストのうち、各リクエストの最初の呼び出しで例外が発生しますが、2 番目の呼び出しは成功しています。
特定のトレースの詳細を表示するには、ポインターを青いスパン名の上に移動します。 推奨されるトレース ID をクリックして詳細を表示できます。
トレース トポロジー
[フルリンクトポロジー] タブには、集約されたトレースのアプリケーション間トポロジーが表示されます。 次の図は、2 つのアプリケーションに呼び出し関係があることを示しています。 各アプリケーションについて、リクエスト数、エラー数、および応答時間が表示されます。
失敗したトレースと低速なトレースの分析
失敗したトレースと低速なトレースの分析は、複数の失敗したトレースと低速なトレースの共通ディメンションを分析するのに役立ちます。 トレースは 1 つのホストに集中しているか、1 つのインターフェイスに属している可能性があります。 ホストまたはインターフェイスでトレースをクエリするか、複数のフィルター条件を組み合わせてトレースをクエリし、問題を特定できます。 例：serviceName="arms-demo" AND ip="192.168.1.1"。 失敗したトレースと低速なトレースの分析は、低速なインターフェイスを整理し、システムの方向性のある最適化を実行するのにも役立ちます。
低速なトレースの分析
ARMS は、期間が最も長い 1,000 のトレースを分析し、低速なトレースに最も関連する 5 つのディメンションを表示します。
低速なトレースの詳細
ARMS は、期間がしきい値より長いトレースから期間が最も長い 1,000 のトレースを選択し、期間がしきい値より短い 1,000 のトレースをサンプリングし、これらのトレースを比較して、低速な呼び出しに最も関連する 3 つの特性を発見します。
ビジネス要件に基づいてしきい値を設定できます。 1 分以上かかるトレースの特性を発見する場合、しきい値を 60000 ミリ秒に設定できます。
失敗したトレースの分析
ARMS は、1,000 の失敗したトレースをランダムに選択して分析し、トレースに最も関連する 5 つのディメンションを表示します。
失敗したトレースの詳細
ARMS は、失敗したトレースと通常のトレースを比較し、失敗した呼び出しに最も関連する 3 つの特性を発見します。
トレースの詳細
コンポーネントタグ (前の図の番号 1 でマークされたセクション)
タグには、呼び出しタイプとスパンの数が表示されます。
呼び出しタイプは、attributes.component.name フィールドによって定義されます。
タグをクリックして、呼び出しタイプに関連するスパンを非表示または表示します。
トレースの横棒グラフ (前の図の番号 2 でマークされたセクション)
棒グラフは、トレース全体とスパンの分布を示しています。
各バーはスパンを表します。 期間が合計期間の 1% より大きいスパンのみが表示されます。
異なる色は異なるアプリケーションを表します。 前の図に示すように、青色は opentelemetry-demo-adservice アプリケーションを表します。
チャートの黒い線の長さは、スパンの自己時間を表します。これは、スパンの合計時間から子スパンで費やされた時間を引いたものです。 スパン A がスパン B を呼び出すとします。スパン A に 10 ミリ秒かかり、スパン B に 8 ミリ秒かかります。 この場合、スパン A には 2 ミリ秒かかります。
タイムラインは、トレースの時間範囲を表します。
トレースのフォーカスとフィルタリング (前の図の番号 3 でマークされたセクション)
このセクションの各行はスパンを表し、親スパンと子スパンの階層関係を示しています。 各親スパンの前には数字が付いており、親スパンが所有する子スパンの数を示します。 このセクションでは、次の操作を実行できます。
折りたたむ：
アイコンをクリックして、子スパンを折りたたみます。展開：
アイコンをクリックして、子スパンを展開します。フォーカス解除:
アイコンをクリックして、スパンのフォーカスを解除します。フィルター: 検索ボックスにスパン名、アプリケーション名、属性など、スパンの情報を入力して、スパンからエントリスパンまでのトレースデータを表示します。 フィルタリングをキャンセルするには、検索ボックスから入力情報を削除し、検索アイコンをクリックします。
拡大/縮小:
アイコンをクリックすると、トレースが拡大され、棒グラフが非表示になります。
アイコンをクリックすると、棒グラフが表示されます。
スパンの詳細 (前の図の番号 4 でマークされたセクション)
スパンの詳細セクションには、現在のスパンの詳細、および関連するメトリックデータ、ログ、例外情報が表示されます。カスタムインタラクションイベントを管理し、インタラクションイベントのトリガーを設定することもできます。
追加情報: スパンの属性、リソース、詳細、イベントが表示されます。追加情報は種類ごとにグループ化されます。スパンの詳細にあるフィールドについては、「トレースエクスプローラー パラメーター」をご参照ください。
メトリック: スパンに関連するメトリックが表示されます。ARMS で監視されている Java アプリケーションのトレースの場合、JVM とホストに関するメトリックが表示されます。オープンソース エージェントによって報告されたトレースの場合、レート、エラー、期間を含む RED メソッドで定義されたメトリックが表示されます。
ログ: トレースに関連するビジネスログが表示されます。アプリケーションの Simple Log Service (SLS) Logstore を設定している場合は、Logstore に移動して、トレース ID に基づいてビジネスログをクエリできます。
例外: スパンに関連する例外情報 (存在する場合) が表示されます。
イベント設定: トレースの1つ以上の属性に対してインタラクションイベントを設定できます。これにより、トレースに関する詳細をクエリしたり、トレースに関連するログとメトリックを表示したりできます。カスタムインタラクションイベントの設定方法については、「トレースのカスタムインタラクションイベントを設定する」をご参照ください。
カスタム開発
トレースデータは SLS に保存されます。プロジェクト名は proj-xtrace-<encode>-<region-id> です。ログストア名は logstore-tracing です。 region-id パラメーターは、Trace Explorer を使用するリージョンです（例： cn-hangzhou）。データ形式については、「Trace Explorer パラメーター」をご参照ください。保存されているすべてのトレースデータに対してカスタム開発を実行できます。フィルター条件または集計ディメンションに基づいて、保存されているすべてのトレースデータを分析できます。このようにして、さまざまなシナリオにおけるカスタム診断の要件を満たすことができます。詳細については、「Trace Explorer を使用してリアルタイムでトレースデータを分析する」をご参照ください。