tracing_log_error

A utility crate to capture an error, and all its key error properties, in a tracing event.

use tracing_log_error::log_error;

let e = std::io::Error::new(std::io::ErrorKind::Other, "My error");
tracing_log_error::log_error!(e, "The connection was dropped");

The log_error! invocation captures:

• The Display representation of the error, in the error.message field.
• The Debug representation of the error, in the error.details field.
• The chain of error sources, in the error.source_chain field.

Using raw tracing, the equivalent would be:

use tracing::{event, Level};
use tracing_log_error::fields;

let e = std::io::Error::new(std::io::ErrorKind::Other, "My error");
event!(
    Level::ERROR,
    {{ fields::ERROR_MESSAGE }} = fields::error_message(&e),
    {{ fields::ERROR_DETAILS }} = fields::error_details(&e),
    {{ fields::ERROR_SOURCE_CHAIN }} = fields::error_source_chain(&e),
    "The connection was dropped"
);

Installation

To use log_error!, add both tracing and tracing_log_error to your Cargo.toml:

[dependencies]
tracing = "0.1"
tracing-log-error = "0.1"

Advanced usage

Check out log_error!'s documentation for more examples and details. You can customize the log level, add custom fields, and more.