Venator is a application for recording, viewing, and filtering logs and spans from programs instrumented with the Rust tracing crate or using OpenTelemetry. It is purpose-built for rapid local development.

Installation

With Pre-built Binaries:

Binaries are pre-built and available in the releases page for:

• Windows (x64)
• MacOS (Intel, Apple silicon)

With Cargo:

Compiling and installing venator source with Cargo (requires Rust 1.76 or newer):

cargo install venator-app

Usage

Using OpenTelemetry:

Configure your program's OpenTelemetry SDK to export logs and traces to 127.0.0.1:8362 (Venator's default listening port) and to use GRPC or HTTP with binary encoding.

Using Rust Tracing:

In your instrumented program:

[dependencies]
venator = "1.0.0"

use venator::Venator;

Venator::default().install();

See the documentation for more.

Features

Events can be viewed narrowed by timespan and filtered by attributes, level, and other properties. The table of records can include columns of custom properties. The graph shows the counts by level at each bar.

Spans can likewise be narrowed by timespan and filter. A detail pane can show all the properties of selected events and spans. The graph shows spans layered hierarchically.

Traces can be viewed that show both events and spans within a single execution.