Rastreamento e observabilidade

O designer @traced torna as etapas de execução individuais visíveis em rastreamentos de trabalho e painéis do Maestro. Use-a para anotar as funções auxiliares que fazem um trabalho significativo, para que você possa ver onde o tempo é gasto e onde uma execução falhou.

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:

Não aplique @traced à função de ponto de entrada. O runtime já encapsula o trabalho inteiro em seu próprio intervalo; rastrear o ponto de entrada produz um intervalo aninhado duplicado.

O que é capturado

Cada etapa rastreada registra seu nome, tipo de execução, horários inicial e final e status. Os traces são vinculados ao trabalho do Orchestrator para que você possa navegar de uma instância de processo do Maestro até a etapa da função individual que foi executada.

Orientação

• Trace as etapas que representam unidades de trabalho distintas — uma chamada externa, uma extração, uma transformação.
• Use um name claro e estável por etapa para que os traces sejam fáceis de ler entre as execuções.
• Mantenha run_type="uipath" para etapas de plataforma.

Próximas Etapas

• Invocar funções — veja traces de um processo do Maestro.