When deploying the Autonomous REST Connector in a SaaS application, the Composer interface provides a dedicated Diagnostics tab to manage debug recording. The settings on this tab allow you to enable recording and download logs.

Note: For information about deploying the Autonomous REST Connector in a SaaS application, refer to Branding the Autonomous REST Composer and Deploying the Autonomous REST Connector in a SaaS application in the Progress DataDirect for JDBC Drivers Distribution Guide.

Recording and downloading logs

The following settings may be used for recording user sessions and downloading logs:


Diagnostics tab in the ARC Composer

  • Enable Recording: Use this setting to start diagnostic recording of system events, API calls, and error conditions. When enabled, a .rec file containing detailed session logs is written to the server. The .rec file is saved in the TEMP directory and named with a randomly generated ID linked to the user session.
  • Download Log File: Use this setting to download logs to your local system. The logs include timestamped events and system details for troubleshooting connection issues, analyzing performance, creating support tickets, and monitoring the system. The original .rec file is converted into individual snapshots and compressed into a ZIP archive. The ZIP file is named after the Model being created.

File management and system properties

The .rec files are managed on the server in the following way:

  • The .rec file is encrypted on the server and decrypted only when converted into individual snapshots for download.
  • By default, a .rec file records for a maximum duration of 24 hours to prevent excessive file growth. This limit can be modified using the system property DDTEK_RECORDING_FILEAGE_LIMIT.
  • The default maximum file size is 100 MB, which can be adjusted through the system property DDTEK_RECORDING_FILESIZE_LIMIT.
  • The system property DDTEK_RECORDING_CLEANUP_AFTER_N_REQUESTS specifies the maximum number of requests that can be stored before an error occurs.
  • The .rec files are automatically deleted when the client disconnects. As an additional safeguard, they are also removed after remaining on the server for more than 24 hours.
  • All .rec files are stored in the TEMP directory on the server machine.