X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=server%2Fhelpers%2Flogger.ts;h=6649db40f4a1eef3651976027ff23b39a5874384;hb=bd09dfaf8dcb0ca4cd5dac9f13e3117486f3bcce;hp=bcd4885af961a9a1a087ab98806fc46bb158da36;hpb=e3a682a877a10833cb54ac3595e55110bda95647;p=github%2FChocobozzz%2FPeerTube.git diff --git a/server/helpers/logger.ts b/server/helpers/logger.ts index bcd4885af..6649db40f 100644 --- a/server/helpers/logger.ts +++ b/server/helpers/logger.ts @@ -1,77 +1,208 @@ -// Thanks http://tostring.it/2014/06/23/advanced-logging-with-nodejs/ -import * as mkdirp from 'mkdirp' -import * as path from 'path' -import * as winston from 'winston' -import { CONFIG } from '../initializers' +import { stat } from 'fs-extra' +import { join } from 'path' +import { format as sqlFormat } from 'sql-formatter' +import { createLogger, format, transports } from 'winston' +import { FileTransportOptions } from 'winston/lib/winston/transports' +import { context } from '@opentelemetry/api' +import { getSpanContext } from '@opentelemetry/api/build/src/trace/context-utils' +import { omit } from '@shared/core-utils' +import { CONFIG } from '../initializers/config' +import { LOG_FILENAME } from '../initializers/constants' const label = CONFIG.WEBSERVER.HOSTNAME + ':' + CONFIG.WEBSERVER.PORT -// Create the directory if it does not exist -mkdirp.sync(CONFIG.STORAGE.LOG_DIR) +const consoleLoggerFormat = format.printf(info => { + let additionalInfos = JSON.stringify(getAdditionalInfo(info), removeCyclicValues(), 2) -// Use object for better performances (~ O(1)) -const excludedKeys = { - level: true, - message: true, - splat: true, - timestamp: true, - label: true -} -function keysExcluder (key, value) { - return excludedKeys[key] === true ? undefined : value -} - -const loggerFormat = winston.format.printf(info => { - let additionalInfos = JSON.stringify(info, keysExcluder, 2) - if (additionalInfos === '{}') additionalInfos = '' + if (additionalInfos === undefined || additionalInfos === '{}') additionalInfos = '' else additionalInfos = ' ' + additionalInfos - if (info.message && info.message.stack !== undefined) info.message = info.message.stack + if (info.sql) { + if (CONFIG.LOG.PRETTIFY_SQL) { + additionalInfos += '\n' + sqlFormat(info.sql, { + language: 'sql', + tabWidth: 2 + }) + } else { + additionalInfos += ' - ' + info.sql + } + } + return `[${info.label}] ${info.timestamp} ${info.level}: ${info.message}${additionalInfos}` }) -const timestampFormatter = winston.format.timestamp({ - format: 'YYYY-MM-dd HH:mm:ss.SSS' -}) -const labelFormatter = winston.format.label({ - label +const jsonLoggerFormat = format.printf(info => { + return JSON.stringify(info, removeCyclicValues()) }) -const logger = new winston.createLogger({ - level: CONFIG.LOG.LEVEL, - transports: [ - new winston.transports.File({ - filename: path.join(CONFIG.STORAGE.LOG_DIR, 'peertube.log'), - handleExceptions: true, - maxsize: 5242880, - maxFiles: 5, - format: winston.format.combine( - timestampFormatter, - labelFormatter, - winston.format.splat(), - winston.format.json() - ) - }), - new winston.transports.Console({ - handleExceptions: true, - humanReadableUnhandledException: true, - format: winston.format.combine( - timestampFormatter, - winston.format.splat(), - labelFormatter, - winston.format.colorize(), - loggerFormat - ) - }) - ], - exitOnError: true +const timestampFormatter = format.timestamp({ + format: 'YYYY-MM-DD HH:mm:ss.SSS' }) +const labelFormatter = (suffix?: string) => { + return format.label({ + label: suffix ? `${label} ${suffix}` : label + }) +} + +const fileLoggerOptions: FileTransportOptions = { + filename: join(CONFIG.STORAGE.LOG_DIR, LOG_FILENAME), + handleExceptions: true, + format: format.combine( + format.timestamp(), + jsonLoggerFormat + ) +} + +if (CONFIG.LOG.ROTATION.ENABLED) { + fileLoggerOptions.maxsize = CONFIG.LOG.ROTATION.MAX_FILE_SIZE + fileLoggerOptions.maxFiles = CONFIG.LOG.ROTATION.MAX_FILES +} + +function buildLogger (labelSuffix?: string) { + return createLogger({ + level: CONFIG.LOG.LEVEL, + defaultMeta: { + get traceId () { return getSpanContext(context.active())?.traceId }, + get spanId () { return getSpanContext(context.active())?.spanId }, + get traceFlags () { return getSpanContext(context.active())?.traceFlags } + }, + format: format.combine( + labelFormatter(labelSuffix), + format.splat() + ), + transports: [ + new transports.File(fileLoggerOptions), + new transports.Console({ + handleExceptions: true, + format: format.combine( + timestampFormatter, + format.colorize(), + consoleLoggerFormat + ) + }) + ], + exitOnError: true + }) +} + +const logger = buildLogger() + +// --------------------------------------------------------------------------- + +function bunyanLogFactory (level: string) { + return function (...params: any[]) { + let meta = null + let args = [].concat(params) + + if (arguments[0] instanceof Error) { + meta = arguments[0].toString() + args = Array.prototype.slice.call(arguments, 1) + args.push(meta) + } else if (typeof (args[0]) !== 'string') { + meta = arguments[0] + args = Array.prototype.slice.call(arguments, 1) + args.push(meta) + } + + logger[level].apply(logger, args) + } +} + +const bunyanLogger = { + level: () => { }, + trace: bunyanLogFactory('debug'), + debug: bunyanLogFactory('debug'), + verbose: bunyanLogFactory('debug'), + info: bunyanLogFactory('info'), + warn: bunyanLogFactory('warn'), + error: bunyanLogFactory('error'), + fatal: bunyanLogFactory('error') +} + +// --------------------------------------------------------------------------- + +type LoggerTagsFn = (...tags: string[]) => { tags: string[] } +function loggerTagsFactory (...defaultTags: string[]): LoggerTagsFn { + return (...tags: string[]) => { + return { tags: defaultTags.concat(tags) } + } +} + +// --------------------------------------------------------------------------- + +async function mtimeSortFilesDesc (files: string[], basePath: string) { + const promises = [] + const out: { file: string, mtime: number }[] = [] + + for (const file of files) { + const p = stat(basePath + '/' + file) + .then(stats => { + if (stats.isFile()) out.push({ file, mtime: stats.mtime.getTime() }) + }) + + promises.push(p) + } + + await Promise.all(promises) + + out.sort((a, b) => b.mtime - a.mtime) + + return out +} // --------------------------------------------------------------------------- export { + LoggerTagsFn, + + buildLogger, timestampFormatter, labelFormatter, - loggerFormat, - logger + consoleLoggerFormat, + jsonLoggerFormat, + mtimeSortFilesDesc, + logger, + loggerTagsFactory, + bunyanLogger +} + +// --------------------------------------------------------------------------- + +function removeCyclicValues () { + const seen = new WeakSet() + + // Thanks: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Errors/Cyclic_object_value#Examples + return (key: string, value: any) => { + if (key === 'cert') return 'Replaced by the logger to avoid large log message' + + if (typeof value === 'object' && value !== null) { + if (seen.has(value)) return + + seen.add(value) + } + + if (value instanceof Set) { + return Array.from(value) + } + + if (value instanceof Map) { + return Array.from(value.entries()) + } + + if (value instanceof Error) { + const error = {} + + Object.getOwnPropertyNames(value).forEach(key => { error[key] = value[key] }) + + return error + } + + return value + } +} + +function getAdditionalInfo (info: any) { + const toOmit = [ 'label', 'timestamp', 'level', 'message', 'sql', 'tags' ] + + return omit(info, toOmit) }