raven.client — exoscale/raven 0.4.15

A netty-based Sentry client.

add-breadcrumb! clj

(add-breadcrumb! breadcrumb)

(add-breadcrumb! context breadcrumb)

Append a breadcrumb to the list of breadcrumbs.

The context is expected to be a map, and if no context is specified, a thread-local storage map will be used instead.

add-breadcrumbs-to-payload clj

(add-breadcrumbs-to-payload context payload)

add-contexts-to-payload clj

(add-contexts-to-payload payload)

Add relevant bits of sentry.interfaces.Contexts to our payload.

add-exception! clj

(add-exception! e)

(add-exception! context e)

Add an exception to the context (or a thread-local storage).

add-extra! clj

(add-extra! extra)

(add-extra! context extra)

Add a map of extra data to the context (or a thread-local storage) preserving its previous keys.

add-fingerprint! clj

(add-fingerprint! fingerprint)

(add-fingerprint! context fingerprint)

Add a custom fingerprint to the context (or a thread-local storage).

add-fingerprint-to-payload clj

(add-fingerprint-to-payload context payload)

If the context provides a fingerprint override entry, pass it to the payload.

add-full-ring-request! clj

(add-full-ring-request! request)

(add-full-ring-request! context request)

Add HTTP information to the Sentry payload from a ring-compliant request map, including the request body

add-http-info! clj

(add-http-info! http-info)

(add-http-info! context http-info)

Add HTTP information to the sentry context (or a thread-local storage).

add-http-info-to-payload clj

(add-http-info-to-payload context payload)

add-ring-request! clj

(add-ring-request! request)

(add-ring-request! context request)

Add HTTP information to the Sentry payload from a ring-compliant request map, excluding its body.

add-tag! clj

(add-tag! tag value)

(add-tag! context tag value)

Add a custom tag to the context (or a thread-local storage).

add-tags! clj

(add-tags! tags)

(add-tags! context tags)

Add custom tags to the context (or a thread-local storage).

add-tags-to-payload clj

(add-tags-to-payload context payload tags)

If the context provides tags or we were given tags directly during capture!, ad them to the payload. Tags provided by capture! override tags provided by the context map.

add-user! clj

(add-user! user)

(add-user! context user)

Add user information to the sentry context (or a thread-local storage).

add-user-to-payload clj

(add-user-to-payload context payload)

add-uuid-to-payload clj

(add-uuid-to-payload context payload)

auth-header clj

(auth-header ts key sig)

Compute the Sentry auth header.

capture! clj

(capture! dsn ev)

(capture! dsn ev tags)

(capture! context dsn event tags)

Send a capture over the network. If ev is an exception, build an appropriate payload for the exception.

clear-context clj

(clear-context)

Reset this thread's context

clear-http-stub clj

(clear-http-stub)

A convenience function to clear the http stub.

This stub is only used when passing a DSN of ':memory:' to the lib.

closable? clj

close-http-connection clj

(close-http-connection response)

When having a connection pool set, the body cannot be closed as it's of a different type.

default-payload clj

(default-payload ts localhost)

Provide default values for a payload.

dsn-pattern clj

The shape of a sentry DSN

get-contexts clj

(get-contexts)

get-full-ring-url clj

(get-full-ring-url request)

Given a ring compliant request object, return the full URL. This was lifted from ring's source code so as to not depend on it.

get-hostname clj

(get-hostname)

Get the current hostname by shelling out to 'hostname'

get-linux-pretty-name clj

(get-linux-pretty-name)

Get the Linux distribution pretty name from /etc/os-release resp. /usr/lib/os-release.

get-os-context clj

(get-os-context)

get-os-name-linux clj

(get-os-name-linux)

Get a human-readable name for the current linux distribution from /etc/os-release, caching the output

get-ring-env clj

(get-ring-env request)

hostname clj

(hostname [age val])

Fetches the hostname by shelling to 'hostname', whenever the given age is stale enough. If the given age is recent, as defined by hostname-refresh-interval, returns age and val instead.

hostname-refresh-interval clj

How often to allow reading /etc/hostname, in seconds.

http-requests-payload-stub clj

Storage for stubbed http 'requests' - actually, we store just the request's payload in clojure form (before it's serialized to JSON).

json-mapper clj

localhost clj

(localhost)

Returns the local host name.

make-breadcrumb! clj

(make-breadcrumb! message category)

(make-breadcrumb! message category level)

(make-breadcrumb! message category level timestamp)

Create a breadcrumb map.

level can be one of: ['debug' 'info' 'warning' 'warn' 'error' 'exception' 'critical' 'fatal']

make-http-info clj

(make-http-info url method)

(make-http-info url method headers query_string cookies data env)

make-ring-request-info clj

(make-ring-request-info request)

Create well-formatted context map for the Sentry 'HTTP' interface by extracting the information from a standard ring-compliant 'request', as defined in https://github.com/ring-clojure/ring/wiki/Concepts#requests

make-user clj

(make-user id)

(make-user id email ip-address username)

Create a user map.

merged-payload clj

(merged-payload event ts localhost)

Return a payload map depending on the type of the event.

parse-dsn clj

(parse-dsn dsn)

Extract DSN parameters into a map

payload clj

(payload context event ts localhost tags)

Build a full valid payload.

perform-http-request clj

(perform-http-request context dsn ts payload)

perform-in-memory-request clj

(perform-in-memory-request payload)

Perform an in-memory pseudo-request, actually just storing the payload on a storage atom, to let users inspect/retrieve the payload in their tests.

re-throw-response clj

(re-throw-response response)

Throw the response in case of its status was not 2xx as we don't want Sentry errors to be unnoticed.

release! clj

(release! webhook-endpoint payload)

Release new application version with provided webhook release URL.

safe-map clj

Wraps map into SafeMap record, effectively hidding values from json output, will not allow 2-way roundtrip. ex: (safe-map {:a 1}) -> "#exoscale/safe-map [:a]". Can be used to hide secrets and/or shorten large/deep maps

SafeMap clj

sentry-uuid! clj

(sentry-uuid!)

A random UUID, without dashes

sign clj

(sign payload ts key secret)

HMAC-SHA1 for Sentry's format.

slurp-pretty-name clj

(slurp-pretty-name path)

thread-storage clj

Storage for this particular thread.

This is a little funny in that it needs to be dereferenced once in order to obtain an atom that is sure to be per-thread.

timestamp! clj

(timestamp!)

Retrieve a timestamp.

The format used is the same as python's 'time.time()' function - the number of seconds since the epoch, as a double to acount for fractional seconds (since the granularity is miliseconds).

user-agent clj

Our advertized UA

validate-payload clj

(validate-payload merged)

Returns a validated payload.