Boop.Event (BoopEx v1.0.0)

Copy Markdown View Source

An event to send to Boop. Only title is required.

FieldNotes
titlerequired, truncated to 200 characters
bodytruncated to 4000 characters
level:info (default), :success, :warning, :error, :critical
sourcewhat produced it, e.g. "cron"; defaults to the configured source
typea category within the source, e.g. "deploy"
external_idyour own id for the event
fingerprinta stable grouping key
occurred_atDateTime, NaiveDateTime (assumed UTC) or ISO 8601 string; defaults to now
dataa map of anything JSON-serialisable; sensitive keys are redacted before sending

The keys exception, stacktrace, tags, context and breadcrumbs inside data get a rich rendering in Boop. See Boop.Event.exception/3 for a helper.

Summary

Types

level()
t()

Functions

exception(exception, stacktrace, extra \\ [])

Builds data for an error event from an exception and stacktrace, in the shape Boop renders richly.

levels()

The valid levels, in ascending severity.

new(input, config \\ [])

Builds and validates an event from a title, keyword list, map, or %Boop.Event{}.

to_payload(event, config \\ [])

Converts an event to the JSON-ready map the server expects, redacting sensitive keys in data and dropping data (with a note in body) if it is still over 256 KB.

Types

level()

@type level() :: :info | :success | :warning | :error | :critical

t()

@type t() :: %Boop.Event{
  body: String.t() | nil,
  data: map(),
  external_id: String.t() | nil,
  fingerprint: String.t() | nil,
  level: level(),
  occurred_at: DateTime.t() | nil,
  source: String.t() | nil,
  title: String.t() | nil,
  type: String.t() | nil
}

Functions

exception(exception, stacktrace, extra \\ [])

@spec exception(Exception.t(), Exception.stacktrace(), keyword()) :: map()

Builds data for an error event from an exception and stacktrace, in the shape Boop renders richly.

rescue e -> Boop.send(title: inspect(e.__struct__), level: :error,
                      data: Boop.Event.exception(e, __STACKTRACE__, tags: %{env: "prod"}))

levels()

@spec levels() :: [level()]

The valid levels, in ascending severity.

new(input, config \\ [])

@spec new(String.t() | keyword() | map() | t(), Boop.Config.t() | keyword()) ::
  {:ok, t()} | {:error, Boop.Error.t()}

Builds and validates an event from a title, keyword list, map, or %Boop.Event{}.

Strings that exceed their limits are truncated rather than rejected. Returns {:error, %Boop.Error{code: :invalid}} when the title is missing or the level is unknown.

to_payload(event, config \\ [])

@spec to_payload(t(), Boop.Config.t() | keyword()) :: map()

Converts an event to the JSON-ready map the server expects, redacting sensitive keys in data and dropping data (with a note in body) if it is still over 256 KB.