LogQuill is one logging library in nine languages. The behaviour that must be identical in every language lives once, in Rust. Each language gets a thin, idiomatic SDK on top.
flowchart TB
subgraph Apps["Your applications"]
PY[Python] --- NODE[Node / TS] --- WEB[Browser / Edge]
JVM[Java / Kotlin] --- NET[.NET] --- GO[Go] --- RB[Ruby] --- SW[Swift]
end
subgraph Bindings["bindings/ — one SDK per language"]
direction LR
B1["Native glue<br/>PyO3 · napi-rs · wasm-bindgen"]
B2["C ABI glue<br/>JNA · P/Invoke · ffi gem · XCFramework"]
B3["Go: core.wasm in wazero"]
end
subgraph Rust["crates/ — the Rust core"]
FFI["logquill-ffi<br/>stable C ABI"]
RT["logquill-runtime<br/>queue · worker · transports · watchers"]
CORE["logquill-core<br/>records · pipeline · plugins · privacy · integrity"]
CLI["logquill-cli<br/>tail · trace · dev · serve · verify"]
end
SCHEMA[("schema/<br/>record schema + golden records + corpus")]
Apps --> Bindings
B1 --> RT
B2 --> FFI --> RT
B3 --> CORE
RT --> CORE
CLI --> RT
SCHEMA -. "every language must pass" .-> CORE
SCHEMA -. "and its own SDK" .-> Bindings
| Layer | Path | Owns | Does not own |
|---|---|---|---|
| Core | crates/logquill-core |
Records, levels, the log-call pipeline, built-in plugins, privacy policy, redaction, hash chain, formatters, trace-id rules, OTel semconv mapping, trace-tree builder |
I/O, threads, clocks (the clock is injected) |
| Runtime | crates/logquill-runtime |
Bounded dispatch queue, one worker thread, console / file / syslog / SQLite / HTTP-family / OTLP transports, alert senders, level watchers | Anything language-specific |
| C ABI | crates/logquill-ffi |
A stable C interface and generated header (include/logquill.h) |
Policy: it forwards, it decides nothing |
| CLI | crates/logquill-cli |
The logquill command and its embedded viewer |
|
| Checks | crates/logquill-runtime-checks |
Tests that need unsafe (a real fork, a counting allocator). Not published |
|
| Bindings | bindings/<language> |
Context propagation, framework adapters, SDK patching, host-driver transports, exit hooks | Redaction, hashing, sampling, formatting: those run in Rust |
| Schema | schema/ |
The JSON Schema of a record and the fixtures every language runs |
The core forbids unsafe (unsafe_code = "forbid" at the workspace level). The binding macros
that expand to unsafe are kept out of the workspace so that this holds.
sequenceDiagram
participant App as Your code
participant SDK as Language SDK
participant Core as logquill-core (Logger)
participant Q as Bounded queue
participant W as Worker thread
participant T as Transports
App->>SDK: logger.info("msg", **meta)
SDK->>SDK: attach context (request, span) and convert meta to JSON
SDK->>Core: log(level, logger, message, meta, llm?)
Core->>Core: level check · enable/disable rules
Core->>Core: content policy (prompts off by default)
Core->>Core: plugins in order (redact → PII → sample → chain …)
Core-->>Q: enqueue formatted record
Q-->>W: drain in batches
W->>T: write(formatted, record)
Points worth knowing:
logger.use(fn)) is a callback.| Place | Bound |
|---|---|
| Dispatch queue | Configurable size; drop_oldest (default), drop_newest or block; a drop warning at most once a minute |
| Batching transports | Both record count and estimated bytes |
| Sampling / elevation / dedupe state | Capped id sets |
| Flight recorder | A strict per-run ring buffer |
| The trace viewer | Streams the log file line by line |
Backpressure and allocations per log call are measured in CI.
| Tier | Languages | How the core is reached |
|---|---|---|
| Native | Python, Node | A compiled extension (PyO3 abi3 wheel; napi-rs addon). Node falls back to WebAssembly where no addon exists |
| WebAssembly | Browsers, Deno, Bun, Workers (@logquill/wasm); Go |
The core compiled to Wasm; Go runs it in wazero, with no cgo |
| C ABI | Ruby, .NET, JVM, Swift | logquill-ffi through the language’s foreign-function layer |
Every binding exposes the same names (casing aside) and the same record shape. The public names are listed per language in API names; what they guarantee is in the contract.
gen_ai.* attribute name lives in one file
(semconv), pinned to one semantic-conventions version.opt(depth)), lazy
callables, tracebacks, framework adapters, SDK patching and driver-based transports (Kafka, Postgres,
Mongo …) are written in each language, because they have to touch host objects.schema/record.schema.json defines a record.schema/golden_records.json, golden_chain.json and golden_otel_ids.json pin exact outputs.schema/corpus/ is a shared set of 865 hostile-input cases across 22 groups. Each binding runs it.miri on the worker and queue.If you change shared behaviour, change the core and the fixtures together; see CONTRIBUTING.