Consulte os conectores compatíveis com a Application Integration.

Ver registros no Cloud Logging

Nesta página, descrevemos como ativar o Cloud Logging para uma integração, consultar registros no Cloud Logging e alguns exemplos de consultas para conferir registros de integração no Cloud Logging.

Visão geral

No Cloud Logging, é possível acessar os registros de execução de integração que contêm detalhes da integração, como status, desempenho, versão da integração, parâmetros de solicitação e resposta e as configurações de gatilho e tarefa. Saiba mais sobre os registros de execução no Cloud Logging em 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 de uma integração editando a versão não publicada dela.

Ativar o Cloud Logging

Para armazenar registros de execução de integração no Cloud Logging, primeiro ative o Cloud Logging 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 do Google Cloud.

  3. Selecione uma integração atual ou crie uma integração em que você quer ativar o Cloud Logging.

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

  4. Selecione a versão DRAFT da integração. Não é possível modificar as configurações de uma versão publicada ou não publicada que não está no modo de rascunho. Para conferir uma lista de versões de integração, consulte Versões.
  5. Clique em (Integration summary) na barra de ferramentas do designer. A página de resumo da integração será exibida.
    1. Em Configurações de registro, clique na opção 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.
      • Error (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 da integração, consulte Estados de execução.

    2. Clique em Salvar.

Mostrar registros

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

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

    Acessar o Application Integration

  2. Para visualizar 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 depois em Visualizar registros do Cloud.
    • No editor Integration, depois de testar uma integração, na caixa de diálogo Testar integração, clique em Ver registros do Cloud.

    A página Análise de registros é exibida. Os registros são exibidos durante as ú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

É possível usar as seguintes consultas para visualizar registros no Cloud Logging:

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

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

  • É possível consultar 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 fornecido: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • Pesquisa execuções pai e filho iniciadas a partir do ID de execução fornecido: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    "EXECUTION_ID"

  • Para visualizar 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 visualizar execuções de integração com falha:

        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, os seguintes registros de solicitações de consulta para o parâmetro requestUrl:

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

    • Para mais exemplos de consultas, acesse Consultas de amostra 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, também é possível ver esses registros na Application Integration.
  • Se a geração de registros local estiver desativada, os registros de execução não serão enviados para o Cloud Logging, mesmo se o Cloud Logging estiver ativado.

Preços

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

A seguir