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 recursos en la bóveda desde la página Explorador de registros en la consola de Google Cloud .

En la página Explorador de registros, se te guiará 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 del cierre automático de los incidentes.
  • Especifica a quién notificar.

Puedes configurar alertas para las siguientes categorías de trabajo: SCHEDULED_BACKUP, ON_DEMAND_BACKUP y RESTORE. También puedes configurar alertas para el estado del trabajo: 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 la creas.

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

  1. En la consola de Google Cloud , 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 falle un trabajo de copia de seguridad programado.

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

    Reemplaza lo siguiente:

    • PROJECT_ID: el nombre del proyecto.

  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 Cómo 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 consulta 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 seleccionada.
      3. En el campo Expresión regular, ingresa una expresión para extraer un valor del campo que debe contener exactamente un grupo de expresión regular.

  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 cierre 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 un canal de notificaciones configurado, 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 de forma manual 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.

    Ve a logEntries.write

  2. Para configurar la siguiente entrada de registro, cambia 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 anteriormente.

  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, obtienes 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 trabajo de copia de seguridad o restablecimiento en tu proyecto de nube.
    • El jsonPayload contiene una categoría de trabajo fallida, SCHEDULED_BACKUP, que indica que el registro está relacionado con una copia de seguridad programada por un plan de copia de seguridad.
    • El jsonPayload contiene el estado del trabajo de campo como FAILED, lo que significa que el trabajo falló.

  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 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 Cloud Monitoring. Si deseas obtener más información sobre los incidentes, incluida la forma de confirmarlos y cerrarlos, consulta Administra los incidentes de alertas basadas en registros.