Usa registros de plataforma

En esta página, se describe cómo ver los registros de la plataforma que genera el tiempo de ejecución de SaaS. Los registros de la plataforma en Google Cloud son registros específicos del servicio que puedes usar para depurar y solucionar problemas, y comprender mejor los servicios de Google Cloudque usas.

Para obtener detalles sobre los registros de plataforma compatibles con SaaS Runtime, consulta Google Cloud registros de plataforma. Para obtener más información sobre cómo comprender los datos en 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 que la facturación esté habilitada para tu proyecto de Google Cloud .
  3. Habilita la API de SaaS Runtime.
  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 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 búsquedas.

  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 notificación.

  6. Haz clic en Guardar alerta.

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

Ejemplo de consultas para registros de la plataforma

En esta sección, se proporcionan ejemplos de consultas para situaciones de alerta comunes basadas en los registros de la plataforma de SaaS Runtime.

Alertas de operaciones de SaaS

Para crear una alerta que se active cuando falle 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 que se active cuando una operación de aprovisionamiento de unidades alcance un estado terminal (completada, fallida o cancelada), 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 si un lanzamiento regional entra en un estado PAUSED o FAILED por un motivo que no sea una acción del usuario, usa la siguiente consulta:

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.RolloutLog"
AND (jsonPayload.current_state="PAUSED" OR jsonPayload.current_state="FAILED")
AND jsonPayload.reason!="USER_PAUSE"
AND jsonPayload.root_rollout_id != resource.labels.rollout_id

Para crear una alerta si un lanzamiento global entra en un estado PAUSED o FAILED, usa la siguiente consulta:

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.RolloutLog"
AND (jsonPayload.current_state="PAUSED" OR jsonPayload.current_state="FAILED")
AND jsonPayload.root_rollout_id == resource.labels.rollout_id

Para crear una alerta de registro que se active cuando un lanzamiento entre en el estado PAUSED (porque el tiempo de ejecución de SaaS identificó que el lanzamiento no es saludable) o en el estado FAILED, usa la siguiente consulta:

logName:"rollout_events" 
(jsonPayload.currentState="PAUSED" jsonPayload.reason="SYSTEM_PAUSE")
OR 
jsonPayload.currentState="FAILED

Para crear una alerta de registro para las métricas de estado del lanzamiento cuando este entra en un estado PAUSED (porque el tiempo de ejecución de SaaS identificó el lanzamiento como no apto) 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?