Seguimientos de UIP

uip traces los intervalos de observabilidad de LLM para trabajos de UiPath: los seguimientos de estilo OpenTelemetry emitidos por agentes codificados y otros flujos de trabajo respaldados por IA. Úsalo para obtener un seguimiento completo de un trabajo de Orchestrator para que puedas inspeccionar solicitudes, llamadas de herramientas y tiempos de respuesta desde el shell o un proceso de CI.

Consulta Herramientas (complementos) para ver cómo se integra esta herramienta con la CLI.

Sinopsis

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

Todos los subcomandos respetan las opciones globales y los códigos de salida.

seguimientos de uip abarcan obtener

Devolver todos los intervalos para un seguimiento. Puedes abordar el seguimiento directamente por su ID, o indirectamente por la clave de trabajo de Orchestrator: la herramienta resuelve el ID de seguimiento del trabajo por ti.

Argumentos

• (opcional) : ID de seguimiento en formato hexadecimal [trace-id] 32 caracteres o GUID.

Opciones

• --job-key <guid> — Clave de trabajo de Orchestrator. Alternativa a <trace-id>; la herramienta obtiene los metadatos del trabajo y extrae su ID de seguimiento.
• -t, --tenant <name> : tenant. El valor predeterminado es el tenant seleccionado por uip login.
• --folder-path <path> — Ruta de la carpeta de Orchestrator (utilizada al resolver el trabajo).
• --folder-key <guid> : clave de carpeta de Orchestrator (utilizada al resolver el trabajo).

Se debe proporcionar exactamente uno de <trace-id> o --job-key . Omitir ambos falla con Failure: "Missing required argument".

Ejemplos

# 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"
    }
  ]
}

La matriz Data contiene un objeto por intervalo, en el orden en que el backend los devuelve. Los campos de intervalo exactos (atributos, eventos, enlaces principal/secundario) dependen de lo que capturó el runtime emisor: la CLI no los normaliza.

Comportamiento de error

• Ni <trace-id> ni --job-key han proporcionado: Failure con Instructions: "Provide either a trace-id argument or --job-key option", salida 1.
• --job-key apunta a un trabajo desconocido o sin seguimiento: Failure: "Error retrieving trace ID for job" con el mensaje de error de backend en Instructions.
• Existe seguimiento, pero no se pueden recuperar los intervalos: Failure: "Error retrieving spans for trace".

Relacionado

• Herramientas (complementos) : instala, actualiza y desinstala el paquete traces-tool .
• uip login : sesión utilizada tanto para la búsqueda de trabajos como para la obtención de intervalo.
• uip insights : métricas de ejecución de trabajos; ortogonal a los datos de seguimiento.