@mwillbanks/tuil-logging

OpenTelemetry-compatible log normalization parsers redaction indexing and query pipelines for tuil.

Overview

OpenTelemetry-compatible log normalization parsers redaction indexing and query pipelines for tuil.

@mwillbanks/tuil-logging is independently installable and also participates in the umbrella @mwillbanks/tuil runtime where applicable.

Installation

npm install @mwillbanks/tuil-logging

How it operates

Logging adapters normalize OpenTelemetry, JSON, syslog, journald, container, and text records, redact before retention, enrich, query, and export bounded data.

Documentation flow diagram. detect/parse; normalize; redact; enrich; retain/query; export; S0 leads to S1; S1 leads to S2 — **Documentation flow diagram.** detect/parse; normalize; redact; enrich; retain/query; export; S0 leads to S1; S1 leads to S2

API

API	Signature	Description
`builtInLogParsers`	`constant builtInLogParsers`	Public constant builtInLogParsers.
`commonLogParser`	`constant commonLogParser`	Public constant commonLogParser.
`compileLogQuery`	`function compileLogQuery`	Public function compileLogQuery.
`containerLogParser`	`constant containerLogParser`	Public constant containerLogParser.
`journaldParser`	`constant journaldParser`	Public constant journaldParser.
`jsonLogParser`	`constant jsonLogParser`	Public constant jsonLogParser.
`LogBufferStatistics`	`interface LogBufferStatistics`	Public interface LogBufferStatistics.
`LogDiagnostic`	`interface LogDiagnostic`	Public interface LogDiagnostic.
`LogEnricher`	`interface LogEnricher`	Public interface LogEnricher.
`LogParser`	`interface LogParser`	Public interface LogParser.
`LogPipeline`	`class LogPipeline`	Public class LogPipeline.
`LogRecord`	`interface LogRecord`	Public interface LogRecord.
`LogRedactor`	`interface LogRedactor`	Public interface LogRedactor.
`LogSource`	`type LogSource`	Public type LogSource.
`normalizeSeverity`	`function normalizeSeverity`	Public function normalizeSeverity.
`openTelemetryLogParser`	`constant openTelemetryLogParser`	Public constant openTelemetryLogParser.
`processLogParser`	`constant processLogParser`	Public constant processLogParser.
`syslogParser`	`constant syslogParser`	Public constant syslogParser.
`textLogParser`	`constant textLogParser`	Public constant textLogParser.

Events and lifecycle

Pipelines return normalized records and observable snapshots; original payloads are never exposed before redaction.

All subscriptions and registrations return a disposer or belong to an owning runtime that disposes them in reverse order.

Example

import { LogPipeline } from "@mwillbanks/tuil-logging";

const pipeline = new LogPipeline({ capacity: 100_000 });
pipeline.ingest(line);