Usar registros da plataforma

Esta página descreve como visualizar os registros da plataforma gerados pelo App Lifecycle Manager. Os registros da plataforma são registros específicos do serviço, que você pode usar para depurar e resolver problemas e entender melhor os serviços que você está usando. Google Cloud Google Cloud

Para mais detalhes sobre os registros da plataforma do App Lifecycle Manager com suporte, consulte Google Cloud Registros da plataforma. Para mais informações sobre como entender os dados nas tabelas de registro da plataforma, consulte Estrutura de entrada de registro.

Antes de começar

  1. No Google Cloud console do, na página do seletor de projetos, escolha ou crie um Google Cloud projeto do.
  2. Verifique se o faturamento foi ativado para o Google Cloud projeto.
  3. Ative a API App Lifecycle Manager.
  4. Para receber as permissões necessárias para visualizar registros e criar alertas, peça para o administrador conceder a você os seguintes papéis do Identity and Access Management (IAM) no projeto:
    • Visualizador de registros (roles/logging.viewer)
    • Editor do Monitoring (roles/monitoring.editor)

Criar alertas baseados em registros

Para criar um alerta baseado em registros, crie uma consulta na Análise de registros que retorne as entradas de registro para as quais você quer receber alertas e configure a política de alertas.

  1. No Google Cloud console do, acesse a página Análise de registros.

    Acessar a Análise de registros

  2. No editor de consultas, insira uma consulta para filtrar as entradas de registro escolhidas. Consulte as seções a seguir para ver exemplos de consultas.

  3. Clique em Criar alerta.

  4. Insira um nome e uma descrição para a política de alertas.

  5. Configure os detalhes do alerta, incluindo canais de notificação.

  6. Clique em Salvar alerta.

Para instruções detalhadas, consulte Criar um alerta baseado em registros.

Exemplo de consultas para registros da plataforma

Esta seção fornece exemplos de consultas para cenários de alerta comuns com base nos registros da plataforma do App Lifecycle Manager.

Alertas de operações de SaaS

Para criar um alerta quando uma operação de provisionamento de unidade falha, use a consulta:

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

Para criar um alerta quando uma operação de provisionamento de unidade atinge um estado terminal (concluído, com falha ou cancelado), use a 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 lançamento

Para criar um alerta de registro quando um lançamento entra em um estado PAUSED (porque o App Lifecycle Manager identificou o lançamento como não íntegro) ou um estado FAILED, use a consulta:

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

Para criar um alerta de métrica para métricas de estado de lançamento quando um lançamento entra em um estado PAUSED (porque o App Lifecycle Manager identificou o lançamento como não íntegro) ou um estado FAILED, use a consulta:

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

A seguir