Articles
Practical guides on structured logging, request tracing, redaction and log export.
Logging in Cloudflare Workers: Structured Logs and ctx.waitUntil
Structured logging in Cloudflare Workers: JSON console logs, per-request context, and flushing batched logs with ctx.waitUntil, using logixia/browser.
NestJS Logging with Request Tracing and Trace IDs
Add structured JSON logging and a trace ID to every request in NestJS with logixia - module setup, header propagation, error logging via an exception filter.
Pino vs Winston vs logixia: Node.js Logging Libraries Compared
An honest comparison of pino, winston and logixia for Node.js - features, ecosystem, maturity, a small benchmark run, and when to pick each logger.
Send Node.js Error Alerts to Slack and Discord from Logs
Turn error logs into Slack and Discord alerts without alert storms, accidental @everyone pings or leaked webhook URLs. Working logixia examples.
Ship Node.js Logs to Datadog and CloudWatch with logixia
Send Node.js logs to Datadog and AWS CloudWatch together: batching, retries, buffer limits, site and credential setup, and when an agent is better.
Express Request Logging with a Trace ID (Correlation ID)
Log every Express request with a trace ID that follows the request through async code. Covers traceparent, x-request-id, AsyncLocalStorage and logixia.
How to Redact Sensitive Data in Node.js Logs
Keep tokens, cookies and PII out of Node.js logs. Path vs pattern redaction, error and URL gotchas, regex pitfalls, and a working logixia config.
Migrate from Winston to logixia: A Practical Mapping Guide
Move a Node.js app from winston to logixia step by step: levels, transports, formats and child loggers with before and after code, plus the gaps.
OpenTelemetry Logs in Node.js: Correlate and Export over OTLP
Correlate Node.js logs with OpenTelemetry traces and export them over OTLP to a Collector, Grafana Loki, Axiom or Better Stack with logixia.
Structured Logging in TypeScript: Wide Events and Typed Fields
A practical guide to structured logging in TypeScript - JSON logs, child loggers, canonical log lines (wide events) and typed log fields, with logixia examples.
/README
Analytics Transports
Send logixia entries as events to Mixpanel, Segment or Google Analytics 4, with batching, reserved key handling, a bounded buffer and per-provider options.
API overview
Every logixia import path and what it exports: logger, context, redaction, metrics, NestJS, middleware, correlation, transports, browser, search and testing.
Articles
Practical guides on structured logging, request tracing, redaction and log export with Logixia.
AWS CloudWatch Transport
Send logixia logs to AWS CloudWatch Logs with batched PutLogEvents calls, no AWS SDK, SigV4 signing, a credential chain and optional EMF metrics.
Azure Monitor Transport
Send logixia logs to Azure Monitor with the Logs Ingestion API and a Data Collection Rule, using OAuth2 client credentials, severity mapping and batching.
Browser and edge runtimes
Use logixia/browser in web pages, Cloudflare Workers, Vercel Edge and Deno: a Node-free logger with console and batched remote transports.
Child loggers and context
Attach request IDs and user IDs to every log entry with logixia child loggers and AsyncLocalStorage-based LogixiaContext, without passing fields around.
Command line tool
Analyze, search, query, tail, export and explore JSON log files from the terminal with the logixia CLI, including SQL-like queries and an interactive explorer.
Configuration
Reference for every logixia LoggerConfig option with types and defaults: levels, fields, redaction, sampling, tracing, graceful shutdown and transports.
Console Transport
Configure the logixia console transport for colored text or compact JSON output on stdout and stderr, with custom level colors, timestamps and filters.
Custom Transports
Write your own logixia transport with ITransport, add flush, close and readiness hooks for batching, and configure retry, backoff and fallback transports.
Customizing output
Customize logixia output - level colors, custom levels, which fields appear, JSON or text format, and per-environment setups for development and production.
Database Transport
Store logixia logs in PostgreSQL, MySQL, MongoDB or SQLite with batched inserts, automatic tables, bounded buffering and isolation of rows the database rejects.
Datadog Transport
Ship logixia logs to Datadog with the v2 Logs intake, regional sites, optional gzip, status mapping, trace correlation through dd.trace_id and optional metrics.
FAQ
Answers to common logixia questions: missing debug logs, no console output with transports, await and flushing, NestJS imports, TypeScript errors and sampling.
File Transport
Write logixia logs to files with size, date and interval rotation, gzip archives, retention, JSON, text or CSV formats, and a bounded in-memory queue.
Getting started
Install logixia, create a TypeScript logger, add file and console transports, attach request context and flush logs before your Node.js process exits.
Google Cloud Logging Transport
Send logixia logs to Google Cloud Logging with severity mapping, Cloud Trace correlation, monitored resources, metadata-server auth and service account keys.
Graceful shutdown
Flush logixia transports on SIGTERM and SIGINT so the last seconds of logs survive deploys and restarts, with timeout, exit mode and hook options.
HTTP request logging
Log Express and Fastify requests with logixia/middleware: start and finish entries, slow request warnings, header and query redaction and trace IDs.
Introduction
logixia is an async-first TypeScript logger for Node.js with trace IDs, redaction, sampling, NestJS support and transports for files, databases and clouds.
Log levels
Built-in and custom logixia log levels, how the active level is chosen, runtime changes, per-namespace levels and the LOGIXIA_LEVEL environment variable.
Log search and analysis
Search, correlate and analyze logs in memory with logixia/search SearchManager: filters, natural language queries, trace correlation, patterns and export.
logixia: structured logging, request tracing and export for Node.js
Structured logging, request tracing and multi-destination export for Node.js, NestJS and the edge, in one TypeScript-first library.
Migrating to 2.0
Upgrade logixia from 1.x to 2.0: NestJS exports moved to logixia/nest, plus behaviour changes from 1.13.3 to 2.0.4 in redaction, transports and tracing.
NestJS integration
Use logixia in NestJS: LogixiaLoggerModule, LogixiaLoggerService, trace IDs, LogixiaExceptionFilter, LogMethod and Kafka or WebSocket interceptors.
OpenTelemetry integration
Correlate logixia logs with OpenTelemetry traces using initOtelBridge, read the active span context, and export logs over OTLP with OtlpLogTransport.
OTLP Logs Transport
Export logixia logs as OTLP/HTTP JSON to an OpenTelemetry Collector, Grafana Loki, Axiom or Better Stack, with trace ID correlation and severity mapping.
Plugins
Extend logixia with plugins that enrich, filter or observe every log entry, react to transport failures and run shutdown hooks, per logger or globally.
Prometheus metrics from logs
Turn structured log fields into Prometheus counters, histograms and gauges with the logixia metrics plugin, including /metrics and label cardinality limits.
Redaction
Keep passwords, tokens and personal data out of logs with logixia redact: dot-path rules, regex patterns, autoDetect presets and fail-closed behaviour.
Sampling and rate limiting
Cut log volume with logixia sampling - global and per-level rates, trace-consistent sampling, a per-second cap and adaptive boosting when errors spike.
Security
How logixia protects secrets and your supply chain: redaction, hidden transport credentials, validated IDs, escaped output, npm provenance and reporting.
Slack and Discord Transports
Post logixia error alerts to Slack incoming webhooks or Discord webhooks with batching, mention-safe escaping, 429 retry handling and custom formatters.
Testing with the mock logger
Assert on log output in Jest or Vitest with logixia/testing createMockLogger - record calls, match messages and fields, and verify that nothing was logged.
Tracing and correlation IDs
Propagate trace and correlation IDs through Node.js services with logixia: traceparent, runWithTraceId, LogixiaContext, Express, Fastify, fetch and Kafka.
Transports Overview
Choose a logixia transport for console, file, database, CloudWatch, GCP, Azure, Datadog, OTLP, Slack or workers, and learn level, filter and retry options.
Typed logger and log schemas
Get autocomplete and compile-time checks for log fields with createTypedLogger, and catch missing or mistyped fields in development with defineLogSchema.
Wide events
Emit one dense canonical log line per request or job with logixia wide events: accumulate fields anywhere and log once, even when the handler throws.
Worker Thread Transport
Run the logixia file, database or console transport in a Node.js worker thread to keep serialization and I/O off the main event loop, with automatic restarts.