kamon-logback

Github星跟踪图

kamon-logback

Build Status
Gitter
Maven Central

The kamon-logback module requires you to start your application using the AspectJ Weaver Agent.

Getting Started

Kamon Logback is currently available for Scala 2.10, 2.11, 2.12 and 2.13.

Supported releases and dependencies are shown below., kamon, status, jdk, scala, :------:, :------:, :----:, ------------------, 1.0.6, stable, 1.8+, 2.10, 2.11, 2.12, 2.0.0, stable, 1.8+, 2.11, 2.12, 2.13

To get started with SBT, simply add the following to your build.sbt or pom.xml
file:

libraryDependencies += "io.kamon" %% "kamon-logback" % "2.0.0"
<dependency>
    <groupId>io.kamon</groupId>
    <artifactId>kamon-logback_2.12</artifactId>
    <version>2.0.0</version>
</dependency>

Logging TraceID

Inserting a conversionRule allows you to incorporate the trace ID for a request into your Logback layout. Here is a simple example logback.xml configuration that does this:

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="false" debug="false">
  <conversionRule conversionWord="traceID" converterClass="kamon.instrumentation.logback.tools.TraceIDConverter" />

  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss}, %-5level, %traceID, %c{0} -> %m%n</pattern>
    </encoder>
  </appender>

  <root level="DEBUG">
    <appender-ref ref="STDOUT" />
  </root>
</configuration>

Propagating TraceID to AsyncAppender

If you choose to use AsyncAppender, your trace ID will automatically be propagated to the thread where the log is actually published. No configuration needed. The same applies for the span ID. You can use them in the logback pattern like this:

 <pattern>%d{yyyy-MM-dd HH:mm:ss}, %-5level, %X{kamonTraceID}, %X{kamonSpanID}, %c{0} -> %m%n</pattern>

You can also add custom values to MDC. To do this, simply add the key value in the library configuration:

kamon.logback.mdc-traced-local-keys = [ userID ].
kamon.logback.mdc-traced-broadcast-keys = [ requestID ]

Then, add the value to the kamon context:

Context
  .create(Span.Key, span)
  .withKey(Key.broadcastString("userID"), Some("user-1"))
  .withKey(Key.local[Option[String]("requestID", None), Some("request-id") {
  // loggers called in this context will have access to the userID, requestID
}

Note: While in Kamon you can have one local key and one broadcast key with the same name, in MDC this is not possible. In this case only the broadcast key will be stored in MDC (will be present in the logs)

Counting Log Entries

Sometimes you need to know how many log entries your application produce as a Kamon counter, in order to easily visualize that information, and more important, be able to alert on those metrics.

This library allows you to do that by just changing the logback.xml file and adding a simple appender, please notice the appender called COUNTER:

<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="false" debug="false">
  <conversionRule conversionWord="traceID" converterClass="kamon.instrumentation.logback.tools.TraceIDConverter" />

  <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss}, %-5level, %traceID, %c{0} -> %m%n</pattern>
    </encoder>
  </appender>
  <appender name="COUNTER" class="kamon.instrumentation.logback.tools.EntriesCounterAppender"/>

  <root level="DEBUG">
    <appender-ref ref="STDOUT" />
    <appender-ref ref="COUNTER" />
  </root>
</configuration>

The Kamon counter is named "log.events", and is refined with the tags:

"level" → "ERROR", "WARN", "INFO", "DEBUG", "TRACE" (One of those values, is the level of the event.)

"component" → "logback" (Always this value)

概览

名称与所有者kamon-io/kamon-logback
主编程语言Scala
编程语言Scala (语言数: 2)
平台
许可证Other
发布数13
最新版本名称v2.0.2 (发布于 2019-10-29 15:36:59)
第一版名称v1.0.0-RC7 (发布于 )
创建于2017-06-28 14:06:31
推送于2020-03-18 16:02:39
最后一次提交2020-03-18 17:02:32
星数12
关注者数8
派生数17
提交数95
已启用问题?
问题数6
打开的问题数0
拉请求数19
打开的拉请求数0
关闭的拉请求数2
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?
去到顶部