Логи системы — модуль Nemo.Travel для учета действий и событий, происходящих в системе.
Содержание
Назначение
nemo.travel поддерживает гибкий инструмент логирования всех важных операций, происходящих в ней. Это помогает в кротчайшие сроки узнать детальную информацию практически по любому действию внутри системы. Интерфейс предоставляет широчайший выбор фильтров для выбора необходимых данных. Кроме того, имеется ряд предустановленных фильтров, которые выделены в отдельный блок и доступны по ссылкам.
Принцип работы
Логи в зависимости от типа бывают:
- индексируемые - ошибки, предупреждения и пр. Эти логи можно искать через фильтры логов.
- неиндексируемые - сообщение и пр., доступны в теле одного лога-действия при открытии.
Если после отработанного скрипта не было собрано ни одного лога с индексацией - логи не сохраняются.
Принципы:
- индексировать только действительно полезные логи (выбирать тип события правильно).
- минимизировать объем данных, помещаемый в логи (например, не сохранять объект брони целиком).
Для поиска и просмотра логов зайдите в раздел Для техподдержки → Логи.
Раздел логов состоит из 3 основных частей:
- Форма фильтров.
- Блок предустановленных фильтров.
- Таблица логов.
Записи логов разбиты постранично, чтобы перейти к следующей странице, нажмите ссылку След.. внизу таблицы.
|
| Страница логов |
Таблица логов
- Столбцы таблицы - параметры логов,
- Строки таблицы - записи действий.
Одна запись лога называется действием (по сути эквивалент одного php-скрипта). Действие содержит множество операций.
Каждая запись в таблице - действие. Чтобы открыть его операции, разверните запись, нажав на нее.
На каждое действие (лог) присутствует ссылка. Дополнительно могут быть ссылки Выгрузить архивом xml логи, Просмотр заказа, Просмотр результатов поиска, Форма поиска и др.
Данные — дополнительная информация о событии (операции). Там может быть тело XML-запроса, набор параметров, полное сообщение (если краткое обрезалось по длине) и т.п.
Зеленым цветом выделены логи, в которых происходило взаимодействие с ГРС.
Внимание! Логи поисковых запросов записываются в отдельную таблицу.
Параметры таблицы логов
- Запуск — время запуска действия.
- Пользователь — пользователь, запустивший действие.
- Компонент — компонент, системы к которому относится данное действие.
- Действие — наименование действия.
- Сообщение — короткое идентификационное сообщение, используется для поиска логов.
- Заказ — номер заказа.
- Поиск — номер поиска.
- Биллинг - номер транзакции по оплате.
- Поставщик — наименование задействованного поставщика услуг.
- Время выполнения — численное значение (в секундах).
- IP — адрес хоста, инициировавшего действие.
- доп. — дополнительная информация, например:
- статус действия (Успешно/Неуспешно);
- количество ошибок, если они произошли;
- режим работы системы, в котором было выполнено действие).
Данные
Данные — дополнительная информация о событии (операции). Там может быть тело XML-запроса, набор параметров, полное сообщение (если краткое обрезалось по длине) и т.п.
Поиск записей логов
Фильтры логов
Для поиска логов используют фильтры. По умолчанию форма фильтров отображается на странице в свернутом виде, в котором доступны наиболее используемые параметры фильтрации:
- Пользователь - идентификатор пользователя,
- Заказ - идентификатор заказа,
- Сообщение - короткое идентификационное сообщение для поиска логов,
- Событие - перечень регистрируемых системой событий.
Чтобы получить доступ ко всем параметрам фильтра, нажмите кнопку Дополнительные фильтры (см. раздел Дополнительные фильтры).
Чтобы применить фильтрацию к логам:
- Выставите значения фильтров,
- Нажмите на кнопку Поиск.
чтобы отменить фильтр, нажмите на кнопку Сброс.
Примеры поиска логов =
- По номеру заказа:
- введите номер заказа в поле заказ,
- нажмите кнопку поиск.
- По ошибке - если в тикете указана ошибка, для поиска логов ее нужно ввести в поле сообщение.
Дополнительные фильтры
Полная форма фильтров включает в себя следующие поля:
| Название | Описание |
|---|---|
| Пользователь | Идентификатор пользователя. |
| Заказ | Идентификатор заказа |
| Сообщение | Короткое идентификационное сообщение для поиска логов. |
| Событие |
Перечень регистрируемых системой событий:
|
| Действие | Выберите тип действия:
|
| Поиск | |
| Биллинг | |
| Поставщик | |
| Платежный шлюз | |
| Объект-пользователь | |
| Объект | |
| ID действия | |
| IP | |
| Дата | |
| За последние X секунд | |
| С запросами к GDS | |
| Тестовый режим | |
| Успешность |
|
Успешность действия
Успешность действия - это признак одного Немо Тревел 1.0 запроса, например, для поиска — это получение хотя бы одного результата, для бронирования — успешная бронь и т.п.
Предустановленные фильтры
Для удобства пользователей, ряд фильтров вынесен в отдельный блок и для их использования нет необходимости заносить какие-либо значения в форму с параметрами фильтра. В блоке предустановленных фильтров доступны следующие варианты:
- Мои логи (текущего пользователя)
- Мои логи (по IP)
- Проблемные выписки
- Частичные выписки
- Проблемные бронирования
- Проблемные аннуляции
Логирование XML-данных
Модуль осуществляет логирование:
- пакетной выгрузки заказов из ЛК в форматах Nemo/SOFI,
- выгрузки статистики метапоиска,
- экспорта пользователей.
Для первых двух выгрузок, одиночных выгрузок заказов и обращений к GDS доступно скачивание каждого лога отдельно.
Если в содержимом события находится не только XML, то из всего содержимого вычленяется и выводится только XML (например, выгрузка Немо/Софи).
Для того чтобы браузер не подвисал из-за большого объема лога события (более 64000 символов) на главной странице логов (settings/logs) вместо содержимого выводится соответствующее сообщение. XML можно просмотреть в отдельном окне через специальный плагин.
Примеры логирования
- Реквизиты подключения к GDS:
- При изменении реквизитов подключения к GDS, эти изменения и состояние настроек до них логируются.
- При удалении реквизитов логируется id самих удаляемых реквизитов и какие данные содержались в этом id.
- Логирование изменения значения настройки - изменение настроек так же логируется:
- дата и время изменения значения настройки;
- полное название настройки;
- пользователь, изменивший значение настройки;
- предыдущее значение настройки;
- текущее значение настройки.
Пример:
2014-10-06 15:33:41.915 [Пользователи] Изменение "user.param.time_zone" (Данные)
Array
(
[oldValue] => Pacific/Fakaofo
[newValue] => Indian/Antananarivo
)
Возможные ошибки
SOAP ERROR ошибки
В случае если тело SOAP запроса не соответствует схеме запроса, то в сообщении лога можно будет увидеть
Ошибка "SoapFault exception: [WSDL] SOAP-ERROR: Parsing WSDL: Couldn't load from '%адрес_схемы%' : faile"