Usar registros da plataforma

Os registros da plataforma do App Lifecycle Manager no Cloud Logging permitem monitorar eventos operacionais, depurar falhas de provisionamento de unidades e resolver problemas de lançamento. É possível consultar esses registros na Análise de registros e criar alertas com base em registros para operações e lançamentos de SaaS no projeto do Google Cloud .

Para detalhes sobre os registros de plataforma compatíveis com o App Lifecycle Manager, consulte Registros de plataforma doGoogle Cloud . Para mais informações sobre como entender os dados nas tabelas de registros da plataforma, consulte Estrutura de entrada de registro.

Antes de começar

  1. No console do Google Cloud , na página do seletor de projetos, selecione ou crie um projeto do Google Cloud .
  2. Verifique se o faturamento está ativado para o projeto do Google Cloud .
  3. Ative a API App Lifecycle Manager.
  4. Para receber as permissões necessárias para visualizar registros e criar alertas, peça ao administrador para 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 com base em registros, crie uma consulta na Análise de registros que retorne as entradas de registro para as quais você quer receber alertas e, em seguida, configure a política de alertas.

  1. No console do Google Cloud , 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 os canais de notificação.

  6. Clique em Salvar alerta.

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

Exemplos de consultas para registros da plataforma

Nesta seção, apresentamos 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 para quando uma operação de provisionamento de unidade falhar, use a 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 criar um alerta para quando uma operação de provisionamento de unidade atingir um estado terminal (bem-sucedido, com falha ou cancelado), use a 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 lançamento

Para criar um alerta de registro para quando um lançamento entrar em um estado PAUSED (porque o App Lifecycle Manager identificou o lançamento como não íntegro) ou em 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 em 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