@ng-mfe/logger

日志服务 — 支持多级别日志、多 Sink 输出与子 Logger 上下文继承。

安装

npm install @ng-mfe/logger

用法

import { LoggerService, ConsoleSink, jsonFormatter } from '@ng-mfe/logger';

const logger = new LoggerService({
  level: 'debug',
  sinks: [new ConsoleSink(jsonFormatter)],
  context: { app: 'portal' },
});

logger.info('应用启动');
logger.warn('配置缺失', { key: 'apiUrl' });
logger.error('请求失败', new Error('timeout'));

// 创建子 Logger（继承 sinks 和 level，合并 context）
const childLogger = logger.createChild({ module: 'auth' });
childLogger.debug('token 已刷新');

API 接口

• LoggerService — 日志服务主类
  • debug(message, ...args) / info(...) / warn(...) / error(...) — 按级别输出日志
  • setLevel(level) — 动态设置日志级别
  • getLevel() — 获取当前日志级别
  • addSink(sink) — 添加日志输出目标
  • createChild(context) — 创建子 Logger，继承配置并合并上下文
• ConsoleSink — 控制台输出 Sink
• plainFormatter — 纯文本格式化器
• jsonFormatter — JSON 格式化器
• 类型：LogLevel（'debug' | 'info' | 'warn' | 'error'）、LogEntry、LogSink、LogFormatter

配置选项

| 字段 | 类型 | 说明 | | --------- | ---------------------- | ------------------------------------------ | | level | LogLevel? | 最低日志级别（默认 'info'） | | sinks | LogSink[]? | 日志输出目标（默认 [new ConsoleSink()]） | | context | Record<string, any>? | 附加上下文信息 |

文档

查看主 README 获取完整文档。