Application Real-Time Monitoring Service (ARMS) は、保存されたフルトレースデータを分析するためのトレースエクスプローラー機能を提供します。トレースエクスプローラーでは、保存されたフルトレースデータに基づいて、フィルター条件と集計ディメンションを組み合わせてリアルタイム分析を行うことができます。これにより、さまざまなシナリオでのカスタム診断要件を満たすことができます。
手順
ARMS コンソールにログインします。
左側のナビゲーションペインで、 を選択します。 上部のナビゲーションバーで、リージョンを選択します。
トレースエクスプローラーページの右上隅で、クエリする時間範囲を選択します。
フィルター条件を指定します。
クイックフィルターセクションで、ステータス、期間、アプリケーション名、スパン名、またはホストアドレスでトレースをクエリします。
指定されたフィルター条件は、検索バーに表示されます。
検索バーをクリックします。ドロップダウンフィルターパネルで、既存のフィルター条件を設定するか、カスタムフィルター条件を追加します。
検索バーにクエリステートメントを入力します。構文の詳細については、トレースエクスプローラーの使用方法を参照してください。
説明集計ディメンションドロップダウンリストの右側にある
アイコンをクリックして、指定したフィルター条件をビューに保存します。 保存済みビューをクリックして、保存されているすべてのビューを表示するか、ビューをクリックして対応するトレースデータを表示します。
クエリされたデータを特定のディメンションに基づいて集計します。
トレースリスト
フィルター条件を指定すると、トレースエクスプローラーページにトレースデータが表示されます。トレースデータには、呼び出しと HTTP エラーの縦棒グラフ、期間の時系列曲線、およびトレースリストが含まれます。
トレースリストでは、次の操作を実行できます。
トレース 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% |
リクエスト数/リクエストの割合パラメーターは、総リクエスト数が 10 で、リクエスト比率が 100% であることを示します。リクエスト数/リクエストの割合パラメーターは、スパン B を呼び出すリクエストが 4 つだけであることを示します。同様に、スパン C を呼び出すリクエストは 1 つだけです。スパン B のリクエスト比率は 40% で、スパン C のリクエスト比率は 10% です。論理判断または例外により、他のリクエストはスパン B とスパン C を呼び出しません。これは、リクエストの分布を反映しています。
スパン/リクエスト倍数パラメーターは 10/1.00 で、これはスパン A が各リクエストによって 1 回だけ呼び出されることを示します。ただし、スパン B の場合、8 つのスパンが 4 つのリクエストによって呼び出されます。したがって、スパン B は各リクエストによって 2 回呼び出されます。これは、各リクエストにおけるスパンの分布を反映しています。
平均自己消費/割合パラメーターは 5.00 ms/25.00% で、これはスパン A の平均自己時間 (スパン B とスパン C を除く) が 5 ミリ秒であることを示します。スパン A の平均自己時間は、全体の平均時間のわずか 25% を占めます。ただし、スパン B とスパン C には子スパンがないため、スパン B とスパン C の平均自己時間は全体の平均時間と同じです。これは、平均期間の分布を反映しています。
例外の数/例外比率パラメーターは 2/20.00% で、これはスパン A に 2 つの例外があり、総リクエスト数の 20% を占めることを示します。例外の数/例外の割合パラメーターは 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 名は logstore-tracing です。region-id パラメーターは、トレースエクスプローラーを使用するリージョンです (例：cn-hangzhou)。データ形式については、トレースエクスプローラーのパラメーターを参照してください。保存されたフルトレースデータに対してカスタム開発を実行できます。フィルター条件または集計ディメンションに基づいて、保存されたフルトレースデータを分析できます。これにより、さまざまなシナリオでのカスタム診断の要件を満たすことができます。詳細については、トレースエクスプローラーを使用してトレースデータをリアルタイムで分析するを参照してください。