Incidentes para políticas de alertas basadas en métricas

Un incidente es un registro de cuándo se cumplen las condiciones de una política de alertas. Por lo general, cuando se cumplen las condiciones, Cloud Monitoring abre un incidente y envía una notificación. Sin embargo, no se crean incidentes cuando la política se pospone o se inhabilita, cuando hay demasiados incidentes abiertos para esa política o cuando se sabe que el recurso subyacente está inhabilitado. Además, cuando una política de alertas contiene varias condiciones, la política de alertas especifica si cumplir con una condición es suficiente para causar la creación de un incidente.

En este documento, se describe cómo puedes ver, investigar y administrar incidentes para las políticas de alertas basadas en métricas.

Antes de comenzar

Asegúrate de tener los permisos necesarios:

Para obtener más información sobre las funciones de Cloud Monitoring, consulta Controla el acceso con Identity and Access Management.

Encuentra incidentes

Para ver una lista de incidentes, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página  Alertas:

    Ir a las Alertas

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

    • En el panel Resumen, se muestra la cantidad de incidentes abiertos.
    • En el panel Incidentes, se muestran los incidentes más recientes. Para enumerar los incidentes más recientes en la tabla, incluidos los que están cerrados, haz clic en Mostrar incidentes cerrados.

  2. Opcional: Para ver los detalles de un incidente específico, selecciónalo en la lista. Se abrirá la página Detalles del incidente. Para obtener información sobre esta página, consulta la sección Investiga incidentes.

Encuentra incidentes más antiguos

En el panel Incidentes en Alertas, se muestran los incidentes abiertos más recientes. Para ubicar los incidentes más antiguos, realiza una de las siguientes acciones:

  • Para desplazarte por las entradas de la tabla Incidentes, haz clic en  Más reciente o  Más antiguo.

  • Para navegar a la página Incidentes, haz clic en Ver todos los incidentes. En la página Incidentes, puedes hacer todo lo siguiente:

    • Mostrar incidentes cerrados: Para enumerar todos los incidentes en la tabla, haz clic en Mostrar incidentes cerrados.
    • Filtra incidentes: Para obtener información sobre cómo agregar filtros, consulta Filtrar incidentes.
    • Confirma o cierra un incidente, o pospone su política de alertas. Para acceder a estas opciones, haz clic en  Más opciones en la fila del incidente y selecciona una opción del menú. Para obtener más información, consulta Administra incidentes.

Filtrar incidentes

Cuando ingresas un valor en la barra de filtros, solo los incidentes que coinciden con el filtro se enumeran en la tabla Incidentes. Si agregas varios filtros, un incidente se muestra solo si satisface todos los filtros.

Para agregar un filtro a la tabla de incidentes, haz lo siguiente:

  1. En la página Incidentes, haz clic en  Filtrar tabla y, luego, selecciona una propiedad de filtro. Las propiedades del filtro incluyen lo siguiente:

    • Estado del incidente
    • Nombre de la política de alertas
    • Cuando se abrió o cerró el incidente
    • Tipo de métrica
    • Tipo de recurso

  2. Selecciona un valor del menú secundario o ingresa un valor en la barra de filtros.

    Por ejemplo, si seleccionas Tipo de métrica y, luego, ingresas usage_time, es posible que solo veas las siguientes opciones en el menú secundario:

    agent.googleapis.com/cpu/usage_time
compute.googleapis.com/guest/container/cpu/usage_time
container.googleapis.com/container/cpu/usage_time

Investiga incidentes

Una vez que hayas encontrado el incidente que deseas investigar, ve a la página Detalles del incidente de ese incidente. Para ver los detalles, selecciona el resumen del incidente en la tabla de incidentes de las páginas Alertas o Incidentes.

Como alternativa, si recibiste una notificación que incluye un vínculo al incidente, puedes usar ese vínculo para ver los detalles del incidente.

En la página Detalles del incidente, se proporciona la siguiente información:

  • Información de estado, incluida la siguiente:

    • Nombre: El nombre de la política de alertas que causó este incidente.
    • Estado: El estado del incidente: abierto, confirmado o cerrado.
    • Gravedad: La gravedad del incidente:
      • Sin gravedad
      • Esencial
      • Error
      • Con advertencias
    • Duración: La cantidad de tiempo durante el cual el incidente estuvo abierto.

  • Información sobre la política de alertas que causó el incidente:

    • Panel Condición: Identifica la condición en la política de alertas que causó el incidente.

    • Panel Mensaje: Proporciona una breve explicación de la causa según la configuración de la condición en la política de alertas. Este panel siempre se propaga.

    • Panel Documentation: Muestra la plantilla de documentación para las notificaciones que proporcionaste cuando creaste la política de alertas. Esta información puede incluir una descripción de lo que supervisa la política de alertas y sugerencias para la mitigación.

      Si omitiste este campo cuando creaste la política de alertas, el panel informará “No se configuró ninguna documentación”.

  • Etiquetas: Informa lo siguiente:

    • Las etiquetas y los valores del recurso supervisado y la métrica de la serie temporal que causó el incidente. Esta información puede ayudarte a identificar el recurso supervisado específico que causó el incidente.

      Cuando usas variables en la documentación para etiquetas de métricas, Monitoring omite la etiqueta de las notificaciones cuando el valor de la etiqueta no comienza con un dígito, una letra, una barra diagonal (/) o un signo igual (=).

    • Cualquier etiqueta y valor especificados por el usuario que definiste en la política de alertas. Puedes usar estas etiquetas para organizar y también identificar las políticas de alertas. Las etiquetas asociadas con una política se enumeran en la sección Etiquetas de política, mientras que las etiquetas definidas como parte de una condición se enumeran en la sección Etiquetas de métrica. Las etiquetas de metadatos solo se muestran cuando hay un filtro o una agrupación que depende de la etiqueta. Para obtener más información, consulta Anota alertas con etiquetas.

En la página Detalles de incidentes, también se proporcionan herramientas para investigar el incidente:

  • Cronograma del incidente: Se muestran dos representaciones visuales del incidente:

    • En el cronograma, una barra roja representa la hora de un incidente. La longitud y la posición de la barra reflejan la duración del incidente.
    • En un gráfico, se muestran los datos de las series temporales y el umbral que usa la política de alertas que causó el incidente. El incidente se abrió cuando una serie temporal cumplió con una condición de la política de alertas.

    El eje de tiempo indica la duración del incidente con dos puntos etiquetados. La posición de estos puntos en el eje de tiempo determina el rango de datos que se muestran en el gráfico que acompaña a la línea de tiempo del incidente. De forma predeterminada, se coloca un punto al comienzo del incidente y otro al final, o en el momento actual si aún está abierto.

    Puedes modificar el intervalo de tiempo en el cronograma del incidente y el gráfico:

    • Para cambiar el intervalo de tiempo que se muestra en el gráfico, arrastra cualquiera de los puntos a lo largo del eje de tiempo. Si usas esta técnica, puedes enfocarte en intervalos específicos, por ejemplo, alrededor del comienzo o del final del incidente.

      Si modificas el gráfico arrastrando los puntos en el eje, se establece un valor personalizado en el menú Período (Time Span) y, luego, se inhabilita el menú. Para habilitar el menú Intervalo de tiempo, haz clic en Restablecer.

    • Para cambiar el intervalo de tiempo que se muestra en el cronograma, selecciona un intervalo en el menú Período (Time Span).
  • Vínculos a otras herramientas de solución de problemas La configuración de tu proyecto y la política de alertas, y la antigüedad del incidente, determinan qué vínculos están disponibles.
    • Para ver la página de detalles de la política de alertas, haz clic en Ver política.
    • Para editar la definición de la política de alertas, haz clic en Editar política.
    • Para ir a un panel con la información de rendimiento del recurso, haz clic en Ver detalles del recurso.
    • Para ver las entradas de registro relacionadas en el explorador de registros, haz clic en Ver registros. Para obtener más información, consulta Visualiza registros con el Explorador de registros.
    • Para investigar los datos del gráfico, haz clic en Ver en el Explorador de métricas.
  • Anotaciones: Proporciona un registro de tus hallazgos, resultados, sugerencias y otros comentarios provenientes de tu investigación del incidente.
    • Para agregar una anotación, ingresa texto en el campo y haz clic en Agregar comentario.
    • Para descartar el comentario, haz clic en Cancelar.

Administración de incidentes

Los incidentes están en uno de los siguientes estados:

  • Abierto: Se cumple el conjunto de condiciones de la política de alertas o no hay datos que indiquen que ya no se cumple la condición. Si una política de alertas contiene varias condiciones, los incidentes se abren según cómo se combinen esas condiciones. Para obtener más información, consulta Políticas con varias condiciones.

  • Confirmado: El incidente está abierto y se marcó de forma manual como confirmado. Por lo general, este estado indica que se investiga el incidente.

  • Cerrado: El sistema observó que la condición dejó de cumplirse, que cerraste el incidente o que pasaron 7 días sin que se observara que la condición seguía cumpliendo.

Cuando configures una política de alertas, asegúrate de que el estado estable proporcione una señal cuando todo esté bien. Esto es necesario para garantizar que se pueda identificar el estado sin errores y, si un incidente está abierto, se puede cerrar. Si no hay una señal que indique que se detuvo una condición de error, después de que se abre un incidente, permanece abierto durante 7 días después de que se activa la política de alertas.

Por ejemplo, si creas una política de alertas que te notifica cuando el recuento de errores es mayor que 0, asegúrate de que produzca un recuento de 0 errores cuando no haya ninguno. Si la política de alertas muestra un valor nulo o vacío en el estado sin errores, no hay señal para indicar cuándo se detuvieron los errores. En algunas situaciones, el lenguaje de consulta de Monitoring (MQL) admite la capacidad de especificar un valor predeterminado que se usa cuando no hay un valor medido disponible. Para ver un ejemplo, consulta Proporción de uso.

Confirma incidentes

Te recomendamos que marques un incidente como confirmado cuando comiences a investigar la causa del incidente.

Para marcar un incidente como confirmado, haz lo siguiente:

  • En el panel Incidentes de la página Alertas, haz clic en Ver todos los incidentes.

  • En la página Incidentes, busca el incidente que deseas confirmar y, luego, realiza una de las siguientes acciones:

    • Haz clic en  Más opciones y, luego, selecciona Confirmar.
    • Abre la página de detalles del incidente y, luego, haz clic en Confirmar incidente.

Si tu política de alertas está configurada para enviar notificaciones repetidas, confirmar un incidente no detendrá las notificaciones. Para detenerlos, realiza una de las siguientes acciones:

  • Crea una alerta pospuesta para la política de alertas.
  • Inhabilitar la política de alertas

Posponer una política de alertas

Para evitar que Monitoring cree incidentes y envíe notificaciones durante un período específico, pospón la política de alertas relacionada. Cuando pospones una política de alertas, Monitoring también cierra todos los incidentes relacionados con ella.

Para crear una alerta pospuesta para un incidente que estás viendo, haz lo siguiente:

  1. En la página Detalles del incidente, haz clic en Posponer.

  2. Selecciona la duración de la alerta pospuesta. Después de seleccionar la duración de la pospuesta, esta comienza de inmediato.

Cuando ves la página de detalles de un incidente, puedes crear una alerta pospuesta para la política de alertas relacionada. Para ello, haz clic en Posponer y, luego, elige una duración. La alerta pospuesta comienza de inmediato. También puedes posponer una política de alertas desde la página Incidentes. Para ello, busca el incidente que deseas posponer, haz clic en  Más opciones y, luego, selecciona Posponer. Puedes posponer las políticas de alertas durante las interrupciones para evitar más notificaciones durante el proceso de solución de problemas.

Cerrar incidentes

Puedes permitir que Monitoring cierre un incidente por ti o puedes cerrarlo después de que las observaciones dejen de llegar. Si cierras un incidente y, luego, llegan datos que indican que se cumple la condición, se crea un incidente nuevo. Cuando cierras un incidente, esa acción no cierra ningún otro incidente que esté abierto para la misma condición. Si pospones una política de alertas, los incidentes abiertos se cierran cuando comienza la función.

Monitoring cierra de forma automática un incidente cuando ocurre alguna de las siguientes situaciones:

  • Condiciones del umbral de métrica:

    • Se recibe una observación que indica que el umbral no se infringió.

    • No llegan observaciones, la condición se configura para cerrar incidentes cuando dejan de llegar las observaciones y el estado del recurso subyacente es desconocido o no está inhabilitado.

    • No llegan observaciones sobre la duración del cierre automático de la política de alertas y la condición no está configurada para cerrar los incidentes de forma automática cuando dejan de llegar las observaciones. Para configurar la duración del cierre automático, puedes usar la consola de Google Cloud o la API de Cloud Monitoring. De forma predeterminada, la duración del cierre automático es de siete días. La duración mínima del cierre automático es de 30 minutos.

  • Condiciones de ausencia de métricas:

    • Ocurre una observación.
    • No llegan observaciones durante 24 horas después de que vence la duración del cierre automático de la política de alertas. Para configurar la duración del cierre automático, puedes usar la consola de Google Cloud o la API de Cloud Monitoring. De forma predeterminada, la duración del cierre automático es de siete días.

  • Condiciones de previsión:

    • Se produce una previsión y esta predice que la serie temporal no infringirá el umbral dentro del período de previsión.

    • No llega ninguna observación durante 10 minutos, la condición se configura para cerrar incidentes cuando las observaciones dejan de llegar y el estado del recurso subyacente es desconocido o no está inhabilitado.

    • No llegan observaciones sobre la duración del cierre automático de la política de alertas y la condición no está configurada para cerrar los incidentes de forma automática cuando dejan de llegar las observaciones.

Por ejemplo, una política de alertas generó un incidente porque la latencia de respuesta HTTP fue superior a 2 segundos durante 10 minutos consecutivos. Si la siguiente medición de la latencia de respuesta HTTP es menor o igual que dos segundos, se cierra el incidente. Del mismo modo, si no se reciben datos durante siete días, se cierra el incidente.

Para cerrar un incidente, haz lo siguiente:

  1. En el panel Incidentes de la página Alertas, haz clic en Ver todos los incidentes.

  2. En la página Incidentes, busca el incidente que deseas cerrar y, luego, realiza una de las siguientes acciones:

    • Haz clic en  Ver más y, luego, selecciona Cerrar incidente.
    • Abre la página de detalles del incidente y, luego, haz clic en Cerrar incidente.

Si ves el mensaje Unable to close incident with active conditions, no se puede cerrar el incidente porque se recibieron datos dentro del período de alerta más reciente.

Si ves el mensaje Unable to close incident. Please try again in a few minutes., no se pudo cerrar el incidente debido a un error interno.

Retención y límites de datos

Para obtener información sobre los límites y el período de retención de los incidentes, consulta Límites de alertas.

¿Qué sigue?

* Para obtener un tratamiento conceptual detallado de las políticas de alertas, consulta Comportamiento de las políticas de alertas basadas en métricas.