emit

Crates.ioemit
lib.rsemit
version0.11.0-alpha.6
sourcesrc
created_at2015-08-08 09:03:14.543574
updated_at2024-06-28 00:23:03.000578
descriptionStructured diagnostics for Rust applications.
homepage
repositoryhttps://github.com/emit-rs/emit
max_upload_size
id2786
size196,977
Ashley Mannix (KodrAus)

documentation

README

emit

all

Current docs

Developer-first diagnostics

emit is a framework for manually instrumenting Rust applications with an expressive syntax inspired by Message Templates.

emit represents all diagnostics as events; a combination of timestamp or timespan, template, and properties. Traditional log records, spans in a distributed trace, and metric samples are all represented as events. Having a unified model of all these signals means you can always capture your diagnostics in one way or another.

[dependencies.emit]
version = "0.11.0-alpha.6"

[dependencies.emit_term]
version = "0.11.0-alpha.6"
use std::time::Duration;

fn main() {
    let rt = emit::setup()
        .emit_to(emit_term::stdout())
        .init();

    greet("Rust");

    rt.blocking_flush(Duration::from_secs(5));
}

#[emit::span("Greet {user}")]
fn greet(user: &str) {
    emit::info!("Hello, {user}!");
}

The output of running the above program

Current status

This is alpha-level software. It implements a complete framework but has almost no tests and needs a lot more documentation.

Getting started

See the examples directory and emit documentation to get started with emit.

Where can I send my diagnostics?

Diagnostics produced by emit are sent to an emitter. This repository currently implements the following emitters:

  • emit_term for writing human-readable output to the console.
  • emit_file for writing JSON or another machine-readable format to rolling files.
  • emit_otlp for sending diagnostics to an OpenTelemetry compatible collector.
  • emit_opentelemetry for integrating emit into an application using the OpenTelemetry SDK for its diagnostics.
Commit count: 133

cargo fmt