A fully fledged Bugsnag exception reporting client for Clojure.
- Automatically exposes ex-info data as metadata
- Ring middleware included, attaches ring request map as metadata
- Include snippet of code around stack trace lines
- Mark in-project stack traces to hide frameworks
- Pass along user IDs to Bugsnag
- Tested, used in production at 6 Wunderkinder for Wunderlist
clj-bugsnag is released via Clojars. The Latest stable release is 0.2.5
Leiningen dependency information:
[clj-bugsnag "0.2.5"]Maven dependency information:
<dependency>
<groupId>clj-bugsnag</groupId>
<artifactId>clj-bugsnag</artifactId>
<version>0.2.5</version>
</dependency>(require '[clj-bugsnag.core :as bugsnag]
'[clj-bugsnag.ring :as bugsnag.ring])
;; Ring middleware, all keys besides :api-key are optional:
(bugsnag.ring/wrap-bugsnag
handler
{:api-key "Project API key"
;; Defaults to "production"
:environment "production"
;; Project namespace prefix, used to hide irrelevant stack trace elements
:project-ns "your-project-ns-prefix"
;; A optional version for your app, this is displayed in bugsnag.
;; If not provided the latest git sha will be used - this means that
;; the git repo is available when you run your app.
:version "your-app-version"
;; A optional function to extract a user object from a ring request map
;; Used to count how many users are affected by a crash
:user-from-request (constantly {:id "shall return a map"})})
;; Manual reporting using the notify function:
(try
(some-function-that-could-crash some-input)
(catch Exception exception
;; Notify with options map, all keys are optional:
(bugsnag/notify
exception
{:api-key "Project API key"
;; Attach custom metadata to create tabs in Bugsnag:
:meta {:input some-input}
;; Pass a user object to Bugsnag for better stats
:user {:id ... :email ...}})
;; If no api-key is provided, clj-bugsnag
;; will fall back to BUGSNAG_KEY environment variable
(bugsnag/notify exception)))Copyright © 2014-2015 6 Wunderkinder GmbH.
Distributed under the Eclipse Public License, the same as Clojure.