Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us Check out our open positions

Sentry SDK for Clojure

A very thin wrapper around the official Java library for Sentry.

This project follows the version scheme MAJOR.MINOR.COMMITS where MAJOR and MINOR provide some relative indication of the size of the change, but do not follow semantic versioning. In general, all changes endeavour to be non-breaking (by moving to new names rather than by breaking existing names). COMMITS is an ever-increasing counter of commits since the beginning of this repository.

Usage

(require '[sentry-clj.core :as sentry])

; You can initialize Sentry manually by providing a DSN or use one of the
; other optional configuration options supplied as a map (see below).

(sentry/init! "https://public:[email protected]/1")

; Sending a simple message is easy...

(try
  (do-something-risky)
  (catch Exception e
    (sentry/send-event {:message "Something has gone wrong!"}
                        :throwable e})))

If you want an interpolated message, you need to provide the full map, i.e.,

(try
  (do-something-risky)
  (catch Exception e
    (sentry/send-event {:message {:message "Something %s has gone %s!"
                                  :params ["foo" "bar"]}
                        :throwable e})))

Additional Initialisation Options

Some examples:

Basic Initialisation (using defaults):

(sentry/init! "https://public:[email protected]/1")

Initialisation with additional options:

(sentry/init! "https://public:[email protected]/1" {:environment "staging" :debug true :release "[email protected]" :in-app-excludes ["foo.bar"])

(sentry/init! "https://public:[email protected]/1" {:before-send-fn (fn [event _] (when-not (= (.. event getMessage getMessage "foo")) event))})

(sentry/init! "https://public:[email protected]/1" {:before-send-fn (fn [event _] (.setServerName event "fred") event)})

(sentry/init! "https://public:[email protected]/1" {:contexts {:foo "bar" :baz "wibble"}})

Supported event keys

API Documentation

• :breadcrumbs - a collection of Breadcrumb maps. See below.
• :dist - a String which identifies the distribution.
• :environment - a String which identifies the environment.
• :event-id - a String id to use for the event. If not provided, one will be automatically generated.
• :extra - a map with Keyword or String keys (or anything for which clojure.core/name can be invoked) and values which can be JSON-ified. If :throwable is given, this will automatically include its ex-data.
  • note: :extra has been deprecated in favour of :contexts upon initialisation
• :fingerprint - a sequence of Strings that Sentry should use as a fingerprint.
• :level - a Keyword. One of :debug, :info, :warning, :error, :fatal. Probably most useful in conjunction with :message if you need to report an exceptional condition that's not an exception.
• :logger - a String which identifies the logger.
• :message - a map or String containing Message information. See below.
• :platform - a String which identifies the platform.
• :release - a String which identifies the release.
• :request - a map containing Request information. See below.
• :server-name - a String which identifies the server name.
• :tags - a map with Keyword or String keys (or anything for which clojure.core/name can be invoked) and values which can be coerced to Strings with clojure.core/str.
• :throwable - a Throwable object. Sentry's bread and butter.
• :transaction - a String which identifies the transaction.
• :user - a map containing User information. See below.

Breadcrumbs

API Documentation

When an event has a :breadcrumbs key, each element of the value collection should be a map. Each key is optional.

• :type - A String
• :level - a String
• :message - a String
• :category - a String
• :data - a map with String keys and String values

Message

API Documentation

When an event has a :message key, either a simple string can be used, or if you require a parameterised message, the following data should be contained within a map, thus:

• :formatted - A String containing the fully formatted message. If missing, Sentry will try to interpolate the message.
• :message - An optional String containing the raw message. If there are params, it will be interpolated.
• :params - An optional sequence of String's containing parameters for interpolation, e.g., `["foo" "bar"]

User

API Documentation

When an event has a :user key, the data following should be contained within a map. You should provide at either the id or the ip-address.

• :email - A String
• :id - A String
• :username - A String
• :ip-address - A String
• :other - A map containing key/value pairs of Strings, i.e., {"a" "b" "c" "d"}

Request

API Documentation

When an event has a :request key, the data should be contained within a map. Each key is optional.

• :url - A String
• :method - A String
• :query-string - A String
• :data - An arbitrary value (e.g., a number, a string, a blob...)
• :cookies - A String
• :headers - A map containing key/value pairs of Strings, i.e., {"a" "b" "c" "d"}
• :env - A map containing key/value pairs of Strings, i.e., {"a" "b" "c" "d"}
• :other - A map containing key/value pairs of Strings, i.e., {"a" "b" "c" "d"}

License

Copyright © 2021 Coda Hale, Sentry

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.