egg-logger-sls

Logger transport for aliyun sls.

Install

$ npm i egg-sls --save
$ npm i egg-logger-sls --save

Usage

// {app_root}/config/plugin.js
exports.sls = {
  enable: true,
  package: 'egg-sls',
};
exports.loggerSLS = {
  enable: true,
  package: 'egg-logger-sls',
};

Configuration

You should configure egg-sls first.

// {app_root}/config/config.default.js
exports.loggerSLS = {
  // sls client name
  client: null,
  // sls project name
  project: '',
  // sls logstore name
  logstore: '',
  // the list of logger name that can be disabled
  disable: [],
  // the function that can modify and filter the logs
  transform: null,
};

If client is not specified, it will use app.sls as default client, otherwise it will get the sls client with the specified name in multiple client case.

// {app_root}/config/config.default.js
exports.sls = {
  clients: {
    sls: {
      endpoint: process.env.SLS_ENDPOINT,
      accessKeyId: process.env.SLS_ACCESS_KEY_ID,
      accessKeySecret: process.env.SLS_ACCESS_KEY_SECRET,
    },
  },
};
exports.loggerSLS = {
  client: 'sls',
  project: '',
  logstore: '',
};

see config/config.default.js for more detail.

Usage

The only thing you should do is configuration, this module will upload log automatically.

Disable Logger

You and disable logger with disable config.

exports.customLogger = {
  myLogger: {
    file: '/path/to/log',
  },
};
exports.loggerSLS = {
  disable: [
    // won't upload this logger
    'myLogger',
  ],
}

Transform and Filter

You can transform the log data before upload.

exports.loggerSLS = {
  transform(log, args) {
    return log;
  },
}

If you want to ignore some log, you can return false when transform.

exports.loggerSLS = {
  transform(log) {
    if (some condition) return false;
    return log;
  },
}

There is two arguments that transform have.

1. One is log object, it contains the default property, which is ip, hostname, env, appName, loggerName, loggerFileName, level. The last one is content that is the log string formated from the arguments when you call log method.
2. The other is original arguments when you call log method, it will not format to content.

Data Structure

The data structure uploaded in below, you can create index in aliyun console as your wish.

• level: logger level
• content: the infomation that you logged
• ip: the host ip
• hostname: the host name
• env: the egg environment
• appName: the package name
• loggerName: the logger name defined by Egg
• loggerFileName: the logger file path

Logger Level

The default logger in Egg contains two level: level and consoleLevel, If you want set level for sls, you can use slsLevel.

// config/config.default.js
module.exports = {
  logger: {
    // for all logs
    slsLevel: 'DEBUG',
  },

  customLogger: {
    // only for one log
    testLogger: {
      slsLevel: 'ERROR',
    },
  },
};

If slsLevel is not specified, it will use level instead.

Questions & Suggestions

Please open an issue here.

License

MIT