Struct opentracingrust::Log

pub struct Log { /* fields omitted */ }

Structured logging information to attach to spans.

Each log has a set of vaules idenfied by strings. Values stored in fields can be of any type convertible to a LogValue.

Logs also have an optional timestamp. If set, the timestamp must be between the start and the end of the span.

Examples

extern crate opentracingrust;

use std::thread;
use std::time::Duration;
use std::time::SystemTime;

use opentracingrust::Log;
use opentracingrust::tracers::NoopTracer;


fn main() {
    let (tracer, _) = NoopTracer::new();
    let mut span = tracer.span("example");

    let time = SystemTime::now();
    thread::sleep(Duration::from_millis(50));

    let log = Log::new()
        .log("error", false)
        .log("event", "some-event")
        .log("line", 26)
        .at(time);
    span.log(log);
}

Methods

impl Log

pub fn new() -> Log

Creates an empty structured log.

impl Log

pub fn at(self, timestamp: SystemTime) -> Log

Sets the timestamp associated with the log.

pub fn at_or_now(&mut self)

Sets the timestamp to now if not set.

pub fn log<LV: Into<LogValue>>(self, key: &str, value: LV) -> Log

Extend the log fields with the given value.

If a value with the same key is already in the log the value is replaced.

pub fn iter(&self) -> Iter<String, LogValue>

Access an iterator over stored fields.

pub fn timestamp(&self) -> Option<&SystemTime>

Access the (optional) timestamp for the log.

Trait Implementations

impl Debug for Log

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Default for Log

fn default() -> Log

Returns the "default value" for a type.