Kotlin

LogDoc имеет встроенный appender для обработки логов Kotlin с использованием logback-classic, разберем как его подключить.

Для работы с логами используются библиотеки log4j, logback-classic и logback-lib.
Необходимо добавить зависимости:
- ch.qos.logback % logback-classic % 1.2.7
- org.logdoc % logback-appenders % 1.0.1

SBT

java


libraryDependencies += "org.logdoc" % "logback-appenders" % "1.0.1"

Maven

java

    
     !-- https://mvnrepository.com/artifact/org.logdoc/logback-appenders -->
      <dependency>
          <groupId>org.logdoc</groupId>
            <artifactId>logback-appenders</artifactId>
          <version>1.0.1</version>
     </dependency>

Установка

Необходимо произвести минимальную настройку логгера с указанием адреса и порта запущенного инстанса LogDoc в файле logback.xml

xml

<configuration>
    <statusListener className="ch.qos.logback.core.status.OnConsoleStatusListener"/>
     <appender class="org.logdoc.appenders.LogdocTcpAppender" name="LOGDOC">
        <!-- Mandatory fields -->
        <host>127.0.0.1</host>
        <port>5656</port>
        <appName>logs-generator</appName>

        <!-- Optional tuning. Default values are predefined. Used only if token is missed -->
        <prefix/> <!-- absolute prefix for logger name (source) -->
        <suffix/> <!-- absolute suffix for logger name (source) -->
        <mapMdc>false</mapMdc> <!-- map MDC to fields (if any), default false -->
    </appender>
    <root level="DEBUG">
    <appender-ref ref="LOGDOC"/>
    </root>
</configuration>

Использование

После настройки любой вызов logger с соответствующим уровнем будет отсылать сообщение в LogDoc

java


public class TestLog {

    private static final Logger logger
            = LoggerFactory.getLogger(TestLog.class);

    public static void main(String[] args) {
        logger.info("Log example from {}", Example.class.getSimpleName());
        logger.warn("Warning!");
        
        try{
            ...
        } catch (Exception e) {
            logger.error("Error!", e);
        }
    }
}