メトリック拡張テンプレートの作成

メトリック拡張テンプレートを作成して、メトリック拡張のSQL問合せ、バインド変数、メトリック、ディメンションおよび推奨収集設定を定義できます。

テンプレートのSQL問合せが、選択したデータベースに適用可能であり、テストおよびメトリック収集に使用されるデータベース・ユーザーに、その実行に必要な権限があることを確認します。

メトリック拡張テンプレートを作成するには:

1. Oracle Cloud Infrastructureコンソールにサインインします。
2. ナビゲーション・メニューを開き、「オブザーバビリティおよび管理」をクリックします。「データベース管理」で、「管理」をクリックします。
3. 左側のペインの「テンプレート・ライブラリ」で、「メトリック拡張テンプレート」をクリックします。
4. コンパートメント適用済フィルタで正しいコンパートメントが選択されていることを確認します。
5. 「メトリック拡張テンプレートの作成」をクリックします。
6. 「メトリック拡張テンプレートの作成」パネルで:
   1. テンプレート情報を指定します。
      1. 名前: テンプレートの名前を入力します。
      2. 説明: オプションで、メトリック拡張テンプレートの説明を入力します。
      3. ネームスペースのモニタリング: 収集されたメトリックがパブリッシュされるネームスペースを指定します。新しいメトリック拡張の場合は、カスタム・ネームスペースを使用します。oracle_またはoci_で始まるネームスペースは、レガシー・メトリック拡張との互換性のために保持されているoracle_metric_extensions_appmgmtを除き、サポートされていません。
      4. モニタリング・リソース・グループ: オプションで、モニタリング・ネームスペース内で収集されたメトリックを編成するリソース・グループ名を指定します。

         モニタリング・ネームスペースおよびリソース・グループは、テンプレートからメトリック拡張を作成するときに変更できます。

   2. 推奨される収集スケジュールを指定します。
      1. スケジュール単位: 収集間隔の単位を選択します。
      2. スケジュール値: 収集間隔値を選択します。

      メトリック拡張ごとに異なるスケジュールを選択できます。

   3. メトリック問合せを指定します。「SQL問合せ」フィールドに、後続のセミコロンなしで読取り専用SQL問合せを入力します。最上位問合せによって返されるすべての列は、メトリックまたはディメンションを表し、二重引用符で囲まれた別名を持つ必要があります。
      • 数値メトリック値には、metric_接頭辞を使用します。
      • ディメンションにはdimension_接頭辞を使用します。

      たとえば、次の問合せでは、メトリックUsedPercentおよびディメンションTablespaceNameを定義します。

      SELECT tablespace_name AS "dimension_TablespaceName",
             used_percent AS "metric_UsedPercent"
      FROM dba_tablespace_usage_metrics
      WHERE tablespace_name = :tablespace_name

      SQL問合せ内で計算を実行します。個別の非表示列および問合せ後の計算式はサポートされません。

      ノート
      
      データベース管理では、resourceIdディメンションおよびresourceNameディメンションが収集されたメトリックに追加されます。これらのディメンションは、テンプレート問合せで宣言しないでください。
   4. SQL問合せでバインド変数を使用する場合は、「バインド変数」セクションで「バインド変数の追加」をクリックし、次のフィールドを構成します。
      1. 名前: SQL問合せで使用されるバインド変数名を指定します。
      2. データ型: バインド変数のデータ・タイプを選択します。
      3. 実行時に必要: このオプションを有効にすると、テンプレートのテスト時またはメトリック拡張の作成時に値を必要とします。
      4. デフォルト値: 「実行時に必須」が有効になっていない場合は、デフォルト値を指定します。
      5. 説明: オプションで、バインド変数の説明を入力します。

      「SQL問合せ」ステップの例では、「データ型」を「文字列」に設定してtablespace_nameバインド変数を構成し、「実行時に必須」を有効にして、デフォルト値を未設定のままにします。テンプレートをテストしてメトリック拡張を作成するときに、その値を指定します。

7. 「作成」をクリックします。

   新しいテンプレートは、「メトリック拡張テンプレート」ページに「ドラフト」ステータスとともにリストされます。

テンプレートの「アクション」アイコン()をクリックし、次のタスクを実行できます:

• 編集: テンプレート情報、推奨される収集スケジュール、SQL問合せまたはバインド変数定義を更新する場合にクリックします。公開済テンプレートの場合、名前と説明のみ編集できます。
• テスト: 管理対象データベースに対してテンプレートをテストし、問合せ結果を確認する場合にクリックします。
• クローン: クリックすると、テンプレートのコピーを作成できます。
• 公開: ドラフト・テンプレートを公開し、メトリック拡張の作成に使用できるようにする場合にクリックします。
• メトリック拡張の作成: パブリッシュされたテンプレートからメトリック拡張を作成する場合にクリックします。
• 削除: クリックすると、ドラフト・テンプレートが削除されます。
• OCIDのコピー: テンプレートのOCIDをコピーする場合にクリックします。