test-cloud

latest

false

重要 :

このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。新しいコンテンツの翻訳は、およそ 1 ～ 2 週間で公開されます。

Test Cloud 管理ガイド

データエクスポートのデータモデル

データエクスポートは、選択したデータソースに応じて、次の 2 つの形式でデータを送信します。

イベントベース (JSON) — UiPath で何かが発生したとき (ジョブのステートの変更、キューアイテムの処理、監査アクションの記録など) に発生する個別のイベントです。Azure Event Hubs または AWS SQS に配信されます。
OTEL トレース — OpenTelemetry 形式のエージェントおよび Maestro 実行トレースを表す階層スパン。Arize、Databricks、または OTLP (OpenTelemetry Protocol) 互換エンドポイントに配信されます。

イベントベース (JSON) のエクスポート

Orchestrator のイベント

Orchestrator は、ジョブ、キューアイテム、マシン、ロボットログに対してイベントを発行します。各イベントには、共通のエンベロープとエンティティ固有の本文が含まれます。

共通フィールド

Orchestrator のすべてのイベントには、次のフィールドが含まれます。

フィールド	説明
イベントの種類	イベントの種類を識別する文字列 ( `job.created`、 `queueitem.added`など)。
SchemaVersion	スキーマバージョンの識別子。
Timestamp	イベントの UTC タイムスタンプです。
TenantKey	テナント識別子
テナント名	テナントの表示名です。
FolderKey	フォルダー識別子。
フォルダー名	フォルダーの表示名。
FullFolderPath	フルフォルダーパス。

ジョブイベント

放出日: job.created, job.started, job.stopped, job.pending, job.completed, job.faulted, job.stopping, job.terminating

フィールド	入力	説明
キー	GUID	ジョブの一意の識別子です。
作成時刻	Timestamp	ジョブの作成時です。
開始時刻	Timestamp	実行開始時刻です。
終了時刻	Timestamp	実行の終了時刻です。
ステート	文字列	ジョブのステータス: `Pending`、`Running`、`Stopping`、`Terminating`、`Faulted`、`Successful`、`Stopped`、`Suspended`、`Resumed`
プロセス名	文字列	ソースパッケージ名。
表示名	文字列	Orchestrator での表示名です。
ロボット名	文字列	実行ロボットの識別子
ホストマシン名	文字列	実行マシン名。

QueueItem イベント

放出日: queueitem.added, queueItem.deferred, queueItem.reviewStatusChanged, queueItem.retried, queueItem.updated, queueItem.transactionAbandoned, queueItem.transactionCompleted, queueItem.transactionFailed, queueItem.transactionRetried, queueItem.transactionStarted

フィールド	入力	説明
キー	GUID	キューアイテムの識別子です。
QueueDefinitionId	Number	キューの数値 ID
ステータス	文字列	アイテムのステータス: `New`、`InProgress`、`Failed`、`Successful`、`Abandoned`、`Retried`、`Deleted`、`Unknown`
レビューステータス	文字列	レビューの分類: `None`、 `InReview`、 `Verified`、 `Retried`、 `Unknown`です。
優先度	文字列	アイテムの優先度: `High`、 `Normal`、 `Low`、 `Unknown`。
期限日	Datetime	処理期限。
作成時刻	Datetime	作成のタイムスタンプ。
処理の開始時刻	Datetime	処理開始時刻。
処理の終了時刻	Datetime	処理完了時刻です。
延期日	Datetime	利用可能な最も早い処理時間です。
過去の試行 (秒)	Number	前回の試行の継続時間 (秒単位)。
リトライ回数	Number	処理試行回数
進行状況	文字列	業務フローの進行状況。
分析データ	文字列	分析プロパティのキーと値のペア。
出力	文字列	[トランザクションのステータスを設定] アクティビティから出力データ。
固有データ	文字列	[特定のコンテンツ] プロパティまたは [キューアイテムを追加] アクティビティのカスタムデータ。
作成ジョブ ID	Number	ジョブ識別子を作成します。
実行ジョブ ID	Number	ジョブの識別子を実行しています。
ProcessExceptionReason	文字列	失敗の概要。
ProcessExceptionDetails	文字列	失敗の詳細。
ProcessExceptionType	文字列	エラーの種類: `ApplicationException`、 `BusinessException`、 `None`。

各イベントに埋め込まれる Queue オブジェクトには、 Key、 Name、 Description、 MaxNumberOfRetries、 EnforceUniqueReference、 SlaInMinutes、 RiskSlaInMinutesが含まれます。

注:

SpecificData、 SpecificContent、 Output は、 queueItem.deferred イベントと queueItem.reviewStatusChanged イベントに含まれません。

マシンイベント

放出日: machine.created、 machine.updated、 machine.deleted、 machine.assign、 machine.unassign

フィールド	入力	説明
マシン ID	Number	マシンの数値 ID です。
マシンキー	GUID	マシン識別子。
マシン名	文字列	マシンのカスタム名。
AutomationCloudSlots	Number	予約済みのランタイムスロット。
HeadlessSlots	Number	ヘッドレスモードスロット。
NonProductionSlots	Number	非運用環境のスロット。
UnattendedSlots	Number	無人実行スロット。

マシンセッションイベント (machineSession.status) には、次のものがあります。

フィールド	入力	説明
マシンキー	GUID	マシン識別子。
マシン名	文字列	マシンのカスタム名。
ホストマシン名	文字列	ホストシステム名。
サービスユーザー名	文字列	Robot サービスアカウント。
マシンのステータス	文字列	ステータス: `Available`、`Busy`、`Disconnected`、`Unknown`
Timestamp	Datetime	イベントのタイムスタンプ。
IsUnresponsive	Boolean	コネクションが応答していないかどうかを示します。

ロボットログイベント

放出元: robotlog

フィールド	入力	説明
メッセージ	文字列	ログの内容。
レベル	文字列	重大度: `Trace`、 `Info`、 `Warn`、 `Error`、 `Fatal`。
ログの種類	文字列	カテゴリ: `User`、 `Default`、 `Error`、 `Business`、 `ExecutionStep`、 `Info`、 `Security`、 `Technical`。
Timestamp	Datetime	生成のタイムスタンプ。
ジョブ ID	GUID	ジョブキー。
プロセス名	文字列	実行プロセス名。
プロセスバージョン	文字列	プロセスのバージョン。
ロボット名	文字列	ロボットの識別子。
マシン ID	Number	マシンの数値 ID です。
マシンキー	GUID	マシン識別子。
マシン名	文字列	マシン名。
ホストマシン名	文字列	ホストマシン名 (セッションログのみ)。
Windows ID	文字列	代理ユーザーアカウント。
initiatedBy	文字列	実行ソース: `Assistant`、`Studio`、`StudioX`、`Orchestrator`、`CommandLine`、`RobotAPI`
ファイル名	文字列	ファイル名 `.xaml` 実行。
アクティビティ情報	JSON	アクティビティメタデータ: `DisplayName`、`State`、`Activity`、`Arguments`
カスタムフィールド	JSON	[ログフィールドを追加] アクティビティを使用して追加されたカスタムフィールド。
QueueName	文字列	ソースのキュー名 (キュー処理のみ)。
トランザクション ID	GUID	トランザクションキー (キュー処理のみ)
transactionState	文字列	`Started`、 `Ended`、 `Postponed` (キュー処理のみ)
transactionStatus	文字列	`Start`、 `Success`、 `Failed`、 `BusinessException`、 `ApplicationException` (キュー処理のみ)。
トランザクション実行時間	Number	実行時間 (秒) (キュー処理のみ)
totalExecutionTimeInSeconds	Number	合計実行時間 (キュー処理のみ)。
queueItemPriority	文字列	`High`、 `Normal`、 `Low` (キュートランザクション終了ログのみ)
queueItemReviewStatus	文字列	`InReview`、 `Verified`、 `Reported`、 `Retried` (キュートランザクション終了ログのみ)
ProcessingExceptionReason	文字列	例外の理由 (キュートランザクション終了ログのみ)。
プロセスの例外の種類	文字列	`ApplicationException` または `BusinessException` (キュートランザクション終了ログのみ) を選択します。

Maestro のイベント

Maestro は、プロセスの実行、要素の実行、およびインシデントのイベントを発行します。

標準フィールド

すべての Maestro イベントには、次のフィールドが含まれます。

フィールド	説明
組織 ID	イベントを発行する組織の識別子です。
TenantId	イベントを発行するテナントの識別子です。
FolderKey	フォルダーまたはワークスペースの識別子。
プロセスキー	プロセス定義の識別子です。
インスタンス ID	プロセスインスタンスの識別子です。
実行 ID	プロセス実行の識別子です。
スパンの種類	Maestro イベントの種類: `Incident`、`ProcessRun`、`ElementRun`、`InstanceOperation`
ステータス	イベントの現在のライフサイクルステートです。
EventUniqueId	生成されるイベントのグローバルに一意の識別子です。
イベントの時刻 (UTC)	イベントが発生したときのタイムスタンプです。
TraceAttributes	任意のトレースレベルのメタデータ (null 許容)。
スパン属性	追加のスパン固有属性の文字列化された JSON です。

インシデントフィールド

フィールド	説明
要素 ID	インシデントが発生した要素。
要素の実行 ID	インシデントに関連付けられた要素の実行。
IncidentUpdateTimeUtc	インシデントが最後に更新されたときのタイムスタンプ。
コメント	インシデントに関連する任意のコメントです。
エラーコード	インシデントのエラーコードです。
エラーメッセージ	短いエラーメッセージ。
エラーの詳細	詳細なエラー情報。
デバッグモード	インシデント発生時のデバッグモードの状態。

プロセス実行フィールド

フィールド	説明
開始時刻 UTC	プロセスの実行開始時刻 (UTC)。
スパン名	人間が判読できる範囲またはイベントの名前です。
TraceId	相関関係のための分散トレース識別子。
スパン ID	このプロセス実行のスパン識別子です。
親スパン ID	親スパンの識別子 (ルートスパンの場合は null を許容)。
PackageId	パッケージ識別子。
パッケージキー	パッケージキー。通常はバージョンが含まれます。
PackageVersion	パッケージバージョン。
Release Name	人間が判読できるリリース名。
外部 ID	外部相関識別子。
ソース	実行のトリガーソース (例: `Manual`) です。
デバッグモードの種類	デバッグモードの構成。
作成者ユーザーキー	実行を開始したユーザー (null を許容)。
ケースインスタンス ID	ケースインスタンス識別子 (null 許容)。
CaseManagementMetadata	ケース管理メタデータ (null 許容)。

要素の実行フィールド

フィールド	説明
開始時刻 UTC	要素の実行開始時刻 (UTC)。
終了時刻UTC	要素の実行終了時刻 (UTC)。
スパン名	人間が判読できる範囲またはイベントの名前です。
TraceId	相関関係のための分散トレース識別子。
スパン ID	この要素の実行の範囲識別子です。
親スパン ID	親スパン識別子 (null 許容)。
変数	要素の実行時にキャプチャされる構造化変数。
変数 JSON	JSON としてシリアル化された変数。
ElementRun.ElementId	要素の識別子です。
ElementRun.ElementName	要素の表示名です。
ElementRun.ElementType	要素の種類。
ElementRun.ElementExtensionType	拡張子の型 (nullable)。
ElementRun.ElementRunId	要素の実行識別子。
ElementRun.IncomingFlowId	受信フロー識別子。
ElementRun.IncomingFlowIds	入力フロー識別子配列 (null 許容)。
ElementRun.CaseStageElementId	ケースステージの要素識別子 (null を許容)。
ElementRun.CaseManagementMetadata	要素レベルのケースメタデータ (null 値許容)。

例: 要素の実行イベント

{
  "ElementRun": {
    "ProcessRun": {
      "ProcessInstance": {
        "OrganizationId": "85d09b09-268b-4748-abfd-738402122e7d",
        "TenantId": "1777e378-59ea-4c6a-a6bf-c2e88fb6d2a1",
        "FolderKey": "cb0b27ed-0211-4a77-81a7-00530f85c67a",
        "PackageId": "Trace.Test.agentic.Agentic.Process",
        "PackageKey": "Trace.Test.agentic.Agentic.Process:1.0.0",
        "PackageVersion": "1.0.0",
        "ReleaseName": "Agentic Process",
        "ProcessKey": "ee34bc76-4989-487d-8cdc-0bc6ea87fae4",
        "InstanceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
        "CaseInstanceId": null,
        "ExternalId": "44777039",
        "Source": "Manual",
        "DebugModeType": "None",
        "CreatorUserKey": null
      },
      "RunId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
      "CaseManagementMetadata": null
    },
    "ElementId": "__Action=Pending__",
    "ElementName": "",
    "ElementType": "__InstanceAction__",
    "ElementExtensionType": null,
    "ElementRunId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
    "IncomingFlowId": "",
    "IncomingFlowIds": null,
    "CaseStageElementId": null,
    "CaseManagementMetadata": null
  },
  "StartTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "EndTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "Status": "Pending",
  "Variables": {},
  "VariablesJson": "{}",
  "SpanName": "Instance Created",
  "TraceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
  "SpanId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
  "ParentSpanId": null,
  "SpanType": "InstanceOperation",
  "EventUniqueId": "d0195ac7-3770-44f8-8d88-a74b53b6218a",
  "EventTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "TraceAttributes": null,
  "SpanAttributes": "{\"spanType\":\"InstanceOperation\",\"operationType\":\"InstanceCreated\",\"comment\":\"\",\"userId\":\"00000000-0000-0000-0000-000000000000\"}"
}
{
  "ElementRun": {
    "ProcessRun": {
      "ProcessInstance": {
        "OrganizationId": "85d09b09-268b-4748-abfd-738402122e7d",
        "TenantId": "1777e378-59ea-4c6a-a6bf-c2e88fb6d2a1",
        "FolderKey": "cb0b27ed-0211-4a77-81a7-00530f85c67a",
        "PackageId": "Trace.Test.agentic.Agentic.Process",
        "PackageKey": "Trace.Test.agentic.Agentic.Process:1.0.0",
        "PackageVersion": "1.0.0",
        "ReleaseName": "Agentic Process",
        "ProcessKey": "ee34bc76-4989-487d-8cdc-0bc6ea87fae4",
        "InstanceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
        "CaseInstanceId": null,
        "ExternalId": "44777039",
        "Source": "Manual",
        "DebugModeType": "None",
        "CreatorUserKey": null
      },
      "RunId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
      "CaseManagementMetadata": null
    },
    "ElementId": "__Action=Pending__",
    "ElementName": "",
    "ElementType": "__InstanceAction__",
    "ElementExtensionType": null,
    "ElementRunId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
    "IncomingFlowId": "",
    "IncomingFlowIds": null,
    "CaseStageElementId": null,
    "CaseManagementMetadata": null
  },
  "StartTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "EndTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "Status": "Pending",
  "Variables": {},
  "VariablesJson": "{}",
  "SpanName": "Instance Created",
  "TraceId": "aafa3baa-dd48-46b9-bfea-2cf1acd999c3",
  "SpanId": "4e410977-6373-4c02-ba81-1699ac94bdc6",
  "ParentSpanId": null,
  "SpanType": "InstanceOperation",
  "EventUniqueId": "d0195ac7-3770-44f8-8d88-a74b53b6218a",
  "EventTimeUtc": "2026-01-06T21:15:42.7806522Z",
  "TraceAttributes": null,
  "SpanAttributes": "{\"spanType\":\"InstanceOperation\",\"operationType\":\"InstanceCreated\",\"comment\":\"\",\"userId\":\"00000000-0000-0000-0000-000000000000\"}"
}

監査ログイベント

監査ログのエクスポートでは、テナントレベルと組織レベルの両方の監査イベントがサポートされます。

テナントレベルのソース:

ID とアクセス: Identity、OMS、KMS、ライセンス、AuthZ、ルーティング

製品とサービス: Integration Service、Data Service、Test Manager、Automation Ops、Apps、Document Understanding

組織レベルのソース: 組織範囲のポリシーとユーザー管理イベント。

標準フィールド

フィールド	説明
ID	監査イベントのグローバルに一意の識別子です。
ローカル ID	順序付け用の内部シーケンシャル識別子。
作成日	イベントが作成されたタイムスタンプです。
最終更新日	前回の変更のタイムスタンプ (null 許容)。
バージョン	監査イベントレコードのバージョンです。
ステート	イベントの内部ライフサイクルステートです。
ステータス	イベントの結果 (数値列挙型)。
イベントの種類	実行されたアクションの識別子です。
イベントのソース	イベントを発生させる製品またはシステムの識別子です。
イベントのターゲット	イベントカテゴリの識別子です。
イベントの詳細	イベント固有の詳細情報を含む埋め込み JSON (以下を参照)。
ServiceName	人間が判読できる出力サービスの名前。
クライアント情報	`IpAddress`と`IpCountry`を含む埋め込み JSON。
アクター ID	アクターの一意の識別子。
アクター名	アクターの表示名です。
俳優のメールアドレス	アクターのメールアドレス (null を許容) です。
ActorDetails	アクターを説明するメタデータを含む埋め込み JSON。
組織 ID	組織識別子
組織名	組織名。
TenantId	テナント識別子 (組織レベルのイベントの場合は null 許容)。
テナント名	テナント名 (組織レベルのイベントの場合は null 値許容)。
作成元	イベントのインフラストラクチャまたは地域の発生元。

EventDetails フィールド (サービス別)

EventDetails フィールドは JSON 文字列であり、その構造は出力サービスによって異なります。

ID/認証イベント:

フィールド	説明
User.Id	ユーザーの識別子。
User.DisplayName	ユーザーの表示名です。
User.Email	ユーザーのメールアドレスです。
User.Type	ユーザーの種類 (enum)。
ログインメソッド	認証方法。
クライアント ID	OAuth クライアント識別子。
スコープ	付与または要求されたスコープ。

Appsのイベント:

フィールド	説明
アプリ ID	一意のアプリ識別子。
appName	アプリケーション名。
アプリの種類	アプリケーションの種類。
version	アプリケーションのバージョン。
説明	アプリの説明。
フォルダー名	アプリを含むフォルダーです。
isActionApp	アプリがアクションアプリかどうか。
isPublicApp	アプリがパブリックに表示されているかどうか。

Integration Service のイベント:

フィールド	説明
ConnectionId	連携コネクション識別子
コネクション名です。	接続の名前です。
コネクタ	コネクタの表示名。
コネクタキー	一意のコネクタキー。

管理/ポリシーイベント:

フィールド	説明
ポリシー ID	ポリシー識別子。
ポリシー名	ポリシー名。
ポリシーの作成	ポリシー作成のメタデータ。
ポリシーの削除	ポリシー削除のメタデータ。
変更されたフィールド	更新中にフィールドが変更された。

License Resource Manager のイベント:

フィールド	説明
製品名	ライセンスされた製品名。
以前の数量	以前のライセンス数
新規の数量	ライセンス数を更新しました。
TenantId	影響を受けるテナント。
テナント名	影響を受けるテナント名。
管理者名	変更を実行した管理者です。

Data Service (DataFabric) イベント:

フィールド	説明
EntityId	DataFabric エンティティの識別子です。
エンティティ名	エンティティの名前です。
レコード ID	影響を受けるレコードの識別子。
変更されたプロパティ	操作によって変更されたプロパティ。
Timestamp	DataFabric 固有のイベントタイムスタンプ。

例: 監査ログイベント

{
  "LocalId": 158693,
  "State": 0,
  "LastModified": null,
  "Version": 1,
  "Id": "6cfeca16-2f9f-4ca1-8d06-be64003df865",
  "CreatedOn": "2026-01-10T16:15:46.5597482",
  "OrganizationId": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
  "OrganizationName": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
  "TenantId": null,
  "TenantName": null,
  "ActorId": "810e5c03-8284-47d4-a0b8-da238ee636e6",
  "ActorName": "System Administrator",
  "ActorEmail": null,
  "ActorDetails": "{\"Type\":1}",
  "EventType": "4ffc49e7-15b1-4c31-ba2d-a6dcdce716e7",
  "EventSource": "80c7a790-c3a8-4077-b4a4-fe6f9f947855",
  "EventTarget": "738aa382-1e14-48c8-a296-2868a1e5a22a",
  "EventDetails": "{\"User\":{\"Id\":\"1f8292e0-c86c-4bb3-b3bc-f9cebe546bbd\",\"DisplayName\":\"Test User\",\"Email\":\"[email protected]\",\"Type\":0}}",
  "ServiceName": "Identity",
  "Status": 0,
  "ClientInfo": null,
  "Origin": "alp-wus2-01-platform"
}
{
  "LocalId": 158693,
  "State": 0,
  "LastModified": null,
  "Version": 1,
  "Id": "6cfeca16-2f9f-4ca1-8d06-be64003df865",
  "CreatedOn": "2026-01-10T16:15:46.5597482",
  "OrganizationId": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
  "OrganizationName": "2511e08f-6fa5-40af-b4bb-ef3f077cb7a1",
  "TenantId": null,
  "TenantName": null,
  "ActorId": "810e5c03-8284-47d4-a0b8-da238ee636e6",
  "ActorName": "System Administrator",
  "ActorEmail": null,
  "ActorDetails": "{\"Type\":1}",
  "EventType": "4ffc49e7-15b1-4c31-ba2d-a6dcdce716e7",
  "EventSource": "80c7a790-c3a8-4077-b4a4-fe6f9f947855",
  "EventTarget": "738aa382-1e14-48c8-a296-2868a1e5a22a",
  "EventDetails": "{\"User\":{\"Id\":\"1f8292e0-c86c-4bb3-b3bc-f9cebe546bbd\",\"DisplayName\":\"Test User\",\"Email\":\"[email protected]\",\"Type\":0}}",
  "ServiceName": "Identity",
  "Status": 0,
  "ClientInfo": null,
  "Origin": "alp-wus2-01-platform"
}

OTEL トレースのエクスポート

エージェントおよび Maestro のトレースは、OpenTelemetry (OTEL) 形式でエクスポートされます。各実行によってスパンのツリーが生成されます。つまり、エージェントまたは Maestro の実行ごとに 1 つのルートスパンと、LLM 呼び出し、ツール呼び出し、ガードレールの評価ごとに子スパンが生成されます。

OTEL スパンフィールド

OTELフィールド	説明
TraceId	トレースの識別子です。1 つの実行に属するすべてのスパンをグループ化します。
spanId	この範囲の一意の識別子です。
parentSpanId	親スパン識別子。ルートスパンの場合は空の文字列です。
name	人間が判読できる範囲の名前です (例: `Agent run - googlesearch`、 `LLM call`)。
kind	スパンの種類: `SPAN_KIND_INTERNAL` または `SPAN_KIND_CLIENT`
startTimeUnixNano	スパン開始時間 (Unix ナノ秒単位)。
endTimeUnixNano	スパン終了時間 (Unix ナノ秒単位)。
status.code	実行ステータス: `STATUS_CODE_OK` または `STATUS_CODE_ERROR`
status.message	ステータスメッセージ (エラーがない場合は空の文字列)。
属性。	ドット表記を使用して平坦化されたスパン属性 (以下を参照)。

UiPath の属性マッピング

UiPath の内部トレースフィールドは、次のように OTEL 属性にマッピングされます。

UiPath のフィールド	OTEL 属性	備考
ID	span_id	一意のスパン識別子。
TraceId	trace_id	トレースの識別子です。
親 ID	parent_span_id	ルートスパンの場合は null です。
名前	name	スパン名。
開始時刻	start_time_unix_nano	Unixナノ秒に変換されました。
終了時刻	end_time_unix_nano	Unixナノ秒に変換されました。
ステータス	status.code	`1` = OK、 `2` = エラー。
属性	属性	ドット表記を使用してキーと値のペアに解析された JSON 文字列。
SpanType、OrganizationId、TenantId、FolderKey、JobKey、ProcessKey、Source、VerbosityLevel	attributes.uipath.*	UiPath のすべてのメタデータフィールド

span 属性タイプ

UiPath の内部スキーマの Attributes フィールドには JSON 文字列が含まれており、この文字列はドット表記を使用して解析され、OTEL スパン属性にフラット化されます。構造はスパンタイプによって異なります。

agentRun 属性 (attributes.type = "agentRun"):

属性	説明
type、agentId、agentName、agentVersion	エージェント ID のフィールド。
systemPrompt、userPrompt	エージェントのプロンプト。
inputSchema、outputSchema	入力スキーマと出力スキーマ。
入力、出力、ソース	実行の入力、出力、トリガーのソース。
エラー	エラーの詳細 (存在する場合)。

補完属性 (attributes.type = "completion"):

属性	説明
タイプ, モデル	範囲の種類と LLM モデルの識別子
settings.maxTokens、settings.temperature	LLM の設定
ツールの呼び出し	補完時に実行されたツール呼び出しの配列。
usage.completionTokens、usage.promptTokens、usage.totalTokens	トークンの使用状況。
usage.isByoExecution、usage.executionDeploymentType、usage.isPiiマスク	実行メタデータ。
エラー	エラーの詳細 (存在する場合)。

toolCall 属性 (attributes.type = "toolCall"):

属性	説明
type、callId、toolName	ツールの呼び出しの ID。
引数、toolType	引数とツールの種類を呼び出します。
結果	ツール呼び出しの結果。
エラー	エラーの詳細 (存在する場合)。

toolGuardrailEvaluation 属性 (attributes.type = "toolGuardrailEvaluation"):

属性	説明
type, guardrailName, guardrail説明	ガードレールの ID。
guardrailAction、詳細、アクション	ガードレールのアクションと結果。
引数、結果	評価の入力と結果
重要度レベル	重大度の分類。
エラー	エラーの詳細 (存在する場合)。

エクスポートの制限

上限量	値 (Value)
個々の属性の最大値	32 KB
スパンあたりの最大合計属性数	256KB
最大OTLPバッチサイズ	~1 MB (プロトブフ)
ファイルの添付	メタデータのみ (ID、ファイル名、MIME タイプ)。ファイルの内容はエクスポートされません。

例: OTEL トレース (1 回のエージェント実行で 4 つのスパン)

[
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "a4bd5687817248fc",
    "parentSpanId": "",
    "name": "Agent run - googlesearch",
    "kind": "SPAN_KIND_INTERNAL",
    "startTimeUnixNano": "1728000235632009500",
    "endTimeUnixNano": "1728000248153231700",
    "attributes.type": "agentRun",
    "attributes.agentId": "80a61442-d3e1-4d10-966e-47e0bccc707d",
    "attributes.agentName": "googlesearch",
    "attributes.agentVersion": "1.0.0",
    "attributes.input.search_query": "google",
    "attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
    "attributes.source": "playground",
    "attributes.uipath.organization_id": "9568beba-50a8-49d1-801e-f2d1711089fd",
    "attributes.uipath.tenant_id": "86011afe-5252-4e44-8805-b3430072d040",
    "attributes.uipath.span_type": "agentRun",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "4c10aa5169c44a17",
    "parentSpanId": "a4bd5687817248fc",
    "name": "LLM call",
    "kind": "SPAN_KIND_CLIENT",
    "startTimeUnixNano": "1728000238084433000",
    "endTimeUnixNano": "1728000245772907200",
    "attributes.type": "completion",
    "attributes.model": "gpt-4o-2024-11-20",
    "attributes.settings.maxTokens": 16384,
    "attributes.settings.temperature": 0,
    "attributes.usage.completionTokens": 491,
    "attributes.usage.promptTokens": 1110,
    "attributes.usage.totalTokens": 1601,
    "attributes.uipath.span_type": "completion",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "0fde078a923d484e",
    "parentSpanId": "4c10aa5169c44a17",
    "name": "LLM",
    "kind": "SPAN_KIND_CLIENT",
    "startTimeUnixNano": "1728000238979846800",
    "endTimeUnixNano": "1728000245095082400",
    "attributes.type": "completion",
    "attributes.model": "gpt-4o-2024-11-20",
    "attributes.uipath.span_type": "completion",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "7fc828f5295d4788",
    "parentSpanId": "a4bd5687817248fc",
    "name": "Agent output",
    "kind": "SPAN_KIND_INTERNAL",
    "startTimeUnixNano": "1728000246820034400",
    "endTimeUnixNano": "1728000246820034400",
    "attributes.type": "agentOutput",
    "attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
    "attributes.uipath.span_type": "agentOutput",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  }
]
[
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "a4bd5687817248fc",
    "parentSpanId": "",
    "name": "Agent run - googlesearch",
    "kind": "SPAN_KIND_INTERNAL",
    "startTimeUnixNano": "1728000235632009500",
    "endTimeUnixNano": "1728000248153231700",
    "attributes.type": "agentRun",
    "attributes.agentId": "80a61442-d3e1-4d10-966e-47e0bccc707d",
    "attributes.agentName": "googlesearch",
    "attributes.agentVersion": "1.0.0",
    "attributes.input.search_query": "google",
    "attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
    "attributes.source": "playground",
    "attributes.uipath.organization_id": "9568beba-50a8-49d1-801e-f2d1711089fd",
    "attributes.uipath.tenant_id": "86011afe-5252-4e44-8805-b3430072d040",
    "attributes.uipath.span_type": "agentRun",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "4c10aa5169c44a17",
    "parentSpanId": "a4bd5687817248fc",
    "name": "LLM call",
    "kind": "SPAN_KIND_CLIENT",
    "startTimeUnixNano": "1728000238084433000",
    "endTimeUnixNano": "1728000245772907200",
    "attributes.type": "completion",
    "attributes.model": "gpt-4o-2024-11-20",
    "attributes.settings.maxTokens": 16384,
    "attributes.settings.temperature": 0,
    "attributes.usage.completionTokens": 491,
    "attributes.usage.promptTokens": 1110,
    "attributes.usage.totalTokens": 1601,
    "attributes.uipath.span_type": "completion",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "0fde078a923d484e",
    "parentSpanId": "4c10aa5169c44a17",
    "name": "LLM",
    "kind": "SPAN_KIND_CLIENT",
    "startTimeUnixNano": "1728000238979846800",
    "endTimeUnixNano": "1728000245095082400",
    "attributes.type": "completion",
    "attributes.model": "gpt-4o-2024-11-20",
    "attributes.uipath.span_type": "completion",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  },
  {
    "traceId": "10f78499ce774eaba05699f234e1c75d",
    "spanId": "7fc828f5295d4788",
    "parentSpanId": "a4bd5687817248fc",
    "name": "Agent output",
    "kind": "SPAN_KIND_INTERNAL",
    "startTimeUnixNano": "1728000246820034400",
    "endTimeUnixNano": "1728000246820034400",
    "attributes.type": "agentOutput",
    "attributes.output.summary": "The search results for 'Google' include the official Google homepage.",
    "attributes.uipath.span_type": "agentOutput",
    "status.code": "STATUS_CODE_OK",
    "status.message": ""
  }
]

イベントベース (JSON) のエクスポート
Orchestrator のイベント
Maestro のイベント
監査ログイベント
OTEL トレースのエクスポート
OTEL スパンフィールド
UiPath の属性マッピング
span 属性タイプ
エクスポートの制限

このページは役に立ちましたか?

前へデータのエクスポートについて

次へAzure Event Hubs を構成する

Test Cloud 管理ガイド

イベントベース (JSON) のエクスポート​

Orchestrator のイベント​

共通フィールド​

ジョブイベント​

QueueItem イベント​

マシン イベント​

ロボット ログ イベント​

Maestro のイベント​

標準フィールド​

インシデント フィールド​

プロセス実行フィールド​

要素の実行フィールド​

監査ログ イベント​

標準フィールド​

EventDetails フィールド (サービス別)​

OTEL トレースのエクスポート​

OTEL スパンフィールド​

UiPath の属性マッピング​

span 属性タイプ​

エクスポートの制限​

このページは役に立ちましたか?

イベントベース (JSON) のエクスポート

Orchestrator のイベント

共通フィールド

ジョブイベント

QueueItem イベント

マシンイベント

ロボットログイベント

Maestro のイベント

標準フィールド

インシデントフィールド

プロセス実行フィールド

要素の実行フィールド

監査ログイベント

標準フィールド

EventDetails フィールド (サービス別)

OTEL トレースのエクスポート

OTEL スパンフィールド

UiPath の属性マッピング

span 属性タイプ

エクスポートの制限