Documentación de Oracle Cloud Infrastructure

Adición de reglas de disparador a una alarma

Defina una o más reglas de disparador, o predicados, para una alarma. Una regla de disparador es una condición (definida por la consulta) que se debe cumplir para que la alarma esté en estado de activación y también incluye la gravedad, el retraso del disparador (pendingDuration) y el cuerpo de la alarma que se va a incluir en las notificaciones. Una condición de una regla de disparador puede especificar un umbral, como 90 % para el uso o una ausencia de CPU.

Agregue hasta dos reglas de disparador, o predicados, a una alarma. Por ejemplo, añada una regla de activador crítico para el 95% y una regla de activador de aviso para el 90%.

Nota

Para comprender cómo se envían las notificaciones cuando una alarma tiene varias reglas de disparador, consulte Agrupación de notificaciones para una alarma y División de notificaciones para una alarma.
Ejemplo de reglas de disparador en una alarma
{
  "body": "95% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>95",
  "ruleName": "95",
  "severity": "CRITICAL",
},
{
  "body": "90% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>90",
  "ruleName": "90",
  "severity": "WARNING",
}

Para ver los operadores de predicado válidos en las expresiones MQL, consulte Operadores de predicado.

Para solucionar problemas de alarma, consulte Solución de problemas de alarmas. Consulte también Creating a Basic Alarm.

    1. En la página de lista Definiciones de alarma, seleccione la alarma con la que desea trabajar. Si necesita ayuda para buscar la página de lista o la alarma, consulte Lista de alarmas.
    2. Vaya a Acciones y, a continuación, seleccione Editar alarma.
    3. En el área Descripción de métrica, verifique que el espacio de nombres de métrica y el nombre de métrica que desea están seleccionados.
    4. Para definir una regla de disparador (predicado) mediante el modo básico (valor por defecto), vaya al área Regla de disparador y proporcione los siguientes valores:
      • En Operador, seleccione el operador que se va a utilizar en el umbral de condición. Consulte Operadores de predicado.
      • En Valor, introduzca el valor que se va a utilizar para el umbral de condición. Para los operadores entre y fuera, introduzca ambos valores para el rango.
      • Para los minutos de retraso de disparador, introduzca el número de minutos que se debe mantener la condición antes de la alarma en estado de activación.
      • Para la gravedad de la alarma, seleccione el tipo de respuesta percibida que la alarma está en estado de activación para esta condición (regla de activación).
      • En Cuerpo de la alarma, introduzca el contenido legible por el usuario de la notificación para esta condición (regla de disparador).

        Recomendamos proporcionar orientación a los operadores para resolver la condición de la alarma. Considere agregar enlaces a las prácticas del libro de ejecución estándar. Ejemplo: "Alerta: Uso elevado de CPU. Para resolver el problema, siga las instrucciones del libro de ejecución". Si lo desea, inserte variables dinámicas para representar el valor de los parámetros de mensaje de alarma asociados en los mensajes de alarma. Por ejemplo, inserte {{query}} para representar el valor de query.

      • Para agregar otra regla de disparador (condición), seleccione Regla de disparador adicional.
    5. Para definir una regla del disparador (predicado) actualizando la expresión MQL, realice los siguientes pasos:
      1. En la parte superior de la página Editar alarma, seleccione Cambiar a modo avanzado.
      2. Proporcione los siguientes valores:
        • En los minutos de retraso de disparador, introduzca el número de minutos que se debe mantener la condición antes de que la alarma esté en estado de activación.
        • Para la gravedad de la alarma, seleccione el tipo de respuesta percibida que la alarma está en estado de activación para esta condición (regla de activación).
        • En Editor de códigos de consulta, edite la consulta MQL para especificar la regla de disparador que desee.

          La regla de disparador es el operador y el fragmento de valor en la consulta MQL. Por ejemplo, el fragmento > 90 representa el operador mayor que y un valor 90. Ejemplo de consulta MQL:

          CpuUtilization[5m].Mean() > 90

          Para obtener referencias, vea Consulta de datos de métricas y Referencia de Monitoring Query Language (MQL).

        • En Cuerpo de la alarma, introduzca el contenido legible por el usuario de la notificación para esta condición (regla de disparador).
        • Para agregar otra regla de disparador (condición), seleccione Regla de disparador adicional.
    6. Actualice cualquier otro valor para la alarma, según sea necesario.
      Para obtener más información sobre los campos, consulte Creación de una alarma básica.
    7. Seleccione Guardar alarma.

  • Utilice el comando oci Monitoring alarm update y los parámetros necesarios para actualizar las reglas de disparador en una alarma. Una regla de disparador forma parte de la expresión MQL o consulta.

    Para una alarma con una regla, utilice el parámetro --query-text. Ejemplo de actualización de regla de disparador a más del 90 por ciento (>90):

    oci monitoring alarm update --query-text "CPUUtilization[1m].mean()>90" [...]

    Para una alarma con varias reglas, utilice el parámetro --overrides. Ejemplo:

    oci monitoring alarm update --overrides <json_file_path> [...]
    Ejemplo de archivo JSON para solicitud (alarma con varias reglas de disparador)
    {
  "body": "95% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>95",
  "ruleName": "95",
  "severity": "CRITICAL",
},
{
  "body": "90% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>90",
  "ruleName": "90",
  "severity": "WARNING",
}

    Para obtener una lista completa de parámetros y valores para comandos de CLI, consulte la Referencia de línea de comandos para la supervisión.

  • Ejecute la operación UpdateAlarm para actualizar una alarma. Una regla de disparador forma parte de la expresión MQL en un atributo query.

    Proporcione las reglas de disparador mediante UpdateAlarmDetails. Para una alarma con una regla (sin valor overrides), utilice el atributo query. Para una alarma con varias reglas, utilice el atributo overrides.