Usa registros de plataforma

En esta página, se describe cómo ver los registros de plataforma generados por App Lifecycle Manager. Los registros de plataforma en Google Cloud son registros específicos del servicio que puedes usar para depurar y solucionar problemas, y comprender mejor los Google Cloud servicios que usas.

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

Antes de comenzar

  1. En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un Google Cloud proyecto.
  2. Asegúrate de que la facturación esté habilitada para tu Google Cloud proyecto.
  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 muestre las entradas de registro para las que deseas recibir alertas y, luego, configura la política de alertas.

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

    Ir 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 ejemplos de consultas para situaciones de alertas comunes basadas en registros de 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:

protoPayload.methodName="google.cloud.saasplatform.saasservicemgmt.v1beta1.SaasDeployments.CreateUnitOperation"
protoPayload.response.state="UNIT_OPERATION_STATE_FAILED"

Para crear una alerta cuando una operación de aprovisionamiento de unidades alcanza un estado terminal (se completó correctamente, falló o se canceló), usa la siguiente consulta:

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.UnitOperationLog"
AND (jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_SUCCEEDED" OR jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_FAILED" OR jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_CANCELLED")
AND jsonPayload.unit_operation_type="PROVISION"

Alertas de lanzamiento

Para crear una alerta de registro cuando un lanzamiento entra en un estado PAUSED (porque App Lifecycle Manager identificó que el lanzamiento no es correcto) o en 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étricas para las métricas de estado de lanzamiento cuando un lanzamiento entra en un estado PAUSED (porque App Lifecycle Manager identificó que el lanzamiento no es correcto) o en 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?