Acessar os resultados da execução do fluxo de trabalho

O Workflows permite inspecionar a saída da execução, verificar o status das etapas e diagnosticar erros de ambiente de execução. Depois de executar um fluxo de trabalho, é possível conferir esses resultados no Google Cloud console ou usando a Google Cloud CLI.

Console

  1. No Google Cloud console, acesse a página Fluxos de trabalho.

    Acessar fluxos de trabalho

  2. Para acessar os resultados da execução de um fluxo de trabalho, clique no nome dele para acessar a página Detalhes do fluxo de trabalho.

  3. Para detalhes sobre uma execução específica, na guia Execuções, clique no ID da execução na lista para acessar a página Detalhes da execução.

  4. Na guia Resumo, cada execução tem as seguintes informações:

    • ID da execução: o identificador exclusivo da execução do fluxo de trabalho.
    • Estado da execução: indica o estado final do fluxo de trabalho, incluindo a etapa atual ou final.
    • Execução criada: quando a execução foi iniciada.
    • Início da execução: quando a execução começou a ser executada e as etapas foram executadas.
    • Fim da execução: quando a execução terminou.
    • Duração da execução: tempo total decorrido. Isso pode ser uma indicação de erros de rede ou problemas de conectividade.
    • Nome do fluxo de trabalho: o nome do fluxo de trabalho.
    • Revisão do fluxo de trabalho: a revisão atual no momento da execução.
    • Nível de registro de chamadas: o nível de registro de chamadas aplicado durante a execução. Para mais informações, consulte Registro de chamadas.
    • Entrada: os argumentos de ambiente de execução transmitidos para o fluxo de trabalho, se houver.
    • Saída: a saída do fluxo de trabalho. Se a execução falhou, inclui a exceção que levou à falha. Neste documento, consulte Mapas de erros de execução.
  5. Para conferir o histórico de execução do fluxo de trabalho como uma lista de entradas de etapa, clique na guia Etapas. Para mais informações, consulte Conferir o histórico de etapas de execução.

  6. Para conferir os registros de uma execução de fluxo de trabalho, clique na guia Registros.

  7. Para filtrar os registros de execução, use o campo Filtro na parte de cima da tabela. Por exemplo, para exibir apenas tentativas de execução malsucedidas, insira failed no campo de texto do filtro.

gcloud

  1. Para ver uma lista completa das execuções de um fluxo de trabalho, digite o seguinte comando:

    gcloud workflows executions list WORKFLOW_NAME
    

    Substitua WORKFLOW_NAME pelo nome do fluxo de trabalho. Copie o ID de execução do seu interesse.

  2. Para ver os registros de execução de um fluxo de trabalho, digite o seguinte comando:

    gcloud workflows executions describe \
        --workflow=WORKFLOW_NAME \
        EXECUTION_ID
    

    Substitua:

    • WORKFLOW_NAME: o nome do fluxo de trabalho
    • EXECUTION_ID: o ID exclusivo da execução

    Esse comando retorna um resultado semelhante a este:

    argument: 'null'
    endTime: '2022-07-19T12:40:07.070039707Z'
    error:
     context: |-
        The argument of 'in' must be a dict or an array; got: null
        in step "checkSearchTermInInput", routine "main", line: 12
     payload: "{"message":"The argument of 'in' must be a dict or an array; got: null"
    ,"tags":["TypeError"]}" stackTrace: elements: - position: column: '26' length: '24' line: '12' routine: main step: checkSearchTermInInput name: projects/1051295516635/locations/us-central1/workflows/myFirstWorkflow/executions/17ffc89c-0a27-4d2f-8356-e681d949a3d3 startTime: '2022-07-19T12:40:07.024823663Z' state: FAILED status: currentSteps: - routine: main step: checkSearchTermInInput workflowRevisionId: 000001-ac2
    A saída contém as informações a seguir:

    • argument: os argumentos de ambiente de execução transmitidos para o fluxo de trabalho, se houver
    • endTime: quando a execução foi finalizada
    • error: a mensagem de erro gerada como parte da exceção que resultou na falha da execução
    • name: o nome completo da execução, incluindo o nome do projeto, o local do fluxo de trabalho, o nome do fluxo de trabalho e o ID da execução
    • startTime: quando a execução começou
    • state: indica o estado final do fluxo de trabalho
    • status: a etapa atual ou final do fluxo de trabalho da execução
    • workflowRevisionID: a revisão atual no momento da execução

Mapas de erros de execução

Quando um fluxo de trabalho gera um erro durante a execução que não é detectado em um try/except bloco, a execução falha e um mapa de erros (um dicionário JSON) que descreve o erro é retornado.

Também é possível gerar erros personalizados usando a sintaxe raise.

A seguir