📩 Installation

bun add logixlysia

📝 Usage

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

Configuration

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)

✨ Features

• Request context: accumulate fields with mergeContext into a context tree. Docs
• Presets: dev, prod, and json output. 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: autoRedact masks PII by pattern; logixlysia/desertant adds neural redaction. Config docs, Neural redaction docs
• Structured errors: HttpError carries why, fix, and link. Docs
• Request IDs: read from the incoming request or generated, when requestId is on (the prod preset turns it on). Docs
• OpenTelemetry: trace correlation and AI usage metrics on the access log. Docs
• WebSocket logging: lifecycle logs via wrapWs. Docs

📚 Documentation

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.

📄 License

Licensed under the MIT License.