Supervisión del rendimiento con métricas de base de datos de IA autónoma

Muestra los pasos para ver las métricas de la base de datos de IA autónoma.

1. En la página Detalles de base de datos de IA autónoma, seleccione el separador Supervisión.
2. Podrá ver un gráfico para cada métrica. En cada gráfico, puede seleccionar un valor de Intervalo y de Estadística o utilizar los valores por defecto.

• Visualización de logs y pistas de auditoría
  Muestra los pasos para ver los logs y las pistas de auditoría de la base de datos de IA autónoma.

Muestra los pasos para ver las métricas de las bases de datos de IA autónomas en un compartimento.

1. En la página Métricas de servicio, en Compartimento, seleccione el compartimento.
2. En la página Métricas de servicio, en Espacio de nombre de métrica, seleccione oci_autonomous_database.
3. Si hay varias bases de datos de IA autónomas en el compartimento, puede mostrar las métricas agregadas en las bases de datos autónomas seleccionando Agregar flujos de métricas.
4. Si desea limitar las métricas que ve, junto a Dimensiones, haga clic en Agregar (haga clic en Editar si ya ha agregado dimensiones).
   1. En el campo Nombre de dimensión, seleccione una dimensión.
   2. En el campo Valor de dimensión, seleccione un valor.
   3. Haga clic en Listo.

   En el recuadro de diálogo Editar dimensiones, haga clic en Dimensión +Additional para agregar una dimensión adicional. Haga clic en la opción x para eliminar una dimensión.

Puede limitar las instancias en las que ve métricas con las dimensiones. Entre las dimensiones disponibles, se incluyen: tipo de carga de trabajo, nombre mostrado de instancia, región y OCID de instancia.

Describe cómo crear y publicar métricas personalizadas en Autonomous AI Database.

Requisitos

1. Obtenga acceso a Oracle Cloud Infrastructure a través de la cuenta gratuita de Oracle Cloud o una cuenta en la nube de pago.

   Consulte Obtención de una cuenta de Oracle Cloud para obtener más información.

2. Cree una instancia de base de datos de IA autónoma o tenga acceso a una instancia de base de datos de IA autónoma existente.

   Consulte Aprovisionamiento de una instancia de base de datos de IA autónoma para obtener más información.

3. Obtenga credenciales ADMIN para su instancia de base de datos de IA autónoma.

4. Utilice Database Actions o cualquiera de los clientes de Oracle Database, como SQL Developer o SQL*Plus, para conectarse a la base de datos.

   Consulte Conexión a una base de datos de IA autónoma para obtener más información.

5. Necesita acceso al servicio OCI Monitoring y a OCI Identity and Access Management.

   Consulte Publicación de métricas personalizadas mediante la API para obtener más información.

Visión general de métricas personalizadas con el servicio OCI Monitoring

En la siguiente figura se muestran los pasos para crear y publicar métricas personalizadas en Autonomous AI Database. Esto muestra que recopila datos de métricas con un script que se ejecuta en su instancia de base de datos de IA autónoma y publica estos datos en el servicio OCI Monitoring, y cómo puede crear alarmas y notificaciones para valores de métricas.

Descripción de la ilustración autonomous-database-custom-metrics.eps

• Cree y despliegue un script PL/SQL en la instancia de la base de datos de IA autónoma. Este script se ejecuta periódicamente para calcular, recopilar y publicar métricas personalizadas en el servicio OCI Monitoring.

• La instancia de base de datos de IA autónoma puede estar en un punto final público o privado. La comunicación entre la instancia de Autonomous AI Database y el servicio OCI Monitoring se lleva a cabo en la red de Oracle Cloud. Esto significa que para publicar métricas en el servicio OCI Monitoring no es necesario crear un gateway de servicio.

Creación y publicación de métricas personalizadas

Para crear y publicar métricas personalizadas:

1. En OCI Identity and Access Management, cree un grupo dinámico para su instancia de Autonomous AI Database y cree una política para autorizar al grupo dinámico a publicar métricas en el servicio OCI Monitoring.

   Por ejemplo:

   1. En la consola de Oracle Cloud Infrastructure, haga clic en Identidad y seguridad.
   2. En Identidad, haga clic en Dominios y seleccione un dominio de identidad (o cree un nuevo dominio de identidad).
   3. En Dominio de identidad, haga clic en Grupos dinámicos.
   4. Haga clic en Crear grupo dinámico e introduzca un nombre, una descripción y una regla.

      Por ejemplo, cree un grupo dinámico denominado adb_dg para su instancia de base de datos de IA autónoma y cree una regla:

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

      También puede seleccionar una única instancia de base de datos de IA autónoma en lugar de todas las instancias del compartimento:

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

      
      

      
      Descripción de la ilustración adb_custom_metrics_dynamic_group.png

      
      
   5. Haga clic en Crear.
   6. Cree una política de OCI Identity and Access Management (IAM) para autorizar el grupo dinámico.

      Por ejemplo, cree una política para autorizar al grupo dinámico adb_dg a publicar métricas en el servicio OCI Monitoring con la política adb_dg_policy:

      Allow dynamic-group adb_dg to use metrics in compartment OCID_of_compartment

      
      

      
      Descripción de la ilustración adb_custom_metrics_policy.png

      
      

   Después de definir la política, el grupo dinámico con la definición adb_dg está autorizado para publicar métricas en el compartimento.

   En este punto, la rutina PL/SQL que se ejecuta en Autonomous AI Database no puede publicar ninguna métrica en el servicio OCI Monitoring porque no hay usuarios de Autonomous AI Database autorizados a publicar métricas en el servicio OCI Monitoring. Esta capacidad se proporciona al activar la entidad de recurso en el siguiente paso (paso 2c).

2. Cree un nuevo usuario o esquema de base de datos con los privilegios necesarios en su instancia de base de datos de IA autónoma o actualice un usuario o esquema de base de datos existente con los privilegios necesarios.

   Por ejemplo:

   1. Cree un usuario de base de datos o utilice un usuario existente para publicar métricas. .

      Por ejemplo, cree un nuevo usuario ECOMMERCE_USER en la instancia de Autonomous AI Database:

      CREATE USER ECOMMERCE_USER IDENTIFIED BY "password";

      Ahora tiene el nuevo usuario ECOMMERCE_USER. Los siguientes pasos son los mismos con este usuario o con el usuario que especifique. Sin embargo, si crea un usuario con un nombre diferente, debe sustituir ECOMMERCE_USER por el nombre de usuario alternativo.

   2. Otorgue al usuario los privilegios necesarios relacionados con 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. Active las credenciales de Oracle Database para la entidad de recurso de Oracle Cloud y otorgue acceso al usuario.

      Este paso conecta el grupo dinámico adb_dg que ha creado en el paso 1 al usuario de base de datos ECOMMERCE_USER, lo que otorga al usuario autorización para publicar métricas en el servicio OCI Monitoring.

      Por ejemplo:

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

      Consulte Uso de la entidad de recurso para acceder a recursos de Oracle Cloud Infrastructure para obtener más información.

      Como alternativa a la autenticación de entidad de recurso, puede utilizar credenciales nativas de OCI para la autenticación. Consulte CREATE_CREDENTIAL Procedure para obtener más información.

   4. (Opcional) Verifique las operaciones que ha completado en el paso anterior.

      Por ejemplo:

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

      Para comprobar si un usuario que no sea ADMIN tiene acceso a la entidad de recurso de OCI, por ejemplo, para comprobar si ECOMMERCE_USER tiene acceso a la credencial de base de datos, utilice la vista DBA_TAB_PRIVS:

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

3. Cree un script PL/SQL que publique datos de métricas y programe el script para que se ejecute en la instancia de la base de datos de IA autónoma.
   1. Por ejemplo, cree un script PL/SQL con una métrica que cuente las filas de los datos de ejemplo de Star Schema Benchmark y las publique en el servicio OCI Monitoring.

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

      Consulte PostMetricData para obtener más información.

   2. Programe un trabajo para llamar y publicar el punto de datos de métrica personalizado una vez por minuto. En producción, el programa se configuraría para ejecutarse según sus necesidades.

      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. Explore las métricas personalizadas publicadas en el explorador de métricas.
   1. En el menú de navegación de la consola de Oracle Cloud Infrastructure, haga clic en Observación y gestión.
   2. En Observación y gestión, haga clic en Explorador de métricas.
      
      

      
      Descripción de la ilustración adb_custom_metrics_explore.png

      
      
   3. En el explorador de métricas, seleccione el espacio de nombres como custom_metrics_from_adb, resourceGroup como ecommerece_adb y el nombre de la métrica como lineorder_metric (nombre de la métrica que ha creado en el script PL/SQL).

      Están disponibles todos los metadatos y dimensiones que defina para las métricas personalizadas. Puede crear consultas de lenguaje de consulta de métricas (MQL) para analizar estas métricas según sus necesidades y caso de uso. También puede configurar alarmas de Oracle Cloud en el flujo de métricas para alertar a su equipo operativo. Esto automatiza el bucle de observabilidad para las métricas de base de datos de IA autónoma que elija. Tenga en cuenta que en el explorador de métricas, la pantalla de métricas muestra por defecto la vista de gráfico y tiene la opción de activar la vista de lista para resaltar los puntos de datos.