https://github.com/trieloff/timbre-loggly

A timbre appender that posts to Loggly
https://github.com/trieloff/timbre-loggly

Last synced: 27 days ago
JSON representation

A timbre appender that posts to Loggly

• Host: GitHub
• URL: https://github.com/trieloff/timbre-loggly
• Owner: trieloff
• License: apache-2.0
• Created: 2017-07-16T10:33:14.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2017-07-16T12:05:41.000Z (over 7 years ago)
• Last Synced: 2024-10-07T17:50:26.458Z (about 1 month ago)
• Language: Clojure
• Size: 12.7 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# timbre-loggly

A timbre (ClojureScript/Node.js) appender that posts to Loggly

[![Clojars Project](https://img.shields.io/clojars/v/trieloff/timbre-loggly.svg)](https://clojars.org/trieloff/timbre-loggly)

[![CircleCI](https://circleci.com/gh/trieloff/timbre-loggly.svg?style=shield)](https://circleci.com/gh/trieloff/timbre-loggly)

## Background

**timbre-loggly** is a log appender for the [τaoenssō/timbre](https://github.com/ptaoussanis/timbre) logging library that posts logs to the [Loggly.com](https://www.loggly.com) logging as a service provider. It is meant for a ClojureScript on Node.js environment.

## Installation

Add this to your `project.clj`'s `:dependencies` vector:

```clojure

[trieloff/timbre-loggly "0.2.0"]

```

You will also need an API Token from Loggly.

## Usage

Require **timbre** and **timbre-loggly**.

```clojure

(:require [taoensso.timbre :as timbre

    :refer-macros [log  trace  debug  info  warn  error  fatal  report

                  logf tracef debugf infof warnf errorf fatalf reportf

                  spy get-env]]

  [timbre.loggly :as loggly])

```

Set up the log appender

```clojure

(timbre/merge-config! {:appenders 

  {:loggly (loggly/loggly-appender 

    {:tags [:example  :timbre]}

     :token ""})}}))

```

Log away

```clojure

(log "Check me out on loggly.com")

```

### Configuration Parameters

#### `:token`

(reqired) The Loggly API key

#### `:tags`

(optional) A list of Loggly tags that will make it easier to identify your application among multiple apps sharing the same Loggly token.

## License

Apache License 2.0

## Contributing

Contributions (in the form of pull requests) are very welcome. Following areas would be most interesting:

- extend support to browser runtimes

- extend support to Clojure