# Журнал логов GlarusBI

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

## Конфигурация уровней вывода логов

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

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

Чтобы начать настраивать логи, сделайте копию [файла по умолчанию log4j2.xml][default-log-config] и измените его под свои нужды. Необходимо будет перезапустить GlarusBI, чтобы изменения в файле вступили в силу. Смотрите документацию 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 GlarusBI 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 в узле <Loggers>:

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

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

Перед запуском образа GlarusBI в 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 или цветовой палитры логов

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

### Конфигурация логов Emoji

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

[default-log-config]: https://github.com/metabase/metabase/blob/master/resources/log4j2.xml
[levels]: https://logging.apache.org/log4j/2.x/manual/customloglevels.html
[log4j]: https://logging.apache.org/log4j/2.x/
[read-logs]: ../troubleshooting-guide/server-logs.md