UiPath Orchestrator Guide

Logging Configuration

The Web.config file (C:\Program Files (x86)\UiPath\Orchestrator) contains multiple settings that enable you to configure Orchestrator to your liking. Most of the parameters that interest you can be found under appSettings, but there might be some logging configurations that can be changed after install.

Note:

It is recommended that only administrators change the values of these parameters.
Additionally, it is recommended that you stop the IIS site in order to modify web.config settings under any circumstances.

Logging is divided as follows:

1. Robot: <logger name="Robot.*" writeTo="database,robotElasticBuffer" final="true" /> - The Robot logger, with the following parameters:

  • writeTo - The location at which the log messages generated by the Robot are written. By default, they are sent to both the Orchestrator's SQL database (database) and ElasticSearch (robotElasticBuffer). Delete one of the values to stop logging to that location.
  • final - A flag that indicates what to do when a match between a logged message and the logger name is found. When set to true, it does not look for another match. When set to false, other rules matching the same source are checked. By default, it is set to true.

2. Schedules: <logger name="Quartz.*" minlevel="Info" writeTo="eventLogQuartz" final="true" /> - Used to log messages generated by schedules.

Note:

To ensure a smooth run for schedules in an Orchestrator setup with a load balancer you should also set the quartz.jobStore.clustered parameter to true.

3. All others: <logger name="*" minlevel="Info" writeTo="eventLog" /> - Used to log all other messages besides the ones described above, including those generated by Orchestrator.

Other preferences to set up for ElasticSearch:

<target xsi:type="ElasticSearch" name="robotElastic" uri="<elasticSearch_url>" index="${event-properties:item=indexName}-${date:format=yyyy.MM}" documentType="logEvent" includeAllProperties="true" layout="${message}" excludedProperties="agentSessionId,tenantId,organizationUnitId,indexName" />

Configure:

  • uri - the ElasticSearch URL; note that you have to include the protocol and port, such as http://elastic_server:9200.
  • excludedProperties - data that you do not want to be saved to ElasticSearch.

Note:

If you maintain more than two million logs in the SQL database, you might have some performance issues. For more than that, we recommend using Elasticsearch.


See Also

App Settings

Logging Configuration