# 🌲 Timber - Great Elixir Logging Made Easy

<p align="center">
  <a href="https://timber.io" target="_blank" align="center">
    <img src="https://res.cloudinary.com/timber/image/upload/v1552328675/banner.jpg" width="900">
  </a>
  <br>
</p>

[![ISC License](https://img.shields.io/badge/license-ISC-ff69b4.svg)](LICENSE.md)
[![Hex.pm](https://img.shields.io/hexpm/v/timber.svg?maxAge=18000=plastic)](https://hex.pm/packages/timber)
[![Documentation](https://img.shields.io/badge/hexdocs-latest-blue.svg)](https://hexdocs.pm/timber/index.html)
[![Build Status](https://travis-ci.org/timberio/timber-elixir.svg?branch=master)](https://travis-ci.org/timberio/timber-elixir)

[Timber.io](https://timber.io) is a hosted service for aggregating logs across your entire stack -
[any language](https://docs.timber.io/setup/languages),
[any platform](https://docs.timber.io/setup/platforms),
[any data source](https://docs.timber.io/setup/log_forwarders).

Unlike traditional logging tools, Timber integrates with language runtimes to automatically
capture in-app context, turning your text-based logs into rich structured events.
Timber integrates with Elixir through this library. And Timber's
[rich free-form query tools](https://docs-new.timber.io/usage/live-tailing#query-syntax) and
[real-time tailing](https://docs-new.timber.io/usage/live-tailing), make drilling down into
important stats easier than ever.

---

### Features

* Simple Integration. Installs as an Elixir logger backend.
* Fast & light-weight. Designed with performance in mind.
* Support for local and global context.
* Automatic context capturing.
* Strong structured logging support.
* Integrates with popular 3rd party libraries such as Phoenix and Plug.

---

### Get Started

* **[Installation](https://docs.timber.io/setup/languages/elixir#installation)**
* **[Configuration](https://docs.timber.io/setup/languages/elixir#configuration)**
* **[Usage](https://docs.timber.io/setup/languages/elixir#usage)**
* **[Guides](https://docs.timber.io/setup/languages/elixir#guides)**
* **[Integrations](https://docs.timber.io/setup/languages/elixir/integrations)**
* **[Performance](https://docs.timber.io/setup/languages/elixir#performance)**

---

<p align="center">
<a href="https://timber.io">Timber</a> &bull;
<a href="https://docs.timber.io">Docs</a> &bull;
<a href="https://timber.io/pricing">Pricing</a> &bull;
<a href="https://timber.io/terms">Security</a> &bull;
<a href="https://timber.io/privacy">Compliance</a>
</p>