observability

Structured contextual logging and tracing for AIngle

Overview

Structured contextual logging built on tracing. This crate provides experimental observability features for AIngle distributed systems, including console output, JSON logging, and span filtering.

Features

• Structured logging - Context-aware log events with spans
• Multiple outputs - Console, JSON, and custom formatters
• Powerful filtering - Filter by module, span, or field values
• Zero-cost abstractions - Disabled spans compile to no-ops

Installation

[dependencies]
observability = "0.1"

Quick Start

Console Logging

# Simple logging
RUST_LOG=trace cargo run

# Filtered logging
RUST_LOG='core[a{something="foo"}]=debug' cargo run

JSON Output

RUST_LOG='core[{}]=debug' cargo run --structured Json > log.json

Filter Syntax

# Module + span + field filtering
RUST_LOG='core[a{something="foo"}]=debug'

# Multiple filters
RUST_LOG='[{}]=error,[{something}]=debug'

JSON Output

{
  "time": "2024-01-01T00:00:00.000Z",
  "name": "event",
  "level": "INFO",
  "target": "my_module",
  "file": "src/lib.rs",
  "line": 42,
  "fields": {"message": "Hello"},
  "spans": [{"name": "request", "id": 1}]
}

Useful Tools

Resources

• Why Tracing? (Video)
• Tokio Tracing Blog
• EnvFilter Documentation

Part of AIngle

This crate is part of the AIngle ecosystem - a Semantic DAG framework for IoT and distributed AI applications.

License

Licensed under the MIT License. See LICENSE for details.

_{Maintained by Apilium Technologies - Tallinn, Estonia}