connect-logger.js 9.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323
  1. /* eslint no-underscore-dangle: ["error", { "allow": ["__statusCode", "_remoteAddress", "__headers", "_logging"] }] */
  2. const levels = require('./levels');
  3. const DEFAULT_FORMAT =
  4. ':remote-addr - -' +
  5. ' ":method :url HTTP/:http-version"' +
  6. ' :status :content-length ":referrer"' +
  7. ' ":user-agent"';
  8. /**
  9. * Return request url path,
  10. * adding this function prevents the Cyclomatic Complexity,
  11. * for the assemble_tokens function at low, to pass the tests.
  12. *
  13. * @param {IncomingMessage} req
  14. * @return {string}
  15. * @api private
  16. */
  17. function getUrl(req) {
  18. return req.originalUrl || req.url;
  19. }
  20. /**
  21. * Adds custom {token, replacement} objects to defaults,
  22. * overwriting the defaults if any tokens clash
  23. *
  24. * @param {IncomingMessage} req
  25. * @param {ServerResponse} res
  26. * @param {Array} customTokens
  27. * [{ token: string-or-regexp, replacement: string-or-replace-function }]
  28. * @return {Array}
  29. */
  30. function assembleTokens(req, res, customTokens) {
  31. const arrayUniqueTokens = (array) => {
  32. const a = array.concat();
  33. for (let i = 0; i < a.length; ++i) {
  34. for (let j = i + 1; j < a.length; ++j) {
  35. // not === because token can be regexp object
  36. // eslint-disable-next-line eqeqeq
  37. if (a[i].token == a[j].token) {
  38. a.splice(j--, 1); // eslint-disable-line no-plusplus
  39. }
  40. }
  41. }
  42. return a;
  43. };
  44. const defaultTokens = [];
  45. defaultTokens.push({ token: ':url', replacement: getUrl(req) });
  46. defaultTokens.push({ token: ':protocol', replacement: req.protocol });
  47. defaultTokens.push({ token: ':hostname', replacement: req.hostname });
  48. defaultTokens.push({ token: ':method', replacement: req.method });
  49. defaultTokens.push({
  50. token: ':status',
  51. replacement: res.__statusCode || res.statusCode,
  52. });
  53. defaultTokens.push({
  54. token: ':response-time',
  55. replacement: res.responseTime,
  56. });
  57. defaultTokens.push({ token: ':date', replacement: new Date().toUTCString() });
  58. defaultTokens.push({
  59. token: ':referrer',
  60. replacement: req.headers.referer || req.headers.referrer || '',
  61. });
  62. defaultTokens.push({
  63. token: ':http-version',
  64. replacement: `${req.httpVersionMajor}.${req.httpVersionMinor}`,
  65. });
  66. defaultTokens.push({
  67. token: ':remote-addr',
  68. replacement:
  69. req.headers['x-forwarded-for'] ||
  70. req.ip ||
  71. req._remoteAddress ||
  72. (req.socket &&
  73. (req.socket.remoteAddress ||
  74. (req.socket.socket && req.socket.socket.remoteAddress))),
  75. });
  76. defaultTokens.push({
  77. token: ':user-agent',
  78. replacement: req.headers['user-agent'],
  79. });
  80. defaultTokens.push({
  81. token: ':content-length',
  82. replacement:
  83. res.getHeader('content-length') ||
  84. (res.__headers && res.__headers['Content-Length']) ||
  85. '-',
  86. });
  87. defaultTokens.push({
  88. token: /:req\[([^\]]+)]/g,
  89. replacement(_, field) {
  90. return req.headers[field.toLowerCase()];
  91. },
  92. });
  93. defaultTokens.push({
  94. token: /:res\[([^\]]+)]/g,
  95. replacement(_, field) {
  96. return (
  97. res.getHeader(field.toLowerCase()) ||
  98. (res.__headers && res.__headers[field])
  99. );
  100. },
  101. });
  102. return arrayUniqueTokens(customTokens.concat(defaultTokens));
  103. }
  104. /**
  105. * Return formatted log line.
  106. *
  107. * @param {string} str
  108. * @param {Array} tokens
  109. * @return {string}
  110. * @api private
  111. */
  112. function format(str, tokens) {
  113. for (let i = 0; i < tokens.length; i++) {
  114. str = str.replace(tokens[i].token, tokens[i].replacement);
  115. }
  116. return str;
  117. }
  118. /**
  119. * Return RegExp Object about nolog
  120. *
  121. * @param {(string|Array)} nolog
  122. * @return {RegExp}
  123. * @api private
  124. *
  125. * syntax
  126. * 1. String
  127. * 1.1 "\\.gif"
  128. * NOT LOGGING http://example.com/hoge.gif and http://example.com/hoge.gif?fuga
  129. * LOGGING http://example.com/hoge.agif
  130. * 1.2 in "\\.gif|\\.jpg$"
  131. * NOT LOGGING http://example.com/hoge.gif and
  132. * http://example.com/hoge.gif?fuga and http://example.com/hoge.jpg?fuga
  133. * LOGGING http://example.com/hoge.agif,
  134. * http://example.com/hoge.ajpg and http://example.com/hoge.jpg?hoge
  135. * 1.3 in "\\.(gif|jpe?g|png)$"
  136. * NOT LOGGING http://example.com/hoge.gif and http://example.com/hoge.jpeg
  137. * LOGGING http://example.com/hoge.gif?uid=2 and http://example.com/hoge.jpg?pid=3
  138. * 2. RegExp
  139. * 2.1 in /\.(gif|jpe?g|png)$/
  140. * SAME AS 1.3
  141. * 3. Array
  142. * 3.1 ["\\.jpg$", "\\.png", "\\.gif"]
  143. * SAME AS "\\.jpg|\\.png|\\.gif"
  144. */
  145. function createNoLogCondition(nolog) {
  146. let regexp = null;
  147. if (nolog instanceof RegExp) {
  148. regexp = nolog;
  149. }
  150. if (typeof nolog === 'string') {
  151. regexp = new RegExp(nolog);
  152. }
  153. if (Array.isArray(nolog)) {
  154. // convert to strings
  155. const regexpsAsStrings = nolog.map((reg) =>
  156. reg.source ? reg.source : reg
  157. );
  158. regexp = new RegExp(regexpsAsStrings.join('|'));
  159. }
  160. return regexp;
  161. }
  162. /**
  163. * Allows users to define rules around status codes to assign them to a specific
  164. * logging level.
  165. * There are two types of rules:
  166. * - RANGE: matches a code within a certain range
  167. * E.g. { 'from': 200, 'to': 299, 'level': 'info' }
  168. * - CONTAINS: matches a code to a set of expected codes
  169. * E.g. { 'codes': [200, 203], 'level': 'debug' }
  170. * Note*: Rules are respected only in order of prescendence.
  171. *
  172. * @param {Number} statusCode
  173. * @param {Level} currentLevel
  174. * @param {Object} ruleSet
  175. * @return {Level}
  176. * @api private
  177. */
  178. function matchRules(statusCode, currentLevel, ruleSet) {
  179. let level = currentLevel;
  180. if (ruleSet) {
  181. const matchedRule = ruleSet.find((rule) => {
  182. let ruleMatched = false;
  183. if (rule.from && rule.to) {
  184. ruleMatched = statusCode >= rule.from && statusCode <= rule.to;
  185. } else {
  186. ruleMatched = rule.codes.indexOf(statusCode) !== -1;
  187. }
  188. return ruleMatched;
  189. });
  190. if (matchedRule) {
  191. level = levels.getLevel(matchedRule.level, level);
  192. }
  193. }
  194. return level;
  195. }
  196. /**
  197. * Log requests with the given `options` or a `format` string.
  198. *
  199. * Options:
  200. *
  201. * - `format` Format string, see below for tokens
  202. * - `level` A log4js levels instance. Supports also 'auto'
  203. * - `nolog` A string or RegExp to exclude target logs or function(req, res): boolean
  204. * - `statusRules` A array of rules for setting specific logging levels base on status codes
  205. * - `context` Whether to add a response of express to the context
  206. *
  207. * Tokens:
  208. *
  209. * - `:req[header]` ex: `:req[Accept]`
  210. * - `:res[header]` ex: `:res[Content-Length]`
  211. * - `:http-version`
  212. * - `:response-time`
  213. * - `:remote-addr`
  214. * - `:date`
  215. * - `:method`
  216. * - `:url`
  217. * - `:referrer`
  218. * - `:user-agent`
  219. * - `:status`
  220. *
  221. * @return {Function}
  222. * @param logger4js
  223. * @param options
  224. * @api public
  225. */
  226. module.exports = function getLogger(logger4js, options) {
  227. if (typeof options === 'string' || typeof options === 'function') {
  228. options = { format: options };
  229. } else {
  230. options = options || {};
  231. }
  232. const thisLogger = logger4js;
  233. let level = levels.getLevel(options.level, levels.INFO);
  234. const fmt = options.format || DEFAULT_FORMAT;
  235. return (req, res, next) => {
  236. // mount safety
  237. if (typeof req._logging !== 'undefined') return next();
  238. // nologs
  239. if (typeof options.nolog !== 'function') {
  240. const nolog = createNoLogCondition(options.nolog);
  241. if (nolog && nolog.test(req.originalUrl)) return next();
  242. }
  243. if (thisLogger.isLevelEnabled(level) || options.level === 'auto') {
  244. const start = new Date();
  245. const { writeHead } = res;
  246. // flag as logging
  247. req._logging = true;
  248. // proxy for statusCode.
  249. res.writeHead = (code, headers) => {
  250. res.writeHead = writeHead;
  251. res.writeHead(code, headers);
  252. res.__statusCode = code;
  253. res.__headers = headers || {};
  254. };
  255. // hook on end request to emit the log entry of the HTTP request.
  256. let finished = false;
  257. const handler = () => {
  258. if (finished) {
  259. return;
  260. }
  261. finished = true;
  262. // nologs
  263. if (typeof options.nolog === 'function') {
  264. if (options.nolog(req, res) === true) {
  265. req._logging = false;
  266. return;
  267. }
  268. }
  269. res.responseTime = new Date() - start;
  270. // status code response level handling
  271. if (res.statusCode && options.level === 'auto') {
  272. level = levels.INFO;
  273. if (res.statusCode >= 300) level = levels.WARN;
  274. if (res.statusCode >= 400) level = levels.ERROR;
  275. }
  276. level = matchRules(res.statusCode, level, options.statusRules);
  277. const combinedTokens = assembleTokens(req, res, options.tokens || []);
  278. if (options.context) thisLogger.addContext('res', res);
  279. if (typeof fmt === 'function') {
  280. const line = fmt(req, res, (str) => format(str, combinedTokens));
  281. if (line) thisLogger.log(level, line);
  282. } else {
  283. thisLogger.log(level, format(fmt, combinedTokens));
  284. }
  285. if (options.context) thisLogger.removeContext('res');
  286. };
  287. res.on('end', handler);
  288. res.on('finish', handler);
  289. res.on('error', handler);
  290. res.on('close', handler);
  291. }
  292. // ensure next gets always called
  293. return next();
  294. };
  295. };