Personalizar el cuerpo de la alarma

Ejemplo: creación de una URL en el cuerpo de la alarma para ver los registros de log de disparo de alarma en el explorador de logs

Puede que desee tener una URL significativa en el cuerpo de la alarma para volver al explorador de logs y ver los registros de log que han disparado la alarma. Para ello, pase un intervalo de tiempo y algunos filtros adicionales. Normalmente, en este flujo, debe transferir el nombre de etiqueta. Además, en el siguiente ejemplo, también pasaremos la entidad (mtgt).

• Definición de regla de detección:

  Considere la regla de detección de tiempo de ingestión que tiene la siguiente configuración:

  • Nombre de regla de detección: http errors
  • La regla de detección se dispara cuando encuentra al menos un registro de log en un período de un minuto al que se le ha asignado la etiqueta HTTP Error. La asignación de esta etiqueta se realiza en la configuración de enriquecimiento automáticamente cuando se ingieren los datos.
  • Cuando hay al menos 1 registro de log coincidente en un período de un minuto, una métrica http_errors en el espacio de nombres logging_analytics_test obtiene un nuevo valor.
  • Las dimensiones se agregan en función de los campos de log analizados Entidad y Dirección IP de host (cliente).
  • Además, las dimensiones se agregan automáticamente para la etiqueta (HTTP Error en este caso) y el OCID de la regla de detección. Son dimensiones implícitas.
• Ver las métricas generadas por la regla de detección en el explorador de métricas:
  
  
  
  

  Al consultar el explorador de métricas para la métrica errores HTTP, se puede anotar la siguiente información:

  Coincidiendo con el explorador de logs, tres puntos de datos con los registros de log 18, 3 y 4 coinciden con esta etiqueta.

  Se muestran las siguientes dimensiones. Tenga en cuenta que Host IP Address (Client) no se muestra porque los registros de log que disparan las alarmas no tienen un valor para ese campo.

  
  
  
  
  
• Personalizar el cuerpo de la alarma:

  Para los registros log que han disparado la alarma, estos son los valores de las dimensiones:

  
  
  
  
  

  La ejecución de la siguiente consulta le lleva de nuevo al explorador de logs en contexto; por ejemplo, cuando la alarma se dispara en 18 registros de log coincidentes (el primer punto de datos del explorador de métricas):

  Label = 'HTTP Error' and Entity='mushop-ZKjW' | where Time > dateAdd(1708916460000, minute, -1) and Time < dateAdd(1708916460000, minute, 1) | timestats count as logrecords

  Aquí, los valores HTTP Error, mushop-ZKjW y 1708916460000 provienen de las variables de alarma. En la consulta, buscamos la hora un minuto antes y después de la hora de la alarma. Puede ajustar esto en la consulta.

  A continuación se muestra un ejemplo de contenido de cuerpo de alarma que le proporciona un enlace en su correo electrónico para volver a esta vista:

  This alarm indicates that one or more HTTP Errors have occurred. You can see the original log records here:
  https://cloud.oracle.com/loganalytics/explorer?region=us-phoenix-1&timeNum=1&timeUnit=week&filters=label__:__{{Dimensions.Label}}__;__entity__:__{{Dimensions.mtgt}}&query=* | where time > dateadd({{timestampEpochMillis}}, minute, -1) and time < dateadd{{timestampEpochMillis}}, minute, 1) | timestats count as logrecords

  Antes de que se genere la notificación de alarma, las variables de {{}} se sustituyen por el servicio Monitoring proporcionando un texto de cuerpo de alarma resultante:

  This alarm indicates that one or more HTTP Errors have occurred. You can see the original log records here:   
  https://cloud.oracle.com/loganalytics/explorer?region=us-phoenix-1&timeNum=1&timeUnit=week&filters=label__:__HTTP Error__;__entity__:__mushop-ZKjW&query=* | where time > dateadd(1708916460000 , minute, -1) and time < dateadd(1708916460000, minute, 1) | timestats count as logrecords

• Ver resultado en el explorador de logs:

  Al hacer clic en el enlace de su correo electrónico y después de conectarse a su arrendamiento, se muestra lo siguiente:

  
  
  
  
  

Para obtener más información sobre los parámetros de URL del explorador de logs, consulte Parámetros de URL del explorador de logs.