Crate sentry_log

Adds support for automatic Breadcrumb and Event capturing from logs.

The log crate is supported in two ways. First, logs can be captured as breadcrumbs for later. Secondly, error logs can be captured as events to Sentry. By default anything above Info is recorded as a breadcrumb and anything above Error is captured as error event.

Examples

let mut log_builder = pretty_env_logger::formatted_builder();
log_builder.parse_filters("info");
let logger = sentry_log::SentryLogger::with_dest(log_builder.build());

log::set_boxed_logger(Box::new(logger)).unwrap();
log::set_max_level(log::LevelFilter::Info);

let _sentry = sentry::init(());

log::info!("Generates a breadcrumb");
log::error!("Generates an event");

Or one might also set an explicit filter, to customize how to treat log records:

use sentry_log::LogFilter;

let logger = sentry_log::SentryLogger::new().filter(|md| match md.level() {
    log::Level::Error => LogFilter::Event,
    _ => LogFilter::Ignore,
});

Structs

• NoopLogger
  A noop log::Log that just ignores everything.
• SentryLogger
  Provides a dispatching logger.

Enums

• LogFilter
  The action that Sentry should perform for a log::Metadata.
• RecordMapping
  The type of Data Sentry should ingest for a log::Record.

Functions

• breadcrumb_from_record
  Creates a Breadcrumb from a given log::Record.
• convert_log_level
  Converts a log::Level to a Sentry Level
• default_filter
  The default log filter.
• event_from_record
  Creates an Event from a given log::Record.
• exception_from_record
  Creates an exception Event from a given log::Record.