メトリック拡張機能テンプレートのテストおよび公開
メトリック拡張テンプレートを管理対象データベースに対してテストして、そのSQL問合せが予期されるメトリックおよびディメンションを返すことを確認できます。テンプレートを公開して、メトリック拡張の作成に使用できるようにします。
テストの前に、選択したデータベース・ユーザーにSQL問合せの実行に必要な権限があることを確認してください。問合せまたはその他のテンプレート設定を変更するには、ドラフト・テンプレートの「アクション」メニューで「編集」をクリックし、変更を加えて「変更の保存」をクリックします。
テンプレートのテストでは、メトリックをモニタリング・サービスに公開したり、スケジュール済メトリックの公開に必要な権限を確認したりしません。
メトリック拡張テンプレートのテスト
- 「メトリック拡張テンプレート」ページに移動します。
- 「コンパートメント」適用済フィルタで、正しいコンパートメントが選択されていることを確認します。
- テンプレートの「アクション」アイコン(
)をクリックし、「テスト」をクリックします。
- 「メトリック拡張テンプレートのテスト」パネルで:
- 「このテストのSQL問合せ」フィールドに表示されている問合せを確認します。
- SQL問合せでバインド変数を使用する場合は、テストに使用する値を入力します。デフォルト値は、使用可能な場合は事前に入力され、変更できます。必要な各変数に値を指定します。
- テスト・データベースを選択します。
- 管理対象データベース・コンパートメント: 管理対象データベースを含むコンパートメントを選択します。
- 管理対象データベース: テンプレートをテストする管理対象データベースを選択します。
- 次の資格証明オプションのうち1つを選択します。
- 優先資格証明: 選択したデータベースに対して構成された優先資格証明を使用します。このオプションは、優先資格証明が構成されている場合にのみ表示されます。
- デフォルトのモニタリング資格証明: 選択したデータベースのデータベース管理で使用されるモニタリング資格証明を使用します。
- 名前付き資格証明: テストに使用する資格証明スコープ(リソース資格証明またはグローバル資格証明)、コンパートメントおよび名前付き資格証明を選択します。
- 必要に応じて、「前のテスト結果」セクションを確認します(使用可能な場合)。「すべてのテスト実行の表示」をクリックして、テスト履歴を表示します。
- 「テストの実行」をクリックします。
- テスト・ステータスおよび戻されたメトリック、ディメンションおよび値をレビューします。テストが失敗した場合は、エラー・メッセージを確認して問題を解決し、テストを再度実行します。
「メトリック拡張テンプレート」ページでテンプレート名をクリックし、「テスト実行」タブをクリックして、テスト履歴を表示することもできます。
メトリック拡張テンプレートの公開
テンプレートをテストし、その結果を確認したら、公開します。
テンプレートの公開後は、その名前と説明のみを編集できます。SQL問合せまたはその他の収集設定を変更するには、テンプレートをクローニングしてコピーを更新します。
- 「メトリック拡張テンプレート」ページに移動します。
- コンパートメント適用済フィルタで正しいコンパートメントが選択されていることを確認します。
- ドラフト・テンプレートの「アクション」アイコン()をクリックし、「公開」をクリックします。
- 「メトリック拡張テンプレートの公開」ダイアログ・ボックスで、情報を確認します。
通常の公開では、最新の保持されたテスト実行が成功し、そのテスト以降もテンプレートは変更されません。使用可能な保持されたテスト結果がない場合、最新の保持されたテストが成功しなかった場合、またはテスト後にテンプレートが変更された場合、ダイアログ・ボックスに警告が表示され、「強制パブリッシュ」が使用可能になります。強制パブリッシュでは、成功したテストおよび変更されていないテンプレート・チェックはバイパスされます。「強制パブリッシュ」は、テンプレートとテスト結果を確認した後にのみ使用します。
「公開」をクリックするか、警告を確認して続行する場合は「公開の強制」をクリックします。
テンプレートのステータスが「公開済」に変わり、そのバージョンが「メトリック拡張テンプレート」ページに表示されます。