Monitorare le prestazioni con le metriche di Autonomous Database

Mostra i passi per visualizzare le metriche di Autonomous Database.

1. Nella pagina Dettagli di Autonomous Database selezionare la scheda Monitoraggio.
2. Esiste un grafico per ogni metrica. In ogni grafico è possibile selezionare Intervallo e Statistica oppure utilizzare i valori predefiniti.

• Visualizza log e audit trail
  Mostra i passi per visualizzare i log e gli audit trail di Autonomous Database.

Mostra i passi per visualizzare le metriche per i database autonomi in un compartimento.

1. Nella pagina Metriche servizio, in Compartimento selezionare il compartimento.
2. Nella pagina Metriche servizio, in Spazio di nomi delle metriche selezionare oci_autonomous_database.
3. Se nel compartimento sono presenti più database autonomi, puoi mostrare le metriche aggregate nei database autonomi selezionando Flussi di metriche aggregati.
4. Per limitare le metriche visualizzate, accanto a Dimensioni fare clic su Aggiungi (se sono già state aggiunte dimensioni, fare clic su Modifica).
   1. Selezionare una dimensione nel campo Nome dimensione.
   2. Nel campo Valore dimensione selezionare un valore.
   3. Fare clic su Fine.

   Nella finestra di dialogo Modifica dimensioni fare clic su Dimensione +Additional per aggiungere una dimensione aggiuntiva. Fare clic su x per rimuovere una dimensione.

È possibile limitare le istanze in cui vengono visualizzate le metriche con dimensioni. Le dimensioni disponibili includono: tipo di carico di lavoro, nome visualizzato dell'istanza, area e OCID dell'istanza.

Descrive come creare e pubblicare metriche personalizzate in Autonomous Database.

Requisiti indispensabili

1. Ottieni l'accesso a Oracle Cloud Infrastructure tramite Oracle Cloud Free Tier o un account cloud a pagamento.

   Per ulteriori informazioni, vedere Ottieni un account Oracle Cloud.

2. Creare un'istanza di Autonomous Database o avere accesso a un'istanza di Autonomous Database esistente.

   Per ulteriori informazioni, vedere Eseguire il provisioning di un'istanza di Autonomous Database.

3. Ottenere le credenziali ADMIN per l'istanza di Autonomous Database.

4. Utilizzare Database Actions o uno dei client Oracle Database, ad esempio SQL Developer o SQL*Plus, per connettersi al database.

   See Connect to Autonomous Database for more information.

5. È necessario accedere al servizio di monitoraggio OCI e a OCI Identity and Access Management.

   Per ulteriori informazioni, vedere Pubblicazione di metriche personalizzate mediante l'API.

Panoramica delle metriche personalizzate con il servizio di monitoraggio OCI

La figura riportata di seguito mostra i passi per creare e pubblicare metriche personalizzate in Autonomous Database. Ciò mostra che si raccolgono i dati delle metriche con uno script in esecuzione sull'istanza di Autonomous Database e si pubblicano questi dati nel servizio di monitoraggio OCI e come è possibile creare allarmi e notifiche per i valori delle metriche.

Descrizione dell'illustrazione autonomous-database-custom-metrics.eps

• Creare e distribuire uno script PL/SQL nell'istanza di Autonomous Database. Questo script viene eseguito periodicamente per calcolare, raccogliere e pubblicare metriche personalizzate nel servizio di monitoraggio OCI.

• L'istanza di Autonomous Database può trovarsi su un endpoint pubblico o privato. La comunicazione tra l'istanza di Autonomous Database e il servizio di monitoraggio OCI viene eseguita sulla rete Oracle Cloud. Ciò significa che per pubblicare le metriche sul servizio di monitoraggio OCI non è necessario creare un gateway di servizi.

Creare e pubblicare metriche personalizzate

Per creare e pubblicare metriche personalizzate:

1. In OCI Identity and Access Management creare un gruppo dinamico per l'istanza di Autonomous Database e un criterio per autorizzare il gruppo dinamico a pubblicare le metriche nel servizio di monitoraggio OCI.

   Ad esempio:

   1. Nella console di Oracle Cloud Infrastructure fare clic su Identità e sicurezza.
   2. In Identità fare clic su Domini e selezionare un dominio di Identity oppure creare un nuovo dominio di Identity.
   3. In Dominio di identità, fare clic su Gruppi dinamici.
   4. Fare clic su Crea gruppo dinamico e immettere un nome, una descrizione e una regola.

      Ad esempio, creare un gruppo dinamico denominato adb_dg per l'istanza di Autonomous Database e creare una regola:

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

      In alternativa, puoi selezionare una singola istanza di Autonomous Database anziché tutte le istanze nel compartimento:

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

      
      

      
      Descrizione dell'immagine adb_custom_metrics_dynamic_group.png

      
      
   5. Fare clic su Crea.
   6. Creare un criterio IAM (Identity and Access Management) OCI per autorizzare il gruppo dinamico.

      Ad esempio, creare un criterio per autorizzare il gruppo dinamico adb_dg a pubblicare le metriche nel servizio di monitoraggio OCI con il criterio adb_dg_policy:

      Allow dynamic-group adb_dg to use metrics in compartment OCID_of_compartment

      
      

      
      Descrizione dell'immagine adb_custom_metrics_policy.png

      
      

   Dopo aver definito il criterio, il gruppo dinamico con definizione adb_dg è autorizzato a pubblicare le metriche nel compartimento.

   A questo punto, la routine PL/SQL in esecuzione su Autonomous Database non può pubblicare metriche nel servizio di monitoraggio OCI perché non sono presenti utenti di Autonomous Database autorizzati a pubblicare metriche nel servizio di monitoraggio OCI. Questa funzionalità viene fornita quando si abilita il principal risorsa nel passo seguente (passo 2c).

2. Creare un nuovo utente o schema di database con i privilegi richiesti nell'istanza di Autonomous Database o aggiornare un utente o uno schema di database esistente con i privilegi richiesti.

   Ad esempio:

   1. Creare un utente del database o utilizzare un utente esistente per pubblicare le metriche.

      Ad esempio, creare un nuovo utente ECOMMERCE_USER nell'istanza di Autonomous Database:

      CREATE USER ECOMMERCE_USER IDENTIFIED BY "password";

      Ora hai il nuovo utente ECOMMERCE_USER. I passi riportati di seguito corrispondono a questo utente o all'utente specificato. Tuttavia, se si crea un utente con un nome diverso, è necessario sostituire ECOMMERCE_USER con il nome utente alternativo.

   2. Concedere all'utente i privilegi correlati a Oracle Database necessari.

      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. Abilitare le credenziali di Oracle Database per il principal risorsa di Oracle Cloud e concedere l'accesso all'utente.

      Questo passo connette il gruppo dinamico adb_dg creato nel passo 1 all'utente del database ECOMMERCE_USER, concedendo all'utente l'autorizzazione per inviare le metriche al servizio di monitoraggio OCI.

      Ad esempio:

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

      Per ulteriori informazioni, consulta la sezione Usa principal risorsa per accedere alle risorse di Oracle Cloud Infrastructure.

      In alternativa all'autenticazione del principal risorsa, puoi utilizzare le credenziali native OCI per l'autenticazione. Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure.

   4. (Facoltativo) Verificare le operazioni completate nel passo precedente.

      Ad esempio:

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

      Per verificare se un utente diverso da ADMIN ha accesso al principal risorsa OCI, ad esempio per verificare se ECOMMERCE_USER dispone dell'accesso alle credenziali del database, utilizzare la vista DBA_TAB_PRIVS:

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

3. Creare uno script PL/SQL che pubblichi i dati delle metriche e pianifichi l'esecuzione dello script nell'istanza di Autonomous Database.
   1. Ad esempio, creare uno script PL/SQL con una metrica che conta le righe dei dati di esempio del benchmark dello schema a stella e li pubblica nel servizio di monitoraggio OCI.

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

      Per ulteriori informazioni, vedere PostMetricData.

   2. Pianificare un job per chiamare e pubblicare il datapoint della metrica personalizzata una volta al minuto. In produzione, la schedulazione verrà configurata per essere eseguita in base alle proprie esigenze.

      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. Esplorare le metriche personalizzate pubblicate in Esplora metriche.
   1. Dal menu di navigazione della console di Oracle Cloud Infrastructure, fare clic su Observability & Management.
   2. In Osservabilità e gestione, fare clic su Esplora metriche.
      
      

      
      Descrizione dell'immagine adb_custom_metrics_explore.png

      
      
   3. In Esplora metriche, selezionare lo spazio di nomi custom_metrics_from_adb, resourceGroup come ecommerece_adb e il nome della metrica come lineorder_metric (il nome della metrica creata nello script PL/SQL).

      Sono disponibili tutti i metadati e le dimensioni impostati per le metriche personalizzate. È possibile creare query MQL (Metrics Query Language) per analizzare queste metriche in base alle proprie esigenze e al proprio caso d'uso. Puoi anche impostare gli allarmi Oracle Cloud nel flusso di metriche per avvisare il tuo team operativo. Ciò automatizza il loop di osservabilità per le metriche di Autonomous Database di tua scelta. Si noti che nella schermata Metriche la schermata Metrica per impostazione predefinita mostra la vista Grafico ed è possibile abilitare la vista Elenco per evidenziare i datapoint.