Interface: GlobalLogger
@eastgold15/elogs / GlobalLogger
Interface: GlobalLogger
Defined in: packages/elogs/src/interfaces.ts:603
全局 Logger,通过 globalLogger 导出。
- 请求作用域内(Elysia 路由 handler / 中间件 / hook 调用栈):自动从 AsyncLocalStorage 拿当前 request,走完整 emit 流水线(file/transports/console)。
- 请求作用域外(模块初始化 / 后台任务 / 进程级错误兜底):降级为 pino 输出,
首次降级时
console.warn一次提示。
调用者不需要也不应该传 request。
Example
import { globalLogger } from "@eastgold15/elogs";
// 路由 handler / 中间件 / hook —— 自动走完整 emit
app.get("/user/:id", ({ params }) => {
globalLogger.info("Fetching user", { userId: params.id });
});
// 错误处理 —— Error 实例自动 unwrap .message + .stack
try {
await db.query();
} catch (err) {
globalLogger.error(err);
}Properties
debug
debug: (
message,context?) =>void
Defined in: packages/elogs/src/interfaces.ts:607
记录 DEBUG 级别日志。作用域内走完整 emit,作用域外走 pino。
Parameters
message
string
context?
Record<string, unknown>
Returns
void
error
error: (
message,context?) =>void
Defined in: packages/elogs/src/interfaces.ts:616
记录 ERROR 级别日志。
Parameters
message
string | Error
字符串消息,或 Error 实例(自动 unwrap .message + .stack 进 context)
context?
Record<string, unknown>
附加上下文。当 message 是 Error 时,stack 和 errorName 会被自动
合并进 context(除非 context 显式提供同名 key,显式值优先级更高)。
Returns
void
getContext
getContext: () =>
Readonly<Record<string,unknown>>
Defined in: packages/elogs/src/interfaces.ts:622
读取当前请求的累积上下文(作用域内有效)。
作用域外返回 {},首次调用时 console.warn 一次。
Returns
Readonly<Record<string, unknown>>
info
info: (
message,context?) =>void
Defined in: packages/elogs/src/interfaces.ts:627
记录 INFO 级别日志。作用域内走完整 emit,作用域外走 pino。
Parameters
message
string
context?
Record<string, unknown>
Returns
void
mergeContext
mergeContext: (
partial) =>void
Defined in: packages/elogs/src/interfaces.ts:633
合并上下文到当前请求(作用域内有效)。
作用域外为 noop,首次调用时 console.warn 一次。
Parameters
partial
Record<string, unknown>
Returns
void
warn
warn: (
message,context?) =>void
Defined in: packages/elogs/src/interfaces.ts:638
记录 WARNING 级别日志。作用域内走完整 emit,作用域外走 pino。
Parameters
message
string
context?
Record<string, unknown>
Returns
void