Seguimiento y observabilidad

El decorador @traced hace que los pasos de ejecución individuales sean visibles en los seguimientos de trabajos y los paneles de Maestro. Úsalo para anotar las funciones auxiliares que realizan un trabajo significativo, para que puedas ver dónde se gasta el tiempo y dónde falló una ejecución.

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")

Importante:

No apliques @traced a la función de punto de entrada. El runtime ya envuelve todo el trabajo en su propio intervalo; el seguimiento del punto de entrada produce un intervalo anidado duplicado.

Qué se captura

Cada paso rastreado registra su nombre, tipo de ejecución, horas de inicio y finalización y estado. Los seguimientos están vinculados al trabajo de Orchestrator para que puedas navegar desde una instancia de proceso de Maestro hasta el paso de función individual que se ejecutó.

Orientación

• Sigue los pasos que representan distintas unidades de trabajo: una llamada externa, una extracción, una transformación.
• Utiliza un name claro y estable por paso para que los seguimientos sean fáciles de leer en todas las ejecuciones.
• Mantener run_type="uipath" para los pasos de la plataforma.

Próximos pasos

• Invocar funciones : consulta los seguimientos de un proceso de Maestro.