トレースを使用した問合せベースのウィジェットの作成

Application Performance Monitoringトレースを使用して、問合せベースのウィジェットを作成できます。

問合せベースのウィジェット・ビルダーで使用可能な多くの機能を使用して、Trace Query Language (TQL)式を表示するウィジェットを作成できます。問合せベースのウィジェット・ビルダーには、トレース・データをビジュアル化およびモニターするためのオプションと機能が用意されています。たとえば、多くの顧客が使用する場合にパフォーマンスが低いスコアを持つトランザクションを表示できるため、これらのトランザクションはパフォーマンス向上に見合う価値があります。

トレース・データを表示する問合せベースのウィジェットを作成するには:

  1. 「ダッシュボード」ページに移動します。
  2. 「ダッシュボードの作成」をクリックして新規ダッシュボードを作成するか、既存のダッシュボードを編集モードで開きます。
  3. ウィジェット・タブで、ウィジェット・グループおよびウィジェットの追加アイコン(ウィジェット・グループおよびウィジェットの追加)をクリックし、問合せベース・ウィジェットの作成...をクリックします。
    問合せベースのウィジェット・ビルダーが表示されます。
  4. オプションで、「フィルタ・パネルをオープン/クローズ」アイコン(フィルタ・パネルを開く/閉じる)をクリックして、すでにダッシュボードに追加されているフィルタを表示し、必要に応じて変更します。

    問合せベースのウィジェットを作成して新しいダッシュボードに追加すると、「コンパートメント」フィルタが自動的に追加され、作成される新しいウィジェットのコンパートメント入力がこの新しく追加されたフィルタにリンクされます。

  5. 右上隅で、ウィジェットにデータを表示する期間を選択します。
  6. 「データ・ソース」ドロップダウン・リストで「トレース」を選択します。
    APMドメイン・フィルタがダッシュボードに追加されない場合、「トレース」が選択されると自動的に追加されます。
  7. 「問合せ」フィールドに表示されるデフォルトの問合せを編集するか、新しい問合せを入力して「実行」をクリックします。

    TQL構文を使用して、問合せを作成し、Application Performance Monitoringからトレース・データを取得します。TQLの詳細は、問合せの作業を参照してください。

    トレース・データは、サービスの名前およびその他の詳細とともに表形式で表示されます。表チャートの下に、トレース問合せによって返されたRAWデータを含む別の表が表示され、「RAWデータを非表示」をクリックして非表示にできます。

  8. 右側の次のタブを使用して、ウィジェットの名前を追加したり、ウィジェット内のデータのビジュアライゼーションをカスタマイズするなどのタスクを実行します。
    ノート

    右上隅の「JSON」をクリックして、ウィジェットのJSONメタデータを直接編集できます。JSONエディタでは、ウィジェットのデータをビジュアル化するための柔軟性が高く、より多くのオプションが提供されますが、ウィジェットJSONの編集に精通している場合にのみ使用することをお薦めします。JSONエディタの詳細は、Oracle Supportにお問い合せください。
    • バージョン情報: ウィジェットの名前を入力し、ウィジェットを配置するコンパートメントを選択して、ウィジェットの説明を追加します。

      オプションで、「拡張オプションの表示」をクリックして、フリーフォームまたは定義済のタグをウィジェットに追加します。ウィジェットの作成に必要な権限がある場合は、フリーフォーム・タグを追加することもできます。定義済タグを追加するには、タグ・ネームスペースを使用する権限が必要です。詳細は、次を参照してください:

    • ビジュアル化: チャート・タイプを選択し、追加オプションを指定または変更してビジュアライゼーションをカスタマイズします。

      チャート・タイプとして「表」を選択した場合は、一部の列を削除するか、「すべての列」チェック・ボックスを選択してすべての列を表示できます。「線」チャートなど、X軸およびY軸を持つチャート・タイプには、次の追加のビジュアライゼーション・オプションの組合せがあります。

      • X軸: X軸に投影するデータ属性を選択します。
      • Y軸: Y軸に投影するデータ属性を選択します。Y軸は数値のデータ属性をサポートし、それらのみがリストされます。
      • シリーズ: チャート内の個別のシリーズで描画するデータ属性を選択します。このオプションは、グラフでも使用できます。
      • サイズ: サイズを割り当てる値を持つデータ属性を選択します。このオプションは、バブル・チャートでのみ使用できます。
      • 色の基準: 値が異なる色を割り当てるデータ属性を選択します。通常は、「色の基準」オプションを「系列」オプションとともに使用して、個別の色を個別の系列に割り当てます。このオプションは、グラフでも使用できます。
      • X軸のタイトル: X軸に投影されるデータ属性のタイトルを指定します。
      • Y軸のタイトル: Y軸に投影されるデータ属性のタイトルを指定します。
      • 凡例: ウィジェット内の凡例の位置を指定します。このオプションは、グラフでも使用できます。
      • 相関ツールチップ: ダッシュボード内のすべての問合せベース・ウィジェットにわたってツールチップを相互に関連付けるには、このオプションを選択します。
      • データ・カーソル: ウィジェットにマウスを置いたときにツールチップを表示するには、このオプションを選択します。
      • 積上げ: チャートに表示されるデータ属性を色でスタックする場合は、このオプションを選択します。
      • 単色を使用: ビジュアライゼーションに「面」チャートを使用する場合、データの存在を表す面は単色になります。このオプションはデフォルトで選択されています。

      問合せベースのウィジェット・ビルダーのビジュアライゼーションの詳細は、「ビジュアライゼーションについて」を参照してください。

    • 設定: 必要に応じて、ウィジェット入力をレビューおよび編集します。
  9. 「保存」をクリックしてウィジェットをウィジェット・ライブラリに保存し、ダッシュボードに追加します。

指定した期間の上位5件のトランザクションが折れ線グラフを使用して表示されるシナリオを次に示します。問合せベースのウィジェット・ビルダーで、次の手順を実行します。

  1. 右上隅で期間が選択されていることを確認します。
  2. 「データ・ソース」ドロップダウン・リストで、「トレース」を選択します。
  3. 「問合せ」フィールドに次のトレースを入力し、「実行」をクリックします。
    show traces OperationName as Transaction, avg(traceDuration) as Duration where pageviews > 0 group by OperationName order by count(*) first 5 rows timeseries
  4. 「ビジュアライゼーション」タブで次を指定します:
    1. 「チャート・タイプ」として「折れ線」チャートを選択します。
    2. 「Y軸」ドロップダウン・リストで、「timeseries.Duration」を選択します。
    3. 「X軸」ドロップダウン・リストで、「timeseries.date」を選択します。
    4. 「シリーズ」ドロップダウン・リストで「トランザクション」を選択します。
    5. 「色の基準」ドロップダウン・リストで「トランザクション」を選択します。

上位5件のトランザクションを含む折れ線グラフが表示されます。

問合せベースのトレース・ウィジェット