insights
2023.4
false
  • Release Notes
      • 2023.4.1
      • 2023.4.2
      • 2023.4.3
      • 2023.4.4
      • 2023.4.5
      • 2023.4.6
      • 2023.4.7
      • 2023.4.8
      • 2023.4.9
    • User Migration Tool Release Notes
  • Getting Started
  • Access and Permissions
  • Interacting with Insights
  • Historical data export
  • Logs
  • Performance and Scalability
  • Real-time data export
    • Overview
    • Preparing Splunk
    • Configure real-time data export to Splunk
    • Real Time Data Export Data Model
Insights
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated Oct 17, 2024

Real Time Data Export Data Model

Overview

Every change in the system is represented by an event logged JSON format.

The following event types are supported:

  • Events describing jobs:

    • job.created
    • job.started
    • job.stopped
    • job.pending
    • job.completed
    • job.faulted
    • job.stopping
    • job.terminating

  • Events describing queue items:

    • queueitem.added
    • queueItem.retried
    • queueItem.updated
    • queueItem.transactionAbandoned
    • queueItem.transactionCompleted
    • queueItem.transactionFailed
    • queueItem.transactionRetried
    • queueItem.transactionStarted

  • Events describing machines:

    • machine.created
    • machine.updated
    • machine.deleted
    • machineSession.status
    • machine.assign
    • machine.unassign

Because different events describe different entities and changes to the system, they have different content (JSON fields).

Format and Schema of Events

Each event is delivered in JSON format and has the following:

  • Event-specific body
  • Common fields
  • Metadata
For a better understanding, check the example below for a job.created event. The example is formatted with new lines and comments describing each section for readability. Real events do not have this formatting and are delivered as a single-line string. 
{
    /*********************
            event-specific body
    **********************/
    "body": {
        "Job": {
            "Key": "<job-key>",
            "CreationTime": null,
            "State": "Pending",
            "StartTime": "<job-start-time>",
            "EndTime": null,
            "ProcessName": "<process-name>",
          "DisplayName": "<display-name>",
            "RobotName": "<robot-name>",
            "HostMachineName": "<host-machine-name>"
        },
    /*********************
            common fields
    **********************/
        "EventType": "job.started",
        "SchemaVersion": "0.0.1",
        "Timestamp": "<timestamp>",
        "TenantKey": "<tenant-key>",
        "TenantName": "<tenant-name>",
        "FolderName": "<folder-name>",
        "FullFolderPath": "<folder-path>",
        "FolderKey": "<folder-key>"
        },
    /*********************
            metadata
    **********************/
    "x-opt-sequence-number": <sequence-number>,
    "x-opt-offset": "<offset>",
    "x-opt-enqueued-time": <enqueued-time>,
    "Diagnostic-Id": "<diagnostic-id>"
}{
    /*********************
            event-specific body
    **********************/
    "body": {
        "Job": {
            "Key": "<job-key>",
            "CreationTime": null,
            "State": "Pending",
            "StartTime": "<job-start-time>",
            "EndTime": null,
            "ProcessName": "<process-name>",
          "DisplayName": "<display-name>",
            "RobotName": "<robot-name>",
            "HostMachineName": "<host-machine-name>"
        },
    /*********************
            common fields
    **********************/
        "EventType": "job.started",
        "SchemaVersion": "0.0.1",
        "Timestamp": "<timestamp>",
        "TenantKey": "<tenant-key>",
        "TenantName": "<tenant-name>",
        "FolderName": "<folder-name>",
        "FullFolderPath": "<folder-path>",
        "FolderKey": "<folder-key>"
        },
    /*********************
            metadata
    **********************/
    "x-opt-sequence-number": <sequence-number>,
    "x-opt-offset": "<offset>",
    "x-opt-enqueued-time": <enqueued-time>,
    "Diagnostic-Id": "<diagnostic-id>"
}

Common Fields

Common fields appear in every event.

Name

Type

Description

EventType

string

The type of event.

SchemaVersion

string

The version of the schema. Different versions may have different event types and fields supported.

Timestamp

timestamp

UTC timestamp of the event.

TenantKey

Guid

The unique identifier of the tenant that generated the event.

TenantName

string

Name of the tenant that generated the event.

FolderName

string

Name of the Orchestrator folder in which the event was generated.

FullFolderPath

string

If a folder is a subfolder of another folder, this field displays the full path.

FolderKey

Guid

The unique identifier of the folder.

{
    "EventType": "queueItem.transactionCompleted",
    "SchemaVersion": "0.0.1",
    "Timestamp": "<timestamp>",
    "TenantKey": "<tenant-key>",
    "TenantName": "<tenant-name>",
    "FolderName": "<folder-name>",
    "FullFolderPath": "<folder-path>",
    "FolderKey": "<folder-key>"
}{
    "EventType": "queueItem.transactionCompleted",
    "SchemaVersion": "0.0.1",
    "Timestamp": "<timestamp>",
    "TenantKey": "<tenant-key>",
    "TenantName": "<tenant-name>",
    "FolderName": "<folder-name>",
    "FullFolderPath": "<folder-path>",
    "FolderKey": "<folder-key>"
}

Job Events

Name

Type

Description

Key

Guid

Unique identifier of a job.

CreationTime

timestamp

Timestamp when the job was created.

StartTime

timestamp

Timestamp when the job started.

EndTime

timestamp

Timestamp when the job completed.

State

string

The state of job. Supported values:

• Pending
• Running
• Stopping
• Terminating
• Faulted
• Successful
• Stopped
• Suspended
• Resumed

ProcessName

string

Name of the package that the job was created from.

DisplayName

string

Name provided to a process in Orchestrator.

RobotName

string

Name of the robot executing the job.

HostMachineName

string

Machine on which the job is being executed.

{
    "body": {
        "Job": {
        "Key": "<job-key>",
        "CreationTime": "<creation-time>",
        "State": "Running",
        "StartTime": "<start-time>",
        "EndTime": null,
        "ProcessName": "<process-name>",
        "DisplayName": "<display-name>",
        "RobotName": "<robot-name>",
        "HostMachineName": "<host-machine-name>",
    },
    ... common fields ...
    "EventType": "job.started",
    ... more common fields ...
}{
    "body": {
        "Job": {
        "Key": "<job-key>",
        "CreationTime": "<creation-time>",
        "State": "Running",
        "StartTime": "<start-time>",
        "EndTime": null,
        "ProcessName": "<process-name>",
        "DisplayName": "<display-name>",
        "RobotName": "<robot-name>",
        "HostMachineName": "<host-machine-name>",
    },
    ... common fields ...
    "EventType": "job.started",
    ... more common fields ...
}

Queue Item Events

Name

Type

Description

   

QueueItem

JSON object

 
   

Key

Guid

Unique identifier of the queue item.

QueueDefinitionId

number

Numeric identifier of a queue that the queue item belongs to.

Status

string

The status of the queue item. Supported values:

• New
• InProgress
• Failed
• Successful
• Abandoned
• Retried
• Deleted
• Unknown

ReviewStatus

string

The review status of the queue item. Supported values:

• None
• InReview
• Verified
• Retried
• Unknown

DueDate

datetime

Latest date and time at which the item should be processed.

Priority

string

The priority of the queue item. Supported values:

• High
• Normal
• Low
• Unknown

CreationTime

datetime

Timestamp when the queue item was created.

StartProcessing

datetime

Timestamp when the queue item started processing.

EndProcessing

datetime

Timestamp when the queue item finished processing (successfully or not).

DefferDate

datetime

The earliest date and time at which the item should be available for processing. If empty, the item can be processed as soon as possible.

SecondsInPreviousAttempt

number

The number of seconds that the last failed processing attempt lasted.

RetryNumber

number

The number of times this queue item has been processed.

Progress

string

String filed added by developers in UiPath Studio which is used to keep track on the business flow progress.

AnalyticsData

string
A collection of key-value pairs containing the data from the Analytics property added by developers in Studio via the Set Transaction Status activity.

Output

string
A collection of key-value pairs containing the data from the Output property added by developers in Studio via the Set Transaction Status activity.

SpecificData

string
A collection of key-value pairs containing the data from the Specific Content property added by developers in Studio via the Set Transaction Status activity.

A collection of key value pairs containing custom data configured in the Add Queue Item activity in

UiPath Studio.

CreatorJobId

number

The ID of the job that created the queue item.

ExecutorJobId

number

The ID of the job that executed the queue item.

ProcessExceptionReason

string

Summary of reason the queue item processing failed.

ProcessExceptionDetails

string

Additional details on the queue item failure.

ProcessExceptionType

string

For queue items that finished with an error this field describes the type of error (exception). Supported values:

• ApplicationException
• BusinessException
• None
   

Queue

JSON Object

 
   

Key

Guid

Unique identifier of the queue.

Name

string

The name of the queue.

Description

string

Additional information about a queue in order to better identify it.

MaxNumberOfRetries

number

The number of times an item of this queue can be retried if its' processing fails.

EnforceUniqueReference

boolean
States whether the Item Reference field should be unique per Queue item.

SlaInMinutes

number

Integer value representing the Queue SLA in minutes.

RiskSlaInMinutes

number

Integer value representing the Queue Risk SLA in minutes.

   
{
    "body": {
        "QueueItem": {
            "Key": "<queue-item-key>",
            "QueueDefinitionId": <queue-definition-id>,
          "Status": "New",
            "ReviewStatus": "None",
            "DueDate": "<due-date>",
            "Priority": "High",
            "CreationTime": "<creation-time>",
            "StartProcessing": "<start-processing-time>",
            "EndProcessing": null,
            "DefferDate": "<deffer-time>",
            "SecondsInPreviousAttempt": 0,
            "RetryNumber": 1,
            "Progress": "<progress>",
            "ProcessExceptionReason": null,
            "ProcessExceptionDetails": null,
            "ProcessExceptionType": null
        },
        "Queue": {
            "Key": "<queue-key>",
            "Name": "<queue-name>",
            "Description": "<queue-description>",
            "MaxNumberOfRetries": 1,
            "EnforceUniqueReference": false,
            "SlaInMinutes": 0,
            "RiskSlaInMinutes": 0
        },
    },
    ... common fields ...
}{
    "body": {
        "QueueItem": {
            "Key": "<queue-item-key>",
            "QueueDefinitionId": <queue-definition-id>,
          "Status": "New",
            "ReviewStatus": "None",
            "DueDate": "<due-date>",
            "Priority": "High",
            "CreationTime": "<creation-time>",
            "StartProcessing": "<start-processing-time>",
            "EndProcessing": null,
            "DefferDate": "<deffer-time>",
            "SecondsInPreviousAttempt": 0,
            "RetryNumber": 1,
            "Progress": "<progress>",
            "ProcessExceptionReason": null,
            "ProcessExceptionDetails": null,
            "ProcessExceptionType": null
        },
        "Queue": {
            "Key": "<queue-key>",
            "Name": "<queue-name>",
            "Description": "<queue-description>",
            "MaxNumberOfRetries": 1,
            "EnforceUniqueReference": false,
            "SlaInMinutes": 0,
            "RiskSlaInMinutes": 0
        },
    },
    ... common fields ...
}

Machine Session Events

Name

Type

Description

MachineKey

Guid

Unique identifier of the machine.

MachineName

string

Custom name of the machine.

HostMachineName

string

Name of the host machine which is mapped to the UiPath machine.

ServiceUsername

string

Name of the user under which the robot service on the machine is running.

MachineStatus

string

Status of the machine. Supported values:

• Available
• Busy
• Disconnected
• Unknown

Timestamp

datetime

Timestamp of the machine session event.

IsUnresponsive

boolean

A check to see if the machine is responsive to connection from Orchestrator. Supported values:

• true
• false

A machine can still be available but be unresponsive. Once it is unresponsive for ten minutes, it becomes disconnected or unknown. 

{
    "body": {
        "MachineSession": {
            "MachineKey": "<machine-key>",
            "MachineName": "<machine-name>",
            "MachineId": <machine-id>,
            "HostMachineName": "<host-machine-name>",
            "ServiceUsername": "<service-username>",
            "MachineStatus": "Disconnected",
            "ReportingTime": "<reporting-time>",
            "IsUnresponsive": false
        },
        ... common fields ...
        "EventType":"machineSession.status",
        ... more common fields ...
}{
    "body": {
        "MachineSession": {
            "MachineKey": "<machine-key>",
            "MachineName": "<machine-name>",
            "MachineId": <machine-id>,
            "HostMachineName": "<host-machine-name>",
            "ServiceUsername": "<service-username>",
            "MachineStatus": "Disconnected",
            "ReportingTime": "<reporting-time>",
            "IsUnresponsive": false
        },
        ... common fields ...
        "EventType":"machineSession.status",
        ... more common fields ...
}

Machine Events

Name

Type

Description

AutomationCloudSlots

number

Number of Automation Cloud<b>TM</b> slots to be reserved at runtime.

HeadlessSlots

number

Number of Headless slots to be reserved at runtime.

MachineId

number

Machine integer id, unique per Orchestrator instance.

MachineKey

Guid

Unique identifier of a machine.

MachineName

string

Custom name of the machine.

NonProductionSlots

number
Number of NonProduction slots to be reserved at runtime.

UnattendedSlots

number
Number of Unattended slots to be reserved at runtime. 
{
    "body": {
        "Machine": {
            "MachineName": "<machine-name>",
            "MachineKey": "<machine-key>",
            "NonProductionSlots": 1,
            "HeadlessSlots": 0,
            "AutomationCloudSlots": 0,
            "UnattendedSlots": 0
        },
        ... common fields ...
}{
    "body": {
        "Machine": {
            "MachineName": "<machine-name>",
            "MachineKey": "<machine-key>",
            "NonProductionSlots": 1,
            "HeadlessSlots": 0,
            "AutomationCloudSlots": 0,
            "UnattendedSlots": 0
        },
        ... common fields ...
}

Machine Assign Events

Name

Type

Values

MachineKey

Guid

Unique identifier of a machine.

MachineName

string

Custom name of the machine.

{
    "body": {
        "MachineAssign": {
            "MachineKey": "<machine-key>",
            "MachineName": "<machine-name>"
        },
        "EventType": "machine.unassigned",
        ... common fields ...
    }
}{
    "body": {
        "MachineAssign": {
            "MachineKey": "<machine-key>",
            "MachineName": "<machine-name>"
        },
        "EventType": "machine.unassigned",
        ... common fields ...
    }
}

Robot Logs

Name

Type

Description

fileName

string
The name of the .xaml file being executed.

initiatedBy

string

The source of the execution. Possible values:

• Assistant
• Studio
• StudioX
• StudioPro
• Orchestrator
• CommandLine
• RobotAPI

JobId
string/guid
The JobKey, a unique identifier for the job.

level

string

Logging level of the log. Possible values:

• Trace
• Info
• Warn
• Error
• Fatal

logType

string

The type of the robot log. Possible values:

• User
• Default
• Error
• Business
• ExecutionStep
• BusinessIteration
• Info
• Security
• Technical

machineId

number

Machine integer id, unique per Orchestrator instance.

machineName

string

Custom name of the machine.

message

string

The message of the robot log. Possible values:

• execution started
• execution ended

• custom message

processName

string

The process name the robot is executing.

processVersion

string

The version of the process.

robotName

string

The name of the robot.

windowsIdentity

string

The name of the user that performed the action that was logged.

processingExceptionReason

string

The reason for the exception. Only present in Transaction End logs.

processingExceptionType

string

The type of the exception. Only present in Transaction End logs. Possible values:

• ApplicationException
• BusinessException

queueItemPriority

string

The priority of the queue item. Only present in Transaction End logs. Possible values:

• High
• Normal
• Low

queueItemReviewStatus

string

The review status of the queue item. Only present in Transaction End logs. Possible values:

• InReview
• Verified
• Reported
• Retried

queueName

string

The queue name from which the robot is executing queue items.

transactionExecutionTime

number

The execution time in seconds for the transaction. Only has values when processing queue items.

transactionId
string/Guid

The unique key of the transaction. Only has values when processing queue items.

transactionState

string

The transaction state. Only has values when processing queue items. Possible values:

• Started
• Ended
• Postponed

transactionStatus

string

The transaction status. Only has values when processing queue items. Possible values:

• ApplicationException
• Start
• SystemError
• Failed
• BusinessException
• Success
• InProgress

totalExecutionTimeInSeconds

number

The execution time for the transaction, measured in seconds. Only has values when processing queue items.

activityInfo

JSON
The activity info JSON containing DisplayName, State (Faulted, Closed, or Executing), Activity, and Arguments.

timestamp

datetime

Time the event was generated.

MachineKey

Guid

Unique identifier of the machine executing the job.

CustomFields

JSON

A JSON that contains the fields defined in the AddLogFields activity in Studio. 

{
    "body": {
        "Level": "Info",
        "MachineKey": "<machine-key>",
        "RobotLog": {
            "message": "Transaction Ended",
            "level": "Information",
            "logType": "Default",
            "CustomFields": {
                "Custom fields 1": "value1",
                "Custom fields 2": 2,
            },
        "timeStamp": "<timestamp>",
        "fingerprint": "<fingerprint>",
        "windowsIdentity": "<windows-identity>",
        "machineName": "<machine-name>",
        "fileName": "<filename>",
        "transactionExecutionTime": 0.6733966,
        "queueItemPriority": "Normal",
        "processingExceptionReason": "",
        "transactionStatus": "Successful",
        "queueName": "<queue-name>",
        "transactionState": "Ended",
        "processingExceptionType": "",
        "transactionId": "<transaction-id>",
        "queueItemReviewStatus": "None",
        "processName": "<process-name>",
        "processVersion": "1.0.6",
        "jobId": "<job-id>",
        "robotName": "<robot-name>",
        "machineId": <machine-id>,
        "organizationUnitId": <organization-unit-id>
        },
        "EventType": "robotlog",
        ... common fields ...
    },
}{
    "body": {
        "Level": "Info",
        "MachineKey": "<machine-key>",
        "RobotLog": {
            "message": "Transaction Ended",
            "level": "Information",
            "logType": "Default",
            "CustomFields": {
                "Custom fields 1": "value1",
                "Custom fields 2": 2,
            },
        "timeStamp": "<timestamp>",
        "fingerprint": "<fingerprint>",
        "windowsIdentity": "<windows-identity>",
        "machineName": "<machine-name>",
        "fileName": "<filename>",
        "transactionExecutionTime": 0.6733966,
        "queueItemPriority": "Normal",
        "processingExceptionReason": "",
        "transactionStatus": "Successful",
        "queueName": "<queue-name>",
        "transactionState": "Ended",
        "processingExceptionType": "",
        "transactionId": "<transaction-id>",
        "queueItemReviewStatus": "None",
        "processName": "<process-name>",
        "processVersion": "1.0.6",
        "jobId": "<job-id>",
        "robotName": "<robot-name>",
        "machineId": <machine-id>,
        "organizationUnitId": <organization-unit-id>
        },
        "EventType": "robotlog",
        ... common fields ...
    },
}

Was this page helpful?

Support and Services
Get The Help You Need
UiPath Academy
Learning RPA - Automation Courses
UiPath Forum
UiPath Community Forum
Uipath Logo White
Trust and Security
Terms of Use
Privacy Policy
Cookies Policy
© 2005-2024 UiPath. All rights reserved.