@radzor/log-aggregator

Structured logging with multiple transports (console, HTTP, custom). Supports log levels, JSON formatting, context enrichment, and pluggable transport system. Zero dependencies.

v0.1.0typescriptpythonServerloggingstructuredtransportmonitoringobservabilityjsonby Radzor

Install

View source on GitHub →

$npx radzor@latest add log-aggregator

⚠ Constraints: Log entries below the configured level are silently discarded. The HTTP transport uses fetch() and is fire-and-forget — network failures do not throw. The file transport uses Node.js fs.appendFileSync — not available in browsers. Console transport works everywhere.

Inputs

Name	Type	Default	Description
level	'debug' \| 'info' \| 'warn' \| 'error' \| 'fatal'	info	Minimum log level. Messages below this level are discarded.
defaultMeta	Record<string, unknown>	—	Metadata attached to every log entry (e.g. service name, version).
transports	TransportConfig[]	—	Pre-configured transports to add on initialization.

level'debug' | 'info' | 'warn' | 'error' | 'fatal'

Minimum log level. Messages below this level are discarded.

default: info

defaultMetaRecord<string, unknown>

Metadata attached to every log entry (e.g. service name, version).

transports

{ "llm": { "constraints": "Log entries below the configured level are silently discarded. The HTTP transport uses fetch() and is fire-and-forget — network failures do not throw. The file transport uses Node.js fs.appendFileSync — not available in browsers. Console transport works everywhere.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/log-aggregator", "tags": [ "logging", "structured", "transport", "monitoring", "observability", "json" ], "events": [ { "name": "onLog", "payload": { "level": "string", "message": "string", "timestamp": "string" }, "description": "Fired for every log entry that passes the level filter." } ], "inputs": [ { "name": "level", "type": "'debug' | 'info' | 'warn' | 'error' | 'fatal'", "default": "info", "required": false, "description": "Minimum log level. Messages below this level are discarded." }, { "name": "defaultMeta", "type": "Record<string, unknown>", "required": false, "description": "Metadata attached to every log entry (e.g. service name, version)." }, { "name": "transports", "type": "TransportConfig[]", "required": false, "description": "Pre-configured transports to add on initialization." } ], "radzor": "1.0.0", "actions": [ { "name": "log", "params": [ { "name": "level", "type": "'debug' | 'info' | 'warn' | 'error' | 'fatal'", "description": "Log level." }, { "name": "message", "type": "string", "description": "Log message." }, { "name": "meta", "type": "Record<string, unknown>", "required": false, "description": "Additional metadata for this entry." } ], "returns": "void", "description": "Write a log entry at the specified level." }, { "name": "info", "params": [ { "name": "message", "type": "string", "description": "Log message." }, { "name": "meta", "type": "Record<string, unknown>", "required": false, "description": "Additional metadata." } ], "returns": "void", "description": "Shorthand for log('info', ...)." }, { "name": "warn", "params": [ { "name": "message", "type": "string", "description": "Log message." }, { "name": "meta", "type": "Record<string, unknown>", "required": false, "description": "Additional metadata." } ], "returns": "void", "description": "Shorthand for log('warn', ...)." }, { "name": "error", "params": [ { "name": "message", "type": "string", "description": "Log message." }, { "name": "meta", "type": "Record<string, unknown>", "required": false, "description": "Additional metadata." } ], "returns": "void", "description": "Shorthand for log('error', ...)." }, { "name": "setLevel", "params": [ { "name": "level", "type": "'debug' | 'info' | 'warn' | 'error' | 'fatal'", "description": "New minimum log level." } ], "returns": "void", "description": "Change the minimum log level at runtime." }, { "name": "addTransport", "params": [ { "name": "transport", "type": "Transport", "description": "Transport instance to add." } ], "returns": "void", "description": "Add a transport for log output." } ], "outputs": [ { "name": "logEntry", "type": "LogEntry", "fields": [ { "name": "level", "type": "string", "description": "Log level." }, { "name": "message", "type": "string", "description": "Log message." }, { "name": "timestamp", "type": "string", "description": "ISO 8601 timestamp." }, { "name": "meta", "type": "Record<string, unknown>", "description": "Merged metadata (default + per-entry)." } ], "description": "A structured log entry produced by the logger." } ], "runtime": "server", "version": "0.1.0", "category": "monitoring", "languages": [ "typescript", "python" ], "description": "Structured logging with multiple transports (console, HTTP, custom). Supports log levels, JSON formatting, context enrichment, and pluggable transport system. Zero dependencies.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "output": "logEntry", "mapField": "message", "compatibleWith": [ "@radzor/search-index.action.index.documents" ] }, { "event": "onLog", "description": "Forward critical logs to alerting", "compatibleWith": [ "@radzor/notification-hub.action.send.body", "@radzor/slack-bot.action.sendMessage.text" ] } ] } }

@radzor/log-aggregator

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json