Zeigt die Schritte zum Anzeigen der Autonomous Database-Metriken an.

1. Klicken Sie auf der Seite "Details" unter Ressourcen auf Metriken.
2. Für jede Metrik gibt es ein Diagramm. In jedem Diagramm können Sie Intervall und Statistik auswählen oder die Standardwerte verwenden.

• Logs und Audittrails anzeigen
  Zeigt die Schritte zum Anzeigen der Autonomous Database-Logs und Audittrails an.

Zeigt die Schritte zum Anzeigen von Metriken für autonome Datenbanken in einem Compartment an.

1. Wählen Sie auf der Seite Servicemetriken unter Compartment das Compartment aus.
2. Wählen Sie auf der Seite Servicemetriken unter Metrik-Namespace die Option oci_autonomous_database aus.
3. Wenn sich mehrere autonome Datenbanken im Compartment befinden, können Sie Metriken anzeigen, die über die autonomen Datenbanken hinweg aggregiert werden. Wählen Sie dazu Metrikstreams aggregieren.
4. Wenn Sie die angezeigten Metriken einschränken möchten, klicken Sie neben Dimensionen auf Hinzufügen (klicken Sie auf Bearbeiten, wenn Sie bereits Dimensionen hinzugefügt haben).
   1. Wählen Sie im Feld Dimensionsname eine Dimension aus.
   2. Wählen Sie im Feld Dimensionswert einen Wert aus.
   3. Klicken Sie auf Fertig.

   Klicken Sie im Dialogfeld Dimensionen bearbeiten auf +Weitere Dimension, um eine zusätzliche Dimension hinzuzufügen. Klicken Sie auf x, um eine Dimension zu entfernen.

Sie können die Instanzen begrenzen, in denen Metriken mit Dimensionen angezeigt werden. Die verfügbaren Dimensionen umfassen: Workload-Typ, Instanzanzeigename, Region und Instanz-OCID.

Beschreibt, wie Sie benutzerdefinierte Metriken in Autonomous Database erstellen und veröffentlichen.

Voraussetzungen

1. Rufen Sie Oracle Cloud Infrastructure-Zugriff über Oracle Cloud Free Tier oder einen kostenpflichtigen Cloud-Account ab.

   Weitere Informationen finden Sie unter Oracle Cloud-Account abrufen.

2. Erstellen Sie eine Autonomous Database-Instanz, oder haben Sie Zugriff auf eine vorhandene Autonomous Database-Instanz.

   Weitere Informationen finden Sie unter Autonomous Database-Instanz bereitstellen.

3. Rufen Sie ADMIN-Zugangsdaten für die Autonomous Database-Instanz ab.

4. Melden Sie sich mit Database Actions oder einem der Oracle Database-Clients wie SQL Developer oder SQL*Plus bei der Datenbank an.

   Weitere Informationen finden Sie unter Verbindung zu Autonomous Database herstellen.

5. Sie benötigen Zugriff auf den OCI Monitoring-Service und OCI Identity and Access Management.

   Weitere Informationen finden Sie unter Benutzerdefinierte Metriken mit der API veröffentlichen.

Überblick über benutzerdefinierte Metriken mit OCI Monitoring Service

Die folgende Abbildung zeigt die Schritte zum Erstellen und Veröffentlichen benutzerdefinierter Metriken in Autonomous Database. Dies zeigt, dass Sie Metrikdaten mit einem Skript erfassen, das auf Ihrer Autonomous Database-Instanz ausgeführt wird, und Sie diese Daten im OCI Monitoring-Service veröffentlichen und wie Sie Alarme und Benachrichtigungen für Metrikwerte erstellen können.

Beschreibung der Abbildung Autonomous-database-custom-metrics.eps

• PL/SQL-Skript erstellen und auf der Autonomous Database-Instanz bereitstellen. Dieses Skript wird regelmäßig ausgeführt, um benutzerdefinierte Metriken zu berechnen, zu erfassen und im OCI Monitoring-Service zu veröffentlichen.

• Die Autonomous Database-Instanz kann sich auf einem öffentlichen oder privaten Endpunkt befinden. Die Kommunikation zwischen der Autonomous Database-Instanz und dem OCI Monitoring-Service findet im Oracle Cloud-Netzwerk statt. Das bedeutet, dass Sie zum Veröffentlichen von Metriken im OCI Monitoring-Service kein Servicegateway erstellen müssen.

Benutzerdefinierte Metriken erstellen und veröffentlichen

So erstellen und veröffentlichen Sie benutzerdefinierte Metriken:

1. Erstellen Sie in OCI Identity and Access Management eine dynamische Gruppe für Ihre Autonomous Database-Instanz, und erstellen Sie eine Policy, um die dynamische Gruppe zu autorisieren, Metriken an den OCI Monitoring-Service zu posten.

   Beispiele:

   1. Klicken Sie in der Oracle Cloud Infrastructure-Konsole auf Identität und Sicherheit.
   2. Klicken Sie unter Identität auf Domains, und wählen Sie eine Identitätsdomain aus (oder erstellen Sie eine neue Identitätsdomain).
   3. Klicken Sie unter Identitätsdomain auf Dynamische Gruppen.
   4. Klicken Sie auf Dynamische Gruppe erstellen, und geben Sie einen Namen, eine Beschreibung und eine Regel ein.

      Beispiel: Erstellen Sie eine dynamische Gruppe namens adb_dg für die Autonomous Database-Instanz, und erstellen Sie eine Regel:

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

      Alternativ können Sie eine einzelne Autonomous Database-Instanz anstelle aller Instanzen im Compartment auswählen:

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

      
      

      
      Beschreibung der Abbildung adb_custom_metrics_dynamic_group.png

      
      
   5. Klicken Sie auf Erstellen.
   6. Erstellen Sie eine OCI Identity and Access Management-(IAM-)Policy, um die dynamische Gruppe zu autorisieren.

      Beispiel: Erstellen Sie eine Policy, um die dynamische Gruppe adb_dg zu autorisieren, Metriken mit der Policy adb_dg_policy an den OCI Monitoring-Service zu posten:

      Allow dynamic-group adb_dg to use metrics in compartment OCID_of_compartment

      
      

      
      Beschreibung der Abbildung adb_custom_metrics_policy.png

      
      

   Nachdem Sie die Policy definiert haben, ist die dynamische Gruppe mit der Definition adb_dg autorisiert, Metriken im Compartment zu posten.

   Zu diesem Zeitpunkt kann die PL/SQL-Routine, die in Autonomous Database ausgeführt wird, keine Metriken an den OCI Monitoring-Service posten, da keine Autonomous Database-Benutzer berechtigt sind, Metriken im OCI Monitoring-Service zu veröffentlichen. Sie stellen diese Funktion bereit, wenn Sie den Resource Principal im folgenden Schritt aktivieren (Schritt 2c).

2. Erstellen Sie einen neuen Datenbankbenutzer oder ein neues Datenbankschema mit den erforderlichen Berechtigungen in Ihrer Autonomous Database-Instanz, oder aktualisieren Sie einen vorhandenen Datenbankbenutzer oder ein vorhandenes Datenbankschema mit den erforderlichen Berechtigungen.

   Beispiele:

   1. Erstellen Sie einen Datenbankbenutzer, oder verwenden Sie einen vorhandenen Benutzer, um Metriken zu veröffentlichen.

      Beispiel: Erstellen Sie einen neuen Benutzer ECOMMERCE_USER in der Autonomous Database-Instanz:

      CREATE USER ECOMMERCE_USER IDENTIFIED BY "password";

      Jetzt haben Sie den neuen Benutzer ECOMMERCE_USER. Die folgenden Schritte sind mit diesem Benutzer oder mit dem angegebenen Benutzer identisch. Wenn Sie jedoch einen Benutzer mit einem anderen Namen erstellen, müssen Sie ECOMMERCE_USER durch den alternativen Benutzernamen ersetzen.

   2. Erteilen Sie dem Benutzer die erforderlichen Oracle Database-Berechtigungen.

      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. Aktivieren Sie Oracle Database-Zugangsdaten für den Oracle Cloud-Resource Principal, und erteilen Sie dem Benutzer Zugriff.

      Dieser Schritt verbindet die in Schritt 1 erstellte dynamische Gruppe adb_dg mit dem Datenbankbenutzer ECOMMERCE_USER und erteilt dem Benutzer die Berechtigung, Metriken an den OCI Monitoring-Service zu posten.

      Beispiele:

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

      Weitere Informationen finden Sie unter Resource Principal für den Zugriff auf Oracle Cloud Infrastructure-Ressourcen verwenden.

      Alternativ zur Resource Principal-Authentifizierung können Sie OCI Native-Zugangsdaten zur Authentifizierung verwenden. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL.

   4. (Optional) Prüfen Sie die im vorherigen Schritt abgeschlossenen Vorgänge.

      Beispiele:

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

      Um zu prüfen, ob ein anderer Benutzer als ADMIN Zugriff auf OCI Resource Principal hat. Beispiel: Um zu prüfen, ob ECOMMERCE_USER Zugriff auf die Datenbankzugangsdaten hat, verwenden Sie die View DBA_TAB_PRIVS:

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

3. Erstellen Sie ein PL/SQL-Skript, das Metrikdaten veröffentlicht und die Ausführung des Skripts auf der Autonomous Database-Instanz terminiert.
   1. Beispiel: Erstellen Sie ein PL/SQL-Skript mit einer Metrik, mit der die Zeilen der Star Schema Benchmark-Beispieldaten gezählt und im OCI Monitoring-Service veröffentlicht werden.

      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;
      /

      Weitere Informationen finden Sie in PostMetricData.

   2. Planen Sie einen Job, um den benutzerdefinierten Metrikdatenpunkt einmal pro Minute aufzurufen und zu veröffentlichen. In der Produktion wird der Zeitplan entsprechend Ihren Anforderungen konfiguriert.

      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. Sehen Sie sich die veröffentlichten benutzerdefinierten Metriken im Metrik-Explorer an.
   1. Klicken Sie im Navigationsmenü der Oracle Cloud Infrastructure-Konsole auf Beobachtbarkeit und Management.
   2. Klicken Sie unter Beobachtbarkeit und Management auf Metrik-Explorer.
      
      

      
      Beschreibung der Abbildung adb_custom_metrics_explore.png

      
      
   3. Wählen Sie im Metrik-Explorer den Namespace custom_metrics_from_adb, resourceGroup als ecommerece_adb und den Metriknamen lineorder_metric (den Namen der Metrik, die Sie im PL/SQL-Skript erstellt haben).

      Alle Metadaten und Dimensionen, die Sie für benutzerdefinierte Metriken festlegen, sind verfügbar. Sie können Metrics Query Language-(MQL-)Abfragen erstellen, um diese Metriken entsprechend Ihren Anforderungen und Ihrem Anwendungsfall zu analysieren. Sie können auch Oracle Cloud-Alarme im Metrikstream einrichten, um Ihr Betriebsteam zu warnen. Dadurch wird die Beobachtbarkeitsschleife für die Autonomous Database-Metriken Ihrer Wahl automatisiert. Beachten Sie, dass im Metrik-Explorer im Metrikbildschirm standardmäßig die Diagrammansicht angezeigt wird und Sie die Option zum Aktivieren der Listenansicht zum Hervorheben von Datenpunkten haben.