Traçage et observabilité

Le séparateur @traced rend les étapes d'exécution individuelles visibles dans les traçages de tâche et les tableaux de bord Maestro. Utilisez-le pour annoter les fonctions d’aide qui effectuent un travail significatif afin de pouvoir voir où le temps est passé et où une exécution a échoué.

from uipath.tracing import traced


@traced(name="fetch_document", run_type="uipath")
def fetch_document(document_id: str) -> bytes:
    # implementation
    ...


def main(input: Input) -> Output:  # do not trace the entry point
    content = fetch_document(input.document_id)
    return Output(result_id="123")

Important :

N’appliquez pas @traced à la fonction de point d’entrée. Le runtime encapsule déjà la tâche entière dans sa propre étendue; le traçage du point d'entrée produit une plage en double imbriquée.

Ce qui est capturé

Chaque étape traçage enregistre son nom, son type d'exécution, ses heures de début et de fin, ainsi que son statut. Les traçages sont liés à la tâche Orchestrator afin que vous puissiez naviguer d'une instance de processus Maestro à l'étape de fonction individuelle qui a été exécutée.

Orientation

• Tracez les étapes qui représentent des unités de travail distinctes: un appel externe, une extraction, une transformation.
• Utilisez un name clair et stable par étape afin que les traçages soient faciles à lire entre les exécutions.
• Conservez run_type="uipath" pour les étapes de la plate-forme.

Prochaines étapes

• Appeler des fonctions — voir les traces d'un processus Maestro.