Supervisión de Oracle NoSQL Database Cloud Service

El servicio Oracle Cloud Infrastructure Monitoring permite supervisar de forma activa y pasiva los recursos en la nube mediante las funciones de métricas y alarmas. El servicio Monitoring utiliza métricas para supervisar recursos y alarmas para notificarle cuando estas métricas alcancen los disparadores especificados por la alarma.

Una métrica es una medición relacionada con el sistema, la capacidad o el rendimiento de un recurso determinado. Una alarma es una regla de disparador y una consulta. Las alarmas supervisan de manera pasiva tus recursos de la nube mediante métricas. Puede configurar los valores de notificación al crear una alarma.

Las métricas se emiten al servicio Monitoring en forma de puntos de datos no procesados (un par de registro de hora y valor para una métrica especificada) junto con las dimensiones (un identificador de recurso proporcionado en la definición de métrica) y metadatos. El servicio Monitoring publica mensajes de alarma para destinos configurados gestionados por el servicio Notifications.

Cuando consulta una métrica, el servicio Monitoring devuelve datos agregados según los parámetros especificados. Puede especificar un rango (por ejemplo, las últimas 24 horas), una estadística y un intervalo. Una estadística es la función de agregación que se aplica a los puntos de datos raw. La función de agregación SUM es un ejemplo de una estadística. Un intervalo es la ventana de tiempo utilizada para convertir un determinado conjunto de puntos de datos sin procesar. Por ejemplo, 5 minutos.

La consola muestra un gráfico de supervisión por métrica para los recursos seleccionados. Los datos agregados en cada gráfico reflejan la estadística y el intervalo seleccionados. Las solicitudes de API pueden filtrar por dimensión y especificar una resolución. Las respuestas a la API incluyen el nombre de la métrica junto con su compartimento de origen y su espacio de nombres de métrica (indica el recurso, el servicio o la aplicación que emite una métrica). El espacio de nombres se proporciona en la definición de la métrica. Por ejemplo, la Definición de Métrica de CpuUtilization emitida por Oracle Cloud muestra el Espacio de Nombres de Métrica oci_computeagent como Origen de la Métrica.

Es posible acceder a la información de las métricas y las alarmas mediante la consola, la CLI y las API. Para obtener más información sobre los conceptos de servicio de supervisión de OCI, consulte Conceptos de supervisión.

En este artículo se incluyen los siguientes temas:

Métricas de Oracle NoSQL Database Cloud Service

Oracle NoSQL Database Cloud Service emite métricas mediante el espacio de nombres de métrica oci_nosql.

Las métricas de Oracle NoSQL Database Cloud Service incluyen las siguientes dimensiones:

RESOURCEID OCID de la página NoSQL en Oracle NoSQL Database Cloud Service.

Nota: el OCID es un ID único asignado por Oracle que se incluye como parte de la información del recurso tanto en la consola como la API.

TABLENAME

Nombre de la tablas NoSQL en Oracle NoSQL Database Cloud Service.
REPLICA

Nombre de la región que recibe la actualización de tabla de otra región.

Oracle NoSQL Database Cloud Service envía métricas al servicio Oracle Cloud Infrastructure Monitoring. Puede ver o crear alarmas en estas métricas mediante los SDK o la CLI de la consola de Oracle Cloud Infrastructure.

Tabla - Métrica de Oracle NoSQL Database Cloud Service

Métrica	Nombre mostrado de la métrica	Unidad	Descripción	Dimensiones
`ReadUnits`	Unidades de lectura	Unidades	Número de unidades de lectura consumidas durante este periodo.	`resourceId tableName`
`WriteUnits`	Unidades de escritura	Unidades	Número de unidades de escritura consumidas durante este periodo.	`resourceId tableName`
`StorageGB`	Tamaño de almacenamiento	GB	Cantidad máxima de almacenamiento consumida por la tabla. Puesto que esta información se genera por hora, puede ver valores desactualizados entre los puntos de refrescamiento.	`resourceId tableName`
`ReadThrottleCount`	Limitación de lectura	Count	Número de excepciones de limitación de lectura en esta tabla en el periodo de tiempo.	`resourceId tableName`
`WriteThrottleCount`	Limitación de escritura	Count	Número de excepciones de limitación de escritura en esta tabla en el periodo de tiempo.	`resourceId tableName`
`StorageThrottleCount`	Limitación de almacenamiento	Count	Número de excepciones de limitación de almacenamiento en esta tabla en el periodo de tiempo.	`resourceId tableName`
`MaxShardSizeUsagePercent`	Uso de tamaño de partición horizontal máximo	Porcentaje	Relación entre el espacio utilizado en la partición horizontal y el espacio total asignado a la partición horizontal. Esto es específico de una tabla y será el valor más alto en todas las particiones horizontales.	`resourceId tableName`
`Replica Lag`	Demora respecto a réplica	Milisegundo	Demora en la replicación de los cambios de datos de una tabla activa global de una región de remitente a una región de receptor.	`resourceId tableName replica`

Además, puede publicar métricas personalizadas según sus necesidades. Por ejemplo, puede configurar métricas para capturar la latencia de transacción de la aplicación (tiempo empleado por transacción finalizada) y, a continuación, contabilizar esos datos en el servicio Monitoring.

Explicación de las métricas de NDCS

Oracle NoSQL Database Cloud Service envía métricas al servicio Oracle Cloud Infrastructure Monitoring.

Unidades de lectura:

Número de unidades de lectura consumidas durante este periodo. Es el rendimiento para un máximo de 1 KB de datos por segundo para una operación que finalmente sea coherente. Si los datos son superiores a 1 KB, se necesitarán varias unidades de lectura para leerlos. El gráfico de métricas Unidad de lectura de una tabla se muestra a continuación. La métrica se toma cada minuto y los gráficos de métricas se trazan durante un intervalo de 5 minutos por defecto.

A continuación se incluye la Descripción de readmetric.png

Descripción de la ilustración readmetric.png

Unidades de escritura:

Número de unidades de escritura consumidas durante este periodo. Es el rendimiento para un máximo de 1 kilobyte de datos por segundo de un funcionamiento de escritura. Las operaciones de escritura se disparan durante las operaciones de inserción, actualización y supresión. Si los datos son superiores a 1 KB, se necesitarán varias unidades de lectura para escribirlos. A continuación se muestra el gráfico de métricas de unidad de escritura para una tabla. La métrica se toma cada minuto y los gráficos de métricas se trazan durante un intervalo de 5 minutos por defecto.

A continuación se incluye la Descripción de writemetric.png

Descripción de la ilustración writemetric.png

GB de almacenamiento:

Cantidad máxima de almacenamiento consumida por la tabla. El gráfico de métricas de almacenamiento de una tabla se muestra a continuación. La métrica se toma cada minuto y los gráficos de métricas se trazan durante un intervalo de 5 minutos por defecto.

Nota: Se tarda una hora después de la creación de la tabla en iniciar el inicio del seguimiento del tamaño de almacenamiento. Después de la hora inicial, las estadísticas de almacenamiento se actualizan cada 5 minutos.

A continuación, se muestra la Descripción de storagemetric.png

Descripción de la ilustración storagemetric.png

Nota: La métrica de GB de almacenamiento está truncada. Por lo tanto, el uso de almacenamiento de menos de 1 GB se mostrará como 0. El gráfico comenzará a mostrar el almacenamiento cuando el uso sea superior a 1 GB.

Recuento de limitaciones de lectura:

Esto proporciona un recuento del número de excepciones de limitación de lectura en la tabla especificada en el período de tiempo. Una excepción de limitación suele indicar que se ha superado el rendimiento de lectura aprovisionado. Si los obtiene con frecuencia, debe considerar aumentar las unidades de lectura de la tabla. A continuación se muestra el gráfico de métricas de recuento de limitaciones de lectura para una tabla. La métrica se toma cada minuto y los gráficos de métricas se trazan durante un intervalo de 5 minutos por defecto.

A continuación se incluye la Descripción de readthrottlemetric.png

Descripción de la ilustración readthrottlemetric.png

Recuento de limitación de escritura:

Esto proporciona un recuento del número de excepciones de limitación de escritura en la tabla especificada en el período de tiempo. Una excepción de limitación suele indicar que se ha superado el rendimiento de escritura aprovisionado. Si los obtiene con frecuencia, debe considerar aumentar las unidades de escritura de la tabla. A continuación, se muestra el gráfico de métricas de recuento de limitación de escritura para una tabla. La métrica se toma cada minuto y los gráficos de métricas se trazan durante un intervalo de 5 minutos por defecto.

A continuación se incluye la Descripción de writethrottlemetric.png

Descripción de la ilustración writethrottlemetric.png

StorageThrottleCount:

Esto proporciona un recuento del número de excepciones de limitación de almacenamiento en la tabla determinada en el período de tiempo. Una excepción de limitación suele indicar que se ha superado la capacidad de almacenamiento aprovisionada. Si las obtiene con frecuencia, debería considerar aumentar la capacidad de almacenamiento de la tabla. A continuación se muestra el gráfico de métricas de recuento de limitaciones de almacenamiento para una tabla. La métrica se toma cada minuto y los gráficos de métricas se trazan durante un intervalo de 5 minutos por defecto.

A continuación se incluye la Descripción de storagethrottlemetric.png

Descripción de la ilustración storagethrottlemetric.png

MaxShardSizeUsagePercent

El mayor uso de espacio en una partición horizontal para una tabla específica, como un porcentaje de espacio utilizado en esa partición horizontal.

Nota: Oracle NoSQL Database Cloud Service aplica hash a las particiones horizontales para proporcionar la distribución a través de una recopilación de nodos de almacenamiento que proporcionan almacenamiento para las tablas. Aunque no es visible para el usuario directamente, las tablas de Oracle NoSQL Database Cloud Service tienen particiones horizontales y se replican para obtener disponibilidad y rendimiento. Una clave de partición horizontal 100% coincide con la clave primaria o es un subjuego de la clave primaria. Todos los registros que comparten una clave de partición horizontal se encuentran en la misma ubicación para lograr la ubicación de los datos.

Cuando maxShardSizeUsagepercent alcanza 100, ya no puede realizar una operación de escritura en la tabla. Debe aumentar la capacidad de almacenamiento para realizar una escritura en la tabla. Esta métrica ayuda a determinar si existe un punto de acceso de almacenamiento para la tabla NoSQL.

Este escenario se produce debido a un desequilibrio en la forma en que los datos de la tabla se almacenan en las particiones horizontales. Se puede producir un desequilibrio cuando la mayoría de los datos de la tabla se almacenan en un subjuego de particiones horizontales. El almacenamiento en una base de datos NoSQL se divide en particiones horizontales y la clave de partición horizontal forma parte de la definición de tabla. En las tablas jerárquicas, las tablas principal y secundaria comparten la misma clave de partición horizontal. Si tiene una tabla principal con tablas secundarias, todos los registros comparten la misma clave de partición horizontal. Así que todos estos datos se almacenarán juntos. Si una tabla principal tiene menos secundarios, ocupa menos espacio de almacenamiento en una sola partición horizontal. Debido a este desequilibrio, ciertas particiones horizontales pueden contener muchos más datos que otras particiones horizontales.

En un punto determinado, una partición horizontal tendrá el uso más alto de espacio para una tabla específica y el porcentaje utilizado en esa partición horizontal es el MaxShardSizeUsagePercent. El gráfico de métricas maxShardSizeUsagepercent de una tabla se muestra a continuación. La métrica se toma cada minuto y los gráficos de métricas se trazan durante un intervalo de 5 minutos por defecto.

A continuación se incluye la Descripción de maxshardusageprct.png

Descripción de la ilustración maxshardusageprct.png

Además de ver el gráfico de una métrica, tiene las siguientes opciones.

A continuación se incluye la Descripción de Metric-options.png

Descripción de la ilustración metric-options.png

Puede obtener la vista de tabla para comprobar el valor de una métrica en un momento determinado.

A continuación, se muestra la Descripción de tableview.png

Descripción de la ilustración tableview.png

Supervisión de la métrica MaxShardSizeUsagePercent

Debe supervisar periódicamente este gráfico para saber si se ha alcanzado o no maxShardSizeUsagepercent. Puede crear una alarma de forma proactiva para esta métrica.

A continuación, se muestra la Descripción de new-alarm-crt-1.png

Descripción de la ilustración new-alarm-crt-1.png

Es decir, debe disparar una alarma cuando la métrica alcance un valor concreto, por ejemplo, el 90 %.

A continuación, se muestra la Descripción de new-alarm-crt-2.png

Descripción de la ilustración new-alarm-crt-2.png

La alarma de OCI utiliza el servicio de notificaciones de OCI para enviar notificaciones. Normalmente, la alarma se configurará para enviar notificaciones por correo electrónico configurado. Cuando maxShardSizeUsagepercent alcanza el 90%, se envía una notificación por correo electrónico.

A continuación, se muestra la Descripción de new-alarm-crt-3.png

Descripción de la ilustración new-alarm-crt-3.png

Consulte Gestión de alarmas y notificaciones para obtener más información.

Cuando se produce un desequilibrio en la forma en que los datos de la tabla se distribuyen entre particiones horizontales, no podrá utilizar la capacidad de almacenamiento asignada a la tabla al máximo. En este escenario, maxShardSizeUsagepercent alcanza el valor de 100 incluso sin utilizar todo el almacenamiento asignado a la tabla. Ahora debe agregar más almacenamiento para continuar escribiendo en la tabla. Este escenario se puede evitar siguiendo algunas directrices al diseñar la tabla.

Decida la clave de partición horizontal correcta para la tabla. Los atributos con alta cardinalidad son una buena opción para las claves de partición horizontal.
Limite el número de tablas secundarias para evitar una posible situación de desequilibrio de almacenamiento de particiones horizontales.

Demora respecto a réplica

Demora en la replicación de los cambios de datos (INSERT/UPDATE o DELETE) de una tabla activa global de una región de remitente a una región de receptor. La operación de escritura que se ha producido en la región de remitente de una tabla activa global se refleja en la región de receptor después de un retraso. La información sobre el retraso se expresa como una métrica denominada Demora de réplica. La demora de réplica es una medida de la actualidad de los datos de la tabla en la región de replicación del receptor, en relación con los datos de la tabla de la región del remitente. La demora de réplica indica que la tabla de la región de receptor aún no ha recibido actualizaciones de la región de remitente que se produjeron durante el período de demora. Si no ha habido escrituras de aplicación para la tabla en la región del remitente, el servicio utiliza los mecanismos de ping para calcular una aproximación de la demora, y la estadística de demora seguirá estando disponible en la región del receptor.

Obtenga información sobre la demora de réplica:

En la región del receptor, haga clic en la tabla Global Active y vea la información de la tabla. En Recursos, haga clic en Métricas. Aparece una métrica, Replica lag, que muestra la demora de replicación en milisegundos. En el siguiente gráfico de ejemplo, verá que la métrica Replica Lag se toma en la región del sudeste de Canadá (Toronto), que es la región receptora. Esta tabla Global Active tiene dos réplicas de tablas regionales, una cada una en las regiones Sureste de Canadá (Montreal) y Este de EE. UU. (Ashburn). Verá que el gráfico tiene dos líneas una para cada una de estas réplicas de tablas regionales en Montreal y Ashburn.

En el siguiente gráfico, Interval indica la ventana de tiempo utilizada para trazar el gráfico. Varias opciones de intervalo disponibles son 1 minuto, 5 minutos, 1 hora y 1 día. Por defecto, el retraso de réplica se supervisa cada 1 minuto y el gráfico se traza cada 5 minutos. Puede seleccionar diferentes estadísticas para la métrica Demora de réplica.

Ejemplo 1: retraso de réplica con el sudeste de Canadá (Toronto) como región de receptor y el sudeste de Canadá (Montreal) y el este de EE. UU. (Ashburn) como regiones de remitente.

El siguiente gráfico se representa para la estadística Media de un intervalo de 5 minutos.

A continuación se muestra la descripción de metric_replica2.png

Descripción de la ilustración metric_replica2.png

En este ejemplo, Montreal y Ashburn son dos regiones de remitente y Toronto es la región de receptor en la que se captura la métrica. Considere el valor de Replica Lag a las 12:25 UTC para Montreal. Son 2020 milisegundos. Esto significa que la región receptora Canadá Sureste (Toronto) no ha recibido actualizaciones que hayan ocurrido en la región remitente Canadá Sureste (Montreal) en los últimos 2020 milisegundos. Asimismo, tenga en cuenta el valor de la demora de réplica a las 12:25 UTC para Ashburn. Son 2954 milisegundos. Esto significa que la región receptora Canadá Sureste (Toronto) no ha recibido actualizaciones que se produjeron en la región remitente Este de EE. UU. (Ashburn) en los últimos 2954 milisegundos.

Ejemplo 2: demora de réplica con el este de EE. UU. (Ashburn) como región de receptor y el sudeste de Canadá (Montreal) y el sudeste de Canadá Toronto como regiones de remitente.

En este ejemplo, Montreal y Toronto son dos regiones de remitente y Ashburn es la región de receptor donde se captura la métrica.

A continuación se muestra la descripción de metric_replica3.png

Descripción de la ilustración metric_replica3.png

Ejemplo 3: retraso de réplica con Canadá Sureste (Montreal) como región receptora y EE. UU. Este (Ashburn) y Canadá Sureste de Toronto como regiones remitentes.

En este ejemplo, Ashburn y Toronto son dos regiones de remitente y Montreal es la región de receptor en la que se captura la métrica.

A continuación se muestra la descripción de metric_replica1.png

Descripción de la ilustración metric_replica1.png

Además de ver el gráfico para la demora de réplica, tiene las siguientes opciones.

A continuación se muestra la descripción de metric_options.png

Descripción de la ilustración metric_options.png

Puede obtener la vista de tabla para comprobar el valor de demora de réplica en un momento determinado.

A continuación se muestra la descripción de tabview_toronto.png

Descripción de la ilustración tabview_toronto.png

Visualización o enumeración de métricas de Oracle NoSQL Database Cloud Service

Puede ver las métricas disponibles para Oracle NoSQL Database Cloud Service desde la consola. Además, puede obtener la lista de métricas disponibles para Oracle NoSQL Database Cloud Service mediante los comandos de la CLI de OCI.

Visualización de métricas de NoSQL desde la consola
Lista de métricas de NoSQL desde la línea de comandos de la CLI de OCI

Abra el menú de navegación y haga clic en Observación y gestión. En Supervisión, haga clic en Métricas de servicio.
Seleccione el compartimento y el espacio de nombres de métrica (oci_nosql).

Desde Cloud Shell, ejecute el siguiente comando. Devuelve definiciones de métricas que coinciden con los criterios especificados en la solicitud. El OCID de compartimento es necesario. Para obtener más información sobre las OPCIONES disponibles con el comando list, consulte List Metrics.

oci monitoring metric list --compartment-id <Compartment_OCID> --namespace oci_nosql

Por ejemplo:

oci monitoring metric list --compartment-id ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya --namespace oci_nosql

Ejemplo de respuesta:

{
  "data": [
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "ReadThrottleCount",
      "namespace": "oci_nosql",
      "resource-group": null
    },
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "ReadUnits",
      "namespace": "oci_nosql",
      "resource-group": null
    },
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "StorageGB",
      "namespace": "oci_nosql",
      "resource-group": null
    },
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "StorageThrottleCount",
      "namespace": "oci_nosql",
      "resource-group": null
    },
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "WriteThrottleCount",
      "namespace": "oci_nosql",
      "resource-group": null
    },
    {
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyasvdkoclhgryulgzox3nvlxb2bqtlxxsrvrc4zxr6lo4a",
        "tableName": "demo"
      },
      "name": "WriteUnits",
      "namespace": "oci_nosql",
      "resource-group": null
    }
  ]
}

¿Cómo recopilar métricas de Oracle NoSQL Database Cloud Service?

Puede crear consultas de métricas para recopilar juegos específicos de métricas (datos agregados). Una consulta de métrica contiene la expresión Monitoring Query Language (MQL) que se evalúa para la obtención de datos agregados. La consulta debe especificar una métrica, una estadística y un intervalo.

Puede utilizar consultas de métricas para controlar de forma activa y pasiva sus recursos en la nube. Supervise de forma activa con consultas de métricas que genere de forma espontánea a petición. En la Consola, actualice un gráfico para ver datos de varias consultas. Guarde las consultas que quiera reutilizar. Supervisar de forma pasiva con alarmas que añade una condición o regla de disparador a una consulta de métricas.

Sintaxis de consulta de métrica:

metric[interval] {dimensionname=dimensionvalue}.groupingfunction.statistic

Sintaxis de consulta de alarma de umbral:

metric[interval]{dimensionname=dimensionvalue}.groupingfunction.statistic alarmoperator alarmvalue

Para conocer los valores de parámetros admitidos, consulte Referencia de Monitoring Query Language (MQL).

Consultas de ejemplo Consulta de métrica simple

Suma de recuentos de limitación de almacenamiento para todas las tablas de un compartimento en un intervalo de un minuto.

Número de líneas mostradas en el diagrama de métricas (consola): 1 por tabla.

StorageThrottleCount[1m].sum()

Consulta de métricas filtrada

Suma de recuentos de limitadores de almacenamiento en un compartimento en un intervalo de un minuto, filtrados en una sola tabla.

Número de líneas mostradas en el diagrama de métricas (consola): 1 por tabla.

StorageThrottleCount[1m]{tableName = "demoKeyVal"}.sum()

Consulta de métrica agregada

Media agregada de la operación de lectura en un intervalo de sesenta minutos, filtrada en un compartimento, agregada para la media.

Número de líneas mostradas en el diagrama de métricas (consola): 1 por tabla.

ReadUnits[60m]{compartmentId="ocid1.compartment.oc1.phx..exampleuniqueID"}.grouping().mean()

Consulta de métrica agregada por grupo

Media agregada de recuento de limitaciones de lectura por unidad de lectura en un intervalo de sesenta minutos, filtrada en una sola tabla en un compartimento.

Número de líneas mostradas en el diagrama de métricas (consola): 1 por unidad de lectura.

ReadThrottleCount[60m]{tableName = "demoKeyVal"}.groupBy(ReadUnits).mean()

Creación de una Consulta de Métrica

Hay dos formas de crear una consulta de métrica. Puede crear una consulta mediante la consola o el comando de la CLI de OCI.

Uso de la consola
Uso de CLI de OCI

Abra el menú de navegación y haga clic en Observación y gestión. En Supervisión, haga clic en Explorador de métricas.

La página Explorador de métricas muestra un gráfico vacío con campos para crear una consulta.
Rellene los campos para realizar una nueva consulta.
- Compartimento: compartimento que contiene las tablas de Oracle NoSQL Database Cloud Service que desea supervisar. Por defecto, se selecciona el primer compartimento accesible.
- Espacio de nombres de métrica: Oracle NoSQL Database Cloud Service emite métricas para las tablas que desea supervisar. Ejemplo: oci_nosql.
- Grupo del recurso (opcional): grupo al que pertenece la métrica. Un grupo de recursos es una cadena personalizada con una métrica personalizada. No se aplica a las métricas de servicio.
- Nombre de la métrica: nombre de la métrica. Solo se puede especificar una métrica. Las selecciones de métricas dependen del compartimento y del espacio de nombres de métrica seleccionados. Ejemplo: ReadUnits
- Intervalo: ventana de agregación.
- Estadística: la función de agregación.
- Dimensiones de métrica: filtros opcionales para reducir los datos de métrica evaluados.
  - Campos de dimensión: para las métricas de Oracle NoSQL Database Cloud Service, puede seleccionar resourceId o tableName como nombre de dimensión y par de valores de dimensión.
- Agregar Flujos de Métricas: Traza una sola línea en el Gráfico de Métricas que representa el valor combinado de todos los Flujos de Métricas para la Estadística seleccionada.
Haga clic en Actualizar gráfico.

En el gráfico se muestran los resultados de la nueva consulta. Los valores muy pequeños o grandes se indican con el Sistema Internacional de Unidades (unidades IS), por ejemplo, con una M para mega (10 elevado a la sexta potencia). Las unidades corresponden a la métrica seleccionada y no cambian por la estadística.
Para ver la consulta como una expresión MQL (Monitoring Query Language), seleccione Modo avanzado
- El modo avanzado se encuentra a la derecha, debajo del gráfico.
  
  Utilice el método avanzado para editar la consulta con la sintaxis de MQL a fin de agregar resultados por grupo. La sintaxis MQL también admite valores de parámetros adicionales. Para obtener más información sobre los parámetros de consulta en los modos básico y avanzado, consulte Referencia de Monitoring Query Language (MQL).

Desde Cloud Shell, ejecute el siguiente comando. Devuelve datos agregados que coinciden con los criterios especificados en la solicitud. El OCID de compartimento es necesario.

oci monitoring metric-data summarize-metrics-data --compartment-id<Compartment_OCID> --namespace oci_nosql --query-text [text]

--query-text es la expresión de Monitoring Query Language (MQL) que se utiliza al buscar puntos de datos de métricas para agregar. La consulta debe especificar una métrica, una estadística y un intervalo. Valores admitidos para intervalo: 1m-60m (también 1h). Opcionalmente, puede especificar dimensiones y funciones de agrupación. Funciones de agrupación soportadas: grouping(), groupBy(). Para obtener más información sobre las OPCIONES disponibles con el comando Summary-metrics-data, consulte Summarize Metrics Data. En el siguiente ejemplo, estamos creando una consulta de métrica filtrada para obtener la suma de unidades de lectura en un compartimento en un intervalo de un minuto, filtrada en una sola tabla.

Por ejemplo:

oci monitoring metric-data summarize-metrics-data --compartment-id ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya
--namespace oci_nosql --query-text 'ReadUnits[1m]{tableName="articles"}.sum()'

Ejemplo de respuesta:

{
  "data": [
    {
      "aggregated-datapoints": [
        {
          "timestamp": "2022-02-17T11:03:00+00:00",
          "value": 0.0
        },
        {
          "timestamp": "2022-02-17T11:04:00+00:00",
          "value": 0.0
        },
        {
          "timestamp": "2022-02-17T11:05:00+00:00",
          "value": 0.0
        },

        ...
        ...
        ...

        {
          "timestamp": "2022-02-17T13:59:00+00:00",
         "value": 0.0
        },
        {
          "timestamp": "2022-02-17T14:00:00+00:00",
          "value": 0.0
        },
        {
          "timestamp": "2022-02-17T14:01:00+00:00",
          "value": 0.0
        }
      ],
      "compartment-id": "ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya",
      "dimensions": {
        "resourceId": "ocid1_nosqltable_oc1_phx_amaaaaaau7x7rfyav7f67yuj3t2q6rk7lp2a2obfdxa6hg2ho2ea7qabin4q",
        "tableName": "demo"
      },
      "metadata": {},
      "name": "ReadUnits",
      "namespace": "oci_nosql",
      "resolution": null,
      "resource-group": null
    }
  ]
}

Crear alarmas

Puede crear una alarma que evalúe la consulta de alarma y envíe una notificación cuando la alarma esté en estado de activación, junto con otras propiedades de alarma. Cuando se dispara, una alarma envía un mensaje de alarma al tema configurado (en Notifications), que luego envía el mensaje a todas las suscripciones del tema. Slack, Email, SMS y PagerDuty son algunos de los ejemplos de tema configurado en las notificaciones.

Cuando se configura, las notificaciones repetidas le recuerdan un estado de activación continuo durante el intervalo de repetición configurado. También se le notificará cuando una alarma regrese al estado OK o cuando se restablezca una alarma.

Una consulta de alarma contiene la expresión Monitoring Query Language (MQL) que se evalúa para la obtención de datos agregados. La consulta debe especificar una métrica, una estadística y un intervalo.

Hay dos formas de crear una alarma. Puede crear una consulta mediante la consola o la CLI de OCI.

Uso de la consola
Uso de CLI de OCI

Abra el menú de navegación y haga clic en Observación y gestión. En Supervisión, haga clic en Definiciones de alarma.
Haga clic en Crear alarma.

Nota: También puede crear una alarma a partir de una consulta predefinida en la página Métricas de servicio. Amplíe Opciones y haga clic en Crear una alarma en esta consulta. Para obtener más información sobre las métricas de servicio, consulte Visualización o listado de métricas de Oracle NoSQL Database Cloud Service.
En la página Crear alarma, en Definir alarma, complete o actualice la configuración de la alarma. Para alternar entre los modos básico y avanzado, haga clic en Cambiar a modo avanzado o Cambiar a modo básico (a la derecha de Definir alarma):
- Nombre de alarma: nombre fácil de recordar para la nueva alarma. Este nombre se envía como título de la notificación relacionada con esta alarma. Evite introducir información confidencial.
- Resumen de alarma: introduzca un resumen fácil de recordar para la nueva alarma. Este campo es opcional.
- Etiquetas (opcional): si tiene permiso para crear un recurso, también lo tiene para aplicar etiquetas de formato libre a ese recurso. Para aplicar una etiqueta definida, debe tener permiso para utilizar el espacio de nombres de la etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si deben aplicar etiquetas, omita esta opción (puede aplicar las etiquetas posteriormente) o pregunte al administrador.
  
  Nota: Haga clic en Mostrar opciones avanzadas en la parte inferior de la página para acceder a las opciones de etiquetas.
- Descripción de la métrica: métrica que se evaluará para la condición de alarma.
  - Compartimento: compartimento que contiene las tablas de Oracle NoSQL Database Cloud Service que desea supervisar. Por defecto, se selecciona el primer compartimento accesible.
  - Espacio de nombres de métrica: Oracle NoSQL Database Cloud Service emite métricas para las tablas que desea supervisar. Ejemplo: oci_nosql.
  - Grupo del recurso (opcional): grupo al que pertenece la métrica. Un grupo de recursos es una cadena personalizada con una métrica personalizada. No se aplica a las métricas de servicio.
  - Nombre de la métrica: nombre de la métrica. Solo se puede especificar una métrica. Las selecciones de métricas dependen del compartimento y del espacio de nombres de métrica seleccionados. Ejemplo: ReadUnits
  - Intervalo: ventana de agregación.
  - Estadística: la función de agregación.
  - Dimensiones de métrica: filtros opcionales para reducir los datos de métrica evaluados.
    - Campos de dimensión: para las métricas de Oracle NoSQL Database Cloud Service, puede seleccionar resourceId o tableName como nombre de dimensión y par de valores de dimensión.
- Agregar Flujos de Métricas: Traza una sola línea en el Gráfico de Métricas que representa el valor combinado de todos los Flujos de Métricas para la Estadística seleccionada.
- Disparar regla: condición que se debe cumplir para la alarma que se active. La condición puede especificar un umbral, como 90 % para el uso de la CPU GB.
  - Operador: operador usado en el umbral de condición.
  - Valor: valor que se va a utilizar para el umbral de condición.
  - minutos de retraso en el disparador: número de minutos que se debe mantener la condición para la activación de la alarma.
  - gravedad de la alarma: tipo de respuesta percibida que Se requiere cuando la alarma está en estado de activación.
  - Cuerpo de la alarma: contenido en lenguaje normal de la notificación entregada. Oracle recomienda proporcionar orientación a los operadores para resolver la condición de la alarma. Ejemplo: "Recuento de limitaciones de lectura alto".
Para cambiar la vista de los resultados de la consulta, haga clic en la opción adecuada situada encima de los resultados, a la derecha:
- Mostrar tabla de datos: muestra los puntos de datos, indicando el registro a la hora y el bytes de cada uno.
- Mostrar gráfico (por defecto): traza puntos de datos en un gráfico.
Configurar notificaciones: en Notificaciones, rellene los campos.
- Destinos: tema que se utilizará para las notificaciones.
- ¿Repetir notificación? : mientras la alarma se encuentra en el estado de activación, reenvía notificaciones en el intervalo especificado.
- Frecuencia de notificación: período de tiempo que se va a esperar para volver a ejecutar la notificación.
- Suprimir Notificaciones: Configure una ventana de tiempo de supresión durante el cual se suspenden las evaluaciones y las notificaciones. Es útil para evitar notificaciones del sistema durante períodos de mantenimiento.
Si desea desactivar la nueva alarma, desactive ¿Activar esta alarma?
Haga clic en Guardar alarma.

Desde Cloud Shell, ejecute el siguiente comando para crear una nueva alarma en el compartimento especificado. El OCID de compartimento es necesario.

oci monitoring alarm create --compartment-id <Compartment_OCID> --namespace oci_nosql --query-text [text] --destinations [complex type] --display-name [text] --is-enabled [boolean] --metric-compartment-id [text] --severity [text]

--query-text es la expresión de Monitoring Query Language (MQL) que se utiliza al buscar puntos de datos de métricas para agregar. La consulta debe especificar una métrica, una estadística y un intervalo. Valores admitidos para intervalo: 1m-60m (también 1h). Opcionalmente, puede especificar dimensiones y funciones de agrupación. Funciones de agrupación soportadas: grouping(), groupBy(). Para obtener más información sobre las OPCIONES disponibles con el comando de creación de alarma, consulte create - alarm. En el siguiente ejemplo, estamos creando una alarma con consulta de alarma cuando el percentil 90 de StorageGB es mayor que 85 en un compartimento a un intervalo de un minuto, filtrado en una sola tabla.

Ejemplo de alarma de umbral:

oci monitoring alarm create --compartment-id ocid1.compartment.oc1..aaaaaaaawrmvqjzoegxbsixp5k3b5554vlv2kxukobw3drjho3f7nf5ca3ya
--namespace oci_nosql --query-text 'StorageGB[1m]{tableName="demo"}.groupBy(WriteUnits).percentile(0.9) > 85'
--display-name HighStorageConsumption --metric-compartment-id demonosql --severity Critical --is-enabled true

Administrar alarmas

Puede seguir estas directrices sobre cómo gestionar las alarmas.

Crear un juego de alarmas para cada métrica. Para cada métrica emitida por la tabla de Oracle NoSQL Database Cloud Service, cree alarmas que definan los siguientes comportamientos de recursos:
- En riesgo: Oracle NoSQL Database Cloud Service corre el riesgo de dejar de funcionar, tal y como indican los valores de métrica. Por ejemplo, el tamaño de almacenamiento de una tabla corre el riesgo de un uso elevado.
- No óptimo: Oracle NoSQL Database Cloud Service funciona a un nivel no óptimo, según lo indicado por los valores de métricas. Por ejemplo, ReadUnits o Write Units tienen una latencia alta.
- El recurso está activo o caído: no se puede acceder a Oracle NoSQL Database Cloud Service o no funciona. Por ejemplo, número alto para ReadThrottleCount o WriteThrottleCount.
Configurar un proceso para responder a alarmas. En función de la gravedad de la alarma, puede elegir responder a las alarmas de las siguientes formas:
- En el caso de las alarmas críticas a riesgo, puede decidir notificar al equipo de operaciones inmediatamente, ya que se necesita una reparación para que las instancias vuelvan a tener niveles operativos óptimos. Configura notificaciones de alarma para el equipo responsable mediante PagerDuty y correo electrónico, y solicita una investigación y las reparaciones pertinentes antes de que las instancias vuelvan a estar operativas. Configura las notificaciones para que se repitan cada minuto. Cuando alguien responde a las notificaciones de alarma, detiene temporalmente estas notificaciones suprimiendo la alarma. Una vez que las métricas regresan a valores óptimos, elimina la supresión.
- Para las alarmas advertidas o no óptimas, puede decidir notificar al individuo o equipo adecuado que la tabla de Oracle NoSQL Database Cloud Service está consumiendo más tamaño de almacenamiento del habitual. Configura una alarma de umbral para notificar a los contactos adecuados, ya que no es necesario realizar acciones inmediatas para investigar y reducir el tamaño de almacenamiento. Activa solo las notificaciones por correo electrónico para el equipo o el desarrollador, y las configura para que se repitan cada 24 horas para no causar molestias.