从 evlog 迁移

把 evlog 的 wide event 风格映射到 Elogs 的请求 context 与 access log

插件 setup

evlog

import { evlog } from 'evlog/elysia'

new Elysia().use(evlog({ drain: myDrain }))

Elogs

import { createElogs } from '@eastgold15/elogs'

new Elysia().use(createElogs({ preset: 'prod' }))

Context 累积

触发 request 日志

evlog:

log.emit({ status: 200 })

Elogs 在 afterHandle 钩子里自动写一条 access log。除非你想跳过默认行,否则不用手动 emit:

store.logger.info(request, 'handled manually')

AI 指标

evlog —— 通过 evlog/ai 自动接入。

Elogs

import { mergeAIMetrics } from '@eastgold15/elogs/ai'

mergeAIMetrics(store.logger, request, {
  model: 'claude-sonnet',
  inputTokens: 100,
  outputTokens: 50,
  totalTokens: 150
})

Tracing

在 request 钩子里用 injectTraceContext(见 OpenTelemetry)。

Drains vs Transports

evlog 的 drains 对应 Elogs 的 transports:

createElogs({
  config: {
    transports: [
      {
        log: (level, message, meta) => {
          myDrain.write({ level, message, ...meta })
        }
      }
    ],
    useTransportsOnly: true
  }
})

数据库错误(Drizzle 翻译)

evlog 时代用 ErrorMapping 字典把 Postgres driver code 翻译成 HTTP 状态。Elogs 2.x 改成 Elysia 2 原生 class extends HTTPError + .error(MyClass, fn),但保留 errorMap() 工厂作为用户工具,翻译后只影响日志级别,响应格式仍由你用 Elysia 钩子控制。

import { Elysia, problem } from 'elysia'
import { createElogs, errorMap } from '@eastgold15/elogs'
import { translateDrizzleError } from '@eastgold15/elogs/translator'

// 方式 1:autoTranslate —— 翻译后只决定日志级别
const app = new Elysia()
  .use(
    createElogs({
      autoTranslate: { db: 'drizzle' }
    })
  )
  .error('DrizzleError', (ctx) => {
    const code = (ctx.error as { code?: string }).code ?? 'UNKNOWN'
    return problem(409, { detail: `duplicate: ${code}` })
  })

// 方式 2:在路由里手动翻译
app.get('/users', () => {
  try {
    // db query
  } catch (e) {
    throw translateDrizzleError(e) // 已经替换成 HTTPError
  }
})

完整 Drizzle 翻译说明、errorMap 用法、httpError 工厂见 Database errors。