Exporting logs

This feature is only available if you are on the Enterprise licensing plan.

Configuring Robot Logs Export

To export Robot logs generated in your Orchestrator services to Azure, AWS S3, and Google Cloud Storage, see the specific procedures described below. Logs are saved in a .csv file in the uipathrobotlogs container. The export is done on a per-tenant basis which facilitates the following:

• Storing logs that must be retained for compliance and audit purposes.

• Analyzing and visualizing log output in your own reporting or BI tools.

  Note: The first time you enable this feature, all historical log data from Orchestrator is exported, up to a maximum of 30 days.

1. Log in to your Automation Cloud™ account.
2. Navigate to Admin and select the tenant in the panel on the left.
3. Click Services.
4. On the card for Orchestrator, click and select Log Export Configuration.

   The Configuration panel opens at the right of the window.

5. Enable the Send robot logs to custom storage toggle.
6. From the Storage Type drop-down, select the storage provider you want to export logs to. The following options are available:
   • Azure
   • AWS S3
   • Google Cloud Storage
   Note:

   The log export feature does not support AWS KMS.

7. After performing the provider-specific steps, the .csv is generated.
   Download .csv example
8. Logs will be delivered on an hourly basis. This time interval is not configurable.

Azure

1. From the Storage Type drop-down, select Azure Storage Account.
   
   

   

   
   
2. In the Azure Blob Connection String field, enter the blob connection string as retrieved from Azure Portal.
   
   

   

   
   
3. On the Container Name field, enter the name of the container used to store the .csv in Azure. By default, that is uipathrobotlogs. If a custom container name is provided and it does not yet exist, the container will be created for you.
4. Click Save. A notification is displayed letting you know that you successfully configured robot logs export.
5. In your Blob Storage Account in Azure Portal:
   • Click Network under Settings in the left-hand panel.
   • Select Allow access from > All networks.

   • Click Save to save the changes.

     
     

     

     
     
6. Within an hour, a .csv log file is generated in the blob storage. The .csv is generated in the uipathrobotlogs container, under the following folder hierarchy [tenant_key]/[year]/[month]/[day]/[hour]/output. It is recommended to map one tenant to a container, as the tenant key is the only way to distinguish between tenants if multiple are routed to one container.
   
   

   

   
   

AWS S3

1. From the Storage Type drop-down, select AWS S3.
   
   

   

   
   
2. In the Bucket Name field, enter the name of the bucket as configured in AWS.
   Note: The same bucket name cannot be shared by multiple organizations.
3. In the Region Name field, enter the name of the regions where logs are to be exported. E.g., us-west-1.
4. Make sure to grant the IAM user provided via the prompt s3:PutObject and s3:DeleteObject access to your bucket.

Google Cloud Storage

1. From the Storage Type drop-down, select Google Cloud Storage.
   
   

   

   
   
2. In the Bucket Name field, enter the name of the bucket as configured in Google Cloud Platform.
   Note: The same bucket name cannot be shared by multiple organizations.
3. Grant the appropriate access to the UiPath® service account, as specified in the prompt below.
   1. In Google Cloud Platform, navigate to Storage > Browser.
   2. Find the bucket for which you want to edit permissions.
   3. Click the vertical ellipsis and select Edit Bucket Permissions.
   4. Click Add members and enter the service account you use to access the bucket.
   5. From the Select a role drop-down, select Storage Object Admin. For more information, see Identity and Access Management in the GCP documentation.
      
      

      

      
      

Deleting Log Export Settings

1. Expand the tenant you want to delete log export settings for.
2. For the Orchestrator service in that tenant, click Log Export Configuration. The Configuration right-hand panel is displayed.
3. Disable the Send robot logs to custom storage toggle.
4. On the Delete Configuration window, click Delete to confirm. The configuration is successfully deleted.