Traces da UIP

uip traces intervalos de observabilidade do LLM para trabalhos da UiPath — os traces no estilo OpenTelemetry emitidos por agentes codificados e outros fluxos de trabalho baseados em IA. Use-o para extrair um rastreamento completo para um trabalho do Orchestrator, para que você possa inspecionar solicitações, chamadas de ferramenta e tempos de resposta a partir do shell ou de um pipeline de CI.

Consulte Ferramentas ( plugins ) para saber como essa ferramenta integra-se à CLI.

Resumo

uip traces spans get [<trace-id>] [--job-key <guid>]
                     [-t <tenant>]
                     [--folder-path <path>] [--folder-key <guid>]

Todos os subcomando honram as opções globais e os códigos de saída.

uip traces spans obter

Retorne todos os intervalos de um trace. Você pode endereçar o trace diretamente por seu ID ou indiretamente pela chave do trabalho do Orchestrator — a ferramenta resolve o ID de trace do trabalho para você.

Argumentos

• (opcional) — ID do trace no formato hexadecimal [trace-id] 32 caracteres ou GUID.

Opções

• --job-key <guid> — chave do trabalho do Orchestrator. Alternativa para <trace-id>; a ferramenta busca os metadados do trabalho e extrai seu ID de trace.
• -t, --tenant <name> Tenant. O padrão é o tenant selecionado por uip login.
• --folder-path <path> — Caminho da pasta do Orchestrator (usado ao resolver o trabalho).
• --folder-key <guid> — Chave de pasta do Orchestrator (usada ao resolver o trabalho).

Exatamente um dos <trace-id> ou --job-key deve ser fornecido. A omissão de ambos falha com Failure: "Missing required argument".

Exemplos

# By trace ID
uip traces spans get 4bf92f3577b34da6a3ce929d0e0e4736

# By job key — the tool resolves the trace ID first
uip traces spans get --job-key a1b2c3d4-0000-0000-0000-000000000001

# By job key within a specific folder
uip traces spans get --job-key a1b2c3d4-0000-0000-0000-000000000001 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

Data shape (--output json)

{
  "Code": "TraceSpans",
  "Data": [
    {
      "spanId": "00f067aa0ba902b7",
      "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
      "name": "llm.completion",
      "startTime": "2025-04-15T10:30:00.123Z",
      "endTime": "2025-04-15T10:30:01.456Z"
    }
  ]
}

A matriz Data contém um objeto por intervalo, na ordem que o backend os retorna. Os campos de intervalo exatos (atributos, eventos, links pai/filho) dependem do que o runtime de emissão capturou — a CLI não os normaliza.

Comportamento de erro

• Nem <trace-id> nem --job-key forneceram: Failure com Instructions: "Provide either a trace-id argument or --job-key option", saída 1.
• --job-key aponta para um trabalho desconhecido ou sem rastreamento: Failure: "Error retrieving trace ID for job" com a mensagem de erro de back-end em Instructions.
• O rastreamento existe, mas não é possível buscar os intervalos: Failure: "Error retrieving spans for trace".

Relacionado

• Ferramentas ( plugins ) — instalam, atualizam e desinstalam o pacote traces-tool .
• uip login — sessão usada para a pesquisa de trabalhos e a busca de intervalo.
• uip insights — métricas de execução do trabalho; ortogonal aos dados de rastreamento.