トレース・エクスプローラでのトレースのモニター

トレース・エクスプローラでApplication Performance Monitoringデータ・ソースを使用してアップロードされたトレースおよびスパンをモニターできます。

トレースは、リクエストを処理するアプリケーションが費やした時間およびリクエストのステータスをトラッキングするために使用されます。各トレースは1つ以上のスパンで構成され、トレース・エクスプローラでのトレースのリストは、トランザクションの開始であるルート・スパンのリストです。たとえば、ページ・アップロード・トレースは、AJAXコール・スパンやページ更新スパンなどで構成されます。また、スパンにはディメンションがあります。これは、スパンにアタッチされたキーと値のペアであり、スパン内で実行される操作に関する追加情報とコンテキストを提供します。トレース・エクスプローラでは、ディメンションを使用してトレースとスパンを問合せおよびフィルタできます。

トレースをモニターするには:

  1. Oracle Cloud Infrastructureコンソールにサインインします。
  2. ナビゲーション・メニューを開き、「オブザーバビリティおよび管理」をクリックします。「Application Performance Monitoring」で、「トレース・エクスプローラ」をクリックします。
  3. 「トレース・エクスプローラ」ページの右上で、コンパートメントとAPMドメインを選択します。オプションで、デフォルトの期間(「過去60分」)を変更して、選択した時間範囲内に開始されたスパンを含むすべてのトレースを表示できます。

トレース・エクスプローラには、即時利用可能な問合せによって決定されたトレース・データが表示されます。このページには次の主要コンポーネントがあり、それらを使用して、即時利用可能な問合せを実行または編集し、モニターするアプリケーション領域に関連するトレース・データが表示されるようにビューをカスタマイズできます。

  • チャート(デフォルトでは左側にクローズ)には、timeseriesを含む問合せから選択したスパーク・チャートが表示されます。

    「チャート」パネルを開いた状態で、timeseriesを含む問合せを実行するか、問合せにtimeseriesがすでに含まれている「トレース・サービス」クイック・ピック・ボタンをクリックすると、表のスパーク・チャートをクリックして、イメージの下部に表示される「チャート」パネルに追加できます。パネルに表示する複数のチャートを追加できます。これにより、グラフをよく見て、それらを一目で比較できます。

  • 左側の「属性」には、問合せに追加できる「トレース」および「スパン」で使用可能なディメンション(文字列値を含む)およびメトリック(数値を含む)がリストされます。次の属性が含まれます。
    • Application Performance Monitoringで使用可能な、データ・ソースによって構成された即時利用可能な属性(サービス名や操作名など)。選択したAPMドメインに関係なく、「属性」リストでは即時利用可能な属性と同じセットを使用できます。
    • データ・ソースの構成時に要件に基づいて追加できるカスタム属性。カスタム属性のセットは、選択したAPMドメインに固有です。

    ディメンションの上にマウスを置くと、リンクが表示され、それをクリックして「ディメンション<名前>値」ダイアログ・ボックスにディメンションの値を表示できます。ApdexScoreなどのメトリック(数値)のリンクは表示されません。また、ディメンションが「トレース」タブまたは「属性」内の「スパン」タブのどちらにリストされているかに応じて、ディメンション値が異なります。「トレース」タブにリストされているディメンションをクリックすると、「ディメンション<名前>の値」ダイアログにトレース(ルート・スパン)の値のみが表示され、「スパン」タブで同じディメンションをクリックすると、すべてのスパンの値が表示されます。「ディメンション<名前>の値」ダイアログ・ボックスには、「コピー」、「問合せに追加」および「グローバル・フィルタに追加」ボタンもあり、これをクリックしてディメンション値をコピーしたり、問合せまたはグローバル・フィルタに挿入できます。

    詳細情報:

  • 左側の「スパンの比較」には、相互に比較するために選択したスパンのリストが表示されます。

    最大4個のスパンをリストに追加できます。詳細は、「スパンの比較」を参照してください。

  • 問合せバーには、即時利用可能な問合せ、問合せバーの右側にある「アクション」アイコン(「アクション」アイコン)、問合せを実行するための「実行」、およびバックグラウンド問合せの表示のドロップダウン・メニューが付属しているクイック・ピック・ボタンが含まれています。

    クイック・ピック・ボタン: デフォルトでは、「クイック・ピック」ボタン(「トレース」、「サービス」、「操作」など)には、トレース・データ検索のいくつかに基づく即時利用可能な問合せが付属しています。トレース・エクスプローラでの問合せは、句とディメンションを含む簡略化されたSQLのような構文に従って、トレース・データをフィルタ、分類および表示します。これにより、大量のトレース・データをフィルタし、関心のある情報を表示できます。

    たとえば、「トレース」クイック・ピックの即時利用可能な問合せは、句および即時利用可能なディメンションを使用してトレースに関する情報を表示します。

    show (traces) TraceStatus as Status,
        TraceFirstSpanStartTime as "Start Time",
        ServiceName as Service,
        OperationName as Operation,
        TraceDuration as Duration,
        span_summary() as Spans,
        ErrorCount as "Span Errors"
      where (ApmrumPageUpdateType <> 'Click' or ApmrumPageUpdateType is omitted)

    この問合せに基づいて、選択した期間について次の列を含む100個のトレースのリストが表示されます:

    • サービス: 操作: トレースのルート・スパン、つまりリクエストが開始されたサービスおよび操作が表示されます。問合せのwhere句で指定されているように、ユーザー・アクティビティ操作(ApmrumPageUpdateType)がClickであるか、値が定義されていないルート・スパンは表示されません。
    • ステータス: トレースのステータスが表示されます:
      • 完了: トレース・エクスプローラでルート・スパンが使用可能であるが、エラーに関する情報が使用可能でないことを示します。
      • 未完了: トレース・エクスプローラでルート・スパンが使用可能でないため、トレースが不完全であることを示します。
      • 成功: トレース・エクスプローラでルート・スパンが使用可能であり、エラー・コードとタイプが成功を表していることを示します(HTTP 200)。
      • エラー: ルート・スパンにエラーがあることを示します。
    • 開始時間: ルート・スパンが開始された時間が表示されます。

      トレースのリストは「開始時間」列でソートされますが、使用可能ないずれの列でもリストをソートできます。たとえば、トレース・リストを「期間」でソートすると、最も長い時間がかかったトレースがリストの先頭に表示されます。

    • 期間: 最初のスパンの開始から最後のスパンの終了までの期間が表示されます。「期間」列の棒グラフは、長時間実行されているトレースを識別するのに役立ちます。
    • スパン: トレース内のスパンの合計数が表示されます。「スパン」列の棒グラフの上にマウスを置くと、トレース内の各サービスのスパン数の内訳およびエラーの数(ある場合)が表示されます。
    • スパン・エラー: エラーのあるスパンの数が表示されます。

    Custom query bar: From Query Bars in Administration, under Resources, or from Manage using the Actions icon (「アクション」アイコン) at the right of the Query Bar, you can create a custom query bar, where you can add your own quick pick buttons with custom queries.

    「問合せバー」の右側にある「アクション」アイコン(「アクション」アイコン)から、「問合せバーを開く」パネルから使用可能な他の問合せバーを開いて現在の問合せバーにできます。現在の問合せバーをデフォルトとして保存することもできます。

    バックグラウンド問合せ: 問合せを作成してバックグラウンドで実行できます。これは、実行に時間がかかる問合せがある場合に役立ちます。詳細は、バックグラウンド問合せの構成を参照してください。

  • グローバル・フィルタを使用すると、トレース・エクスプローラでの作業中に有効になる問合せ結果のフィルタを追加できます。これにより、クイック・ピックの切替えなど、問合せの変更中に特定の基準を固定できます。where句として形成されるグローバル・フィルタは、問合せボックスには表示されませんが、問合せとともに機能し、バーの右側にあるスイッチを使用してオンまたはオフに切り替えることができます。

    問合せと同様に、グローバル・フィルタ・バーの右側にある「アクション」アイコン(「アクション」アイコン)を使用して、現在のフィルタを保存し、「グローバル・フィルタを開く」パネルを開くことができます。このパネルでは、保存済フィルタを検索、クイック編集およびオープンできます。「管理」の「グローバル・フィルタ」の「リソース」で、保存済フィルタをさらに編集、管理および削除できます。

各トレースまたはスパンの「アクション」アイコン(「アクション」アイコン)をクリックし、次の処理を実行することもできます:

  • 「トレース詳細の表示」または「スパン詳細の表示」
  • トレース・トポロジの表示
  • トレースの表示またはスパンの表示

問合せでトポロジ・ビューがサポートされている場合のみ、「トレース・トポロジの表示」オプションが「アクション」メニューに表示されることに注意してください。トレースまたはスパンのリストが表示され、「トレース詳細の表示」または「スパン詳細の表示」オプションは、group by句を含む集計問合せの結果について表示されます。