451
правка
Изменения
Нет описания правки
[[ФайлКатегория:Общий_вид_интерфейса_логов_2.png|thumb|200px|Пример окна логов системы NemoТермины]][[Категория:Функции]]<!-- -->'''Логи системы''' - административный раздел системы Nemo, содержащий подробный журнал [[#Действие— модуль {{NameSystem|link}} для учета действий]] и [[#Операция|операций]]событий, происходящих в системе.
nemo.travel поддерживает гибкий инструмент логирования всех важных операций, происходящих в ней. Это помогает в кратчайшие сроки узнать детальную информацию практически по любому действию внутри системы. Интерфейс предоставляет широчайший выбор фильтров для выбора необходимых данных. Кроме того, имеется ряд предустановленных фильтров, которые выделены в отдельный блок и доступны по ссылкам. ==Принцип работы== Логи в зависимости от типа бывают:* индексируемые — ошибки, предупреждения и пр. Эти логи можно искать через фильтры логов.* не индексируемые — сообщение и пр., доступны в теле одного лога-действия при открытии. Если после отработанного скрипта не было собрано ни одного лога с индексацией, логи не сохраняются. '''Принципы:'''*индексировать только действительно полезные логи (выбирать тип события правильно).*минимизировать объем данных, помещаемый в логи (например, не сохранять объект брони целиком). Для поиска и просмотра логов зайдите в раздел '''Для техподдержки → Логи'''. Раздел логов состоит из 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||-|Тестовый режим||-|Успешность|* Любой* Успешные* Не успешные|- |} === Предустановленные фильтры ===Для быстроты поиска создан блок ссылок с предустановленными фильтрами:* Мои логи (текущего пользователя).* Мои логи (по IP).* Проблемные выписки.* Частичные выписки.* Проблемные бронирования.* Проблемные аннуляции. ==Поиск записей логов=====Поиск логов===Чтобы применить фильтрацию к логам:# Выставите значения фильтров.# Нажмите на кнопку ''Поиск''.<br />Чтобы отменить фильтр, нажмите на кнопку ''Сброс''.{| class="wikitable"|-|[[Файл:Поиск логов.png|500px]]|-|Поиск логов по e-mail нотификациям указанного пользователя.|} ===Поиск логов поисковых запросов===Логи поисковых запросов записываются в отдельную таблицу. Чтобы искать поисковые логи: # Нажмите на кнопку ''Таблица логов поисковых запросов''.# Выставите значения фильтров.# Нажмите на кнопку ''Поиск''.<br />Чтобы отменить фильтр, нажмите на кнопку ''Сброс''. {| class="wikitable"|-|[[Файл:Кнопка_Таблица_логов_поисковых_запросов.png|500px]]|-|Ссылка на таблицу логов поисковых запросов|} {| class="wikitable"|-|[[Файл:Поиск_логов_поиска.png|500px]]|-|Пример поиска логов поисковых запросов|} ===Поиск восстановленных логов=== После перехода по ссылке '''Поиск восстановленных логов'''Операция, поиск будет вестись в специальном хранилище логов, которые по какой-либо причине были утрачены, а затем восстановлены. === Примеры поиска логов === * '''По номеру заказа''':*# введите номер заказа в поле ''Заказ'',*# нажмите кнопку ''Поиск''.{| class="wikitable"|-|[[Файл:Поиск_логов_по_номеру_заказа.png|500px]]|-|Поиск логов по номеру заказа|}* '''По ошибке''' — если искомые заказы содержат известную ошибку:*# введите текст ошибки в поле ''Сообщение''.*# нажмите кнопку ''Поиск'' .{| class="wikitable"|-|[[Файл:Поиск заказов пользователя по ошибке.png|500px]]|- много |Поиск логов с ошибкой среди заказов указанного пользователя.png|} == Логирование XML-данных ==Модуль осуществляет логирование: * пакетной выгрузки заказов из ЛК в форматах Nemo/SOFI, * выгрузки статистики метапоиска, * экспорта пользователей. Для первых двух выгрузок, одиночных выгрузок заказов и обращений к GDS доступно скачивание каждого лога отдельно. Если в одном действии содержимом события находится не только XML, то из всего содержимого вычленяется и выводится только XML (например, выгрузка Немо/Софи). Для того, чтобы браузер не подвисал из-за большого объема лога события (более 64000 символов), на главной странице логов (кривоsettings/logs)вместо содержимого выводится соответствующее сообщение. XML можно просмотреть в отдельном окне через специальный плагин. == Примеры логирования ==В {{NameSystem}} логируются следующие действия:* изменение настроек в панели администрирования,* действие с заказом (в т.ч. нотификации, выгрузки, оплаты, фиксации статусов и т.д.),* поиск,* авторизация / регистрация на сайте,* действие в ЛК (экспорт заказов, отправка сообщений/заявок и т.д.). ===Особенности логирования действий в {{NameSystem}}===* Реквизиты подключения к ГРС:** При изменении реквизитов подключения к ГРС эти изменения и состояние настроек до них логируются.** При удалении реквизитов логируется id самих удаляемых реквизитов и какие данные содержались в этом id. * Логирование изменения значения настройки — изменение настроек также логируется:** дата и время изменения значения настройки;** полное название настройки;** пользователь, изменивший значение настройки;** предыдущее значение настройки;** текущее значение настройки.<br />Пример:<pre>2014-10-06 15:33:41.915 [Пользователи] Изменение "user.param.time_zone" (Данные)Array( [oldValue] => Pacific/Fakaofo [newValue] => Indian/Antananarivo)</pre><!--== Возможные ошибки ===== SOAP ERROR ошибки === В случае если тело SOAP запроса не соответствует схеме запроса, то в сообщении лога можно будет увидеть <pre>Ошибка "SoapFault exception: [WSDL] SOAP-ERROR: Parsing WSDL: Couldn't load from '%адрес_схемы%' : faile"</pre> --> == Ошибки возникающие при оплате ==* '''Блокировка "Оплата запрещена для данного заказа"''' - эту ошибку можно встретить в Админ-панели Nemo в логах когда заказ еще не забронирован и пользователь попытался оплатить; либо когда заказ забронирован, но нет в доступных действиях по заказу операции выписки; либо когда заказ выписан и нет доп.услуг для довыписки. При попытке оплаты система осуществляет эти проверки и блокирует оплату в указанных случаях. == См.также ==* [[Пользователь]]* [[Настройка]]* [[Ошибка]]* [[Служба поддержки]]