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

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

• チャート(デフォルトでは左側にクローズ)には、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.

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

  バックグラウンド問合せ: 問合せを作成してバックグラウンドで実行できます。これは、実行に時間がかかる問合せがある場合に役立ちます。問合せステータスおよび結果は後で取得できます。

  バックグラウンド問合せを実行するには、「実行」の横にあるドロップダウン・メニューに移動し、「問合せをバックグラウンドで実行」オプションを選択します。バックグラウンド問合せを作成するためのウィンドウが表示されます。ご希望のオプションで更新し、「送信」をクリックします。

  バックグラウンド問合せを作成した後、「バックグラウンド問合せの表示」を選択して、以前に初期化した問合せのリストを表示します。「ステータス」、「行」、「失効」などのバックグラウンド問合せに関する情報を表示できます。「アクション」アイコン()を使用して、「詳細の表示/編集の詳細」、「問合せ結果のフェッチ」、「属性からの新規問合せ」、「問合せの再実行」および「削除」など、その他のオプションを表示します。

  バックグラウンド問合せを編集するには、「詳細の表示/編集」を使用します。たとえば、バックグラウンド問合せの有効期限を延長する必要がある場合は、「期限切れ」フィールドを更新します。デフォルトの「失効」値は30日です。

  バックグラウンド問合せの結果を絞り込むには、属性からの新規問合せを使用します。たとえば、結果から返される行が少なくなるようにする場合は、属性を含むwhere句を追加できます。

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

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

You can also click the Actions icon () for each trace or span and perform the following actions:

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

Note that the Show Trace Topology option is displayed in the Actions menu only if the query supports the Topology view. The Show Trace Details or Show Span Details options are displayed when a list of traces or spans is displayed and the Show Traces or Show Spans options are displayed for results of aggregate queries that have the group by clause.