Data Export data model

Data Export sends data in two formats depending on the data source selected:

• Event-based (JSON) — discrete events emitted when something happens in UiPath (a job changes state, a queue item is processed, an audit action is recorded). Delivered to Azure Event Hub or AWS SQS.
• OTEL Trace — hierarchical spans representing agent and Maestro execution traces in OpenTelemetry format. Delivered to Arize, Databricks, or any OTLP (OpenTelemetry Protocol)-compatible endpoint.

Event-based (JSON) exports

Orchestrator Events

Orchestrator emits events for Jobs, Queue Items, Machines, and Robot Logs. Each event includes a common envelope plus an entity-specific body.

共通フィールド

All Orchestrator events include the following fields:

フィールド	説明
イベントの種類	String identifying the event type (for example, job.created, queueitem.added).
SchemaVersion	Schema version identifier.
Timestamp	イベントの UTC タイムスタンプです。
TenantKey	Tenant identifier.
テナント名	Tenant display name.
FolderKey	Folder identifier.
フォルダー名	フォルダーの表示名。
FullFolderPath	Full folder path.

ジョブイベント

Emitted on: job.created, job.started, job.stopped, job.pending, job.completed, job.faulted, job.stopping, job.terminating

フィールド	入力	説明
キー	GUID	Unique job identifier.
作成時刻	Timestamp	Job creation time.
開始時刻	Timestamp	Execution start time.
終了時刻	Timestamp	Execution end time.
ステート	文字列	Job status: Pending, Running, Stopping, Terminating, Faulted, Successful, Stopped, Suspended, Resumed.
プロセス名	文字列	Source package name.
表示名	文字列	Display name in Orchestrator.
ロボット名	文字列	Executing robot identifier.
ホスト マシン名	文字列	Execution machine name.

QueueItem イベント

Emitted on: queueitem.added, queueItem.deferred, queueItem.reviewStatusChanged, queueItem.retried, queueItem.updated, queueItem.transactionAbandoned, queueItem.transactionCompleted, queueItem.transactionFailed, queueItem.transactionRetried, queueItem.transactionStarted

フィールド	入力	説明
キー	GUID	Queue item identifier.
QueueDefinitionId	Number	Queue numeric ID.
ステータス	文字列	Item status: New, InProgress, Failed, Successful, Abandoned, Retried, Deleted, Unknown.
レビュー ステータス	文字列	Review classification: None, InReview, Verified, Retried, Unknown.
優先度	文字列	Item priority: High, Normal, Low, Unknown.
期限日	Datetime	Processing deadline.
作成時刻	Datetime	Creation timestamp.
処理の開始時刻	Datetime	Processing start time.
処理の終了時刻	Datetime	Processing completion time.
延期日	Datetime	Earliest available processing time.
過去の試行 (秒)	Number	Duration of the previous attempt in seconds.
リトライ回数	Number	Number of processing attempts.
進行状況	文字列	Business flow progress.
分析データ	文字列	Analytics property key-value pairs.
出力	文字列	Output data from the Set Transaction Status activity.
固有データ	文字列	Custom data from the Specific Content property or Add Queue Item activity.
作成ジョブ ID	Number	Creating job identifier.
実行ジョブ ID	Number	Executing job identifier.
ProcessExceptionReason	文字列	Failure summary.
ProcessExceptionDetails	文字列	Failure details.
ProcessExceptionType	文字列	Error type: ApplicationException, BusinessException, None.

The Queue object embedded in each event includes: Key, Name, Description, MaxNumberOfRetries, EnforceUniqueReference, SlaInMinutes, RiskSlaInMinutes.

注:

SpecificData, SpecificContent, and Output are not included in queueItem.deferred and queueItem.reviewStatusChanged events.

マシン イベント

Emitted on: machine.created, machine.updated, machine.deleted, machine.assign, machine.unassign

フィールド	入力	説明
マシン ID	Number	Machine numeric ID.
マシン キー	GUID	Machine identifier.
マシン名	文字列	Machine custom name.
AutomationCloudSlots	Number	Reserved runtime slots.
HeadlessSlots	Number	Headless mode slots.
NonProductionSlots	Number	Non-production environment slots.
UnattendedSlots	Number	Unattended execution slots.

Machine session events (machineSession.status) include:

フィールド	入力	説明
マシン キー	GUID	Machine identifier.
マシン名	文字列	Machine custom name.
ホスト マシン名	文字列	Host system name.
サービス ユーザー名	文字列	Robot service account.
マシンのステータス	文字列	Status: Available, Busy, Disconnected, Unknown.
Timestamp	Datetime	Event timestamp.
IsUnresponsive	Boolean	Whether the connection is unresponsive.

Robot log events

Emitted on: robotlog

フィールド	入力	説明
メッセージ	文字列	Log content.
レベル	文字列	Severity: Trace, Info, Warn, Error, Fatal.
ログの種類	文字列	Category: User, Default, Error, Business, ExecutionStep, Info, Security, Technical.
Timestamp	Datetime	Generation timestamp.
ジョブ ID	GUID	Job key.
プロセス名	文字列	Executing process name.
プロセス バージョン	文字列	Process version.
ロボット名	文字列	Robot identifier.
マシン ID	Number	Machine numeric ID.
マシン キー	GUID	Machine identifier.
マシン名	文字列	Machine name.
ホスト マシン名	文字列	Host machine name (session logs only).
Windows ID	文字列	Acting user account.
initiatedBy	文字列	Execution source: Assistant, Studio, StudioX, Orchestrator, CommandLine, RobotAPI.
ファイル名	文字列	Executed .xaml file name.
アクティビティ情報	JSON	Activity metadata: DisplayName, State, Activity, Arguments.
カスタム フィールド	JSON	Custom fields added via the AddLogFields activity.
QueueName	文字列	Source queue name (queue processing only).
トランザクション ID	GUID	Transaction key (queue processing only).
transactionState	文字列	Started, Ended, Postponed (queue processing only).
transactionStatus	文字列	Start, Success, Failed, BusinessException, ApplicationException (queue processing only).
トランザクション実行時間	Number	Execution duration in seconds (queue processing only).
totalExecutionTimeInSeconds	Number	Total execution duration (queue processing only).
queueItemPriority	文字列	High, Normal, Low (queue transaction end logs only).
queueItemReviewStatus	文字列	InReview, Verified, Reported, Retried (queue transaction end logs only).
ProcessingExceptionReason	文字列	Exception reason (queue transaction end logs only).
プロセスの例外の種類	文字列	ApplicationException or BusinessException (queue transaction end logs only).

---

Maestro Events

Maestro emits events for Process Runs, Element Runs, and Incidents.

Standard fields

All Maestro events include the following fields:

フィールド	説明
組織 ID	Identifier of the organization emitting the event.
TenantId	Identifier of the tenant emitting the event.
FolderKey	Folder or workspace identifier.
ProcessKey	Identifier of the process definition.
InstanceId	Identifier of the process instance.
RunId	Identifier of the process run.
SpanType	Maestro event type: Incident, ProcessRun, ElementRun, InstanceOperation.
ステータス	Current lifecycle state of the event.
EventUniqueId	Globally unique identifier of the emitted event.
EventTimeUtc	Timestamp when the event was emitted.
TraceAttributes	Optional trace-level metadata (nullable).
SpanAttributes	Stringified JSON of additional span-specific attributes.

Incident fields

フィールド	説明
ElementId	Element where the incident occurred.
ElementRunId	Element run associated with the incident.
IncidentUpdateTimeUtc	Timestamp when the incident was last updated.
コメント	Optional comment associated with the incident.
ErrorCode	Error code for the incident.
ErrorMessage	Short error message.
ErrorDetails	Detailed error information.
DebugMode	Debug mode state when the incident occurred.

Process run fields

フィールド	説明
StartTimeUtc	Process run start time in UTC.
SpanName	Human-readable name of the span or event.
TraceId	Distributed trace identifier for correlation.
SpanId	Span identifier for this process run.
ParentSpanId	Parent span identifier (nullable for root spans).
PackageId	Package identifier.
PackageKey	Package key, typically includes version.
PackageVersion	パッケージ バージョン。
Release Name	Human-readable release name.
ExternalId	External correlation identifier.
ソース	Trigger source of the run (for example, Manual).
DebugModeType	Debug mode configuration.
CreatorUserKey	User that initiated the run (nullable).
CaseInstanceId	Case instance identifier (nullable).
CaseManagementMetadata	Case management metadata (nullable).

Element run fields

フィールド	説明
StartTimeUtc	Element execution start time in UTC.
EndTimeUtc	Element execution end time in UTC.
SpanName	Human-readable name of the span or event.
TraceId	Distributed trace identifier for correlation.
SpanId	Span identifier for this element run.
ParentSpanId	Parent span identifier (nullable).
変数	Structured variables captured at element execution.
VariablesJson	Variables serialized as JSON.
ElementRun.ElementId	Identifier of the element.
ElementRun.ElementName	Display name of the element.
ElementRun.ElementType	Element type.
ElementRun.ElementExtensionType	Extension type (nullable).
ElementRun.ElementRunId	Element run identifier.
ElementRun.IncomingFlowId	Incoming flow identifier.
ElementRun.IncomingFlowIds	Incoming flow identifiers array (nullable).
ElementRun.CaseStageElementId	Case stage element identifier (nullable).
ElementRun.CaseManagementMetadata	Case metadata at element level (nullable).

Example: Element run event

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

---

Audit Log Events

Audit log exports support both tenant-level and organization-level audit events.

Tenant-level sources:

Identity and access: Identity, OMS, KMS, Licensing, AuthZ, Routing

Products and services: Integration Service, Data Service, Test Manager, Automation Ops, Apps, Document Understanding

Organization-level sources: Organization-scoped policy and user management events.

Standard fields

フィールド	説明
ID	Globally unique identifier of the audit event.
LocalId	Internal sequential identifier for ordering.
作成日	Timestamp when the event was created.
最終更新日	Timestamp of the last modification (nullable).
バージョン	Version of the audit event record.
ステート	Internal lifecycle state of the event.
ステータス	Outcome of the event (numeric enum).
イベントの種類	Identifier of the action performed.
EventSource	Identifier of the product or system emitting the event.
EventTarget	Identifier of the event category.
EventDetails	Embedded JSON with event-specific details (see below).
ServiceName	Human-readable name of the emitting service.
ClientInfo	Embedded JSON with IpAddress and IpCountry.
ActorId	Unique identifier of the actor.
ActorName	Display name of the actor.
ActorEmail	Email of the actor (nullable).
ActorDetails	Embedded JSON with metadata describing the actor.
組織 ID	Organization identifier.
組織名	Organization name.
TenantId	Tenant identifier (nullable for organization-level events).
テナント名	Tenant name (nullable for organization-level events).
作成元	Infrastructure or regional origin of the event.

EventDetails fields by service

The EventDetails field is a JSON string whose structure depends on the emitting service.

Identity / Authentication events:

フィールド	説明
User.Id	Identifier of the user.
User.DisplayName	User display name.
User.Email	User email.
User.Type	User type (enum).
LoginMethod	Authentication method.
クライアント ID	OAuth client identifier.
スコープ	Granted or requested scopes.

Apps events:

フィールド	説明
appId	Unique app identifier.
appName	Application name.
appType	Type of application.
version	Application version.
説明	App description.
folderName	Folder containing the app.
isActionApp	Whether the app is an action app.
isPublicApp	Whether the app is publicly visible.

Integration Service events:

フィールド	説明
ConnectionId	Integration connection identifier.
ConnectionName	Name of the connection.
コネクタ	Connector display name.
ConnectorKey	Unique connector key.

Admin / Policy events:

フィールド	説明
PolicyId	Policy identifier.
PolicyName	Policy name.
CreatedPolicy	Policy creation metadata.
DeletedPolicy	Policy deletion metadata.
ModifiedFields	Fields changed during the update.

License Resource Manager events:

フィールド	説明
ProductName	Licensed product name.
OldQuantity	Previous license quantity.
NewQuantity	Updated license quantity.
TenantId	Affected tenant.
テナント名	Affected tenant name.
AdminName	Administrator who performed the change.

Data Service (DataFabric) events:

フィールド	説明
EntityId	Identifier of the DataFabric entity.
エンティティ名	Name of the entity.
レコード ID	Identifier of the affected record.
changedProperties	Properties modified by the operation.
Timestamp	DataFabric-specific event timestamp.

Example: Audit log event

{
  "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 Trace exports

Agent and Maestro traces are exported in OpenTelemetry (OTEL) format. Each execution generates a tree of spans — one root span per agent or Maestro run, with child spans for each LLM call, tool call, and guardrail evaluation.

OTEL span fields

OTEL Field	説明
traceId	Trace identifier. Groups all spans belonging to one execution.
spanId	Unique identifier for this span.
parentSpanId	Parent span identifier. Empty string for root spans.
name	Human-readable span name (for example, Agent run - googlesearch, LLM call).
kind	Span kind: SPAN_KIND_INTERNAL or SPAN_KIND_CLIENT.
startTimeUnixNano	Span start time in Unix nanoseconds.
endTimeUnixNano	Span end time in Unix nanoseconds.
status.code	Execution status: STATUS_CODE_OK or STATUS_CODE_ERROR.
status.message	Status message (empty string when no error).
attributes.*	Span attributes flattened using dot notation (see below).

UiPath attribute mapping

UiPath's internal trace fields map to OTEL attributes as follows:

UiPath のフィールド	OTEL attribute	備考
ID	span_id	Unique span identifier.
TraceId	trace_id	Trace identifier.
親 ID	parent_span_id	Null for root spans.
名前	name	Span name.
開始時刻	start_time_unix_nano	Converted to Unix nanoseconds.
終了時刻	end_time_unix_nano	Converted to Unix nanoseconds.
ステータス	status.code	1 = OK, 2 = ERROR.
属性	attributes	JSON string parsed into key-value pairs using dot notation.
SpanType, OrganizationId, TenantId, FolderKey, JobKey, ProcessKey, Source, VerbosityLevel	attributes.uipath.*	All UiPath metadata fields.

Span attribute types

The Attributes field in UiPath's internal schema contains a JSON string that is parsed and flattened into OTEL span attributes using dot notation. The structure depends on the span type.

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

属性	説明
type, agentId, agentName, agentVersion	Agent identity fields.
systemPrompt, userPrompt	Agent prompts.
inputSchema, outputSchema	Input and output schemas.
input, output, source	Execution inputs, outputs, and trigger source.
error	Error details, if present.

completion attributes (attributes.type = "completion"):

属性	説明
type, model	Span type and LLM model identifier.
settings.maxTokens, settings.temperature	LLM settings.
toolCalls	Array of tool calls made during completion.
usage.completionTokens, usage.promptTokens, usage.totalTokens	Token usage.
usage.isByoExecution, usage.executionDeploymentType, usage.isPiiMasked	Execution metadata.
error	Error details, if present.

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

属性	説明
type, callId, toolName	Tool call identity.
arguments, toolType	Call arguments and tool type.
結果	Tool call result.
error	Error details, if present.

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

属性	説明
type, guardrailName, guardrailDescription	Guardrail identity.
guardrailAction, details, action	Guardrail action and outcome.
arguments, result	Evaluation inputs and result.
severityLevel	Severity classification.
error	Error details, if present.

Export limits

上限量	値 (Value)
Max individual attribute value	32 KB
Max total attributes per span	256 KB
Max OTLP batch size	~1 MB (protobuf)
File attachments	Metadata only (ID, filename, MIME type). File content is not exported.

Example: OTEL trace (four spans for one agent run)

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