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 e incluye también la gravedad, el retraso del disparador (pendingDuration) y el cuerpo de la alarma que se debe incluir en las notificaciones. Una condición de una regla de disparador puede especificar un umbral, como un 90 % de uso de CPU o una ausencia.

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 se han seleccionado el espacio de nombres de métrica y el nombre de métrica que desea.
    4. Para definir una regla de disparador (predicado) mediante el modo básico (por defecto), vaya al área Regla de disparador y proporcione los siguientes valores:
      • Para Operador, seleccione el operador que se utilizará en el umbral de condición. Consulte Operadores de predicado.
      • En Valor, introduzca el valor que se utilizará para el umbral de condición. Para los operadores entre y fuera, introduzca ambos valores para el rango.
      • En Minutos de retraso del disparador, introduzca el número de minutos que se debe mantener la condición para que la alarma entre en estado de activación.
      • Para Gravedad de la alarma, seleccione el tipo de respuesta percibida necesaria cuando la alarma está en estado de activación para esta condición (regla de disparador).
      • En Cuerpo de alarma, introduzca el contenido en lenguaje natural 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". Opcionalmente, 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 de 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 Minutos de retraso del disparador, introduzca el número de minutos que se debe mantener la condición para que la alarma entre en estado de activación.
        • Para Gravedad de la alarma, seleccione el tipo de respuesta percibida necesaria cuando la alarma está en estado de activación para esta condición (regla de disparador).
        • En Editor de códigos de consulta, edite la consulta MQL para especificar la regla de disparador que desea.

          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 alarma, introduzca el contenido en lenguaje natural 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 Save alarm.

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

    Para una alarma con una regla, utilice el parámetro --query-text. Ejemplo de actualización de la 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> [...]
    Archivo JSON de ejemplo 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 los comandos de la CLI, consulte la Command Line Reference for Monitoring.

  • 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.