Configurar una alerta basada en registros para recursos protegidos

En esta página se explica cómo configurar una alerta basada en registros para recursos protegidos en la página Explorador de registros de la consola de Google Cloud .

La página Explorador de registros te guía por los siguientes pasos para crear y editar alertas basadas en registros:

  • Proporciona un nombre y una descripción para la alerta.
  • Elige los registros de los que quieras recibir una notificación.
  • Define el intervalo de tiempo entre las notificaciones.
  • Define el tiempo que debe transcurrir para que los incidentes se cierren automáticamente.
  • Especifica a quién quieres notificar.

Puede configurar alertas para las categorías de trabajos de copia de seguridad y restauración: SCHEDULED_BACKUP, ON_DEMAND_BACKUP y RESTORE.

También puede configurar alertas para las categorías de trabajos de planes de copias de seguridad y de asociación de planes de copias de seguridad: UPDATE.

Los estados de trabajo disponibles son SUCCESSFUL, FAILED, SKIPPED y RUNNING.

Puedes configurar uno o varios canales de notificaciones, como Google Chat, correo electrónico, SMS o canales de programas de chat, para recibir notificaciones cuando se produzca una alerta. Para obtener instrucciones, consulta el artículo Crear y gestionar canales de notificación.

Antes de empezar

Crear una alerta basada en registros

Para enviar una alerta, debes tener un canal de notificación. Puedes crear el canal de notificaciones antes de crear una alerta o durante la creación de una alerta.

Sigue estas instrucciones para crear una alerta basada en registros.

  1. En la Google Cloud consola, ve a la página Explorador de registros.

    Ir a Explorador de registros

  2. En el panel Consulta, define la alerta de la que quieres recibir notificaciones.

    • La siguiente consulta es un ejemplo para recibir una notificación cada vez que falle una tarea de copia de seguridad programada.

      logName="projects/PROJECT_ID/logs/backupdr.googleapis.com/LOG_NAME"
jsonPayload.jobCategory="SCHEDULED_BACKUP"
jsonPayload.jobStatus="FAILED"

      Haz los cambios siguientes:

      • PROJECT_ID: el nombre del proyecto.

      • LOG_NAME: el nombre del registro, que puede ser:

        • bdr_backup_plan_jobs: tareas relacionadas con un plan de copia de seguridad
        • bdr_backup_plan_association_jobs: tareas relacionadas con la asociación del plan de copia de seguridad en el proyecto del administrador, en caso de protección entre proyectos.
        • bdr_backup_plan_association_source_jobs: trabajos relacionados con la asociación de planes de copia de seguridad en el proyecto de carga de trabajo.

  3. En el encabezado del panel Resultados de la consulta, haz clic en Crear alerta.

  4. En la sección Información de la alerta, haga lo siguiente:

    1. En el campo Nombre de la política de alertas, escribe el nombre de la alerta. Este nombre se muestra en el encabezado de la notificación.
    2. En el campo Documentation (Documentación), introduce la descripción de la alerta. Para obtener información sobre cómo dar formato y perfeccionar el contenido de este campo, consulta Usar Markdown y variables en plantillas de documentación.

  5. Haz clic en Siguiente.

  6. En la sección Seleccionar los registros que se incluirán en la alerta, haga lo siguiente:

    1. Haz clic en Vista previa de los registros para comprobar la consulta y los resultados. También puede editar la consulta en este panel, si es necesario.

    2. Haz clic en Añadir etiqueta y sigue estos pasos. Las etiquetas te permiten personalizar las notificaciones y hacer que sean más informativas.

      1. En el campo Nombre visible, introduce un nombre para la etiqueta.
      2. En la lista Nombre del campo de registro, selecciona un nombre de campo de registro. Estos campos se muestran en función del resultado de la consulta seleccionada.
      3. En el campo Expresión regular, introduzca una expresión para extraer un valor del campo que debe contener exactamente un grupo de expresiones regulares.

  7. Haz clic en Siguiente.

  8. En la sección Definir la frecuencia de las notificaciones y la duración del cierre automático, haga lo siguiente:

    1. En la lista Tiempo entre notificaciones, selecciona el tiempo mínimo entre notificaciones. Este valor le permite controlar el número de notificaciones que recibe de esta alerta si se activa varias veces.
    2. En la lista Duración del cierre automático de incidencias, selecciona el periodo tras el cual se cerrará automáticamente la incidencia si no hay entradas de registro coincidentes.

  9. Haz clic en Siguiente.

  10. En la lista Canales de notificación, selecciona uno o varios canales de notificación para tu alerta. Si no tienes ningún canal de notificaciones configurado, haz clic en Gestionar canales de notificaciones para crear uno. Para obtener instrucciones, consulta el artículo Crear y gestionar canales de notificación.

  11. Haz clic en Guardar.

Probar la alerta basada en registros

Para probar la alerta basada en registros que has creado, puedes escribir manualmente una entrada de registro que coincida con la consulta.

Sigue estas instrucciones para escribir la entrada de registro.

  1. Ve a la página de referencia de logEntries.write.

    Ve a logEntries.write.

  2. Configura la siguiente entrada de registro cambiando la variable PROJECT_ID por el ID de tu proyecto.

          {
        "entries": [
          {
            "jsonPayload": {
              "jobCategory": "SCHEDULED_BACKUP",
              "jobStatus": "FAILED"
            }
          }
        ],
        "resource": {
          "type": "backupdr.googleapis.com/BackupDRProject"
        },
        "logName": "projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs"
      }

    Haz los cambios siguientes:

    • PROJECT_ID: el nombre del proyecto.

  3. Copia la entrada de registro que configuraste anteriormente.

  4. En el panel Probar esta API, sigue estos pasos:

    1. En el campo Request body (Cuerpo de la solicitud), sustituye el contenido por la entrada de registro que has copiado en el paso anterior.
    2. Haz clic en la opción para ejecutar. Si se te solicita, sigue el flujo de autenticación.

  5. Si la llamada logEntries.write se realiza correctamente, obtendrá un código de respuesta HTTP 200 y un cuerpo de respuesta vacío, {}. Para obtener más información sobre el Explorador de APIs, consulte el artículo Usar el Explorador de APIs.

    La entrada de registro coincide con el filtro especificado para la alerta de las siguientes formas:

    • El valor logName especifica los registros de las tareas de copia de seguridad o restauración de tu proyecto en la nube.
    • El jsonPayload contiene una categoría de trabajo fallido, SCHEDULED_BACKUP, que indica que el registro está relacionado con una copia de seguridad programada por un plan de copias de seguridad.
    • El campo jsonPayload contiene el estado de la tarea como FAILED, lo que significa que la tarea ha fallado.

  6. Después de escribir la entrada de registro, se produce la siguiente secuencia:

    1. La nueva entrada de registro aparece en el explorador de registros y activa la alerta.
    2. Se abre un incidente en la página Cloud Monitoring.

    3. Recibirás una notificación sobre el incidente. Si has configurado un canal de notificaciones por correo electrónico, se mostrará la notificación.

      Puede hacer clic en Ver incidente en el correo para ver el incidente en la página Cloud Monitoring. Para obtener más información sobre los incidentes, incluido cómo confirmarlos y cerrarlos, consulta el artículo Gestionar incidentes relacionados con alertas basadas en registros.