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

Изменения

Логи системы

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