Логирование работы сервиса 1С:Маркировка

О новом функционале логирования запросов к серверам ИС

Работа сервиса 1С:Маркировка для Казахстана практически целиком построена на механизмах обмена данными с внешними серверами. Это означает, что в процессе, например, отправки акта из 1С последовательно отрабатывают несколько систем: 

• 1С - для формирования отправляемых данных, 
• криптобиблиотека  - для их подписи, 
• обмен с серверами ИТС - для проверки данных пользователя и подписки на сервис 1С:Маркировка, 
• обмен с серверами ИС маркировки – для, непосредственно, регистрации документа на портале.  

Взаимосвязь данных в этих процессах не всегда прямо очевидна, да и сами процессы технически достаточно сложны, а проблемы могут возникать на стороне любой из участвующих в процессе систем, поэтому расследование ошибок в некоторых случаях может быть затруднено. 
Для того чтобы ускорить разбор ошибочных ситуаций, возникающих у пользователя, и собрать необходимую информацию для передачи обращения техническому специалисту, в составе конфигураций с поддержкой маркировки был реализован новый механизм логирования запросов к серверам ИС.

Данный механизм относится к сервисно-техническому функционалу и не предназначен для регулярного использования пользователем, но с его помощью можно провести сбор данных в случае столкновения с явно некорректным поведением системы. Например, если при отправке документа на сервер вышло сообщение об ошибке, не содержащей поясняющей информации для пользователя. В этом случае вопрос, скорее всего, необходимо будет направить техническому специалисту, которому может потребоваться более развернутое описание возникшей проблемы. Именно для сбора этой информации и предназначен лог запросов. 

Стоит также отметить, что логирование может помочь в сборе данных только в ситуациях, когда ошибка воспроизводится стабильно, т.е. более 1 раза, и имеет четкий сценарий воспроизведения. 

Как использовать лог запросов для сбора информации об ошибках у пользователя

Механизм логирования реализован для двух модулей сервиса 1С:Маркировка для Казахстана и может фиксировать выполнение запросов как к серверам ИС МПТ, так и к серверам ИС ЦЭДМ. Соответственно, доступ к функционалу возможен как из рабочего места Маркировка и прослеживаемость товаров (ИС МПТ) в случае работы с маркируемой табачной или обувной продукцией, так и из рабочего места Маркировка и прослеживаемость лекарственной продукции (ИС ЦЭДМ). В рабочих местах новый функционал расположен в группе Логирование запросов на вкладке Сервисные возможности.

 
Логирование запросов работает по принципу сплошной записи всех выполняемых процессов в рамках текущего сеанса и может быть включено/отключено пользователем в любой момент работы. Если пользователь не выполнил выключение режима логирования самостоятельно, оно будет продолжать запись и отключится вместе с завершением сеанса базы данных. 

Право на осуществление записей в лог по умолчанию предоставляется всем пользователям сервиса Маркировки, имеющим роль Базовые права работника маркировки (ИС МПТ) или Базовые права работника маркировки (ИС ЦЭДМ). При этом лог запросов поддерживает механизм ограничения доступа к данным в разрезе Организации. 

Команда Включить логирование (на время сеанса) позволяет начать запись в лог запросов. После ее включения кнопка на форме меняется, переходя в режим отключения записи.

 
Пока запись включена, любое взаимодействие с сервером будет формировать записи в служебный регистр сведений. Перейти к нему для просмотра собранной информации можно по ссылке Лог запросов к серверу ИС из рабочего места сервиса маркировки.
Данные в этом регистре носят служебный характер и содержат техническую информацию о параметрах и результате выполнения методов интеграции с сервером, поэтому записи нельзя редактировать, добавлять или удалять вручную.

В общем случае подразумевается, что механизм логирования будет использоваться по следующему сценарию:

• Пользователь сервиса маркировки во время работы сталкивается с явной (выводящей какое-то сообщение) системной ошибкой, однако по полученному описанию невозможно понять, что именно произошло. Например, если в сообщении сказано, что не удалось отправить документ, потому что в нем не заполнены сведения о кодах маркировки – это не системная ошибка. А вот сообщение «При отправке документа произошла ошибка. Код обращения к серверу: 500» уже может являться основанием для использования логирования.
• Пользователь повторяет действия, в результате которых произошла ошибка, чтобы убедиться, что она воспроизводится стабильно. 
• Если удается выявить сценарий стабильного воспроизведения ошибки, пользователь через соответствующее рабочее место сервиса маркировки включает запись в лог.
• Затем пользователь повторяет всю последовательность действий, необходимых для возникновения ошибочной ситуации.
• После чего возвращается в рабочее место и отключает режим логирования.
• Далее, если у организации есть собственные технические специалисты, можно начать анализ собранных данных или сформировать отчет для передачи на линию поддержки сервиса маркировки.  

Для очистки устаревших записей регистра предусмотрена команда Очистить историю, при этом предусмотрена возможность как полной очистки данных лога, так и очистки записей за конкретный период.

 
Для передачи информации, накопленной при помощи логирования запросов, необходимо сформировать специальный отчет. При этом поддерживается как выгрузка одной конкретной записи, так и формирование отчета с хронологическим списком выполненных операций.
Для выгрузки одной конкретной записи необходимо открыть ее путем двойного клика по строчке регистра. Откроется окно записи, в котором будет доступна команда Сохранить в файл. 

При выполнении этой команды будет предложено выбрать каталог сохранения, в который система выгрузит сформированный отчет. В данном случае будет сформирован один текстовый файл с наименованием, соответствующим шаблону «Лог_запросов_*Наименование организации*_от_*дата и время выгрузки*».

 
Для выгрузки истории выполнения нескольких запросов нужно воспользоваться командой Выгрузить отчет непосредственно в общем списке лога. Поддерживается выгрузка как полностью всех записей регистра, так и формирование отчета за указанный период. 

 
В данном случае данные лога будут выгружены в указанный пользователем каталог в виде zip-архива с наименованием, соответствующим шаблону «Лог_запросов_*Наименование организации*_от_*дата и время выгрузки*».

Сформированные отчеты можно использовать для передачи на линию поддержки сервиса 1С:Маркировка для Казахстана в качестве приложения к вашему обращению. В некоторых случаях это может упростить расследование ситуации и ускорить процесс подготовки ответа.