Настройка протоколов аудита работы Essbase

 

Essbase предоставляет простую и мощную систему для контроля своей работы, которую можно масштабировать, в зависимости от предъявляемых требований к системе. Существует несколько уровней логирования от info до critical, определяемых параметрами AGENTLOGMESSAGELEVEL и LOGMESSAGELEVEL в конфигурационном файле essbase.cfg, располагающимся в каталоге %HYPERION_HOME%\AnalyticServices\bin.

 

В системе предусмотрено двухуровневое логирование : на уровне сервера и на уровне приложения.

1 Анализ логов

Происходит посредством «ручного» просмотра файла с логами работы системы. Обычно это требуется при возникновении «внешних» признаков неработоспособности системы

•    неприемлемо долгое время ответа системы на запрос получения данных

•    генерация *.xcp файлов

•    и прочие ошибки

На основе файла логов приложения можно , с помощью инструментария предоставляемого Administration Service Console, анализировать активность пользователей и загрузку сервера.

Подробности о количестве и составе файлов, в которых пишется деятельность сервера, и о протоколируемой информации в Analytic Server смотрите в документе

2 Настройки системы, влияющие на состав и уровень протоколируемой информации

 

2.1. Настройки протоколирование на уровне сервера

AGENTLOGMESSAGELEVEL – настройка файла essbase.cfg, которая определяет, что бы Analytic Server писал все сообщения (INFO), либо сообщения о предупреждениях (WARNING), либо только сообщения об ошибках (ERROR) в файл протоколирования Analytic Server.

PORTUSAGELOGINTERVAL – настройка файла essbase.cfg, которая определяет интервал для записи в лог количество свободных и занятых портов

2.2. Настройки протоколирование на уровне приложения

LOGMESSAGELEVEL (INFO,WORNING,ERROR) настройка файла essbase.cfg, которая определяет что бы Analytic Server писал либо все сообщения, либо предупреждения, либо ошибки в файл логов приложения

TIMINGMESSAGES (TRUE | FALSE) настройка файла essbase.cfg, которая определяет что бы Analytic Server писал длительность выполнения каждого пользовательского запроса на получения данных.

SSLUNKNOWN (TRUE | FALSE) настройка файла essbase.cfg, которая определяет что бы Analytic Server писал сообщения о ошибке включающие в себя запросы на получение значений с несуществующих элементов.

SET MSG настройка в файле скрипта, которая определяет как и что Analytic Server буде писать в лог приложения (Суммарную статистику по этому скрипту, расширенную стистику, настрйку уровней сообщений (без них, ошибки, предупреждения, все сообщения)

2.3. Настройка протоколирования пользовательских запросов

Для включения опции протоколирования пользовательских запросов, создайте файл dbname.cfg в директории базы данных используя следующей синтаксис:

•    Определение направления, обращения к которому будет протоколироваться QUERYLOG [dimension_name]

•    Глубина протоколирования по поколениям или по уровням: QUERYLOG GENERATION generation-range or QUERYLOG LEVEL level-range)

•    Исключение из протокола запросов: QUERYLOG NONE GENERATION generation-range or QUERYLOG NONE LEVEL level-range

•    Включать в протокол запросы к элементам нулевого уровня при HOLAP QUERYLOG LOGHAMBRS ON | OFF

•    Месторасположение файла логов QUERYLOG LOGPATH path-expression

•    Формат логов файлов QUERYLOG LOGFORMAT CLUSTER | TUPLE

•    Размер одного файла логов QUERYLOG LOGFILESIZE n

•    Общий размер всех файлов QUERYLOG TOTALLOGFILESIZE n

•    Включить или выключить логирование при следующем запуске базы QUERYLOG ON | OFF

 

Пример файла
# Log the Product dimension
QUERYLOG [Product]
# Log Hybrid Analysis members of Product, if applicable
QUERYLOG LOGHAMBRS ON
# Log the Market dimension
QUERYLOG [Market]
# Log members of generation 2 of Market by generation number
QUERYLOG GENERATION 2
# Display log output in cluster format
QUERYLOG LOGFORMAT CLUSTER
# Create log file in C:\QUERYLOG\
QUERYLOG LOGPATH C:\QUERYLOG\
# Start a new log file after an individual log file size reaches 2 MB
QUERYLOG LOGFILESIZE 2
# Turn off query logging after the total size of all log files reaches 1024 MB (1 GB)
QUERYLOG TOTALLOGFILESIZE 1024
# Enable query logging
QUERYLOG ON

2.4. Настройка протоколирование изменений структуры метаданных

OUTLINECHANGELOG (TRUE | FALSE) настройка файла essbase.cfg, которая имеет значение TRUE, для создания файла протоколов изменений

OUTLINECHANGELOGFILESIZE n настройка файла essbase.cfg, которая определяет максимальный размер файла протокола.

2.5. Настройка протоколирования создания направлений

DATAERRORLIMIN n настройка файла essbase.cfg, которая определяет максимальное количество записей в файле dataload.err

2.6. Очистка файла протоколов работы сервера

CLEARLOGFILE (TRUE | FALSE) настройка файла essbase.cfg, в значении TRUE очищает лог сервера или приложений в случае их перезапуска