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](https://github.com/kmdreko/venator/releases) for: - Windows (x64) - MacOS (Intel, Apple silicon) ### With Cargo: Compiling and installing `venator` from 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/protobuf`. ### Using Rust Tracing: In your instrumented program: ```toml [dependencies] venator = "1.1.0" ``` ```rust use venator::Venator; Venator::default().install(); ``` See the [documentation](https://docs.rs/venator/latest/venator/) 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.