Puede crear extensiones de métricas para aprovechar Database Management Diagnostics & Management como la herramienta central de supervisión de las bases de datos gestionadas.

Para crear una extensión de métrica:

1. Conéctese a la consola de Oracle Cloud Infrastructure.
2. Abra el menú de navegación, haga clic en Observación y gestión. En Database Management, haga clic en Administración.
3. En el panel de la izquierda, haga clic en Extensiones de métrica y seleccione un compartimento en la lista desplegable Compartimento. La extensión de métrica se debe crear en el compartimento en el que reside o en el que se supervisa la base de datos.
4. Haga clic en Crear extensión de métrica.
5. En el panel Crear extensión de métrica:
   1. Proporcione las siguientes propiedades de extensión de métrica:
      1. Nombre: introduzca un nombre para la extensión de métrica. El nombre de la extensión de métrica se agrega automáticamente como prefijo ME_.
      2. Nombre mostrado: introduzca un nombre mostrado para la extensión de métrica, si es diferente del nombre. El Nombre mostrado puede tener espacios y números.
      3. Descripción: también puede introducir una descripción para la extensión de métrica.
   2. Proporcione propiedades de método de recopilación para especificar el tipo de recurso de base de datos, como CDB, PDB o no CDB para el que se está creando la extensión de métrica, y otras propiedades:
      1. Tipo de recurso: seleccione el tipo de recurso de base de datos para el que está creando una extensión de métrica.
      2. Método de recopilación: seleccione el método de recopilación SQL para ejecutar consultas SQL personalizadas en bases de datos gestionadas, devolviendo resultados en una tabla de métricas.
      3. Frecuencia de recopilación: seleccione opciones para especificar la frecuencia con la que se debe recopilar la extensión de métrica.
      4. Consulta SQL: introduzca la consulta SQL. Por ejemplo:

         select a.ename, (select count(*) from emp p where p.mgr=a.empno) directs from emp a

         Las sentencias PL/SQL también están soportadas y, si se utilizan, se deben rellenar las propiedades Posición del parámetro de salida y Tipo de parámetro de salida. Las variables de enlace se pueden transferir a la consulta SQL mediante las propiedades En parámetro.

         Seleccione Cargar archivo encima del campo Consulta SQL para seleccionar o arrastrar y soltar el script SQL para ejecutar y proporcionar las propiedades de parámetros de entrada y salida relevantes.

      5. En parámetro: opcionalmente, introduzca la variable de enlace si utiliza la opción Consulta SQL o los parámetros de entrada si utiliza la opción Secuencia de comandos SQL.
         Nota
         
         En parámetro soporta el uso de marcador de posición de propiedad de instancia, que se puede utilizar para sustituir el marcador de posición por el valor de propiedad de instancia real de la base de datos gestionada para la que se recopila la métrica. Por ejemplo, para oracle_psft, db_service_name es una propiedad de instancia. Se puede transferir como un valor En parámetro dentro de un par de símbolos % (porcentaje), %db_service_name%.
      6. Posición del parámetro de salida: si lo desea, introduzca el número de posición del parámetro de salida.
      7. Tipo de parámetro de salida: opcionalmente, seleccione el tipo de parámetro de salida. Este campo sólo se activa si el número de posición del parámetro de salida se especifica en el campo Posición de parámetro de salida.
   3. Proporcione las siguientes propiedades de métrica y dimensión:
      1. Nombre: introduzca el nombre de la métrica o la dimensión en PascalCase. Por ejemplo, CpuUtilization y TotalDatabaseSize.
         Nota
         
         Las métricas de una extensión de métrica con el estado de borrador pueden tener los mismos nombres para el mismo tipo de recurso, pero no cuando se publica la extensión de métrica. Si ya existe un nombre de métrica concreto para un tipo de recurso y se utiliza en una extensión de métrica publicada, otra métrica no puede utilizarlo para el mismo tipo de recurso. Por ejemplo, si hay una extensión de métrica ME_FirstMetricExtension publicada para un tipo de recurso concreto y tiene una métrica denominada MetricFirst, no puede publicar otra extensión de métrica, ME_SecondMetricExtension, para el mismo tipo de recurso con una métrica también denominada MetricFirst.

         Esta restricción no se aplica a métricas y dimensiones ocultas.

      2. Nombre mostrado: opcionalmente, introduzca un nombre mostrado para la métrica o la dimensión, si es diferente del nombre. El Nombre mostrado puede tener espacios y números.
      3. ¿Es la dimensión?: seleccione Sí si está definiendo una dimensión de métrica y No si está definiendo una métrica.

         Una dimensión es un calificador para una métrica y debe ser un valor único para cada fila de los resultados de la recopilación de métricas. Por ejemplo, una métrica puede ser el porcentaje de espacio de almacenamiento utilizado y la dimensión es el nombre del sistema de archivos.

      4. ¿Está oculta?: seleccione Sí si la métrica solo se utilizará en expresiones informáticas, lo que significa que la métrica solo se utiliza como valor para calcular otra métrica o que no es necesario enviarla al servicio Oracle Cloud Infrastructure Monitoring. De lo contrario, seleccione No.
      5. Tipo de valor: seleccione el tipo de valor. Todas las métricas no ocultas deben ser numéricas; una métrica o dimensión oculta puede ser String o Number.
      6. Unidad: si lo desea, introduzca la unidad asociada a la métrica. Según la métrica, las posibles unidades podrían ser latencia en segundos, milisegundos, microsegundos, minutos o frecuencia en hercios o porcentaje. Este campo solo está activado para métricas y aparece atenuado para dimensiones.
      7. Categoría: seleccione el tipo de datos de métrica que recopila la métrica: Disponibilidad, Capacidad, Carga, Utilización. Este campo solo está activado para métricas que no están ocultas y aparece atenuado para dimensiones y métricas que están ocultas.
      8. Expresión de cálculo: opcionalmente, introduzca expresiones de cálculo para calcular el valor de una métrica basándose en operaciones matemáticas o lógicas realizadas en otras métricas o dimensiones dentro de la misma extensión de métrica. Las expresiones de cálculo necesitan que se defina al menos otra métrica en primer lugar y solo pueden incluir aquellas otras métricas que ya se hayan definido en la extensión de métrica. Para obtener más información, consulte Expresiones de recursos informáticos.
      9. Agregar otra métrica/dimensión: haga clic para agregar otra métrica o dimensión a la extensión de métrica.
6. Haga clic en una de las siguientes opciones para crear la extensión de métrica:
   • Crear y probar: haga clic para probar la extensión de métrica en una o más bases de datos gestionadas y verificar que los valores devueltos son correctos. En función de los valores devueltos, puede continuar editando y probando de forma iterativa.
     Nota
     
     Al probar una extensión de métrica, se reinicia Management Agent. Se recomienda probar las extensiones de métricas en bases de datos que no sean de producción.
   • Crear: haga clic para guardar la definición de extensión de métrica y probarla en bases de datos gestionadas más adelante.

WITH wait_stats AS (
SELECT
inst_id,
wait_class,
time_waited_fg
FROM
TABLE ( gv$(CURSOR(
SELECT
to_number(userenv('INSTANCE')) AS inst_id,
wait_class,
time_waited_fg / 100 AS time_waited_fg
FROM
v$system_wait_class
WHERE
wait_class <> 'Idle'
)) )
), inst_list AS (
SELECT
instance_number,
instance_name,
host_name
FROM
TABLE ( gv$(CURSOR(
SELECT
instance_number,
instance_name,
host_name
FROM
v$instance
)) )
)
SELECT
inst.instance_number instance_number,
inst.instance_name instance_name,
inst.host_name host_name,
ws.wait_class wait_class,
ws.time_waited_fg time_waited_fg
FROM
wait_stats ws,
inst_list inst
WHERE
inst.instance_number = ws.inst_id