aingle-observability 0.1.0

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'

Component	Description
`core`	Module path filter
`[a]`	Span name filter
`{field="value"}`	Field value filter
`=debug`	Minimum log level

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

Tool	Purpose
jq	JSON processing
json2csv	Convert to CSV
tad	CSV viewer

Resources

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.