UIP トレース

uip traces UiPath のジョブの LLM の監視 範囲 (コード化されたエージェントやその他の AI が支援するワークフローによって出力される OpenTelemetry スタイルのトレース) を取得します。このツールチップを使用して Orchestrator のジョブの完全なトレースをプルし、シェルまたは CI パイプラインからプロンプト、ツール呼び出し、応答時間を検査できるようにします。

このツールがCLIとどのように連携するかについては、「 ツール(プラグイン)」 を参照してください。

概要

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

すべてのサブコマンドは、 グローバルオプション と 終了コードを尊重します。

uip トレース、スパン、GET

トレースのすべてのスパンを返します。トレースのアドレスは、ID で直接指定することも、Orchestrator のジョブ キーで間接的にアドレス指定することもできます。ジョブのトレース ID は自動的にツールによって解決されます。

引数

• [trace-id] (オプション) — 32 文字の 16 進数または GUID 形式のトレース ID。

オプション

• --job-key <guid> — Orchestrator のジョブ キー。<trace-id>の代替。ツールはジョブのメタデータを取得し、そのトレース ID を抽出します。
• -t, --tenant <name> — テナント既定では、uip loginによって選択されたテナントが使用されます。
• --folder-path <path> — Orchestrator フォルダーのパス (ジョブの解決時に使用)。
• --folder-key <guid> — Orchestrator のフォルダー キー (ジョブの解決時に使用)。

<trace-id>または--job-keyのうちの1つだけを指定する必要があります。両方を省略すると、 Failure: "Missing required argument"で失敗します。

例

# 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

データシェイプ (--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"
    }
  ]
}

Data 配列には、バックエンドが返す順序で、スパンごとに 1 つのオブジェクトが含まれます。正確なスパンフィールド(属性、イベント、親/子リンク)は、出力ランタイムがキャプチャした内容によって異なりますが、CLIはそれらを正規化しません。

エラー動作

• <trace-id>も--job-keyも提供されていません:Instructions: "Provide either a trace-id argument or --job-key option"のあるFailure、出口1。
• --job-key 、不明またはトレースのないジョブを指します。 Failure: "Error retrieving trace ID for job" 、 Instructionsにバックエンド エラー メッセージが表示されます。
• トレースは存在するがスパンを取得できない: Failure: "Error retrieving spans for trace"

関連

• ツール (プラグイン) — traces-tool パッケージをインストール、更新、アンインストールします。
• uip login — ジョブの検索とスパン取得の両方に使用されるセッション。
• uip insights — ジョブ実行のメトリックトレース データと直交します。