Ver registros no Cloud Logging

No Cloud Logging, é possível conferir os registros de execução da integração com detalhes, como status, desempenho, versão da integração, parâmetros de solicitação e resposta, além das configurações de gatilho e tarefa. Para mais informações sobre registros de execução no Cloud Logging, consulte Registros de execução de integração no Cloud Logging. Para informações sobre limitações e preços, consulte Limitações e Preços.

Por padrão, o Cloud Logging está desativado para integrações. É possível ativar a geração de registros para uma integração editando a versão não publicada dela.

Antes de começar

Para armazenar registros de execução da integração no Cloud Logging, primeiro ative o serviço para sua integração. Para fazer isso, siga estas etapas:

  1. No console do Google Cloud , acesse a página Application Integration.

    Acessar o Application Integration

  2. No menu de navegação, clique em Integrações.

    A página Integrações aparece listando todas as integrações disponíveis no projeto Google Cloud .

  3. Selecione uma integração ou crie uma para ativar o Cloud Logging.

    Isso abre a integração na página do editor de integração.

  4. Selecione a versão DRAFT da sua integração. Não é possível modificar as configurações de uma versão publicada ou não publicada que não esteja no modo de rascunho. Para conferir uma lista de versões de integração, consulte Versões.
  5. Clique em (Resumo da integração) na barra de ferramentas do designer. A página de resumo da integração é exibida.
    1. Em Configurações de registro, clique na chave Ativar o Cloud Logging e, na lista Gravidade, selecione o tipo de gravidade dos registros que você quer armazenar no Cloud Logging:
      • Informações: selecione essa opção para capturar todos os status de execução: SUCCEEDED, FAILED, PROCESSING, PENDING, SUSPENDED, RETRY_ON_HOLD e CANCELLED.
      • Erro: selecione essa opção para capturar os seguintes status de execução: FAILED e CANCELLED.
      • Aviso: selecione essa opção para capturar os seguintes status de execução: FAILED e CANCELLED.

        • Para conferir uma lista de estados de execução de integração, consulte Estados de execução.

    2. Clique em Salvar.

Como visualizar registros

Para ver os registros no Cloud Logging, primeiro ative o serviço e siga estas etapas:

  1. No console do Google Cloud , acesse a página Application Integration.

    Acessar o Application Integration

  2. Para conferir os registros de execução da integração no Cloud Logging, use um dos seguintes métodos:
    • No menu de navegação, clique em Registros e em Ver registros do Cloud.
    • No menu de navegação, clique em Registros e, no campo Cloud Logging, clique em Ver. Se o Cloud Logging estiver ativado, este campo fornecerá um link para visualizar os registros no Cloud Logging. Se o Cloud Logging não estiver ativado, este campo será definido como Desativado.
    • No editor de integração, depois de testar uma integração, clique em Ver registros do Cloud no painel Testar integração.

    A página Análise de registros é exibida. Os registros são mostrados das últimas três horas para a seguinte consulta padrão: 

    resource.type=integrations.googleapis.com/IntegrationVersion

    3. Para entender o formato dos registros do Application Integration, consulte o payload log_entries.

Amostras de consultas

Use as consultas a seguir para ver registros no Cloud Logging:

  • Para conferir todos os registros de execução da integração:

        resource.type="integrations.googleapis.com/IntegrationVersion"

  • É possível conferir os registros de execução de integração para um ID de execução específico:

    • Pesquisa apenas as execuções principais com o ID de execução especificado: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • Pesquisa execuções principais e secundárias iniciadas com o ID de execução especificado: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    "EXECUTION_ID"

  • Para conferir os registros de execução de uma integração específica:

        resource.type="integrations.googleapis.com/IntegrationVersion" 
    "INTEGRATION_NAME"
     Ou 
        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integration="INTEGRATION_NAME"

  • Para conferir as execuções de integração com falha de uma integração específica:

        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integrationExecutionDetails.integrationExecutionState="FAILED"
    jsonPayload.integration="INTEGRATION_NAME"

  • Para ver registros com um nome de parâmetro de solicitação específico. Por exemplo, a consulta a seguir solicita registros para o parâmetro requestUrl:

        resource.type="integrations.googleapis.com/IntegrationVersion"
    "requestUrl"

    • Para mais exemplos de consultas, consulte Exemplos de consultas do Cloud Logging.

Limitações

Os registros de integração no Cloud Logging estão sujeitos às seguintes limitações:

  • O Cloud Logging só aceita entradas de registro de até 256 KiB. Se os registros excederem esse limite, os parâmetros de solicitação e resposta não serão mostrados nos detalhes do registro. Para informações sobre cotas e limites do Cloud Logging, consulte Cotas e limites. Para resolver esse erro, atualize as variáveis de integração para que o valor não exceda o limite. Como alternativa, você também pode ver esses registros na integração de aplicativos.
  • Se a geração de registros local estiver desativada, os registros de execução não serão enviados ao Cloud Logging, mesmo que ele esteja ativado.

Preços

Para informações sobre os preços do Cloud Logging, consulte Preços do Cloud Logging.

A seguir