Выгрузка логов диалогов

Платформа предоставляет доступ к ежедневным логам для анализа статистики диалогов. Пользователь самостоятельно может скачать логи со всего аккаунта за предыдущий день. Логи предоставляются в формате .csv.

Как скачать логи диалогов?

1. Администратор аккаунта должен обратиться в техническую поддержку с запросом на активацию опции скачивания логов диалогов.

Если вы используете один из бизнес-тарифов (JAICP Business Standard, JAICP Business Pro, JAICP Business Pro+, JAICP Business Ultra, JAICP Business Enterprise), то опция была автоматически подключена при переходе на этот тариф.

2. Затем администратор аккаунта добавляет роль RAWLOGS_ANALYTIC тем пользователям, которые должны иметь возможность скачивать файлы логов диалогов.

3. Пользователь с ролью RAWLOGS_ANALYTIC авторизуется на платформе и скачивает логи диалогов по адресу:

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

Здесь:

• hostname — имя хоста, где размещена платформа, например app.jaicp.com.
• dd, mm и yyyy — день, месяц и год соответственно.

Когда начнут формироваться логи?

Логи для выгрузки начинают формироваться с момента подключения опции. Логи диалогов, сформированные до подключения, недоступны для скачивания.

Ежедневные логи записываются в файл за предыдущий день от момента запуска задачи на генерацию. По умолчанию логи формируются в 00:01 по часовому поясу UTC−0. При формировании логов за один и тот же день предыдущий файл будет перезаписан.

Логи диалогов в разделе Диалоги отображаются согласно часовому поясу, установленному в профиле пользователя, но в выгружаемом файле — по UTC−0.

Как повторно сгенерировать отчет?

Администратор аккаунта может запустить повторную генерацию отчета, вызвав метод выше с параметром force=true:

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

Новый отчет будет доступен через 10 минут по прежнему адресу.

У меня включено удаление логов диалогов

Если для аккаунта или одного из проектов активна опция Удаление логов диалогов, то логи старше указанной даты будут удалены полностью для всего аккаунта независимо от проекта.

Есть другой способ скачать логи?

Файл также можно скачать по GET-запросу. Скачивание доступно только для аутентифицированного пользователя с ролью RAWLOGS_ANALYTIC. В запросах используйте basic-аутентификацию, а также указывайте в заголовках Product: botadmin.

Выгружаемые данные

В выгружаемом csv-файле представлены следующие колонки. Разделитель между колонками — ;.