Configura una alerta basada en registros para los recursos de la bóveda

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

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

  • Proporciona un nombre y una descripción para la alerta.
  • Elige los registros para los que quieres recibir notificaciones.
  • Establece el intervalo de tiempo entre notificaciones.
  • Establece la hora para el cierre automático de incidentes.
  • Especifica a quién notificar.

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

También puedes configurar alertas para las categorías de trabajos del plan de copias de seguridad y de la asociación del plan de copias de seguridad: UPDATE.

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

Puedes configurar uno o más 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 Cómo crear y administrar canales de notificaciones.

Antes de comenzar

Crear una alerta basada en registros

Para notificar una alerta, debes tener un canal de notificaciones. Puedes crear el canal de notificaciones antes de crear una alerta o mientras creas una.

Usa las siguientes instrucciones para crear una alerta basada en registros.

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

    Ir al Explorador de registros

  2. En el panel Consulta, define la alerta sobre la que deseas recibir notificaciones.

    • La siguiente consulta es un ejemplo para recibir notificaciones cada vez que falla un trabajo de copia de seguridad programado.

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

      Reemplaza lo siguiente:

      • PROJECT_ID: el nombre del proyecto.

      • LOG_NAME: Es el nombre del registro, que puede ser uno de los siguientes:

        • bdr_backup_plan_jobs: Trabajos relacionados con un plan de copia de seguridad
        • bdr_backup_plan_association_jobs: Son los trabajos relacionados con la asociación del plan de copias de seguridad en el proyecto del administrador, en caso de protección entre proyectos.
        • bdr_backup_plan_association_source_jobs: Son trabajos relacionados con la asociación del plan 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 Detalles de la alerta, haz lo siguiente:

    1. En el campo Nombre de la política de alertas, ingresa un nombre para la alerta. Este nombre se muestra en el encabezado de la notificación.
    2. En el campo Documentación, ingresa la descripción de la alerta. Para obtener información sobre cómo puedes dar formato y definir mejor el contenido de este campo, consulta Usar Markdown y variables en las plantillas de documentación.

  5. Haz clic en Siguiente.

  6. En la sección Elige registros para incluir en la alerta, haz lo siguiente:

    1. Haz clic en Obtener vista previa de los registros para verificar la consulta y los resultados. Si es necesario, también puedes editar la búsqueda en este panel.

    2. Haz clic en Agregar una etiqueta y haz lo siguiente. Las etiquetas te permiten personalizar las notificaciones y hacerlas más informativas.

      1. En el campo Nombre visible, ingresa 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 según el resultado de la consulta seleccionado.
      3. En el campo Expresión regular, ingresa 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 Establecer la frecuencia de notificación y la duración del cierre automático, haz lo siguiente:

    1. En la lista Tiempo entre notificaciones, selecciona el tiempo mínimo entre notificaciones. Este valor te permite controlar la cantidad de notificaciones que recibes de esta alerta si se activa varias veces.
    2. En la lista Duración del cierre automático de incidentes, selecciona una duración después de la cual se cerrará automáticamente el incidente cuando falten entradas de registro que coincidan.

  9. Haz clic en Siguiente.

  10. En la lista Canales de notificaciones, selecciona uno o más canales de notificaciones para tu alerta. Si no tienes configurado un canal de notificaciones, haz clic en Administrar canales de notificaciones para crear uno. Para obtener instrucciones, consulta Cómo crear y administrar canales de notificaciones.

  11. Haz clic en Guardar.

Prueba la alerta basada en registros

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

Usa las siguientes instrucciones para escribir la entrada de registro.

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

    Ir 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"
      }

    Reemplaza lo siguiente:

    • PROJECT_ID: el nombre del proyecto.

  3. Copia la entrada de registro que configuraste antes.

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

    1. En el campo Cuerpo de la solicitud, reemplaza el contenido por la entrada de registro que copiaste en el paso anterior.
    2. Haz clic en Ejecutar. Si se te solicita, sigue el flujo de autenticación.

  5. Si la llamada a logEntries.write se realiza correctamente, recibirás 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, consulta Cómo usar el Explorador de APIs.

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

    • El valor logName especifica los registros de los trabajos de copia de seguridad o restauración en tu proyecto de Cloud.
    • El objeto 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 copia de seguridad.
    • El campo jsonPayload contiene el estado del trabajo como FAILED, lo que significa que el trabajo falló.

  6. Después de escribir la entrada de registro, ocurre 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 de Cloud Monitoring.

    3. Recibes una notificación sobre el incidente. Si configuraste un canal de notificaciones por correo electrónico, se mostrará la notificación.

      Puedes hacer clic en Ver incidente en el correo electrónico para ver el incidente en la página de Cloud Monitoring. Para obtener más información sobre los incidentes, incluido cómo confirmarlos y cerrarlos, consulta Administra los incidentes de alertas basadas en registros.