Открыть главное меню

Изменения

Логи системы

1704 байта добавлено, 14:18, 29 июля 2020
Нет описания правки
[[Категория:Функции]]
<!-- -->
[[Файл:Общий_вид_интерфейса_логов_2.png|thumb|300px|Пример окна логов системы {{NameSystem}}]]'''Логи системы''' — модуль системы онлайн-бронирования {{NameSystem|link}}, содержащий подробный журнал для учета действий и событий, происходящих в системе.
==Назначение==
Система онлайн-бронирования nemo.travel поддерживает гибкий инструмент логирования всех важных операций, происходящих в ней. Это помогает в кротчайшие кратчайшие сроки узнать детальную информацию практически по любому действию внутри системы. Интерфейс предоставляет широчайший выбор фильтров для выбора необходимых данных. Кроме того, имеется ряд предустановленных фильтров, которые выделены в отдельный блок и доступны по ссылкам.
==Принцип работы==
Логи в зависимости от типа бывают:
* индексируемые - ошибки, предупреждения и пр. Эти логи можно искать через фильтры в административной панели управления (/settings__logs)логов.* неиндексируемые - не индексируемые — сообщение и пр., доступны в теле одного лога-действия при открытии.
Если после отработанного скрипта не было собрано ни одного лога с индексацией - , логи не сохраняются.
'''Принципы:'''
*индексировать только действительно полезные логи (выбирать тип события правильно).*минимизировать объем данных, помещаемый в логи (например, не сохранять объект брони целиком)[[Файл:Форма_фильтров_логов_полная.png|thumb|300px|Полная форма фильтров логов]][[Файл:Предустановленные_фильтры_логов.png|thumb|300px|Предустановленные фильтры логов]]<!--[[Файл:Фрагмент_логов.png|thumb|300px|Фрагмент записей логов]][[Файл:Детальная_информация_лога.png|thumb|300px|Пример детальной информации лога]][[Файл:Детальная_информация_лога_2.png|thumb|300px|Пример детальной информации лога]]-->
Для поиска и просмотра логов зайдите в раздел '''Для техподдержки → Логи'''.
Страница Раздел логов состоит из 3 основных частей:
* Форма фильтров.
* Блок предустановленных фильтров.
* Таблица логов.
Записи логов разбиты постранично, чтобы перейти к следующей странице, нажмите ссылку '''След..''' внизу таблицы.
{{Attention|Логи поисковых запросов записываются в отдельную таблицуclass="wikitable"|-|[[Файл:Общий_вид_интерфейса_логов_2.}png|1200px]]|-|Страница логов|}
'''Успешность действия''' — это признак одного {{NameProject1}} запроса, например, для поиска — это получение хотя бы одного результата, для бронирования — успешная бронь и т.п. ==Поиск записей Таблица логов==* '''Столбцы таблицы''' — параметры логов,* '''Строки таблицы''' — записи действий. Одна запись лога называется '''действием''' (по сути эквивалент одного php-скрипта). Действие содержит множество '''операций'''.
=== Фильтры логов ===Для поиска логов используют фильтрыКаждая запись в таблице — действие. По умолчанию форма фильтров отображается Чтобы открыть его операции, разверните запись, нажав на странице в свернутом виденее. <br /> Некоторые операции сопровождаются ссылкой '''Данные''', в котором доступны наиболее используемые параметры фильтрацииоткрывающей дополнительную информацию о событии (операции):тело XML-запроса, набор параметров или полное сообщение (если краткое обрезалось по длине) и т.п.
*На каждое действие (лог) присутствует ссылка. Дополнительно могут быть ссылки ''Выгрузить архивом xml логи'Пользователь', '' - идентификатор пользователя*'''Заказ''' - идентификатор Просмотр заказа*'''Сообщение', '' - короткое идентификационное сообщение для Просмотр результатов поиска логов*'', 'Событие'Форма поиска'' - перечень регистрируемых системой событийи др.
Чтобы получить доступ ко всем параметрам фильтраЗеленым цветом выделены логи, нажмите кнопку ''«Дополнительные фильтры»'' (см. [[Логи системы#Дополнительные фильтры|Дополнительные фильтры]])в которых происходило взаимодействие с ГРС.
Чтобы фильтр применился к логам, необходимо нажать на кнопку ''«Поиск»'', чтобы отменить фильтр, нужно воспользоваться кнопкой ''«Сброс»''{{Attention|Логи поисковых запросов записываются в отдельную таблицу.}}
===Параметры таблицы логов===
* '''Запуск''' — время запуска действия.
* '''Пользователь''' — пользователь, запустивший действие.
* '''Компонент''' — компонент системы, к которому относится данное действие.
* '''Действие''' — наименование действия.
* '''Сообщение''' — короткое идентификационное сообщение, используется для поиска логов.
* '''Заказ''' — номер заказа.
* '''Поиск''' — номер поиска.
* '''Биллинг''' — номер транзакции по оплате.
* '''Поставщик''' — наименование задействованного поставщика услуг.
* '''Время выполнения''' — численное значение (в секундах).
* '''IP''' — адрес хоста, инициировавшего действие.
* '''доп.''' — дополнительная информация, например:
** статус действия (''Успешно''/''Неуспешно'');
** количество ошибок, если они произошли;
** режим работы системы, в котором было выполнено действие).
 
==Фильтры логов ==
Для поиска логов используют фильтры. По умолчанию форма фильтров отображается на странице в свернутом виде, в котором доступны наиболее используемые параметры фильтрации:
 
*'''Пользователь''' — идентификатор пользователя,
*'''Заказ''' — идентификатор заказа,
*'''Сообщение''' — короткое идентификационное сообщение для поиска логов,
*'''Событие''' — перечень регистрируемых системой событий.
 
Чтобы получить доступ ко всем параметрам фильтра, нажмите кнопку ''Дополнительные фильтры'' (см. раздел [[Логи системы#Дополнительные фильтры|Дополнительные фильтры]]).
==== Дополнительные фильтры ====
Полная форма фильтров включает в себя следующие поля:
* {{Setting|Пользователь}} — идентификатор пользователя.class="wikitable mw-collapsible mw-uncollapsed"* {{Setting|Заказ}} — идентификатор заказа.-* {{Setting! scope="col" |Сообщение}} — короткое идентификационное сообщение для поиска логов.Название* {{Setting! scope="col" |Событие}} — перечень регистрируемых системой событий:Описание** '''Любой'''** '''Регистрация действия'''** '''[GDS] Запрос''' — запрос к внешней системе.** '''[GDS] Ответ''' — ответ от внешней системы.** '''[GDS] Ошибка''' — получена ошибка от внешней системы.** '''[Нотификация] Событие''' — что|-то кому-то отправлено (сообщение).** | width="20%"|'''[Нотификация] SMSПользователь ''' — SMS нотификация.** '''[Нотификация] Email''' — e-mail нотификация| width="80%"| Идентификатор пользователя.** '''[Нотификация] Ошибка''' — ошибка при нотификации.** '''[Ошибка] Валидация''' — ошибка при бэкенд валидации (формы например).** '''[Ошибка] Ограничение доступа''' — ошибка с запретом доступа кому-нибудь куда|-нибудь.** |'''[Ошибка] БлокировкаЗаказ''' — для неопределенных ошибок вызванных функцией контроллера ->lock().** '''[Ввод/вывод] Запрос''' — получили входящий запрос (колбек какой-нибудь).|Идентификатор заказа** '''[Ввод/вывод] Ответ''' — ответ на входящий запрос.** '''[Ввод/вывод] Загрузка файла''' — кто|-то вгружает файл.** |'''[Ввод/вывод] Локальный автозапросСообщение''' — запуск http запроса к своему серверу.** '''[Интеграция] Экспорт''' — экспорт в систему|Короткое идентификационное сообщение для поиска логов.** '''[Интеграция] Импорт''' — импорт из системы.** '''[Интеграция] Ошибка''' — ошибка импорта/экспорта.** '''[Авторизация] Через сайт''' — авторизация через сайт.** '''[Авторизация] Через внешнюю систему''' — авторизация через удаленную систему.** '''[Авторизация] Выход''' — logout.** '''[Авторизация] Ошибка''' — ошибка при авторизации.** '''[Регистрация] Запрос''' — регистрация.** '''[Регистрация] Подтверждение''' — подтверждение регистрации.** '''[Регистрация] автоматическая''' — авторегистрация.** '''[Пользователи] Изменение''' — в пользователе/группе что|-то меняется.** |'''[Пользователи] Создание новогоСобытие''' — новый пользователь.** '''[Пользователи] Создание компании''' — новая компания/агентство.** '''[Пользователи] Создание группы''' — новая группа.** '''[Пользователи] Изменение пароля''' — изменение пароля.** '''[Пользователи] Удаление''' — удаление пользователя.** '''[Заказ] Ошибка при бронировании'''** '''[Заказ] Ошибка при аннуляция'''** '''[Заказ] Ошибка при выписке'''** '''[Заказ] Ошибка при обновлении'''** '''[Заказ] Ошибка при модификации'''** '''[Заказ] Операция'''** '''[DB] Новая запись'''** '''[DB] Обновление записи'''** '''[DB] Удаление записи'''** '''[Система] Якорь (для индексации)'''** '''[API] Запрос''' — запрос к агентским сервисам.** '''[API] Ответ''' — ответ от агентских сервисов.** '''[API] Ошибка''' — ошибка агентских сервисов.** '''[Оплата] Смена статуса''' — смена статуса оплаты.** '''[Оплата] Запрос к шлюзу''' — запрос к платежному шлюзу.** '''[Оплата] Ответ от шлюза''' — ответ от платежного шлюза.** '''[Оплата] Ошибка''' — ошибка платежного шлюза.** '''[Оплата] Переход на страницу шлюза''' ** '''[Оплата] Смена способа оплаты'''|** '''[Депозит] Изменение депозита'''** '''[Депозит] Изменение кредитного лимита'''** '''[Депозит] Доступные средства'''** '''Предупреждение'''* {{Setting|Действие}} — перечень Перечень регистрируемых в системе действий.** Любой** Неустановленное** Регистрация** Авторизация** Авторизация (дополнительно)** Выход** Настройки** Форма поиска** Процесс поиска** Результаты поиска** Запрос данных по услуге** Ввод информации о заказчике** Ввод информации о пассажирах** Бронирование** Отображение информации о заказе** Оплата** Неопределенное действие с заказом** Подтверждение** Выписка** Отмена выписки** Возврат денег** Просмотр информации** Дополнительный клиентский запрос** Обновление** Тестовый скрипт** Модификация заказа** Автоматическое действие** Системное действие** Форма (прочее)** Мои пассажиры** Сообщения и заявки** Документы* {{Setting|Поиск}}* {{Setting|Биллинг}}* {{Setting|Поставщик}}* {{Setting|Платежный шлюз}}* {{Setting|Объект-пользователь}}* {{Setting|Объект}}* {{Setting|ID действия}}* {{Setting|IP}}* {{Setting|Дата}}* {{Setting|За последние X секунд}}* {{Setting|С запросами к GDS}}* {{Setting|Тестовый режим}}* {{Setting|Успешность}} ** Любой** Успешные** Не успешныесистемой событий:
* ''Любой''.* ''Регистрация действия''.* ''[GDS] Запрос'' — запрос к внешней системе.* ''[GDS] Ответ'' — ответ от внешней системы.* ''[GDS] Ошибка'' — получена ошибка от внешней системы.* ''[Нотификация] Событие'' — что-то кому-то отправлено (сообщение).* ''[Нотификация] SMS'' — SMS нотификация.* ''[Нотификация] Email'' — e-mail нотификация.* ''[Нотификация] Ошибка'' — ошибка при нотификации.* ''[Ошибка] Валидация'' — ошибка при бэкенд-валидации (формы, например).* ''[Ошибка] Ограничение доступа'' — ошибка с запретом доступа кому-нибудь куда-нибудь.* ''[Ошибка] Блокировка'' — для неопределенных ошибок вызванных функцией контроллера ->lock().* ''[Ввод/вывод] Запрос'' — получили входящий запрос.* ''[Ввод/вывод] Ответ'' — ответ на входящий запрос.* ''[Ввод/вывод] Загрузка файла'' — кто-то загружает файл.* ''[Ввод /вывод] Локальный автозапрос'' — запуск http-запроса к своему серверу.* ''[Интеграция] Экспорт'' — экспорт из системы.* ''[Интеграция] Импорт'' — импорт в поле «Идентификатор пользователя» ограничен использованием целых положительных чиселсистему.* ''[Интеграция] Ошибка'' — ошибка импорта/экспорта. На остальные поля ввода строгие ограничения не накладываются, однако, необходимо вводить значения логически подходящие под конкретное поле, иначе фильтр просто не вернет результатов* ''[Авторизация] Через сайт'' — авторизация через сайт.* ''[Авторизация] Через внешнюю систему'' — авторизация через удаленную систему.* ''[Авторизация] Выход'' — logout.* ''[Авторизация] Ошибка'' — ошибка при авторизации.* ''[Регистрация] Запрос'' — регистрация.* ''[Регистрация] Подтверждение'' — подтверждение регистрации.* ''[Регистрация] автоматическая'' — авторегистрация.* ''[Пользователи] Изменение'' — в пользователе/группе что-то меняется.* ''[Пользователи] Создание нового'' — новый пользователь.* ''[Пользователи] Создание компании'' — новая компания/агентство.* ''[Пользователи] Создание группы'' — новая группа.* ''[Пользователи] Изменение пароля'' — изменение пароля.* ''[Пользователи] Удаление'' — удаление пользователя.* ''[Заказ] Ошибка при бронировании''* ''[Заказ] Ошибка при аннуляция''* ''[Заказ] Ошибка при выписке''* ''[Заказ] Ошибка при обновлении''* ''[Заказ] Ошибка при модификации''* ''[Заказ] Операция''* ''[DB] Новая запись''* ''[DB] Обновление записи''* ''[DB] Удаление записи''* ''[Система] Якорь (для индексации)''* ''[API] Запрос'' — запрос к агентским сервисам.* ''[API] Ответ'' — ответ от агентских сервисов.* ''[API] Ошибка'' — ошибка агентских сервисов.* ''[Оплата] Смена статуса'' — смена статуса оплаты.* ''[Оплата] Запрос к шлюзу'' — запрос к платежному шлюзу.* ''[Оплата] Ответ от шлюза'' — ответ от платежного шлюза.* ''[Оплата] Ошибка'' — ошибка платежного шлюза.* ''[Оплата] Переход на страницу шлюза'' * ''[Оплата] Смена способа оплаты''* ''[Баланс] Изменение баланса''* ''[Баланс] Изменение доступного овердрафта''* ''[Баланс] Доступные средства''* ''Предупреждение''|-|Действие|Выберите тип действия:* ''Любой''* ''Неустановленное''* ''Регистрация''* ''Авторизация''* ''Авторизация (дополнительно)''* ''Выход''* ''Настройки''* ''Форма поиска''* ''Процесс поиска''* ''Результаты поиска''* ''Запрос данных по услуге''* ''Ввод информации о заказчике''* ''Ввод информации о пассажирах''* ''Бронирование''* ''Отображение информации о заказе''* ''Оплата''* ''Неопределенное действие с заказом''* ''Подтверждение''* ''Выписка''* ''Отмена выписки''* ''Возврат денег''* ''Просмотр информации''* ''Дополнительный клиентский запрос''* ''Обновление''* ''Тестовый скрипт''* ''Модификация заказа''* ''Автоматическое действие''* ''Системное действие''* ''Форма (прочее)''* ''Мои пассажиры''* ''Сообщения и заявки''* ''Документы''|-|Поиск||-|Биллинг||-|Поставщик||-|Платежный шлюз||-|Объект-пользователь||-|Объект||-|ID действия||-|IP||-|Дата||-|За последние X секунд||-|С запросами к GDS||-|Тестовый режим||-|Успешность|* Любой* Успешные* Не успешные|-
===== Успешность действия =====Успешность действия это признак всего действия (одного пхп запроса), например, для поиска — это получение хотя бы одного результата, для бронирования — успешная бронь и т.п.|}
=== Предустановленные фильтры ===
Для удобства пользователей, ряд фильтров вынесен в отдельный быстроты поиска создан блок и для их использования нет необходимости заносить какие-либо значения в форму ссылок с параметрами фильтра. В блоке предустановленных фильтров доступны следующие вариантыпредустановленными фильтрами:* Мои логи (текущего пользователя) .* Мои логи (по IP) .* Проблемные выписки .* Частичные выписки .* Проблемные бронирования .* Проблемные аннуляции. ==Поиск записей логов=====Поиск логов===Чтобы применить фильтрацию к логам:# Выставите значения фильтров.# Нажмите на кнопку ''Поиск''.<br />Чтобы отменить фильтр, нажмите на кнопку ''Сброс''.{| class="wikitable"|-|[[Файл:Поиск логов.png|500px]]|-|Поиск логов по e-mail нотификациям указанного пользователя.|} ===Поиск логов поисковых запросов===Логи поисковых запросов записываются в отдельную таблицу. Чтобы искать поисковые логи: # Нажмите на кнопку ''Таблица логов поисковых запросов''.# Выставите значения фильтров.# Нажмите на кнопку ''Поиск''.<br />Чтобы отменить фильтр, нажмите на кнопку ''Сброс''.
{| class=== Записи логов ==="wikitable"|-|[[Файл:Фрагмент_логовКнопка_Таблица_логов_поисковых_запросов.png|thumb500px]]|600px-|Таблица Ссылка на таблицу логов]]поисковых запросов[[Файл:Детальная_информация_лога.png|thumb} {|600pxclass="wikitable"|Детальная информация лога]]-|[[Файл:Детальная_информация_лога_2Поиск_логов_поиска.png|thumb|600px|Пример детальной информации лога500px]]Таблица логов состоит из набора параметров:|-* '''Запуск''' — время запуска действия.* '''Пользователь''' — кто запустил данное действие.* '''Компонент''' — к какой компоненте системы относится данное действие.* '''Действие''' — формальное наименование действия.* '''Сообщение''' — короткое идентификационное сообщение для |Пример поиска логов.поисковых запросов* '''Объект''' — любое вспомогательное числовое значение (например количество результатов в поиске).* '''Заказ''' — номер заказа.* '''Поиск''' — номер поиска.* '''Поставщик''' — формальное наименование задействованного поставщика услуг.* '''Время выполнения''' — численное значение (в секундах).* '''IP''' — адрес хоста, с которого запущено действие.* '''доп.''' — дополнительная информация по действию. Обычно в этом поле указывается статус действия («Успешно»/«Неуспешно»; количество ошибок, если они произошли; режим работы системы, в котором было выполнено действие).|}
Одна запись лога называется '''действием''' (по сути эквивалент одного php-скрипта). Действие содержит множество '''операций'''.===Поиск восстановленных логов===
На каждое действие (лог) присутствует ссылкаПосле перехода по ссылке '''Поиск восстановленных логов''', поиск будет вестись в специальном хранилище логов, которые по какой-либо причине были утрачены, а затем восстановлены.
Дополнительно могут быть ссылки ''«Выгрузить архивом xml логи»'', ''«Просмотр заказа»'', ''«Просмотр результатов поиска»'', ''«Форма поиска»'' и др.=== Примеры поиска логов ===
* '''По номеру заказа''':*# введите номер заказа в поле ''Заказ'',*# нажмите кнопку ''Поиск''.{| class==== Данные ===="wikitable"|-|[[Файл:Поиск_логов_по_номеру_заказа.png|500px]]|-|Поиск логов по номеру заказа|}* '''ДанныеПо ошибке''' — дополнительная информация о событии (операции)если искомые заказы содержат известную ошибку:*# введите текст ошибки в поле ''Сообщение''. Там может быть тело XML*# нажмите кнопку ''Поиск''.{| class="wikitable"|-запроса, набор параметров, полное сообщение (если краткое обрезалось |[[Файл:Поиск заказов пользователя по длине) и тошибке.пpng|500px]]|-|Поиск логов с ошибкой среди заказов указанного пользователя.png|}
== Логирование XML-данных ==
Если в содержимом события находится не только XML, то из всего содержимого вычленяется и выводится только XML (например, выгрузка Немо/Софи).
Для того , чтобы браузер не «подвисал» подвисал из-за большого объема лога события (более 64000 символов) , на главной странице логов (settings/logs) вместо содержимого выводится соответствующее сообщение. XML можно просмотреть в отдельном окне через специальный плагин.
== Примеры логирования ==
=== Реквизиты подключения к GDS ===В {{NameSystem}} логируются следующие действия:* При изменении реквизитов подключения к GDSизменение настроек в панели администрирования, эти изменения * действие с заказом (в т.ч. нотификации, выгрузки, оплаты, фиксации статусов и состояние настроек до них логируютсят.д.),* При удалении реквизитов логируется id самих удаляемых реквизитов поиск,* авторизация / регистрация на сайте,* действие в ЛК (экспорт заказов, отправка сообщений/заявок и какие данные содержались в этом idт.д.).
=== Логирование изменения значения настройки Особенности логирования действий в {{NameSystem}}===Любое изменение настройки логируется* Реквизиты подключения к ГРС:* дата * При изменении реквизитов подключения к ГРС эти изменения и время изменения значения настройки;состояние настроек до них логируются.* полное название настройки;* пользователь, изменивший значение настройки;* предыдущее значение настройки;* текущее значение настройкиПри удалении реквизитов логируется id самих удаляемых реквизитов и какие данные содержались в этом id.
* Логирование изменения значения настройки — изменение настроек также логируется:
** дата и время изменения значения настройки;
** полное название настройки;
** пользователь, изменивший значение настройки;
** предыдущее значение настройки;
** текущее значение настройки.<br />
Пример:
<pre>
)
</pre>
 == Примеры поиска логов == Если в тикете указана ошибка, для поиска логов ее нужно ввести в поле ''сообщение''.<!--
== Возможные ошибки ==
=== SOAP ERROR ошибки ===
В случае если тело SOAP запроса не соответствует схеме запроса, то в сообщении лога можно будет увидеть <pre>Ошибка "SoapFault exception: [WSDL] SOAP-ERROR: Parsing WSDL: Couldn't load from '%адрес_схемы%' : faile"</pre>
 
-->
 
== Ошибки возникающие при оплате ==
* '''Блокировка "Оплата запрещена для данного заказа"''' - эту ошибку можно встретить в Админ-панели Nemo в логах когда заказ еще не забронирован и пользователь попытался оплатить; либо когда заказ забронирован, но нет в доступных действиях по заказу операции выписки; либо когда заказ выписан и нет доп.услуг для довыписки. При попытке оплаты система осуществляет эти проверки и блокирует оплату в указанных случаях.
== См. также ==
'