Dialog log export

The platform provides access to daily logs for statistical analysis. Users can download the previous day’s logs for the entire account. The logs are provided in the .csv format.

How can I download dialog logs?

1. The account administrator should contact support with a request to activate the option to download dialog logs.

If you use one of the business plans (JAICP Business Standard, JAICP Business Pro, JAICP Business Pro+, JAICP Business Ultra, JAICP Business Enterprise), the option was automatically activated when switching to this plan.

2. After confirming that the option was enabled, the account administrator adds the RAWLOGS_ANALYTIC role to the users that should have permission to download dialog log files.

3. The user with the RAWLOGS_ANALYTIC role logs in to the platform and downloads dialog logs using this URL:

http(s)://<hostname>/restapi/rawlogs/dd-mm-yyyy.csv

Here,

• hostname is the name of the platform host, e.g. app.jaicp.com.
• dd, mm, and yyyy are the date, month, and year respectively.

When does log generation start?

Log generation starts when the option is first enabled. Dialog logs generated prior to the option being enabled are not available for download.

Daily logs are written to a file for the previous day as counted from the start time of the log generation task. By default, logs for the previous day are generated at 00:01 in the UTC−0 time zone. When dialog logs for the same day are generated, the previously saved file is overwritten.

Dialog logs in the Dialogs section are displayed in accordance with the time zone set in the user profile. However, the time zone in the exported file is always UTC−0.

How can I regenerate the log report?

The account administrator can regenerate log reports by calling the method above with the force=true parameter:

http(s)://<hostname>/restapi/rawlogs/run/{accountId}/dd-MM-yyyy?force=true

The new log report will be available for download in 10 minutes at the former address.

I have enabled removal of dialog logs

If the Cleanup dialogs option is active for the account or a project, logs older than the specified date will be completely removed for the entire account, regardless of the project.

Is there another way to download logs?

You can also download the file via HTTP GET requests. The download is available only to authenticated users that have the RAWLOGS_ANALYTIC role. Use basic authentication in the requests.

Exported data

The exported csv file contains the following columns. The column separator is ;.