Practical logging framework that doesn't require any other logging framework and can be completely configured programmatically.
Scala Other
Clone or download
Permalink
Failed to load latest commit information.
benchmarks/src/main Created AsynchronousFlusher to automatically flush file logging when … Jul 12, 2018
core Minor cleanup and addition of LogFile.isDisposed and isActive Jul 20, 2018
logstash/src/main/scala/scribe/logstash Updated to youi 0.9.0-M16 Jul 12, 2018
macros/shared/src/main/scala/scribe Additional features and functionality added to `scribe.async` to supp… Jun 20, 2018
project Release 2.5.3 Jul 13, 2018
slack/src/main/scala/scribe/slack Updated to youi 0.9.0-M16 Jul 12, 2018
slf4j/src Major cleanup of SLF4J LoggerAdapter to fix non-standard formatting t… Jul 12, 2018
slf4j18/src Major cleanup of SLF4J LoggerAdapter to fix non-standard formatting t… Jul 12, 2018
tests Additional features and functionality added to `scribe.async` to supp… Jun 20, 2018
work Added SampleTime and Throughput to benchmarks (Resolves #64) May 29, 2018
.gitignore Fixed problems with Travis Jan 18, 2018
.jvmopts Updated to latest version of Perfolation May 16, 2018
.travis.yml Updated to latest version of Perfolation May 16, 2018
LICENSE Initial commit Jan 26, 2016
README.md Updated README to include docs Jul 16, 2018
build.sbt Updated to snapshot release Jul 20, 2018
jitpack.yml add jitpack.yml for cross-build with jitpack Jun 2, 2018
publish-local.sh Created AsynchronousFlusher to automatically flush file logging when … Jul 12, 2018
publish.sh Minor updates for 2.5.0 Jun 6, 2018
sbt.scalajs1.0.sh Added support to build for Scala.js 1.0.0-M1 when ScalaTest supports it. Jul 24, 2017
scalastyle-config.xml slf4j: Finished preliminary integration and basic tests. Feb 11, 2016
test.sh Updated publish and test scripts May 15, 2018

README.md

scribe

Build Status Codacy Badge Stories in Ready Gitter Maven Central Latest version Javadocs

Scribe is a completely different way of thinking about logging. Instead of wrapping around existing logging frameworks and bearing their performance and design flaws, Scribe is built from the ground up to provide fast and effective logging in Scala, Scala.js, and Scala Native without the need of configuration files or additional dependencies. All management of logging can be handled programmatically (of course, classic logging configuration can be utilized as well if desired) in Scala itself, giving the developer the freedom to use whatever configuration framework, if any, they should choose to use.

Quick Start

For people that want to skip the explanations and see it action, this is the place to start!

Dependency Configuration

libraryDependencies += "com.outr" %%% "scribe" % "2.5.3"

Or, if you want interoperability with SLF4J (for those silly projects that haven't switched to Scribe yet):

libraryDependencies += "com.outr" %%% "scribe-slf4j" % "2.5.3"

Usage

scribe.info("Yes, it's that simple!")

Why Another Logging Framework?

Yes, we know there are too many Java logging frameworks to count, and a large number of decent logging frameworks in Scala, so why did we write yet another logging framework? Nearly every Scala logging framework is mostly just a wrapper around Java logging frameworks (usually SLF4J, Log4J, or Logback). This comes with a few problems:

  1. No support for Scala.js
  2. No support for Scala Native
  3. Performance cost (Blog Post: http://www.matthicks.com/2018/02/scribe-2-fastest-jvm-logger-in-world.html)
  4. Additional dependencies
  5. Substantial cost logging method and line numbers
  6. Lack of programmatic configuration support

A few of the main features that Scribe offers:

  1. Performance is a critical consideration. We leverage Macros to handle optimization of everything possible at compile-time to avoid logging slowing down your production application. As far as we are aware, Scribe is the fastest logging framework on the JVM.
  2. Programmatic configuration. No need to be bound to configuration files to configure your logging. This means you can rely on any configuration framework or you can configure real-time changes to your logging in your production environment. This particularly comes in handy if you need to enable debug logging on something going wrong in production. No need to restart your server, simply provide a mechanism to modify the logging configuration in real-time.
  3. Clean logging. Macros allow us to introduce logging into a class via an import instead of a mix-in or unnecessary setup code.
  4. Zero cost class, method, and line number logging built-in. Never worry about your logger working up the stack to figure out the position of the logging statement at runtime. With Macros we determine that information at compile-time to avoid any runtime cost.
  5. Asynchronous logging support. Scribe's logger is very fast, but if real-time performance is critical, the asynchronous logging support completely removes logging impact from your application's thread impact.

Documentation

Advanced Topics

Optional Modules

Community

The best way to receive immediate feedback for any questions is via our Gitter channel