Accéder aux résultats d'exécution d'un workflow

Workflows vous permet d'inspecter le résultat de l'exécution, de vérifier l'état des étapes et de diagnostiquer les erreurs d'exécution. Une fois que vous avez exécuté un workflow, vous pouvez afficher ces résultats dans la Google Cloud console ou à l'aide de Google Cloud CLI.

Console

  1. Dans la Google Cloud console, accédez à la page Workflows.

    Accéder à "Workflows"

  2. Pour accéder aux résultats d'exécution d'un workflow, cliquez sur son nom pour accéder à la page Détails du workflow.

  3. Pour en savoir plus sur une exécution particulière, cliquez sur l'ID d'exécution dans la liste de l'onglet Exécutions pour accéder à la page Détails de l'exécution.

  4. Dans l'onglet Résumé, chaque exécution contient les informations suivantes :

    • ID d'exécution : identifiant unique de l'exécution du workflow.
    • État de l'exécution : indique l'état de fin du workflow, y compris l' étape actuelle ou finale du workflow.
    • Exécution créée : date de lancement de l'exécution.
    • Début de l'exécution : date de début de l'exécution et des étapes.
    • Fin de l'exécution : date de fin de l'exécution.
    • Durée de l'exécution : temps total écoulé. Cela peut indiquer des erreurs réseau ou des problèmes de connectivité.
    • Nom du workflow : nom du workflow.
    • Révision du workflow : révision actuelle au moment de l'exécution.
    • Niveau des journaux d'appels : niveau de journalisation des appels appliqué lors de l' exécution. Pour en savoir plus, consultez la section Journaux d'appels.
    • Entrée : arguments d'exécution transmis au workflow, le cas échéant.
    • Sortie : sortie du workflow. Si l'exécution a échoué, inclut l'exception qui a entraîné l'échec de l'exécution. Dans ce document, consultez la section Mappages des erreurs d'exécution.
  5. Pour afficher l'historique d'exécution du workflow sous forme de liste d'entrées d'étape, cliquez sur l'onglet Étapes. Pour en savoir plus, consultez la section Afficher l'historique des étapes d'exécution.

  6. Pour afficher les journaux d'exécution d'un workflow, cliquez sur l'onglet Journaux.

  7. Pour filtrer les journaux d'exécution, utilisez le champ Filtrer en haut du tableau. Par exemple, pour n'afficher que les tentatives d'exécution ayant échoué, saisissez failed dans le champ de texte du filtre.

gcloud

  1. Pour afficher la liste complète des exécutions d'un workflow, saisissez la commande suivante:

    gcloud workflows executions list WORKFLOW_NAME
    

    Remplacez WORKFLOW_NAME par le nom de votre workflow. Copiez l'ID de l'exécution qui vous intéresse.

  2. Pour afficher les journaux d'exécution d'un workflow, saisissez la commande suivante:

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

    Remplacez les éléments suivants :

    • WORKFLOW_NAME: nom du workflow
    • EXECUTION_ID: ID unique de l'exécution

    La commande renvoie un résultat semblable à celui-ci :

    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
    Le résultat contient les informations suivantes :

    • argument: arguments d'exécution transmis au workflow, le cas échéant
    • endTime: date de fin de l'exécution
    • error: message d'erreur généré avec l'exception qui a entraîné l'échec de l'exécution.
    • name: nom complet de l'exécution, y compris le nom du projet, l'emplacement du workflow, le nom du workflow et l'ID d'exécution
    • startTime: début de l'exécution
    • state : indique l'état de fin du workflow.
    • status : étape actuelle ou finale du workflow de l'exécution
    • workflowRevisionID : révision actuelle au moment de l'exécution

Mappages des erreurs d'exécution

Lorsqu'un workflow génère une erreur pendant l'exécution qui n'est pas interceptée dans un try/except bloc, l' exécution échoue et un mappage d'erreur (dictionnaire JSON) décrivant l'erreur est renvoyé.

Vous pouvez également générer des erreurs personnalisées à l'aide de la syntaxe raise.

Étape suivante