Soma

Appearance

Telemetry & Logging ​

All Rust backends initialize tracing via soma_core::telemetry::init_tracing(...) (backend/crates/core/src/telemetry.rs).

Configuration ​

  • RUST_LOG: sets the log filter (for example: info, debug, soma_peer=debug,libp2p=info). If unset, each binary supplies a default filter (typically info).
  • SOMA_LOG_FORMAT: enables structured logging when set to json (also accepts structured, true, 1). If unset, logs are formatted as plain text.
  • SOMA_LOGS_DIR: enables file logging when set. Logs are written to a weekly-rotating file with the prefix log in that directory (the directory is created if missing). If unset, logs go to the default writer (stdout/stderr depending on runtime).
  • SOMA_FLAME_ENABLED: opt-in flame capture using tracing-flame + tracing-error. When set (1/true/yes/on), a folded stack file is written to a flame/ directory that sits next to the logs directory (or ./flame if SOMA_LOGS_DIR is unset). One .folded file is created per binary (<binary>.folded).

Examples ​

The remaining standalone backend binary is somad (with subcommands bot / relay / rendezvous / bff / all). The desktop side embeds the daemon + agent runtimes in-process inside the Tauri src-tauri host, so the same env vars (RUST_LOG, SOMA_LOG_FORMAT, SOMA_LOGS_DIR, SOMA_FLAME_ENABLED) apply when exported into the host process. In the packaged app, the desktop-services logger and tauri-plugin-log route output to the OS logs dir (~/Library/Logs/Soma/ on macOS, ~/.local/state/soma/logs/ on Linux).

Plain text to stdout/stderr (server binary):

bash
RUST_LOG=info cargo run -p somad -- bot --help

JSON to stdout/stderr:

bash
SOMA_LOG_FORMAT=json RUST_LOG=debug cargo run -p somad -- relay

JSON to a rolling file:

bash
SOMA_LOGS_DIR=./.data/logs/bot SOMA_LOG_FORMAT=json RUST_LOG=debug \
  cargo run -p somad -- bot

Flame capture alongside logs:

bash
SOMA_FLAME_ENABLED=1 SOMA_LOGS_DIR=./.data/logs/bot RUST_LOG=info \
  cargo run -p somad -- bot

# Convert folded stacks to an SVG flamegraph (requires inferno)
cat ./.data/flame/somad.folded | inferno-flamegraph > ./.data/flame/somad.svg