bun add logixlysiaWorks with Elysia 1.4 and the Elysia 2 prereleases. To try Elysia 2, install it from its rc tag (bun add elysia@rc); what changes on Elysia 2.
Add the plugin, then log from a handler with log. Fields you add with log.mergeContext land on that request's access line.
import { Elysia } from 'elysia'
import logixlysia from 'logixlysia'
new Elysia()
.use(logixlysia())
.get('/users/:id', ({ log, params }) => {
log.mergeContext({ userId: params.id })
return { id: params.id }
})
.listen(3000)GET /users/42 prints this when the output is piped or colors are off:
2026-11-12T05:54:29.847Z INFO GET /users/42 200 1ms
ββ userId 42
import { Elysia } from 'elysia'
import logixlysia from 'logixlysia' // or import { logixlysia } from 'logixlysia'
const app = new Elysia({
name: 'Elysia with Logixlysia'
})
.use(
logixlysia({
config: {
service: 'api-server',
showStartupMessage: true,
startupMessageFormat: 'banner',
showContextTree: true,
contextDepth: 2,
slowThreshold: 500,
verySlowThreshold: 1000,
timestamp: {
translateTime: 'yyyy-mm-dd HH:MM:ss.SSS'
},
ip: true
}
})
)
.get('/', () => {
return { message: 'Welcome to Basic Elysia with Logixlysia' }
})
app.listen(3000)logFilter takes path globs, so health checks and static assets stay out of your logs. A request whose pathname matches exclude, or misses a non-empty include, writes nothing: no access line, no log.* lines from its handler, no error line, no WebSocket lines. exclude wins over include. ** crosses /; * and ? do not.
logixlysia({
config: {
logFilter: {
include: ['/api/**'],
exclude: ['/api/internal/**']
}
}
})- Request context: accumulate fields with
mergeContextinto a context tree. Docs - Presets:
dev,prod, andjsonoutput. Docs - File logging: writes to disk with rotation by size, age, or count. Docs
- Adapters: nine built-in destinations, Axiom, Better Stack, ClickHouse, Datadog, HyperDX, Loki, OTLP, PostHog, and Sentry. Docs
- Sampling: head and tail sampling controls log volume. Docs
- Enrichers: add trace, user agent, geo, and size fields to every request. Docs
- Redaction:
autoRedactmasks PII by pattern;logixlysia/desertantadds neural redaction. Config docs, Neural redaction docs - Structured errors:
HttpErrorcarrieswhy,fix, andlink. Docs - Request IDs: read from the incoming request or generated, when
requestIdis on (theprodpreset turns it on). Docs - OpenTelemetry: trace correlation and AI usage metrics on the access log. Docs
- WebSocket logging: lifecycle logs via
wrapWs. Docs
Check out the website for more detailed documentation and examples.
Using a coding agent? The repo ships an agent skill with the API and conventions.
Licensed under the MIT License.
