Autonomous Databaseメトリックを使用したパフォーマンスのモニター

Autonomous Databaseメトリックを表示するステップを示します。

1. 「Autonomous Databaseの詳細」ページで、「モニタリング」タブを選択します。
2. メトリックごとにチャートがあります。各チャートで、「間隔」および「統計」を選択するか、デフォルト値を使用できます。

• ログおよび監査証跡の表示
  Autonomous Databaseのログおよび監査証跡を表示するステップを示します。

コンパートメント内のAutonomous Databaseのメトリックを表示するステップを示します。

1. 「サービス・メトリック」ページの「コンパートメント」で、コンパートメントを選択します。
2. 「サービス・メトリック」ページの「メトリック・ネームスペース」で、「oci_autonomous_database」を選択します。
3. コンパートメント内に複数のAutonomous Databaseがある場合、「集計メトリック・ストリーム」を選択すると、Autonomous Database全体で集計されたメトリックを表示できます。
4. 表示されるメトリックを制限する場合は、「ディメンション」の横にある「追加」をクリックします(ディメンションをすでに追加している場合は「編集」をクリックします)。
   1. 「ディメンション名」フィールドでディメンションを選択します。
   2. 「ディメンション値」フィールドで値を選択します。
   3. 「完了」をクリックします。

   「ディメンションの編集」ダイアログで、「+Additionalディメンション」をクリックして、別のディメンションを追加します。ディメンションを削除するには、「x」をクリックします。

メトリックとディメンションを表示するインスタンスを制限できます。使用可能なディメンションには、ワークロード・タイプ、インスタンス表示名、リージョンおよびインスタンスOCIDが含まれます。

Autonomous Databaseでカスタム・メトリックを作成および公開する方法について説明します。

前提条件

1. Oracle Cloud Free Tierまたは有料クラウド・アカウントを通じてOracle Cloud Infrastructureへのアクセスを取得します。

   詳細は、Oracle Cloudアカウントの取得を参照してください。

2. Autonomous Databaseインスタンスを作成するか、既存のAutonomous Databaseインスタンスへのアクセス権を持ちます。

   詳細は「Autonomous Databaseインスタンスのプロビジョニング」を参照してください。

3. Autonomous DatabaseインスタンスのADMIN資格証明を取得します。

4. データベースに接続するには、データベース・アクションまたはSQL DeveloperやSQL*PlusなどのOracle Databaseクライアントを使用します。

   詳細は、Autonomous Databaseへの接続を参照してください。

5. OCIモニタリング・サービスおよびOCI Identity and Access Managementへのアクセスが必要です。

   詳細は、APIを使用したカスタム・メトリックの公開を参照してください。

OCIモニタリング・サービスを使用したカスタム・メトリックの概要

次の図は、Autonomous Databaseでカスタム・メトリックを作成および公開するステップを示しています。これは、Autonomous Databaseインスタンスで実行されているスクリプトを使用してメトリック・データを収集し、このデータをOCIモニタリング・サービスに公開すること、およびメトリック値のアラームと通知を作成する方法を示しています。

図autonomous-database-custom-metrics.epsの説明

• Autonomous DatabaseインスタンスにPL/SQLスクリプトを作成してデプロイします。このスクリプトは、カスタム・メトリックを計算、収集およびOCIモニタリング・サービスに公開するために定期的に実行されます。

• Autonomous Databaseインスタンスは、パブリック・エンドポイントまたはプライベート・エンドポイントに配置できます。Autonomous DatabaseインスタンスとOCIモニタリング・サービスの間の通信は、Oracle Cloudネットワークで行われます。つまり、OCIモニタリング・サービスにメトリックを公開するには、サービス・ゲートウェイを作成する必要はありません。

カスタム・メトリックの作成および公開

カスタム・メトリックを作成して公開するには:

1. OCI Identity and Access Managementで、Autonomous Databaseインスタンスの動的グループを作成し、OCIモニタリング・サービスにメトリックをポストする動的グループを認可するポリシーを作成します。

   たとえば:

   1. Oracle Cloud Infrastructureコンソールで、「アイデンティティおよびセキュリティ」をクリックします。
   2. 「アイデンティティ」で、「ドメイン」をクリックし、アイデンティティ・ドメインを選択します(または新しいアイデンティティ・ドメインを作成します)。
   3. 「アイデンティティ・ドメイン」で、「動的グループ」をクリックします。
   4. 「動的グループの作成」をクリックし、「名前」、「説明」およびルールを入力します。

      たとえば、Autonomous Databaseインスタンス用にadb_dgという名前の動的グループを作成し、ルールを作成します:

      ALL {resource.type = 'autonomousdatabase', resource.compartment.id = 'OCID_of_compartment'}

      または、コンパートメント内のすべてのインスタンスではなく、単一のAutonomous Databaseインスタンスを選択できます:

      ALL {resource.type = 'autonomousdatabase', resource.id = 'OCID_of_autonomousdatabase_instance'}

      
      

      
      図adb_custom_metrics_dynamic_group.pngの説明

      
      
   5. 「作成」をクリックします。
   6. OCI Identity and Access Management (IAM)ポリシーを作成して、動的グループを認可します。

      たとえば、動的グループadb_dgに、ポリシーadb_dg_policyを使用してOCIモニタリング・サービスにメトリックをポストすることを認可するポリシーを作成します。

      Allow dynamic-group adb_dg to use metrics in compartment OCID_of_compartment

      
      

      
      図adb_custom_metrics_policy.pngの説明

      
      

   ポリシーを定義した後、定義adb_dgを持つ動的グループは、コンパートメントにメトリックをポストする権限を持ちます。

   この時点で、Autonomous Databaseで実行されているPL/SQLルーチンは、OCIモニタリング・サービスにメトリックを公開する権限を持つAutonomous Databaseユーザーがいないため、OCIモニタリング・サービスにメトリックをポストできません。この機能は、次のステップ(ステップ2c)でリソース・プリンシパルを有効にするときに指定します。

2. Autonomous Databaseインスタンスで必要な権限を持つ新しいデータベース・ユーザーまたはスキーマを作成するか、必要な権限で既存のデータベース・ユーザーまたはスキーマを更新します。

   たとえば:

   1. データベース・ユーザーを作成するか、既存のユーザーを使用してメトリックを公開します。

      たとえば、Autonomous Databaseインスタンスに新規ユーザーECOMMERCE_USERを作成します:

      CREATE USER ECOMMERCE_USER IDENTIFIED BY "password";

      これで、新しいユーザーECOMMERCE_USERになります。次のステップは、このユーザーまたは指定したユーザーと同じです。ただし、別の名前でユーザーを作成する場合は、ECOMMERCE_USERを代替ユーザー名に置き換える必要があります。

   2. 必要なOracle Database関連の権限をユーザーに付与します。

      GRANT CREATE TABLE, ALTER ANY INDEX, CREATE PROCEDURE, 
             CREATE JOB, SELECT ANY TABLE, EXECUTE ANY PROCEDURE, UPDATE ANY TABLE, 
             CREATE SESSION, UNLIMITED TABLESPACE, CONNECT, RESOURCE 
             TO ECOMMERCE_USER;
      GRANT  SELECT ON "SYS"."V_$PDBS" TO ECOMMERCE_USER;
      GRANT  EXECUTE ON "C##CLOUD$SERVICE"."DBMS_CLOUD" to ECOMMERCE_USER;
      GRANT  SELECT ON SYS.DBA_JOBS_RUNNING TO ECOMMERCE_USER;

   3. Oracle Cloudリソース・プリンシパルのOracle Database資格証明を有効にし、ユーザーへのアクセス権を付与します。

      このステップでは、ステップ1で作成した動的グループadb_dgをデータベース・ユーザーECOMMERCE_USERに接続し、メトリックをOCIモニタリング・サービスにポストする権限をユーザーに付与します。

      たとえば:

      EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL(username => 'ECOMMERCE_USER');

      詳細は、リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセスを参照してください。

      リソース・プリンシパル認証のかわりに、OCIネイティブ資格証明を認証に使用できます。詳細は「CREATE_CREDENTIALプロシージャ」を参照してください。

   4. (オプション)前のステップで完了した操作を確認します。

      たとえば:

      SELECT OWNER, CREDENTIAL_NAME FROM DBA_CREDENTIALS WHERE CREDENTIAL_NAME = 'OCI$RESOURCE_PRINCIPAL'  AND OWNER =  'ADMIN';

      ADMIN以外のユーザーがOCIリソース・プリンシパルにアクセスできるかどうか(たとえば、ECOMMERCE_USERがデータベース資格証明にアクセスできるかどうか)を確認するには、DBA_TAB_PRIVSビューを使用します。

      SELECT * FROM DBA_TAB_PRIVS WHERE DBA_TAB_PRIVS.GRANTEE='ECOMMERCE_USER';

3. メトリック・データを公開し、スクリプトをAutonomous Databaseインスタンスで実行するようにスケジュールするPL/SQLスクリプトを作成します。
   1. たとえば、スター・スキーマ・ベンチマーク・サンプル・データの行をカウントし、OCIモニタリング・サービスに公開するメトリックを含むPL/SQLスクリプトを作成します。

      CREATE OR REPLACE PROCEDURE publish_lineorder_metric (p_sql_statement IN VARCHAR2)
      IS
      l_result NUMBER;
      l_compartment_ocid VARCHAR2(255);
      l_db_name VARCHAR2(255);
      l_region VARCHAR2(255);
      l_json_payload CLOB;
      l_cloud_identity CLOB;
      BEGIN
      
      -- 1. Execute the SQL statement and get the result
      EXECUTE IMMEDIATE p_sql_statement INTO l_result;
       
       -- 2. Get compartment OCID, DB name, and region from cloud identity
       SELECT cloud_identity INTO l_cloud_identity FROM v$pdbs;
        
       l_compartment_ocid := JSON_VALUE(l_cloud_identity, '$.COMPARTMENT_OCID');
       l_db_name := JSON_VALUE(l_cloud_identity, '$.DATABASE_NAME');
       l_region := JSON_VALUE(l_cloud_identity, '$.REGION');
       
      DBMS_OUTPUT.PUT_LINE(l_cloud_identity);
       
       -- 3. Construct the JSON payload for the metric
      
       l_json_payload :=
       '{' ||
       ' "metricData": [' ||
       ' {' ||
       ' "namespace": "custom_metrics",' ||
       ' "compartmentId": "' || l_compartment_ocid || '",' ||
       ' "name": "lineorder_metric",' ||
       ' "dimensions": {' ||
       ' "dbName": "' || l_db_name || '"' ||
       ' },' ||
       ' "datapoints": [' ||
       ' {' ||
       ' "timestamp": "' || TO_CHAR(SYSTIMESTAMP AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS.FF3"Z"') || '",' ||
       ' "value": ' || l_result ||
       ' }' ||
       ' ]' ||
       ' }' ||
       ' ]' ||
       '}';
       
       -- 4. Publish the metric using DBMS_CLOUD.SEND_REQUEST
      
       DECLARE
       l_response DBMS_CLOUD_TYPES.resp;
       BEGIN
       l_response := DBMS_CLOUD.SEND_REQUEST(
       credential_name => 'OCI$RESOURCE_PRINCIPAL',
       uri => 'https://telemetry-ingestion.' || l_region || '.oraclecloud.com/20180401/metrics',
       method => 'POST',
       body => UTL_RAW.CAST_TO_RAW(l_json_payload)
       );
       
       –- 5. Check response status
      
       IF DBMS_CLOUD.GET_RESPONSE_STATUS_CODE(l_response) = 200 THEN
       DBMS_OUTPUT.PUT_LINE('Metric published successfully!');
       ELSE
       DBMS_OUTPUT.PUT_LINE('Error publishing metric: ' || DBMS_CLOUD.GET_RESPONSE_STATUS_CODE(l_response));
       DBMS_OUTPUT.PUT_LINE(DBMS_CLOUD.GET_RESPONSE_TEXT(l_response));
       END IF;
       
       EXCEPTION
       WHEN OTHERS THEN
       DBMS_OUTPUT.PUT_LINE('Error during SEND_REQUEST: ' || SQLERRM);
       END;
      EXCEPTION
       WHEN OTHERS THEN
       DBMS_OUTPUT.PUT_LINE('Error: ' || SQLERRM);
      END;
      /

      詳細については、PostMetricDataを参照してください。

   2. カスタム・メトリック・データ・ポイントをコールおよび公開するジョブを1分に1回スケジュールします。本番では、スケジュールは必要に応じて実行するように構成されます。

      BEGIN
         DBMS_SCHEDULER.CREATE_JOB (
            job_name => 'publish_lineorder_count_job',
            job_type => 'STORED_PROCEDURE',
            job_action => 'ECOMMERCE_USER.publish_lineorder_metric',
            number_of_arguments => 1,
            start_date => SYSTIMESTAMP,
            repeat_interval => 'FREQ=MINUTELY;INTERVAL=1',
            enabled => FALSE,
            AUTO_DROP => FALSE,
            comments => 'Publishes the count of rows in SSB.LINEORDER every 1 minute'
      );
       
        DBMS_SCHEDULER.SET_JOB_ARGUMENT_VALUE (
             job_name => 'publish_lineorder_count_job',
             argument_position => 1,
             argument_value => 'SELECT COUNT(*) FROM SSB.LINEORDER'
       );
       
         DBMS_SCHEDULER.ENABLE('ECOMMERCE_USER.PUBLISH_LINEORDER_COUNT_JOB');
      END;

4. メトリック・エクスプローラで公開されたカスタム・メトリックを確認します。
   1. Oracle Cloud Infrastructure Consoleのナビゲーション・メニューから、「監視および管理」をクリックします。
   2. 「監視および管理」で、「メトリック・エクスプローラ」をクリックします。
      
      

      
      図adb_custom_metrics_explore.pngの説明

      
      
   3. メトリック・エクスプローラで、ネームスペースとしてcustom_metrics_from_adb、resourceGroupとしてecommerece_adb、メトリック名としてlineorder_metric (PL/SQLスクリプトで作成したメトリックの名前)を選択します。

      カスタム・メトリックに設定したすべてのメタデータおよびディメンションを使用できます。メトリック問合せ言語(MQL)問合せを作成して、ニーズおよびユース・ケースに応じてこれらのメトリックを分析できます。また、メトリック・ストリームにOracle Cloudアラームを設定して、業務チームにアラートを送信することもできます。これにより、選択したAutonomous Databaseメトリックの可観測性ループが自動化されます。メトリック・エクスプローラでは、メトリック画面にデフォルトでグラフ・ビューが表示され、リスト・ビューを有効にしてデータ・ポイントを強調表示することもできます。