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

Изменения

Логи системы

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