npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@umajs/logger

v2.1.0

Published

umajs logger日志

Downloads

9

Readme

@umajs/logger

umajs日志系统规划

  • [x] 日志分级(高)
  • [x] 日志模块缓存(高)
  • [x] 日期切割(高)
  • [x] 支持全局日志对象调用(中)
  • [ ] 自定义日志文件配置(目录,切割方式)
  • [ ] 自定义传送远程日志(将日志信息发送到指定远程服务器)

使用说明

const Logger = require('@umajs/logger');
Logger.init({
    level: 'DEBUG', //日志输出级别
    dir: '/path/to/your/custom/log', //日志输出目录
    errorLogName: 'errorlogger.log', //error级别日志文件名
    infoLogName: 'infologger.log', //info级别日志文件名
    warnLogName: 'warnlogger.log', //warn级别日志文件名
    encoding:'utf-8', //日志编码格式
    outputJSON:true, //是否格式化输出携带pid等信息 false仅输出msg
    consoleLevel:'debug', //终端日志输出级别
    allowDebugAtProd:true, //生产环境是否允许打印debug日志
    replaceConsole:false, //是否重写系统console日志
});  //在启动时初始化一次 其他地方直接import Logger直接使用

or

const {UmaLogger } = require('@umajs/logger');
const Logger = new UmaLogger({
   ...options
})

or

//提供单例模式使用logger 避免多次实例化
const {UmaLogger } = require('@umajs/logger');
const Logger = UmaLogger.instance({
   ...options
});

//使用
Logger.info('info');
Logger.debug('debug');
Logger.warn('warn');
Logger.error('error');

如果用户需要使用ctx上的数据可直接使用contextLogger

import {ContextLogger} from '@umajs/logger';
app.use(async ctx => {
   ctx.logger = ContextLogger(ctx, options)
   ctx.logger.info('ctxLogger-info');
   ctx.body = 'Hello World';
});

配置属性

{
    level: 'DEBUG', //日志输出级别
    dir: '/path/to/your/custom/log', //日志输出目录
    errorLogName: 'errorlogger.log', //error级别日志文件名
    infoLogName: 'infologger.log', //info级别日志文件名
    warnLogName: 'warnlogger.log', //warn级别日志文件名
    file: '/path/to/your/custom/log/logger.log', //日志文件写入路径(所有级别日志)
    encoding:'utf-8', //日志编码格式
    outputJSON:true, //是否格式化输出携带pid等信息 false仅输出msg
    consoleLevel:'debug', //终端日志输出级别
    replaceConsole:false, //是否重写系统console日志
    allowDebugAtProd:true, //是否允许打印debug日志
    flushInterval: 1000, //文件流定时写入
    maxBufferLength: 1000, //最大buffer 超出限制执行写入
    formatter: function(meta?:TConsoleMeta) {
        return `[${meta.level} ${meta.pid}] ${meta.date} ${meta.hostname} ${meta.paddingMessage}: ${meta.message}`;
    }, //日志格式化输出
    splitTime: '00 00 * * * *' //日志文件切割时间
};

日志级别

日志分为ALL DEBUG INFO WARN ERROR NONE6个级别。默认会同时打印INFO及以上级别的日志到文件和终端,可自定义日志输出级别:

1.文件日志级别(默认INFO

// config/logger.config.js
exports.logger = {
   level: 'ALL' // 打印所有级别日志到文件中
};

2.终端日志级别(默认INFO

// config/logger.config.js
exports.logger = {
   consoleLevel: 'NONE' //关闭日志终端输出
};

consoleLevel优先级高于levelconsoleLevel仅对终端输出生效。 日志输出如下所示:

[DEBUG 24053] 2019-08-01 18:57:20,573 liumindeMacBook-Pro.local: debug
[INFO 24053] 2019-08-01 18:57:20,574 liumindeMacBook-Pro.local: info GET
[WARN 24053] 2019-08-01 18:57:20,575 liumindeMacBook-Pro.local: warn
[ERROR 24053] 2019-08-01 18:57:20,576 liumindeMacBook-Pro.local: error

3.生产环境关闭打印debug日志,默认关闭

exports.logger = {
   allowDebugAtProd: ture // 开启生产环境打印debug日志
};

日志文件输出

  1. 文件编码,默认编码为utf-8,可自定义
  2. 日志文件输出格式默认为JSON
exports.logger = {
   encoding: 'gbk',
   outputJSON: true
};

日志切割

  1. 默认按天切割,在每日00:00按照.log.YYYY-MM-DD文件名切割。