Oracle Cloud Infrastructure Monitoringサービス・メトリックを使用して、問合せベースのウィジェットを作成できます。

1. 「ダッシュボード」ページに移動します。
2. 「ダッシュボードの作成」をクリックして新規ダッシュボードを作成するか、既存のダッシュボードを編集モードで開きます。
3. オプションで、「メトリック・ディメンション」フィルタをダッシュボードに追加します。

   「メトリック・ディメンション」フィルタを使用して、問合せベースのウィジェットのメトリック・ディメンション入力を指定できます。詳細は、「メトリック・ディメンション・フィルタの使用」を参照してください。

4. ウィジェット・タブで、ウィジェット・グループおよびウィジェットの追加アイコン()をクリックし、問合せベース・ウィジェットの作成...をクリックします。
   問合せベースのウィジェット・ビルダーが表示されます。
5. オプションで、「フィルタ・パネルをオープン/クローズ」アイコン()をクリックして、ダッシュボードに追加されたフィルタを表示し、必要に応じて変更します。

   問合せベースのウィジェットを作成して新しいダッシュボードに追加すると、「コンパートメント」フィルタが自動的に追加され、作成される新しいウィジェットのコンパートメント入力がこの新しく追加されたフィルタにリンクされます。また、「サブコンパートメント」チェック・ボックスが「コンパートメント」フィルタに表示され、これを選択すると、ルート・コンパートメント内のすべてのサブコンパートメントのメトリック・データを表示できます。サブコンパートメントからメトリック・データを表示するオプションは、ルート・コンパートメントが「コンパートメント」フィルタで選択されている場合にのみ使用できます。

6. 右上隅で、ウィジェットにデータを表示する期間を選択します。
7. 「データ・ソース」フィールドで「モニタリング」を選択します。
8. 次のモニタリング・サービス・メトリック詳細を指定します:
   1. ネームスペース: 該当するネームスペースを選択します。
   2. リソース・グループ: 必要に応じて、リソース・グループを選択します(使用可能な場合)。リソース・グループは、カスタム・メトリックで提供されるカスタム文字列で、フィルタまたは結果の集計に使用できます。
   3. 問合せ: このフィールドに表示されるデフォルト問合せを編集するか、新しい問合せを入力して、ウィジェットに表示するメトリック情報を取得します。

      問合せベースのウィジェットの作成に使用される問合せでは、モニタリング・サービスにパブリッシュされるメトリックの問合せ式を制御するMQL構文(METRIC[auto].grouping().mean())が使用されます。詳細は、Monitoring Query Language (MQL)リファレンスを参照してください。

   4. 「実行」をクリックします

   問合せが実行され、メトリック・データがメトリック、タイムスタンプおよび値の名前で表形式で表示されます。表チャートの下に、問合せによって返されたRAWデータを含む別の表が表示され、RAWデータを非表示をクリックして非表示にできます。

9. オプションで、入力パラメータを追加して、そのパラメータの異なる値を指定してウィジェットを再利用可能にします。たとえば、入力パラメータは、特定のディメンションでデータをフィルタするように構成できます。このディメンションでは、パラメータを介して値が指定されます。データベース管理サービス(oracle_oci_databaseネームスペース)の問合せベース・ウィジェットを作成してCPU使用率(CpuUtilizationメトリック)を表示する場合は、resourceNameディメンションを使用して入力パラメータを追加し、ウィジェット内の特定のリソースのCPU使用率データを表示するようにディメンション値を構成できます。
   1. 「設定」タブで、「入力の追加+」をクリックします。
   2. 無題のウィジェットに対する入力の構成(オプション)ダイアログ・ボックス:
      1. 入力名: 入力パラメータの名前を入力します。たとえば、ウィジェットの入力パラメータとしてresourceNameディメンションを追加する場合、入力名はresourcenameになります。問合せにプレースホルダ式を追加する場合は、入力名が必要です。
      2. 入力ラベル: 入力の表示名を指定します。入力名はデフォルトでこのフィールドに表示され、ユーザー・フレンドリにするために変更できます。
      3. デフォルト設定: デフォルト設定を確認し、必要に応じて変更します。
         ノート
         
         デフォルト設定を更新して入力パラメータを構成すると、このウィジェットが別のダッシュボードに追加されるたびに同じ設定が適用されます。ウィジェットの作成およびウィジェット・ライブラリへの追加後に値を編集できる入力パラメータを構成するには、このダイアログ・ボックスの「ウィジェット入力の構成」セクションのオプションを使用します。
         • 必須: 必須のウィジェット入力であることを示す場合に選択します。このチェック・ボックスを選択し、入力パラメータを構成しない場合、データはウィジェットに表示されません。
         • 複数値の許可: 入力パラメータに対して複数の値を構成できるようにする場合に選択します。
         • ウィジェット・ユーザーが<name>入力をフィルタにリンクすることを許可します: 固定入力パラメータ値のみを指定する場合のみ、このチェック・ボックスの選択を解除します。このチェック・ボックスはデフォルトで選択されており、選択を解除すると、入力をフィルタにリンクするために使用できるフィールドはダイアログ・ボックスに表示されません。
         • ウィジェット・ユーザーによる<name>入力の指定を許可します: 入力をフィルタにリンクする場合のみ、このチェック・ボックスの選択を解除します。このチェック・ボックスはデフォルトで選択されており、選択を解除すると、固定入力パラメータ値を指定するために使用できるフィールドはダイアログ・ボックスに表示されません。
      4. ウィジェット入力の構成: 次のオプションから選択して、入力パラメータを構成します:
         • 入力と既存のフィルタのリンク: 入力パラメータをウィジェットの既存のフィルタにリンクする場合に選択します。
         • 入力の指定: 固定入力パラメータ値を指定する場合に選択します。このパラメータは、このウィジェット・コンテキストでのみ使用されます。
         • 未構成: 入力を構成解除したままにする場合に選択します。
   3. 次の式を使用して、問合せにプレースホルダを追加して、ウィジェットの追加入力パラメータのデータを表示します。

      {<dimension>=$(params.<input_name>)}

      ステップ8の先頭で説明した同じ例を使用して、resourceNameディメンションの入力パラメータを追加した後、次のプレースホルダ式(太字)をCpuUtilization問合せに追加して、ウィジェットのリソースでデータをフィルタする必要があります。

      CpuUtilization[auto]{resourceName=$(params.resourcename)}.mean()

10. 右側の次のタブを使用して、ウィジェットの名前を追加したり、ウィジェット内のデータのビジュアライゼーションをカスタマイズするなどのタスクを実行します。
    ノート
    
    右上隅の「JSON」をクリックして、ウィジェットのJSONメタデータを直接編集できます。JSONエディタでは、ウィジェットのデータをビジュアル化するための柔軟性が高く、より多くのオプションが提供されますが、ウィジェットJSONの編集に精通している場合にのみ使用することをお薦めします。JSONエディタの詳細は、Oracle Supportにお問い合せください。

    • バージョン情報: ウィジェットの名前を入力し、ウィジェットを配置するコンパートメントを選択して、ウィジェットの説明を追加します。

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

      • タグ付けの概念およびタグの操作に必要な権限は、タグ付けの概要を参照してください。
      • リソースの作成時にタグを追加する方法は、リソースの作成時にタグを追加するにはを参照してください。
    • ビジュアル化: チャート・タイプを選択し、追加オプションを指定または変更してビジュアライゼーションをカスタマイズします。

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

      • X軸: X軸に投影するデータ属性を選択します。X軸では、メトリック、ネームスペースなどの名前を表示するように選択できます。
      • Y軸: Y軸に投影するデータ属性を選択します。Y軸は数値のデータ属性をサポートし、それらのみがリストされます。
      • シリーズ: チャート内の個別のシリーズで描画するデータ属性を選択します。たとえば、問合せにディメンションを含むgroupBy句を追加し、そのディメンションの様々な値に対して個別の系列を表示します。次の問合せでは、oracle_oci_databaseネームスペースのCPU使用率メトリックがresourceNameディメンション別にグループ化され、リソースごとに個別のシリーズが表示されます。

        CpuUtilization[auto].groupBy(resourceName).mean()

        このオプションは、円グラフでも使用できます。

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

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

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