База знаний
Включение журналирования КриптоПро JCP
Опубликовано on 2012-02-01 15:15

Журналирование КриптоПро JCP осуществляется стандартными средствами Java машины. Формат протокола, поля вывода, уровни протоколирования настраивается в файле <jre>/lib/logging.properties. Имя класса протокола для JCP: ru.CryptoPro.JCP.tools.JCPLogger.

Уровни протоколирования JCP совпадают с уровнями протоколирования Java, ниже они приведены в порядке по возрастанию информативности сообщений, уровень выше включает все сообщения приведенные по тексту ниже. Уровень ALL включает все сообщения, уровень OFF выключает все сообщения.

При настройках Java машины по умолчанию, включен уровень INFO.

  • OFF В протокол не выводятся никакие сообщения.
  • SEVERE - Критические ошибки в JCP, функционирование JCP после появления этих ошибок невозможно. К ним относятся ошибки загрузки, ошибки контроля целостности и др.
  • WARNING - Ошибки JCP. Ошибки не приводящие к отказу функционирования JCP. К ним относятся, например ошибки настройки JCP, неправильный вызов функций JCP.
  • INFO - Информационные сообщения о загрузке JCP.
  • CONFIG - Информационные сообщения при получении текущих настроек используемых JCP.
  • FINE - Информационные сообщения о завершении функции провайдера с ошибкой.
  • FINER - Информационные сообщения связанные с входом/выходом в/из функции провайдера.
  • FINEST - Уровень, не используется
  • ALL - Сам уровень не используется, приводит к выдаче всех сообщений выдаваемых JCP.

При включении уровня отличного от заданного по умолчанию (INFO) следует помнить, что уровни выше CONFIG могут значительно замедлить скорость провайдера, а уровни ниже INFO привести к несвоевременному обнаружению причин отказа JCP. При обычной работе JCP рекомендуется оставлять настройку уровня выводимых сообщений по умолчанию (INFO).

Пример настройки файла logging.properties с уровнем FINE (исправления выделены жирным):


...
# Default global logging level.
# This specifies which kinds of events are logged across
# all loggers.  For any given facility this global level
# can be overriden by a facility specific level
# Note that the ConsoleHandler also has a separate level
# setting to limit messages printed to the console.
.level= INFO

############################################################
# Handler specific properties.
# Describes specific configuration info for Handlers.
############################################################

# default file output is in user's home directory.
java.util.logging.FileHandler.pattern = %h/java%u.log
java.util.logging.FileHandler.limit = 50000
java.util.logging.FileHandler.count = 1
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter

# Limit the message that are printed on the console to INFO and above.

#java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.level = FINE
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter

############################################################
# Facility specific properties.
# Provides extra control for each logger.
############################################################

# For example, set the com.xyz.foo logger to only log SEVERE
# messages:

com.xyz.foo.level = SEVERE

ru.CryptoPro.JCP.tools.JCPLogger.level = FINE
...
(9 vote(s))
Helpful
Not helpful

Коментарии (0)