Consulte os conectores compatíveis com a integração de aplicativos.

Abra os registros de execução

A Application Integration gera mensagens de registro de execução para cada execução de uma integração. As mensagens de registro contêm informações que podem ser úteis para determinar o status de cada etapa de uma integração ou para solucionar problemas em uma integração, tarefa ou evento com falha. Para mais informações sobre a geração de registros na Application Integration, consulte Introdução aos registros.

Conferir os registros de execução da integração

Para ver a página Registros de execução, selecione uma das opções:

Console

  1. Na Integração de aplicativos, acesse a página Registros.

    Acessar os registros do Application Integration

  2. No menu de navegação, clique em Registros. Como alternativa, no menu de navegação, clique em Integration e selecione a integração da qual você quer ver os registros. Em seguida, clique em imagem mostrando o ícone de registros de execuçãoExibir registros de execução para esta integração. A página Registros de execução é exibida.
  3. Na lista Região, selecione a região para ver os registros de execução específicos da região. Também é possível clicar em Atualizar registros para atualizar a lista de registros atual.

    A imagem a seguir mostra um exemplo de página de registros de execução do Application Integration.

    imagem mostrando a página de registros de execução do Application Integration imagem mostrando a página de registros de execução do Application Integration

    Os atributos a seguir são exibidos para cada mensagem do registro de execução.

    • Nome da integração: nome da integração.
    • ID da execução: um identificador exclusivo gerado para cada execução de uma integração.
    • Status: o status da execução da integração.
      • Em andamento:indica que a integração está sendo executada.
      • Concluída: indica que a integração foi executada.
      • Com falha: indica que a integração não foi executada.
      • Cancelada: indica que a execução da integração foi cancelada pelo usuário.
      • Em espera: indica que a execução da integração está pausada temporariamente e está aguardando a conclusão de um evento ou uma ação.
      • Nova tentativa em espera: indica que a execução da integração falhou e está aguardando uma nova tentativa.
      • Suspensa: indica que a integração está temporariamente pausada e requer intervenção manual para retomá-la.
    • Horário de início: a data/hora de quando a integração começou.
    • Duração: tempo gasto para executar a integração.
    • Versão da integração: a versão da integração executada.
    • ID do gatilho: valor do ID do gatilho.
    • Cloud Logging: indica se a integração está configurada para gerar registros no Cloud Logging. 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.
    • Reproduzida de: se a execução de integração for reproduzida, esse campo vai mostrar o ID da execução que foi reproduzida. É possível reproduzir novamente uma execução de integração publicada quando quiser executar novamente uma integração com os mesmos parâmetros da execução anterior. Por exemplo, você pode repetir uma execução se uma integração falhar devido a um erro de tempo limite ou se a saída de uma integração não for como o esperado. Para saber como repetir execuções, consulte Repetir execuções.

  4. No campo Filtro, adicione filtros. É possível filtrar os registros com base em critérios como nome da integração, ID da execução, período ou intervalo de tempo, status de execução, tipo de variável e nome ou valor da variável. Para uma pesquisa mais personalizada, use o método projects.locations.integrations.executions.list, conforme explicado na guia "API".

    Para adicionar um filtro para as execuções dos casos de teste, use o seguinte formato:

    Integration name:INTEGRATION_NAME:TEST_CASE_NAME

    Substitua:

    • INTEGRATION_NAME: o nome da integração que contém testes funcionais.
    • TEST_CASE_NAME: o nome do caso de teste para o qual você quer listar as execuções de teste.
    • Por exemplo, Integration name:example-integration-name:example-test-case

API

Se o tamanho dos registros de execução for maior do que 300 MB, o Application Integration emitirá o erro Response too large error e os registros não serão carregados na página Registros de execução. Nesse caso, é necessário usar o método projects.locations.integrations.executions.list para receber os registros. Para exibir registros usando o método de API, siga estas etapas:

  1. Para conseguir o ID de execução dos registros de execução, crie uma solicitação GET usando o método projects.locations.integrations.executions.list com o parâmetro snapshotMetadataWithoutParams definido como TRUE:
    curl -v -X -G GET
        -H "Content-Type: application/json"
        -H "Authorization: Bearer $(gcloud auth print-access-token)"
        -d 'snapshotMetadataWithoutParams=true'
        'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
    

    Os IDs de execução são retornados na resposta. Copie o ID de execução dos registros que você quer exibir.

  2. Para conseguir o registro de execução do ID, crie uma solicitação POST usando o método projects.locations.integrations.executions.list com um filtro no ID de execução copiado na etapa anterior:
    curl -v -X -G GET 
        -H "Content-Type: application/json"
        -H "Authorization: Bearer $(gcloud auth print-access-token)"
        -d 'filter=execution_id="EXECUTION_ID"'
        'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
    

    Na resposta, consulte o campo ExecutionDetails para ver os detalhes do registro.

    Como alternativa, no console do Google Cloud, é possível filtrar os registros de execução pelo ID de execução.

  3. Exemplo: filtrar registros

    Se você quiser filtrar a resposta para listar os registros de todas as integrações esperadas para uma integração, use o seguinte formato:

    curl -v -X -G GET 
        -H "Content-Type: application/json"
        -H "Authorization: Bearer $(gcloud auth print-access-token)"
        -d 'filter= workflowName!="INTEGRATION_NAME"'
        'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions'
    

Usar registros para resolver problemas

A seção a seguir explica como resolver falhas usando o registro de execução da integração de aplicativos.

Resolver problemas de integração

As mensagens de registro de execução podem ser úteis para resolver problemas de integração com falha.

Por exemplo, se uma integração não for executada em um período específico, use estas etapas para acessar e filtrar os registros para solucionar a falha:

  1. Pesquise ou selecione a integração para resolver problemas na lista Integrações e clique para abrir o Editor de integração.
  2. Clique em Logs na barra de ferramentas do editor de integração para ver as mensagens de registro.
  3. No campo Filtro de registro de execução, selecione Nome da integração e insira o nome da integração que você quer consultar.
  4. Clique em Enter.
  5. Para exibir as integrações com falha, no campo Filtro de registro de execução, selecione Status de execução para mostrar a lista de status e selecione Com falha.
  6. Para mostrar integrações com falhas em um período específico, no campo Filtro de registro de execução, selecione Data de início após e insira o horário desejado no formato válido. Em seguida, selecione Data de término antes de e digite a hora desejada. Por padrão, vários filtros são combinados usando a condição AND.

Se a integração falhou durante o período filtrado, a página Registros de execução exibe uma lista de mensagens de registro. Cada mensagem de registro corresponde a uma execução com falha específica da integração.

Conferir exceções de stack trace

Para visualizar a lista de exceções, clique em qualquer mensagem de registro. Clique nos links de cada mensagem de exceção para ver o stack trace da pilha da exceção.

imagem mostrando erros de exceção de registros expandidos imagem mostrando erros de exceção de registros expandidos

Falhas no conector de rastreamento

Você pode usar as mensagens do registro de execução para resolver problemas e rastrear execuções de conectores de tarefas com falha. Os dados de registro de uma tarefa de conector com falha são armazenados usando o Cloud Logging e podem ser visualizados no Explorador de registros.

Siga estas etapas para acessar os dados de registro de uma tarefa de conector com falha na integração de aplicativos:

  1. Acesse a página Registros de execução da integração desejada.
  2. Expanda a mensagem de registro da execução com falha e empilhe o rastreamento para a linha que contém a tarefa de conectores com falha.
  3. Na coluna Status, clique em Falha.

    imagem mostrando registros de uma tarefa do conector que falhou imagem mostrando registros de uma tarefa do conector que falhou

  4. A Application Integration executa automaticamente a consulta necessária para a tarefa de conectores com falha e abre a página da Análise de registros para exibir os dados detalhados do registro de execução.

Para recuperar manualmente os dados de registro de uma tarefa de conectores com falha, execute a seguinte consulta na página de consulta do Explorador de registros. Para mais informações sobre como usar o Explorador de registros, consulte Interface do Explorador de registros.

Formato da consulta

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="EXECUTION_ID_EXECUTION_TASK_ID_EXECUTION_ATTEMPT_NUMBER"

Exemplo

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="9db51e4b-7d57-473d-931f-cc27b282dfad_1_2"

Limitação

A seguir