ArctonArcton
Integraciones

Logging

Loguea cada request con @arcton/logger — un middleware de logging sin ninguna dependencia en runtime.

@arcton/logger loguea una línea por request — método, path, status, duración — sin ninguna dependencia en runtime. Es un único middleware: ninguna configuración vive en Arcton() ni en listen().

Instalación

bun add @arcton/logger

Uso básico

index.ts
import { Arcton } from '@arcton/core'
import { logger } from '@arcton/logger'

const app = Arcton()

app.use(logger())

app.get('/users/:id', ctx => ({ id: ctx.params.id }))

app.listen()

Cada request ahora produce una línea de JSON, una vez que se conoce la respuesta:

{"level":"info","time":"2026-09-14T16:00:00.000Z","msg":"GET /users/1 200 0.4ms","method":"GET","path":"/users/1","status":200,"durationMs":0.4}

El status decide el nivel

import { Arcton } from '@arcton/core'
import { logger } from '@arcton/logger'

const app = Arcton()

app.use(logger())

app.get('/ok', () => ({ ok: true })) // logueado a info
app.get('/missing', ctx => {
  ctx.response.status = 404 // logueado a warn (4xx)
  return { error: 'not found' }
})
app.get('/boom', () => {
  throw new Error('kaboom') // logueado a error
})

app.listen()

Una respuesta 2xx/3xx se loguea a info, una 4xx a warn, una 5xx a error — ningún handler tiene que loguear nada por su cuenta. Si un request falla y nada aguas abajo captura el error, el logger lo loguea a error con el error adjunto y vuelve a lanzarlo sin modificarlo, así que el manejo de errores (un handler de onError(), o ninguno) se comporta exactamente igual que sin el logger.

Modo pretty

pretty: true cambia JSON por un formato pensado para leerse en vivo, en una terminal — sin dependencia que instalar, sin transport que configurar:

import { Arcton } from '@arcton/core'
import { logger } from '@arcton/logger'

const app = Arcton()

app.use(logger({ pretty: process.env.NODE_ENV !== 'production' }))

app.get('/users/:id', ctx => ({ id: ctx.params.id }))

app.listen()

Un request ahora imprime dos líneas en vez de una — → cuando llega, ← cuando termina — cada una con el mismo level que llevaría una línea de JSON, escrito y coloreado, no solo implícito por el color:

→ INFO  16:00:00.000 GET    /users/1
← INFO  16:00:00.004 200 GET    /users/1 0.4ms

Un request que falla sin que nada capture el error queda etiquetado ERROR en vez de un status — no hay ninguno, igual que la línea de JSON para este caso no tiene campo status — con el mensaje del error al final:

→ INFO  16:00:01.000 GET    /boom
← ERROR 16:00:01.001 GET    /boom 0.1ms kaboom

level sigue filtrando qué se imprime: 'silent' no imprime nada, y un nivel por encima del que tendría un request dado (un mínimo warn, por ejemplo) descarta la línea → de llegada y cualquier línea ←/ERR que tampoco lo supere.

Child loggers

log.child(bindings) devuelve un nuevo logger con bindings mezclado en cada record que escriba de ahí en adelante — útil para etiquetar cada línea de una parte de la app sin repetir esos campos en cada llamada:

import { createLogger } from '@arcton/logger'

const log = createLogger()
const dbLog = log.child({ component: 'database' })

dbLog.info('query executed', { table: 'users' })
// { "component": "database", "table": "users", "msg": "query executed", ... }

Los children se componen — un nieto lleva cada binding que agregaron sus ancestros. createLogger() construye un Logger independiente, sin depender de ningún request; consultá la referencia de la API para el conjunto completo trace/debug/info/warn/error/fatal.

Un sink personalizado

sink es dónde se escribe una línea formateada — process.stdout.write por defecto (con fallback a console.log donde process no existe, como un Worker). Pasá el tuyo propio para redirigir la salida, por ejemplo para capturar líneas de log en un test:

import { Arcton } from '@arcton/core'
import { logger } from '@arcton/logger'

const lines: string[] = []

const app = Arcton()

app.use(logger({ sink: line => lines.push(line) }))

app.get('/', () => 'ok')

app.listen()

Loguear fuera del ciclo de request

logger() devuelve el middleware con el Logger subyacente agregado como .logger, así que el mismo logger se puede usar en cualquier otro lugar de tu app — por ejemplo, justo después de listen():

import { Arcton } from '@arcton/core'
import { logger } from '@arcton/logger'

const app = Arcton()
const log = logger()

app.use(log)
app.get('/', () => 'ok')

const server = app.listen({ port: 0 })
log.logger.info(`listening on ${server.url}`)

Ver logger() para la referencia completa de la API.

En esta página