Логи системы: различия между версиями
(→Поиск логов) |
м |
||
Строка 6: | Строка 6: | ||
==Назначение== | ==Назначение== | ||
− | nemo.travel поддерживает гибкий инструмент логирования всех важных операций, происходящих в ней. Это помогает в | + | nemo.travel поддерживает гибкий инструмент логирования всех важных операций, происходящих в ней. Это помогает в кратчайшие сроки узнать детальную информацию практически по любому действию внутри системы. Интерфейс предоставляет широчайший выбор фильтров для выбора необходимых данных. Кроме того, имеется ряд предустановленных фильтров, которые выделены в отдельный блок и доступны по ссылкам. |
==Принцип работы== | ==Принцип работы== | ||
Строка 12: | Строка 12: | ||
Логи в зависимости от типа бывают: | Логи в зависимости от типа бывают: | ||
* индексируемые - ошибки, предупреждения и пр. Эти логи можно искать через фильтры логов. | * индексируемые - ошибки, предупреждения и пр. Эти логи можно искать через фильтры логов. | ||
− | * | + | * не индексируемые - сообщение и пр., доступны в теле одного лога-действия при открытии. |
− | Если после отработанного скрипта не было собрано ни одного лога с индексацией | + | Если после отработанного скрипта не было собрано ни одного лога с индексацией, логи не сохраняются. |
'''Принципы:''' | '''Принципы:''' | ||
Строка 55: | Строка 55: | ||
* '''Запуск''' — время запуска действия. | * '''Запуск''' — время запуска действия. | ||
* '''Пользователь''' — пользователь, запустивший действие. | * '''Пользователь''' — пользователь, запустивший действие. | ||
− | * '''Компонент''' — компонент, | + | * '''Компонент''' — компонент системы, к которому относится данное действие. |
* '''Действие''' — наименование действия. | * '''Действие''' — наименование действия. | ||
* '''Сообщение''' — короткое идентификационное сообщение, используется для поиска логов. | * '''Сообщение''' — короткое идентификационное сообщение, используется для поиска логов. | ||
Строка 107: | Строка 107: | ||
* ''[Нотификация] Email'' — e-mail нотификация. | * ''[Нотификация] Email'' — e-mail нотификация. | ||
* ''[Нотификация] Ошибка'' — ошибка при нотификации. | * ''[Нотификация] Ошибка'' — ошибка при нотификации. | ||
− | * ''[Ошибка] Валидация'' — ошибка при бэкенд валидации (формы например). | + | * ''[Ошибка] Валидация'' — ошибка при бэкенд-валидации (формы, например). |
* ''[Ошибка] Ограничение доступа'' — ошибка с запретом доступа кому-нибудь куда-нибудь. | * ''[Ошибка] Ограничение доступа'' — ошибка с запретом доступа кому-нибудь куда-нибудь. | ||
* ''[Ошибка] Блокировка'' — для неопределенных ошибок вызванных функцией контроллера ->lock(). | * ''[Ошибка] Блокировка'' — для неопределенных ошибок вызванных функцией контроллера ->lock(). | ||
− | * ''[Ввод/вывод] Запрос'' — получили входящий запрос | + | * ''[Ввод/вывод] Запрос'' — получили входящий запрос. |
* ''[Ввод/вывод] Ответ'' — ответ на входящий запрос. | * ''[Ввод/вывод] Ответ'' — ответ на входящий запрос. | ||
− | * ''[Ввод/вывод] Загрузка файла'' — кто-то | + | * ''[Ввод/вывод] Загрузка файла'' — кто-то загружает файл. |
− | * ''[Ввод/вывод] Локальный автозапрос'' — запуск http запроса к своему серверу. | + | * ''[Ввод/вывод] Локальный автозапрос'' — запуск http-запроса к своему серверу. |
− | * ''[Интеграция] Экспорт'' — экспорт | + | * ''[Интеграция] Экспорт'' — экспорт из системы. |
− | * ''[Интеграция] Импорт'' — импорт | + | * ''[Интеграция] Импорт'' — импорт в систему. |
* ''[Интеграция] Ошибка'' — ошибка импорта/экспорта. | * ''[Интеграция] Ошибка'' — ошибка импорта/экспорта. | ||
* ''[Авторизация] Через сайт'' — авторизация через сайт. | * ''[Авторизация] Через сайт'' — авторизация через сайт. | ||
Строка 288: | Строка 288: | ||
|Поиск логов по номеру заказа | |Поиск логов по номеру заказа | ||
|} | |} | ||
− | * '''По ошибке''' - если искомые | + | * '''По ошибке''' - если искомые заказы содержат известную ошибку: |
*# введите текст ошибки в поле ''Сообщение''. | *# введите текст ошибки в поле ''Сообщение''. | ||
*# нажмите кнопку ''Поиск''. | *# нажмите кнопку ''Поиск''. | ||
Строка 308: | Строка 308: | ||
Если в содержимом события находится не только XML, то из всего содержимого вычленяется и выводится только XML (например, выгрузка Немо/Софи). | Если в содержимом события находится не только XML, то из всего содержимого вычленяется и выводится только XML (например, выгрузка Немо/Софи). | ||
− | Для того чтобы браузер не подвисал из-за большого объема лога события (более 64000 символов) на главной странице логов (settings/logs) вместо содержимого выводится соответствующее сообщение. XML можно просмотреть в отдельном окне через специальный плагин. | + | Для того чтобы браузер не подвисал из-за большого объема лога события (более 64000 символов), на главной странице логов (settings/logs) вместо содержимого выводится соответствующее сообщение. XML можно просмотреть в отдельном окне через специальный плагин. |
== Примеры логирования == | == Примеры логирования == | ||
*Реквизиты подключения к GDS: | *Реквизиты подключения к GDS: | ||
− | ** При изменении реквизитов подключения к GDS | + | ** При изменении реквизитов подключения к GDS эти изменения и состояние настроек до них логируются. |
** При удалении реквизитов логируется id самих удаляемых реквизитов и какие данные содержались в этом id. | ** При удалении реквизитов логируется id самих удаляемых реквизитов и какие данные содержались в этом id. | ||
− | * Логирование изменения значения настройки - изменение настроек | + | * Логирование изменения значения настройки - изменение настроек также логируется: |
** дата и время изменения значения настройки; | ** дата и время изменения значения настройки; | ||
** полное название настройки; | ** полное название настройки; |
Версия 14:21, 6 мая 2016
Логи системы — модуль Nemo.Travel для учета действий и событий, происходящих в системе.
Содержание
Назначение
nemo.travel поддерживает гибкий инструмент логирования всех важных операций, происходящих в ней. Это помогает в кратчайшие сроки узнать детальную информацию практически по любому действию внутри системы. Интерфейс предоставляет широчайший выбор фильтров для выбора необходимых данных. Кроме того, имеется ряд предустановленных фильтров, которые выделены в отдельный блок и доступны по ссылкам.
Принцип работы
Логи в зависимости от типа бывают:
- индексируемые - ошибки, предупреждения и пр. Эти логи можно искать через фильтры логов.
- не индексируемые - сообщение и пр., доступны в теле одного лога-действия при открытии.
Если после отработанного скрипта не было собрано ни одного лога с индексацией, логи не сохраняются.
Принципы:
- индексировать только действительно полезные логи (выбирать тип события правильно).
- минимизировать объем данных, помещаемый в логи (например, не сохранять объект брони целиком).
Для поиска и просмотра логов зайдите в раздел Для техподдержки → Логи.
Раздел логов состоит из 3 основных частей:
- Форма фильтров.
- Блок предустановленных фильтров.
- Таблица логов.
Записи логов разбиты постранично, чтобы перейти к следующей странице, нажмите ссылку След.. внизу таблицы.
Страница логов |
Успешность действия - это признак одного Немо Тревел 1.0 запроса, например, для поиска — это получение хотя бы одного результата, для бронирования — успешная бронь и т.п.
Таблица логов
- Столбцы таблицы - параметры логов,
- Строки таблицы - записи действий.
Одна запись лога называется действием (по сути эквивалент одного php-скрипта). Действие содержит множество операций.
Каждая запись в таблице - действие. Чтобы открыть его операции, разверните запись, нажав на нее.
Некоторые операции сопровождаются ссылкой Данные, открывающей дополнительную информацию о событии (операции): тело XML-запроса, набор параметров или полное сообщение (если краткое обрезалось по длине) и т.п.
На каждое действие (лог) присутствует ссылка. Дополнительно могут быть ссылки Выгрузить архивом xml логи, Просмотр заказа, Просмотр результатов поиска, Форма поиска и др.
Зеленым цветом выделены логи, в которых происходило взаимодействие с ГРС.
Внимание! Логи поисковых запросов записываются в отдельную таблицу.
Параметры таблицы логов
- Запуск — время запуска действия.
- Пользователь — пользователь, запустивший действие.
- Компонент — компонент системы, к которому относится данное действие.
- Действие — наименование действия.
- Сообщение — короткое идентификационное сообщение, используется для поиска логов.
- Заказ — номер заказа.
- Поиск — номер поиска.
- Биллинг - номер транзакции по оплате.
- Поставщик — наименование задействованного поставщика услуг.
- Время выполнения — численное значение (в секундах).
- IP — адрес хоста, инициировавшего действие.
- доп. — дополнительная информация, например:
- статус действия (Успешно/Неуспешно);
- количество ошибок, если они произошли;
- режим работы системы, в котором было выполнено действие).
Фильтры логов
Для поиска логов используют фильтры. По умолчанию форма фильтров отображается на странице в свернутом виде, в котором доступны наиболее используемые параметры фильтрации:
- Пользователь - идентификатор пользователя,
- Заказ - идентификатор заказа,
- Сообщение - короткое идентификационное сообщение для поиска логов,
- Событие - перечень регистрируемых системой событий.
Чтобы получить доступ ко всем параметрам фильтра, нажмите кнопку Дополнительные фильтры (см. раздел Дополнительные фильтры).
Дополнительные фильтры
Полная форма фильтров включает в себя следующие поля:
Название | Описание |
---|---|
Пользователь | Идентификатор пользователя. |
Заказ | Идентификатор заказа |
Сообщение | Короткое идентификационное сообщение для поиска логов. |
Событие |
Перечень регистрируемых системой событий:
|
Действие | Выберите тип действия:
|
Поиск | |
Биллинг | |
Поставщик | |
Платежный шлюз | |
Объект-пользователь | |
Объект | |
ID действия | |
IP | |
Дата | |
За последние X секунд | |
С запросами к GDS | |
Тестовый режим | |
Успешность |
|
Предустановленные фильтры
Для быстроты поиска создан блок ссылок с предустановленными фильтрами:
- Мои логи (текущего пользователя).
- Мои логи (по IP).
- Проблемные выписки.
- Частичные выписки.
- Проблемные бронирования.
- Проблемные аннуляции.
Поиск записей логов
Поиск логов
Чтобы применить фильтрацию к логам:
- Выставите значения фильтров.
- Нажмите на кнопку Поиск.
Чтобы отменить фильтр, нажмите на кнопку Сброс.
Поиск логов по e-mail нотификациям указанного пользователя. |
Поиск логов поисковых запросов
Логи поисковых запросов записываются в отдельную таблицу.
Чтобы искать поисковые логи:
- Нажмите на кнопку Таблица логов поисковых запросов.
- Выставите значения фильтров.
- Нажмите на кнопку Поиск.
Чтобы отменить фильтр, нажмите на кнопку Сброс.
Ссылка на таблицу логов поисковых запросов |
Пример поиска логов поисковых запросов |
Примеры поиска логов
- По номеру заказа:
- введите номер заказа в поле Заказ,
- нажмите кнопку Поиск.
Поиск логов по номеру заказа |
- По ошибке - если искомые заказы содержат известную ошибку:
- введите текст ошибки в поле Сообщение.
- нажмите кнопку Поиск.
500px |
Поиск логов с ошибкой среди заказов указанного пользователя.png |
Логирование 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"