About Logs

Overview

The Logs page displays logs generated by Robots in all folders that you have access to.

To access it, navigate to Orchestrator Automations tab from a folder context, and select Logs from the options displayed.

Note: Logs generated outside the context of a folder can be viewed only in the Orchestrator database and Elasticsearch.

Filtering

To view all logs generated by a Robot for an indicated job, navigate to the Jobs page, click the 3-dot menu corresponding to the job you are interested in, and select View Logs.

To filter logs generated by Robots in all folders that you have access to, go to the Logs page and use the desired filters. Note that some filters are applied by default, such as Time, which is set to Last day. To view all logs, make sure to remove all filters.

To filter logs by the name of the host machine they have been generated on, use the Machine filter on the Logs page. The filter works retroactively for logs stored in Elasticsearch, while for logs stored in the database, it only works for new log entries.

Log Storage

If Orchestrator is unavailable, logs are stored in a local database (C:\Windows\SysWOW64\config\systemprofile\AppData\Local\UiPath\Logs\execution_log_data), within the available disk space, until the connection is restored. When the connection is restored, the logs are sent in batches in the order they had been generated.

Note: The database is not deleted after the logs have been successfully sent to Orchestrator.

The status of a job is stored in the memory of the UiPath Robot service. When Orchestrator becomes available, the information regarding the job status is synced between the two. However, if Orchestrator is not available and you restart the UiPath Robot service, the information is lost. This means that whenever Orchestrator becomes available, the job is executed again.

Logs can be sent to ElasticSearch, a local SQL database, and/or UiPath Insights, thus enabling you to have non-repudiation logs. They are independent of each other and, as such, an issue encountered in one does not affect the other(s).

The Logs page displays the entries that Robots send to Orchestrator if the logs are sent to Elasticsearch or a SQL database. If logs are sent to both Elasticsearch and SQL, then the Logs page displays only the entries sent to Elasticsearch.

Note:

The performance of the SQL database starts degrading when it reaches 2 million Robot logs, with a severe degradation once the 6 million threshold is reached. The degradation leads to slow log searches and impacts the performance of your automations.

These thresholds represent our observed averages. Depending on your database server hardware, the values can either be smaller or larger (by up to 2 - 3 times).

You need to regularly clean up the database so as to ensure that you stay within these limits.

If, however, your business needs require that you exceed these thresholds, you need to use Elasticsearch in order to maintain performance.

If you use Elasticsearch to store your Robot logs, please note that, in certain circumstances, only 10.000 items can be queried.

Due to an Elasticsearch limitation, Cloud Platform's Orchestrator tenants are configured to ignore Robot logs larger than 50 kb. The vast majority of logs average around 2 kb.

Logging Levels

Messages are logged on the following levels: Trace,Debug,Info,Warn,Error and Fatal.

Custom messages can also be sent to this page from Studio, with the Log Message activity. The messages can be logged at all the levels described above and should be used for diagnostic purposes.

For example, in the screenshot below, you can see that we logged a custom message at a Fatal severity level.

Exporting Logs

All logs can be exported to a .csv file, by clicking the Export button. The filters applied to this page are taken into account when this file is generated. For example, if you set to view logs only from the last 30 days with an Info severity level, only the entries that meet these criteria are downloaded.

To ensure the best performance, please note that the exported entries are not in reverse chronological order.

Logs may not be in the proper order only in the following scenario:

• There are two or more robot log entries with almost equal timestamps - they are equal up to the millisecond (time expressed as yyyy-MM-dd HH\:mm\:ss.fff is the same), but differ in the millisecond's subunits (the last four values in yyyy-MM-dd HH\:mm\:ss.fffffff are different).
• The logs are viewed in Orchestrator with the default sort order in the grid (sort by Time descending).

However, this does not affect the database and exported .csv file.

Note: Both server exceptions from Orchestrator, and the stack trace on the Job Details window, are logged in English, regardless of what language was chosen by the user.

Permissions

You need View permission on Logs in the folder context to have access to logs generated in a folder.