Application Real-Time Monitoring Service (ARMS) は、保存されたフルトレースデータを分析するためのトレースエクスプローラー機能を提供します。 トレースエクスプローラーを使用すると、保存されたフルトレースデータに基づいて、リアルタイム分析のためのフィルター条件と集約ディメンションを組み合わせることができます。 これにより、さまざまなシナリオでのカスタム診断要件を満たすことができます。
前提条件
ARMS エージェントがアプリケーションにインストールされています。
アプリケーション監視は、新しい課金モードを有効にしているユーザー向けに、新しいアプリケーション詳細ページを提供します。
新しい課金モードを有効にしていない場合は、[新しいバージョンに切り替える]アプリケーション一覧 ページで をクリックして、新しいアプリケーション詳細ページを表示できます。
手順
ARMS コンソール にログインします。左側のナビゲーションウィンドウで、 を選択します。
[アプリケーションリスト] ページで、上部のナビゲーションバーでリージョンを選択し、管理するアプリケーションの名前をクリックします。
説明[言語] 列に表示されるアイコンは、アプリケーションが記述されている言語を示します。
: Java アプリケーション
: Go アプリケーション
: Python アプリケーションハイフン ([-]): Managed Service for OpenTelemetry で監視されるアプリケーション。
上部のナビゲーションバーで、トレース エクスプローラー をクリックします。
[トレースエクスプローラー] ページの右上隅で、クエリする時間範囲を選択します。
フィルター条件を指定します。
[クイックフィルター] セクションで、ステータス、期間、アプリケーション名、スパン名、またはホストアドレスでトレースをクエリします。
指定したフィルター条件は、検索ボックスに表示されます。
上部の検索ボックスをクリックします。ドロップダウン ダイアログボックスで、既存のフィルター条件を構成するか、カスタム フィルター条件を追加します。
検索ボックスにクエリ文を入力します。構文の詳細については、「トレースエクスプローラーの使用方法」をご参照ください。
説明検索ボックスの横にある
アイコンをクリックして、現在のフィルター条件を保存できます。[保存済みビュー] をクリックして保存済みのフィルター条件を表示し、フィルター条件をクリックして対応するトレースデータを表示できます。
クエリされたデータを特定のディメンションに基づいて集約できます。
トレースリスト
フィルター条件を指定すると、[トレースエクスプローラー] タブにトレースデータが表示されます。トレースデータには、棒グラフの呼び出し数と HTTP エラーの数、時系列曲線の呼び出し期間、スパンリストとトレースリストが含まれます。
凡例の説明:
: スパンは正常な状態です。この凡例は、statusCode=1のスパンから派生しています。
: スパンはエラー状態です。この凡例は、statusCode=2のスパンから派生しています。
: スパンに例外があります。この凡例は、attributes.excep.idsに値が含まれている場合にトリガーされます。ページ上部の棒グラフの 2XX（緑）、3XX（黄）、4XX（オレンジ）、5XX（赤）:
attributes.http.status_codeまたはattributes.http.response.status_codeフィールドから派生した HTTP ステータスコード。スパンに両方のフィールドが含まれている場合、HTTP ステータスコードは状態インジケーターよりも優先されます。
スパンリストとトレースリストでは、次の操作を実行できます。
呼び出すトレースの ID をクリックするか、[操作] 列の [詳細] をクリックして、トレースの詳細とそのトポロジービューを表示します。詳細については、「失敗したトレースと低速なトレースの分析」セクションをご参照ください。
[操作] 列の [ログ] をクリックして、トレースのログを表示します。詳細については、「ログ分析機能を使用する」をご参照ください。
アイコンをクリックして、トレース 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 の平均期間は、子スパンがないため、全体の平均期間と同じです。これは、平均期間の分布を反映しています。
スパン A の 例外の数/例外の割合 パラメーターは 2/20.00% です。これは、スパン A に 2 つの例外があり、リクエストの総数の 20% を占めていることを示します。スパン B の 例外の数/例外の割合 パラメーターは 2/50.00% です。各リクエストがスパン B を 2 回呼び出すとすると、リクエストの総数は 4 で、例外比率は 50% であるため、2 つのリクエストに例外があります。したがって、スパン B の例外の分布は次のようになります。合計 4 つのリクエストのうち、2 つのリクエストは成功しています。残りの 2 つのリクエストのうち、各リクエストの最初の呼び出しで例外が発生しますが、2 番目の呼び出しは成功しています。
特定のトレースの詳細を表示するには、ポインターを青いスパン名の上に移動します。推奨される traceId をクリックして詳細を表示できます。
トレース トポロジー
[フルリンク トポロジー] タブには、集約されたトレースのアプリケーション間トポロジーが表示されます。次の図は、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 名は logstore-tracing です。region-id パラメーターは、トレースエクスプローラーを使用するリージョンです（例: cn-hangzhou）。データ形式については、「トレースエクスプローラーのパラメーター」をご参照ください。保存されたフルトレースデータに対してカスタム開発を実行できます。フィルター条件または集約ディメンションに基づいて、保存されたフルトレースデータを分析できます。これにより、さまざまなシナリオでのカスタム診断の要件を満たすことができます。詳細については、「トレースエクスプローラーを使用してトレースデータをリアルタイムで分析する」をご参照ください。
参考資料
よくある質問
トレースで SQL 文が切り捨てられるのはなぜですか? トレースに含まれるものは何ですか？
デフォルトでは、ARMS は SQL 文を 1,024 文字に制限します。アプリケーションの [カスタム構成] タブの [データベース呼び出し構成] セクションで、[SQL コレクションの最大保持長] の値を変更できます。
ARMS エージェントを V4.x に更新した後、Nacos 呼び出し期間が 30 秒以上のスパンが多数表示されるのはなぜですか?多くのスパンで、ARMS エージェントを V4.x に更新した後、Nacos 呼び出し時間が 30 秒以上になりますか？
ARMS エージェント 4.x は、構成の更新とサービス検出のために Nacos によって開始された HTTP ロングポーリングリクエストをインストルメント化します。ただし、これらのスパンは V3.x ではキャプチャされません。詳細については、「[お知らせ] ARMS エージェント V4.x の更新」をご参照ください。
これらのスパンを無視するには、アプリケーションの [カスタム構成] タブの [インターフェイス呼び出し構成] セクションでフィルタリングします。
この機能は、ARMS エージェント V4.2.x 以降でのみ使用できます。
