Usa registros de plataforma

Los registros de la plataforma de App Lifecycle Manager en Cloud Logging te permiten supervisar eventos operativos, depurar fallas de aprovisionamiento de unidades y solucionar problemas de lanzamiento. Puedes consultar estos registros en el Explorador de registros y crear alertas basadas en registros para las operaciones y los lanzamientos de SaaS en tu proyecto de Google Cloud .

Para obtener detalles sobre los registros de plataforma de App Lifecycle Manager compatibles, consulta Registros de plataforma deGoogle Cloud . Para obtener más información sobre cómo comprender los datos de las tablas de registros de la plataforma, consulta Estructura de las entradas de registro.

Antes de comenzar

  1. En la consola de Google Cloud , en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud .
  2. Asegúrate de tener habilitada la facturación para tu proyecto de Google Cloud .
  3. Habilita la API de App Lifecycle Manager.
  4. Para obtener los permisos que necesitas para ver registros y crear alertas, pídele a tu administrador que te otorgue los siguientes roles de Identity and Access Management (IAM) en tu proyecto:
    • Visor de registros (roles/logging.viewer)
    • Editor de Monitoring (roles/monitoring.editor)

Crea alertas basadas en registros

Para crear una alerta basada en registros, compila una consulta en el Explorador de registros que devuelva las entradas de registro para las que deseas recibir alertas y, luego, configura la política de alertas.

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

    Ve al Explorador de registros

  2. En el editor de consultas, ingresa una consulta para filtrar las entradas de registro elegidas. Consulta las siguientes secciones para ver ejemplos de consultas.

  3. Haz clic en Crear alerta.

  4. Ingresa un nombre y una descripción para la política de alertas.

  5. Configura los detalles de la alerta, incluidos los canales de notificaciones.

  6. Haz clic en Guardar alerta.

Para obtener instrucciones detalladas, consulta Crea una alerta basada en registros.

Ejemplos de consultas para registros de plataforma

En esta sección, se proporcionan consultas de ejemplo para situaciones de alerta comunes basadas en los registros de la plataforma de App Lifecycle Manager.

Alertas de operaciones de SaaS

Para crear una alerta cuando falla una operación de aprovisionamiento de unidades, usa la siguiente consulta:

log_id("saasservicemgmt.googleapis.com/deployment_events") AND
resource.type="saasservicemgmt.googleapis.com/Unit" AND
jsonPayload.unitOperationState="UNIT_OPERATION_STATE_FAILED" AND
jsonPayload.unitOperationType="provision"

Para crear una alerta cuando una operación de aprovisionamiento de unidades alcance un estado terminal (correcto, con errores o cancelado), usa la siguiente consulta:

log_id("saasservicemgmt.googleapis.com/deployment_events") AND
resource.type="saasservicemgmt.googleapis.com/Unit" AND
(jsonPayload.unitOperationState="UNIT_OPERATION_STATE_SUCCEEDED"
  OR jsonPayload.unitOperationState="UNIT_OPERATION_STATE_FAILED"
  OR jsonPayload.unitOperationState="UNIT_OPERATION_STATE_CANCELLED") AND
jsonPayload.unitOperationType="provision"

Alertas de lanzamiento

Para crear una alerta de registro cuando un lanzamiento entra en un estado PAUSED (porque App Lifecycle Manager identificó el lanzamiento como en mal estado) o un estado FAILED, usa la siguiente consulta:

resource.type = "saasservicemgmt.googleapis.com/Rollout"
(jsonPayload.currentState = "PAUSED" AND jsonPayload.reason = "SYSTEM_PAUSE")
  OR
jsonPayload.currentState = "FAILED"

Para crear una alerta de métrica para las métricas de estado de lanzamiento cuando un lanzamiento entra en un estado PAUSED (porque App Lifecycle Manager identificó el lanzamiento como en mal estado) o un estado FAILED, usa la siguiente consulta:

saasservicemgmt_googleapis_com:rollout_state
{state_name="PAUSED", reason="SYSTEM_PAUSE"}
OR
saasservicemgmt_googleapis_com:rollout_state{state_name="FAILED"}

¿Qué sigue?