数据导出数据模型

“数据导出”以两种格式发送数据，具体取决于所选的数据源：

• 基于事件 (JSON) — UiPath 中发生某些情况（作业更改状态、处理队列项目、记录审核操作）时发出的独立事件。已交付到 Azure 事件中心或 AWS SQS。
• OTEL 追踪— 以 OpenTelemetry 格式表示智能体和 Maestro 执行追踪的层次结构跨度。已交付到 Arize、Databricks 或任何与 OTLP (OpenTelemetry 协议) 兼容的端点。

基于事件 (JSON) 导出

Orchestrator 事件

Orchestrator 会发出有关作业、队列项目、计算机和机器人日志的事件。每个事件都包含一个通用信封和一个特定于实体的正文。

常用字段

所有 Orchestrator 事件都包含以下字段：

字段	描述
事件类型	识别事件类型的字符串（例如， job.created 、 queueitem.added ）。
SchemaVersion	架构版本标识符。
时间戳	事件的 UTC 时间戳。
TenantKey	租户标识符。
租户名称	租户显示名称。
FolderKey	文件夹标识符。
文件夹名称	文件夹显示名称。
FullFolderPath	完整文件夹路径。

Job events

发出日期： job.created 、 job.started 、 job.stopped 、 job.pending 、 job.completed 、 job.faulted 、 job.stopping 、 job.terminating

字段	类型	描述
密钥	Guid	唯一作业标识符。
创建时间	时间戳	作业创建时间。
开始时间	时间戳	执行开始时间。
结束时间	时间戳	执行结束时间。
状态	字符串	作业状态： Pending 、 Running 、 Stopping 、 Terminating 、 Faulted 、 Successful 、 Stopped 、 Suspended 、 Resumed 。
流程名称	字符串	源包名称。
显示名称	字符串	在 Orchestrator 中的显示名称
机器人名称	字符串	正在执行的机器人标识符。
主机名	字符串	执行计算机名称。

Queue item events

发出日期： queueitem.added 、 queueItem.deferred 、 queueItem.reviewStatusChanged 、 queueItem.retried 、 queueItem.updated 、 queueItem.transactionAbandoned 、 queueItem.transactionCompleted 、 queueItem.transactionFailed 、 queueItem.transactionRetried 、 queueItem.transactionStarted

字段	类型	描述
密钥	Guid	队列项目标识符。
队列定义 ID	数字	队列数字 ID。
状态	字符串	项目状态： New 、 InProgress 、 Failed 、 Successful 、 Abandoned 、 Retried 、 Deleted 、 Unknown 。
审核状态	字符串	审核分类： None 、 InReview 、 Verified 、 Retried 、 Unknown 。
优先级	字符串	项目优先级： High 、 Normal 、 Low 、 Unknown 。
截止日期	Datetime	处理截止日期。
创建时间	Datetime	创建时间戳。
开始处理	Datetime	处理开始时间。
结束处理	Datetime	处理完成时间。
推迟日期	Datetime	最早可用处理时间。
之前尝试中的秒数	数字	上次尝试的持续时间（以秒为单位）。
重试次数	数字	处理尝试的次数。
进度	字符串	业务流程进度。
分析数据	字符串	分析属性键值对。
输出	字符串	“设置事务状态”活动的输出数据。
特定数据	字符串	来自“特定内容”属性或“添加队列项目”活动的自定义数据。
创建者作业 ID	数字	正在创建作业标识符。
执行者作业 ID	数字	正在执行作业标识符。
ProcessExceptionReason	字符串	失败摘要。
ProcessExceptionDetails	字符串	失败详细信息。
ProcessExceptionType	字符串	错误类型： ApplicationException 、 BusinessException 、 None 。

每个事件中嵌入的Queue对象包括： Key 、 Name 、 Description 、 MaxNumberOfRetries 、 EnforceUniqueReference 、 SlaInMinutes 、 RiskSlaInMinutes 。

备注：

SpecificData和Output事件不包含queueItem.deferred 、 SpecificContent和queueItem.reviewStatusChanged 。

Machine events

发出日期： machine.created 、 machine.updated 、 machine.deleted 、 machine.assign 、 machine.unassign

字段	类型	描述
计算机 ID	数字	计算机数字 ID。
计算机键值	Guid	计算机标识符。
计算机名称	字符串	计算机自定义名称。
AutomationCloudSlots	数字	保留的 runtime 插槽。
HeadlessSlots	数字	无头模式插槽。
NonProductionSlots	数字	Non-Production 环境插槽。
UnattendedSlots	数字	无人值守执行插槽。

计算机会话事件 ( machineSession.status ) 包括：

字段	类型	描述
计算机键值	Guid	计算机标识符。
计算机名称	字符串	计算机自定义名称。
主机名	字符串	主机系统名称。
服务用户名	字符串	机器人服务帐户。
计算机状态	字符串	状态： Available 、 Busy 、 Disconnected 、 Unknown 。
时间戳	Datetime	事件时间戳。
IsUnresponsive	布尔值	连接是否无响应。

机器人日志事件

发出时间： robotlog

字段	类型	描述
消息	字符串	日志内容。
级别	字符串	严重性： Trace 、 Info 、 Warn 、 Error 、 Fatal 。
日志类型	字符串	类别： User 、 Default 、 Error 、 Business 、 ExecutionStep 、 Info 、 Security 、 Technical 。
时间戳	Datetime	生成时间戳。
作业 ID	Guid	作业键。
流程名称	字符串	正在执行的流程名称。
流程版本	字符串	流程版本。
机器人名称	字符串	机器人标识符。
计算机 ID	数字	计算机数字 ID。
计算机键值	Guid	计算机标识符。
计算机名称	字符串	计算机名称。
主机名	字符串	主机名（仅限会话日志）。
Windows 标识	字符串	代理用户帐户。
初始化人员	字符串	执行来源： Assistant 、 Studio 、 StudioX 、 Orchestrator 、 CommandLine 、 RobotAPI 。
文件名	字符串	已执行的.xaml文件名。
活动信息	JSON	活动元数据： DisplayName 、 State 、 Activity 、 Arguments 。
自定义字段	JSON	通过“添加日志字段”活动添加的自定义字段。
队列名称	字符串	源队列名称（仅限队列处理）。
交易 ID	Guid	事务密钥（仅队列处理）。
交易说明	字符串	Started、 Ended 、 Postponed （仅队列处理）。
交易状态	字符串	Start、 Success 、 Failed 、 BusinessException 、 ApplicationException （仅队列处理）。
事务执行时间	数字	执行持续时间以秒为单位（仅队列处理）。
总执行时间（以秒为单位）	数字	执行总持续时间（仅限队列处理）。
队列项目优先级	字符串	High、 Normal 、 Low （仅限队列事务结束日志）。
队列项目审核状态	字符串	InReview、 Verified 、 Reported 、 Retried （仅限队列事务结束日志）。
ProcessingExceptionReason	字符串	异常原因（仅限队列事务结束日志）。
处理异常的类型	字符串	ApplicationException 或BusinessException （仅限队列事务结束日志）。

---

Maestro 事件

Maestro 会发出流程运行、元素运行和故障事件。

标准字段

所有 Maestro 事件都包含以下字段：

字段	描述
组织 ID	发出事件的组织的标识符。
租户 ID	发出事件的租户的标识符。
FolderKey	文件夹或工作区标识符。
流程密钥	流程定义的标识符。
实例 ID	流程实例的标识符。
RunId	流程运行的标识符。
跨度类型	Maestro 事件类型： Incident 、 ProcessRun 、 ElementRun 、 InstanceOperation 。
状态	事件的当前生命周期状态。
事件唯一 ID	已发出事件的全局唯一标识符。
EventTimeUtc	发出事件时的时间戳。
追踪属性	可选的追踪级别元数据（可为 null）。
跨度属性	其他跨度特定属性的字符串化 JSON。

事件字段

字段	描述
ElementId	发生事件的元素。
元素运行 ID	与事件关联的元素运行。
事件更新时间 UTC	上次更新事件的时间戳。
注释	与事件关联的可选注释。
错误代码	事件的错误代码。
错误消息	简短错误消息。
错误详情	详细错误信息。
DebugMode	发生事件时的调试模式状态。

流程运行字段

字段	描述
开始时间 Utc	流程运行开始时间 (UTC)。
跨度名称	跨度或事件的人类可读名称。
追踪 ID	用于关联的分布式追踪标识符。
跨度 ID	此流程运行的跨度标识符。
父跨度 ID	父跨度标识符（根跨度可为空）。
PackageId	包标识符。
PackageKey	包密钥，通常包含版本。
PackageVersion	包版本。
版本名称	人类可读的版本名称。
外部 ID	外部关联标识符。
来源	运行的触发器来源（例如Manual ）。
调试模式类型	调试模式配置。
创建者用户密钥	启动运行的用户（可以为空）。
CaseInstanceId	案例实例标识符（可为 null）。
案例管理元数据	案例管理元数据（可以为 null）。

元素运行字段

字段	描述
开始时间 Utc	元素执行开始时间 (UTC)。
结束时间 Utc	元素执行结束时间 (UTC)。
跨度名称	跨度或事件的人类可读名称。
追踪 ID	用于关联的分布式追踪标识符。
跨度 ID	此元素运行的跨度标识符。
父跨度 ID	父跨度标识符（可以为空）。
变量	在元素执行时捕获的结构化变量。
变量 Json	序列化为 JSON 的变量。
元素运行.元素 ID	元素的标识符。
ElementRun.元素名称	元素的显示名称。
ElementRun.ElementType	元素类型。
ElementRun.ElementExtensionType	扩展程序类型 (可以为 null)。
元素运行.元素运行 ID	元素运行标识符。
ElementRun.In应流 ID	传入流标识符。
ElementRun.传入的 FlowId	传入流标识符数组（可为 null）。
元素运行.案例阶段元素 ID	案例阶段元素标识符（可为 null）。
元素Run.案例管理元数据	元素级别的案例元数据（可以为空）。

示例：元素运行事件

{
  "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\"}"
}

---

审核日志事件

审核日志导出支持租户级别和组织级别的审核事件。

租户级别来源：

身份和访问：身份、OMS、KMS、许可、AuthZ、路由

产品和服务： Integration Service、Data Service、Test Manager、Automation Ops、Apps、Document Understanding

组织级别来源：组织范围内的策略和用户管理事件。

标准字段

字段	描述
ID	审核事件的全局唯一标识符。
本地 ID	用于排序的内部顺序标识符。
创建日期	创建事件的时间戳。
最后修改日期	上次修改的时间戳（可以为空）。
版本	审核事件记录的版本。
状态	事件的内部生命周期状态。
状态	事件的结果（数值枚举）。
事件类型	所执行操作的标识符。
EventSource	发出事件的产品或系统的标识符。
EventTarget	事件类别的标识符。
EventDetails	具有特定于事件的详细信息的嵌入式 JSON（见下文）。
ServiceName	人类可读的发出服务名称。
客户端信息	带IpAddress和IpCountry嵌入式 JSON。
参与者 ID	参与者的唯一标识符。
ActorName	参与者的显示名称。
参与者电子邮件	参与者的电子邮件（可以为空）。
参与者详细信息	内含描述参与者的元数据的嵌入式 JSON。
组织 ID	组织标识符。
组织名称	组织名称。
租户 ID	租户标识符（对于组织级别的事件可为 null）。
租户名称	租户名称（对于组织级别的事件可以为空）。
原始	事件的基础设施或区域来源。

按服务划分的事件详细信息字段

EventDetails字段是 JSON 字符串，其结构取决于发出的服务。

身份/身份验证事件：

字段	描述
用户 ID	用户的标识符。
用户.显示名称	用户显示名称。
用户.电子邮件	用户电子邮件。
用户.类型	用户类型 (enum)。
登录方法	身份验证方法。
ClientId	OAuth 客户端标识符。
作用域	已授予或请求的作用域。

Apps 事件：

字段	描述
应用程序 ID	唯一应用程序标识符。
appName	应用程序名称。
应用程序类型	应用程序的类型。
版本	应用程序版本。
描述	应用程序说明。
文件夹名称	包含应用程序的文件夹。
为操作应用程序	应用程序是否为 Action 应用程序。
是公共应用程序	应用程序是否公开可见。

Integration Service 事件：

字段	描述
ConnectionId	集成连接标识符。
ConnectionName	连接名称。
连接器	连接器显示名称。
ConnectorKey	唯一连接器密钥。

管理员/策略事件：

字段	描述
PolicyId	策略标识符。
策略名称	策略名称。
已创建的策略	策略创建元数据。
已删除的策略	策略删除元数据。
ModifiedFields	字段在更新过程中发生更改。

许可证资源管理器事件：

字段	描述
产品名称	许可的产品名称。
OldQuantity	先前的许可证数量。
NewQuantity	更新了许可证数量。
租户 ID	受影响的租户
租户名称	受影响的租户名称。
AdminName	执行更改的管理员。

Data Service (DataFabric) 事件：

字段	描述
EntityId	DataFabric 实体的标识符。
EntityName	实体名称。
RecordId	受影响记录的标识符。
已更改的属性	该操作修改的属性。
时间戳	特定于 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\":\"[e-mail]\",\"Type\":0}}",
  "ServiceName": "Identity",
  "Status": 0,
  "ClientInfo": null,
  "Origin": "alp-wus2-01-platform"
}

---

OTEL 追踪导出

智能体和 Maestro 追踪记录以 OpenTelemetry (OTEL) 格式导出。每次执行都会生成一个跨度树——每次智能体或 Maestro 运行一个根跨度，每次 LLM 调用、工具调用和防护栏评估都会包含子跨度。

OTEL 跨度字段

OTEL 字段	描述
追踪 ID	追踪标识符。对属于一次执行的所有跨度进行分组。
跨度 ID	此跨度的唯一标识符。
父跨度 ID	父跨度标识符。根跨度为空字符串。
name	人类可读的跨度名称（例如， Agent run - googlesearch 、 LLM call ）。
kind	跨度种类： SPAN_KIND_INTERNAL或SPAN_KIND_CLIENT 。
开始时间UnixN倍	跨度起始时间（以 Unix 纳秒为单位）。
结束时间 Linux	跨度结束时间（以 Unix 纳秒为单位）。
状态.代码	执行状态: STATUS_CODE_OK或STATUS_CODE_ERROR 。
状态.消息	状态消息（如果没有错误，则为空字符串）。
属性。*	使用点符号展平跨度属性（见下文）。

UiPath 属性映射

UiPath 的内部追踪字段映射到 OTEL 属性，如下所示：

UiPath 字段	OTEL 属性	注意
ID	跨度 ID	唯一的跨度标识符。
追踪 ID	追踪 ID	追踪标识符。
ParentId	父跨度 ID	根跨度为 Null。
名称	name	跨度名称。
开始时间	start_time_unix_nana	转换为 Unix 纳秒。
结束时间	Unix 纳秒结束时间	转换为 Unix 纳秒。
状态	状态.代码	1 = 确定， 2 = 错误。
属性	属性	使用点符号解析为键值对的 JSON 字符串。
跨度类型、组织 ID、租户 ID、文件夹密钥、作业密钥、流程密钥、来源、详细程度	属性.uipath。*	所有 UiPath 元数据字段。

跨度属性类型

UiPath 内部架构中的Attributes字段包含一个 JSON 字符串，该字符串已解析并展平为使用点表示法的 OTEL 跨度属性。结构取决于跨度类型。

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

属性	描述
类型、智能体 ID、智能体名称、智能体版本	智能体身份字段。
systemPrompt、userPrompt	智能体提示。
输入架构、输出架构	输入和输出架构。
输入、输出、来源	执行输入、输出和触发源。
错误	错误详情（如果有）。

补全属性( attributes.type = "completion" )：

属性	描述
类型、模型	跨度类型和 LLM 模型标识符。
settings.maxTokens、设置.温度	LLM 设置。
toolCalls	完成期间进行的工具调用的数组。
usage.completionTokens、usage.promptTokens、usage.totalTokens	令牌使用情况。
usage.isByoExecution、usage.executionDeploymentType、usage.isPiiMasted	执行元数据。
错误	错误详情（如果有）。

工具调用属性( attributes.type = "toolCall" )：

属性	描述
类型、调用 ID、工具名称	工具调用身份。
参数、工具类型	调用参数和工具类型。
结果	工具调用结果。
错误	错误详情（如果有）。

工具防护栏评估属性( attributes.type = "toolGuardrailEvaluation" )：

属性	描述
类型、防护栏名称、防护栏说明	防护机制身份。
防护栏操作、详细信息、操作	防护栏操作和结果。
参数、结果	评估输入和结果。
严重性级别	严重性分类。
错误	错误详情（如果有）。

导出限制

上限	值
最大单个属性值	32 KB
每个跨度的最大属性总数	256 KB
最大 OTLP 批处理大小	约 1 MB (protobuf)
文件附件	仅元数据（ID、文件名、MIME 类型）。不会导出文件内容。

示例: OTEL 追踪（一次智能体运行四个跨度）

[
  {
    "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": ""
  }
]