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

Изменения

Логи системы

10 855 байт добавлено, 14:18, 29 июля 2020
Нет описания правки
[[ФайлКатегория:Общий_вид_интерфейса_логов_2.png|thumb|200px|Пример окна логов системы NemoТермины]][[Категория:Функции]]<!-- -->'''Логи системы''' - административный раздел системы Nemo, содержащий подробный журнал [[#Действие— модуль {{NameSystem|link}} для учета действий]] и [[#Операция|операций]]событий, происходящих в системе. Система онлайн-бронирования Nemo включает в себя гибкий инструмент логирования всех важных операций, происходящих в ней, что позволяет в кротчайшие сроки узнавать детальную информацию практически по любому действию внутри системы. Интерфейс предоставляет широчайший выбор фильтров для выбора необходимых данных. Кроме того, имеется ряд предустановленных наиболее часто используемых фильтров, которые выделены в отдельный блок и доступны по ссылкам.
[[Файл:Форма_фильтров_логов_сокращенная.png|thumb|200px|Сокращенная форма фильтров логов]][[Файл:Форма_фильтров_логов_полная.png|thumb|200px|Полная форма фильтров логов]][[Файл:Предустановленные_фильтры_логов.png|thumb|200px|Предустановленные фильтры логов]][[Файл:Фрагмент_логов.png|thumb|200px|Фрагмент записей логов]]==Назначение==
==Пользовательский интерфейс==nemo.travel поддерживает гибкий инструмент логирования всех важных операций, происходящих в ней. Это помогает в кратчайшие сроки узнать детальную информацию практически по любому действию внутри системы. Интерфейс пользователя состоит из 3 основных частей:* формы предоставляет широчайший выбор фильтров* блока для выбора необходимых данных. Кроме того, имеется ряд предустановленных фильтров* записей логов, разбитых постранично (доступ к страницам осуществляется с помощью меню пагинации)которые выделены в отдельный блок и доступны по ссылкам.
===Форма фильтров=Принцип работы== Логи в зависимости от типа бывают:* индексируемые — ошибки, предупреждения и пр. Эти логи можно искать через фильтры логов.* не индексируемые — сообщение и пр., доступны в теле одного лога-действия при открытии. Если после отработанного скрипта не было собрано ни одного лога с индексацией, логи не сохраняются. '''Принципы:'''*индексировать только действительно полезные логи (выбирать тип события правильно).*минимизировать объем данных, помещаемый в логи (например, не сохранять объект брони целиком). Для поиска и просмотра логов зайдите в раздел '''Для удобства выбора определенных записей техподдержки → Логи'''. Раздел логов на странице присутствует форма состоит из 3 основных частей:* Форма фильтров.* Блок предустановленных фильтров. Изначально в ней доступны наиболее используемые параметры фильтрации* Таблица логов. Чтобы получить доступ ко всем параметрам фильтра Записи логов разбиты постранично, необходимо раскрыть формучтобы перейти к следующей странице, кликнув по ссылке нажмите ссылку '''След.'''внизу таблицы. {| class="Дополнительные фильтрыwikitable"|-|[[Файл:Общий_вид_интерфейса_логов_2.png|1200px]]|-|Страница логов|} '''Успешность действия''' — это признак одного {{NameProject1}} запроса, например, для поиска — это получение хотя бы одного результата, для бронирования — успешная бронь и т.п. == Таблица логов ==* '''Столбцы таблицы''' — параметры логов,* '''Строки таблицы''' — записи действий. Одна запись лога называется '''действием'''(по сути эквивалент одного php-скрипта). Действие содержит множество '''операций'''.  Каждая запись в таблице — действие. Чтобы фильтр приминился к логамоткрыть его операции, разверните запись, необходимо нажать нажав на кнопку нее. <br /> Некоторые операции сопровождаются ссылкой '''Данные''"Искать"', открывающей дополнительную информацию о событии (операции): тело 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|**SABRE|-**GALILEO|Тестовый режим**TRAVELFUSION|**SIRENA|-**SIRENA2000|Успешность**NETFLIGHTS|**NTFSЛюбой**GTAУспешные**GULLIVERНе успешные**HOTELBEDS|-**DOTW**SERHS|}**MIKI**TRAVCO=== Предустановленные фильтры ===**GNДля быстроты поиска создан блок ссылок с предустановленными фильтрами:**ACADEMМои логи (текущего пользователя).**TOURICOМои логи (по IP).**AMADEUSПроблемные выписки.**ANDROMEDAЧастичные выписки.**ORANTAПроблемные бронирования.**MOBITICKETПроблемные аннуляции.**SKYEXPRESS**NWS==Поиск записей логов==**NFS===Поиск логов===**UFSЧтобы применить фильтрацию к логам:**SOFI# Выставите значения фильтров.*# Нажмите на кнопку ''Поиск''.<br />Чтобы отменить фильтр, нажмите на кнопку 'Платежный шлюз'Сброс''.{| class="wikitable"|-|[[Файл:Поиск логов.png|500px]]|-|Поиск логов по e-mail нотификациям указанного пользователя.|} ===Поиск логов поисковых запросов===*Логи поисковых запросов записываются в отдельную таблицу. Чтобы искать поисковые логи: # Нажмите на кнопку ''Таблица логов поисковых запросов'Объект-пользователь'.# Выставите значения фильтров.# Нажмите на кнопку ''*Поиск''.<br />Чтобы отменить фильтр, нажмите на кнопку 'Объект'Сброс''. {| class="wikitable"|-|[[Файл:Кнопка_Таблица_логов_поисковых_запросов.png|500px]]*|-|Ссылка на таблицу логов поисковых запросов|} {| class="wikitable"|-|[[Файл:Поиск_логов_поиска.png|500px]]|-|Пример поиска логов поисковых запросов|} ===Поиск восстановленных логов=== После перехода по ссылке '''ID действияПоиск восстановленных логов''', поиск будет вестись в специальном хранилище логов, которые по какой-либо причине были утрачены, а затем восстановлены. === Примеры поиска логов === *'''IPПо номеру заказа''':*# введите номер заказа в поле '''Дата'Заказ'',*# нажмите кнопку '''За последние X секунд'Поиск''.{| class="wikitable"|-|[[Файл:Поиск_логов_по_номеру_заказа.png|500px]]|-|Поиск логов по номеру заказа|}*'''С запросами к GDSПо ошибке'''— если искомые заказы содержат известную ошибку:*# введите текст ошибки в поле '''Тестовый режим'Сообщение''.*# нажмите кнопку '''Успешность'Поиск'' .{| class="wikitable"|-|[[Файл:Поиск заказов пользователя по ошибке.png|500px]]|-|Поиск логов с ошибкой среди заказов указанного пользователя.png|} == Логирование XML-данных ==Модуль осуществляет логирование: * пакетной выгрузки заказов из ЛК в форматах Nemo/SOFI, * выгрузки статистики метапоиска, * экспорта пользователей.  Для первых двух выгрузок, одиночных выгрузок заказов и обращений к GDS доступно скачивание каждого лога отдельно.
Ввод Если в поле "Идентификатор пользователя" ограничен использованием целых положительных чисел. На остальные поля ввода строгие ограничения содержимом события находится не накладываютсятолько XML, однакото из всего содержимого вычленяется и выводится только XML (например, необходимо вводить значения логически подходящие под конкретное поле, иначе фильтр просто не вернет результатоввыгрузка Немо/Софи).
Для того, чтобы браузер не подвисал из-за большого объема лога события (более 64000 символов), на главной странице логов (settings/logs) вместо содержимого выводится соответствующее сообщение. XML можно просмотреть в отдельном окне через специальный плагин.
===Предустановленные фильтры=Примеры логирования ==В {{NameSystem}} логируются следующие действия:* изменение настроек в панели администрирования,* действие с заказом (в т.ч. нотификации, выгрузки, оплаты, фиксации статусов и т.д.),* поиск,* авторизация / регистрация на сайте,* действие в ЛК (экспорт заказов, отправка сообщений/заявок и т.д.).
===Записи логовОсобенности логирования действий в {{NameSystem}}===Таблица логов состоит из набора параметров* Реквизиты подключения к ГРС:*'''Запуск''' - время запуска действия*'''Пользователь''' - кто запустил данное действие*'''Компонент''' - При изменении реквизитов подключения к какой компоненте системы относится данное действие*'''Действие''' - формальное наименование действияГРС эти изменения и состояние настроек до них логируются.*'''Сообщение''' - ???*'''Объект''' - ??? количество объектов При удалении реквизитов логируется id самих удаляемых реквизитов и какие данные содержались в результате выполнения действия*'''Заказ''' - номер заказа *'''Поиск''' - номер поиска *'''Поставщик''' - формальное наименование задействованного поставщика услуг*'''Время выполнения''' - численное значение (в секундах)*'''IP''' - адрес хоста, с которого запущено действие*'''допэтом id.''' - дополнительная информация по действию. Обычно в этом поле указывается статус действия ("Успешно"/"Неуспешно"; количество ошибок, если они произошли; режим работы системы, в котором было выполнено действие )
* Логирование изменения значения настройки — изменение настроек также логируется:** дата и время изменения значения настройки;** полное название настройки;** пользователь, изменивший значение настройки;** предыдущее значение настройки;** текущее значение настройки.<br />Пример:<pre>2014-10-06 15:33:41.915 [Пользователи] Изменение "user.param.time_zone" (Данные)Array( [Файл:Фрагмент_логов.pngoldValue]=> Pacific/Fakaofo [newValue]=> Indian/Antananarivo)</pre><!--== Возможные ошибки ===== SOAP ERROR ошибки ===
Одна запись В случае если тело SOAP запроса не соответствует схеме запроса, то в сообщении лога называется '''действием''' (по сути эквивалент одного phpможно будет увидеть <pre>Ошибка "SoapFault exception: [WSDL] SOAP-скрипта). Действие содержит множество '''ОперацийERROR: Parsing WSDL: Couldn't load from '%адрес_схемы%'.: faile"</pre>
[[Файл:Детальная_информация_лога.png]]-->
== Ошибки возникающие при оплате ==
* '''Блокировка "Оплата запрещена для данного заказа"''' - эту ошибку можно встретить в Админ-панели Nemo в логах когда заказ еще не забронирован и пользователь попытался оплатить; либо когда заказ забронирован, но нет в доступных действиях по заказу операции выписки; либо когда заказ выписан и нет доп.услуг для довыписки. При попытке оплаты система осуществляет эти проверки и блокирует оплату в указанных случаях.
'''''Пагинация''''' - постраничное разбиение информации== См.также ==* [[Пользователь]]* [[Настройка]]* [[Ошибка]]* [[Служба поддержки]]
'