На этой странице мы расскажем вам о работе с логированием на портале и разберем следующие вопросы:

Что такое логи и зачем они нужны

Логирование – это процесс фиксации изменений, которые происходят в системе при взаимодействии с ней.

Логи помогают контролировать изменения и видеть ответственных за их появление. Логирование ошибок помогает в диагностике проблем.

Как найти логи

Логи расположены в Административной части портала в разделе Логи

Open

Как понять какие логи мне нужны

Детально функционал описан ниже, в соответствующих разделах документации.

Лог авторизации

Раздел доступен пользователям с активным свитчером Логирование \ Административная часть

В раздел записывается информация о неуспешных и успешных попытках входа в систему, отсортированная по убыванию их даты. На одной странице выводится 20 записей логов, если записей больше, появляется пагинация.

Логи хранятся в течение 180 дней. Предупреждение об этом располагается вверху страницы

Open

Блок фильтрации состоит из:

• Выпадающие списки фильтрации по доступным параметрам:

  • Фильтрация записей в заданный диапазон логирования, по дате и времени – формат: с “ДД.ММ.ГГГГ ЧЧ:ММ” по “ДД.ММ.ГГГГ ЧЧ:ММ”

  • Учётная запись – доступен множественный выбор из списка пользователей

  • Статус – успешно или неуспешно

• Кнопка Применить – по нажатию применяются параметры и осуществляется фильтрация

• Кнопка Сбросить – появляется после выполненной фильтрации, по нажатию фильтрация сбрасывается и кнопка вновь скрывается

• Кнопка Сохранить xlsx – по нажатию выгружается таблица логов в файле формата .xlsx. Если ранее к таблице были применены фильтры, в таблицу выгружаются только отфильтрованные записи

Таблица с записями логов имеет следующую структуру:

• ID – уникальный номер записи

• Дата авторизации – дата и время попытки авторизации

• Учётная запись:

  • Если при попытке авторизации был введён логин, который можно сопоставить с имеющейся на платформе неудалённой учётной записью, выводится:

    • Аватар пользователя

    • Имя и фамилия пользователя – под которым пытались авторизоваться, где “имя и фамилия” это активная ссылка на редактирование пользователя в панели администрирования

    • Почта

  • Если был введён логин, которому не соответствует неудалённая учётная запись пользователя, выводится надпись Пользователь не обнаружен

• Логин – данные, которые были введены в поле Логин при авторизации. Пустое если аутентификация происходила при помощи OAuth

• Тип авторизации:

  • Локальная – при вводе логина и пароля, который хранится в БД Мотивити

  • 2FA – при подключенном втором факторе аутентификации на Мотивити. В этом случае по пользователю в логах будет отображено две строки: одна про успешную локальную авторизацию, вторая - про успешное или неуспешное прохождение второго фактора

  • ldap – при использовании аутентификации через ldap/s

  • OAuth/<Имя провайдера> – при использовании для аутентификации одного из методов OAuth, где имя провайдера может быть KeyCloak | AD FS | OKTA | Azure

  • Мобильный телефон - при вводе телефона на первом шаге авторизации (при авторизации с помощью SMS)

  • Одноразовый SMS-код - при вводе кода на втором шаге авторизации (при авторизации с помощью SMS)

При авторизации по SMS отдельными строками логируются событие ввода телефона на экране авторизации и последующие события ввода кода при их наличии.

Подробнее об авторизации по SMS Авторизация по кодам из SMS (СМС)Preview

• Статус:

  • Успешно – если пользователь был авторизован в Мотивити

  • Неуспешно – если:

    • Введённый пароль/код был неверен
      или

    • Внешняя система прислала отказ в аутентификации пользователя и он не был авторизован в Мотивити
      или

    • Пользователь ввёл пароль неверно 8 раз, был временно заблокирован, но продолжает попытки авторизоваться
      или

    • Пользователь пытается авторизоваться под удалённым или неактивным пользователем

• Номер попытки

  • Номера попыток для OAuth авторизации не записываются

  • Номера попыток на первый и второй фактор авторизации (Локальная и 2FA авторизация) считаются отдельно

  • Если пользователь был временно заблокирован после неудачного ввода логина и пароля (8 попыток подряд) и спустя время разблокировки начал вводить пароль снова, счётчик попыток начинает считаться с 1

  • Если пользователь продолжает попытки авторизации после того, как был временно заблокирован, до истечения срока блокировки, счётчик попыток продолжается ( из-за специфики блокировки авторизации могут некорректно считаться номера неудачных попыток в случае, если пользователь неудачно ввёл пароль 8 раз и был заблокирован, а потом вернулся до конца разблокировки и ввёл логин пароль ещё раз)

• IP-адрес – ip-адрес, с которого была произведена попытка авторизации

• Тип устройства

  • Мобильный – при авторизации со смартфона/планшета

  • Компьютер – при авторизации с компьютера или если авторизация происходила в браузере мобильного устройства работающего в режиме версии для ПК

• Браузер

  • <Имя браузера и его версия> – при авторизации через браузер

  • Мобильное приложение – при авторизации через мобильное приложение

Лог баллов

Open

Пример отображения страницы Лог баллов.
(1) Столбец ID; (2) Столбец Дата события; (3) Столбец Инициатор; (4) Столбец Действие; (5) Столбец Цель; (6) Столбец Изменение

На портале предусмотрено логирование всех действий администраторов по изменению конфигурации баллов:

• При изменении количества баллов за обучение и баллов кармы по активностям пользователей на портале – см. раздел Как настроить конфигурацию баллов

• И, при наличии модуля Каталог призов, при смене валюты каталога призов

Инструмент располагается в разделе Логи – Лог баллов. 

Фильтрация и сортировка не предусмотрены.

Поля в таблице:

• ID – уникальный номер записи

• Дата события – дата и время внесения изменений

• Инициатор – имя пользователя, который внес изменения. Активная ссылка в ЛК пользователя в Публичной части портала

• Действие:

  • Обновил

• Цель – название параметра, в котором внесены изменения.

• Изменения – обновление, которое совершил администратор в формате “Название поля: Было → Стало”
  Пример: Изменено значение параметра "Валюта для покупки призов": Старое - Из кармы, Новое - Из обучения

Таблица логов не выгружается в .xlsx-файле.

Лог действий

Open

Пример отображения страницы Лог действий.
(1) Поле поиска; (2) Фильтр по инициатору события; (3) Фильтр по действию; (4) Кнопка Сохранить xslx; (5) Поля для указания временного промежутка поиска; (6) Кнопка Применить; (7) Столбец ID; (8) Столбец Дата события; (9) Столбец Инициатор; (10) Столбец Действие; (11) Столбец Цель;
(12) Столбец Изменения; (13) Столбец Комментарий

Располагается в разделе Логи – Лог действий и фиксирует изменения в контенте и в данных пользователей.

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

Блок поиска и фильтрации состоит из:

• Выпадающие списки фильтрации по доступным параметрам:

  • Фильтрация записей в заданный диапазон логирования, по дате и времени – формат: с “ДД.ММ.ГГГГ ЧЧ:ММ” по “ДД.ММ.ГГГГ ЧЧ:ММ”.

  • Инициатор события – доступен множественный выбор из списка пользователей

  • Действие – доступен множественный выбор из списка возможных действий

• Поле ввода Поиск. Поиск осуществляется по следующим параметрам:

  • id записи лога

  • id сущности

• Кнопка Применить – по нажатию применяются параметры и осуществляется поиск и фильтрация

• Кнопка Сбросить – появляется после выполненного поиска/фильтрации, по нажатию поиск и фильтрация сбрасываются и кнопка вновь скрывается

• Кнопка Сохранить xlsx – по нажатию выгружается таблица логов в файле формата .xlsx

Поля в таблице:

• ID – уникальный номер записи

• Дата события – дата и время внесения изменений

• Инициатор

  • Имя и фамилия пользователя, который внес изменения через интерфейс платформы или был указан в запросе метода публичного API, где “имя и фамилия” – это активная ссылка в ЛК пользователя в публичной части портала, а кнопка “карандашик“ – ссылка на редактирование пользователя в панели администрирования

  • Система – если изменение было внесено при помощи вызова метода публичного API, в котором нельзя указать пользователя, вносившего изменения

• Действие – действие, которое совершил пользователь:

  • Обновил

  • Создал

  • Удалил

  • Восстановил

  • Отменил

  • Деактивировал

  • Активировал

  • Обновил пароль

  • Обновил назначения

  • Обновил доступы

• Цель – объект изменений

  • ФИО пользователя, для которого внесены изменения, где “имя и фамилия” – это активная ссылка в ЛК пользователя в публичной части портала, а кнопка “карандашик“ – ссылка на редактирование пользователя в панели администрирования

  • Название материала, в котором внесены изменения, где “название материала” – это активная ссылка на страницу материала в публичной части портала, а кнопка “карандашик“ – ссылка на редактирование материала в панели администрирования

    • Механика работы активной ссылки “Название материала“:

      • Если материал удален – ссылка не отображается

      • Если материал удален и неактивен – ссылка ведет на страницу материала в публичной части портала, но раз материал неактивен, отображается 404 ошибка

      • Если материал удален и активирован – ссылка ведет на страницу материала в публичной части портала

    • Важно! Для объектов, у которых нет своих страниц в публичной части (неактивен, удален) или в панели администрирования (удален и его нельзя восстановить), ссылка или кнопка “карандашик“ не выводятся.

• Изменение – список данных, которые были изменены в формате “Название поля: Было → Название поля: Стало”, при этом значение “Было” выводится на сером фоне, а “Стало” – на зеленом

• Комментарий – выводится дополнительная информация, например, информация о вызванном методе публичного API, с помощью которого произошло изменение данных пользователя

Лог действий Опросы

В логе действий, где Целью являются Опросы, в поле Изменения логируются следующие значения:

В логе действий, где Целью являются вопросы из базы вопросов в модуле Опросы, в поле Изменения логируются следующие значения:

Лог действий Тестирования

В логе действий, где Целью являются Тестирования, в поле Изменения логируются следующие значения: