Журнал Glarus BI¶

По умолчанию Glarus BI выводит в журнал большое количество информации, используя [Log4j 2][log4j]. Так же вы можете самостоятельно настроить уровень детальности журналов.

Конфигурация уровней детальности журналов¶

Здесь представлена [конфигурация логирования по умолчанию][default-log-config] Glarus BI. Вы можете переопределить этот файл XML и настроить Glarus BI, используя свой собственный файл конфигурации, передав аргумент -Dlog4j.configurationFile при запуске. Например, если ваш файл собственной конфигурации находится в /path/to/custom/log4j2.xml, вы можете использовать его так:

java -Dlog4j.configurationFile=file:/path/to/custom/log4j2.xml -jar glarusBI.jar

Чтобы начать настраивать журналы, сделайте копию [файла по умолчанию log4j2.xml][default-log-config] и измените его под свои нужды. Необходимо будет перезапустить Glarus BI, чтобы изменения в файле вступили в силу. Смотрите документацию Log4j для информации об [уровнях логирования][levels].

Можно устанавливать различные уровни детальности журналов для различных разделов приложения, например:

<Loggers>
    <Logger name="metabase" level="INFO"/>
    <Logger name="metabase-enterprise" level="INFO"/>
    <Logger name="metabase.plugins" level="DEBUG"/>
    <Logger name="metabase.server.middleware" level="DEBUG"/>
    <Logger name="metabase.query-processor.async" level="DEBUG"/>
    <Logger name="com.mchange" level="ERROR"/>

    <!-- Example: Add trace logging to the Glarus BI analysis process, which can help debugging trouble with syncing, fingerprinting and scanning -->
    <Logger name="metabase.sync" level="TRACE"/>

    <Root level="WARN">
      <AppenderRef ref="STDOUT"/>
    </Root>
</Loggers>

Проверьте следующее [Как проверять журналы][read-logs].

Журналы сервера Jetty¶

Вы можете настроить веб-сервер Jetty, чтобы он предоставлял больше информации в журналах, установив уровень детальности DEBUG. Однако имейте в виду, что журналы отладки Jetty могут быть очень многословными, что может затруднить поиск нужной информации.

Чтобы получить логи Jetty, добавьте следующие строки в файл Log4J2 XML в узле :

<Logger name="org.eclipse.jetty" level="DEBUG"/>

Использование Log4j 2 вместе с Docker¶

Перед запуском образа Glarus BI в Docker, вам нужно будет передать аргумент log4j.configurationFile. Добавьте JAVA_OPTS=-Dlog4j.configurationFile=file:/path/to/custom/log4j2.xml к переменным окружения контейнера, как показано ниже:

docker run -p 3000:3000 -v $PWD/my_log4j2.xml:/tmp/my_log4j2.xml -e JAVA_OPTS=-Dlog4j.configurationFile=file:///tmp/my_log4j2.xml metabase/metabase`

Отключение emoji или цветовой палитры логов¶

По умолчанию Glarus BI будет включать символы emoji в журналы. Вы можете отключить emoji, используя переменную окружения MB_EMOJI_IN_LOGS:

Отключение Emoji в журналах¶

export MB_EMOJI_IN_LOGS="false"
java -jar glarusBI.jar

Дополнительная информация: