X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=server%2Fhelpers%2Flogger.ts;h=6649db40f4a1eef3651976027ff23b39a5874384;hb=21609258dee096e1ecc3af7a2b9e841742ef7f7d;hp=b8ae28b3f12235d69b2d8c26430fcfb0f09bb6ca;hpb=7cd1b12c19d0589d1d692ed0571ca0800f028aea;p=github%2FChocobozzz%2FPeerTube.git diff --git a/server/helpers/logger.ts b/server/helpers/logger.ts index b8ae28b3f..6649db40f 100644 --- a/server/helpers/logger.ts +++ b/server/helpers/logger.ts @@ -1,68 +1,54 @@ -// Thanks http://tostring.it/2014/06/23/advanced-logging-with-nodejs/ -import { mkdirpSync } from 'fs-extra' -import * as path from 'path' -import * as winston from 'winston' +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 { omit } from 'lodash' import { LOG_FILENAME } from '../initializers/constants' const label = CONFIG.WEBSERVER.HOSTNAME + ':' + CONFIG.WEBSERVER.PORT -// Create the directory if it does not exist -// FIXME: use async -mkdirpSync(CONFIG.STORAGE.LOG_DIR) +const consoleLoggerFormat = format.printf(info => { + let additionalInfos = JSON.stringify(getAdditionalInfo(info), removeCyclicValues(), 2) -function getLoggerReplacer () { - 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 (typeof value === 'object' && value !== null) { - if (seen.has(value)) return - - seen.add(value) - } - - if (value instanceof Error) { - const error = {} - - Object.getOwnPropertyNames(value).forEach(key => { error[key] = value[key] }) + if (additionalInfos === undefined || additionalInfos === '{}') additionalInfos = '' + else additionalInfos = ' ' + additionalInfos - return error + if (info.sql) { + if (CONFIG.LOG.PRETTIFY_SQL) { + additionalInfos += '\n' + sqlFormat(info.sql, { + language: 'sql', + tabWidth: 2 + }) + } else { + additionalInfos += ' - ' + info.sql } - - return value } -} - -const consoleLoggerFormat = winston.format.printf(info => { - const obj = omit(info, 'label', 'timestamp', 'level', 'message') - - let additionalInfos = JSON.stringify(obj, getLoggerReplacer(), 2) - - if (additionalInfos === undefined || additionalInfos === '{}') additionalInfos = '' - else additionalInfos = ' ' + additionalInfos return `[${info.label}] ${info.timestamp} ${info.level}: ${info.message}${additionalInfos}` }) -const jsonLoggerFormat = winston.format.printf(info => { - return JSON.stringify(info, getLoggerReplacer()) +const jsonLoggerFormat = format.printf(info => { + return JSON.stringify(info, removeCyclicValues()) }) -const timestampFormatter = winston.format.timestamp({ +const timestampFormatter = format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss.SSS' }) -const labelFormatter = winston.format.label({ - label -}) +const labelFormatter = (suffix?: string) => { + return format.label({ + label: suffix ? `${label} ${suffix}` : label + }) +} const fileLoggerOptions: FileTransportOptions = { - filename: path.join(CONFIG.STORAGE.LOG_DIR, LOG_FILENAME), + filename: join(CONFIG.STORAGE.LOG_DIR, LOG_FILENAME), handleExceptions: true, - format: winston.format.combine( - winston.format.timestamp(), + format: format.combine( + format.timestamp(), jsonLoggerFormat ) } @@ -72,31 +58,41 @@ if (CONFIG.LOG.ROTATION.ENABLED) { fileLoggerOptions.maxFiles = CONFIG.LOG.ROTATION.MAX_FILES } -const logger = winston.createLogger({ - level: CONFIG.LOG.LEVEL, - format: winston.format.combine( - labelFormatter, - winston.format.splat() - ), - transports: [ - new winston.transports.File(fileLoggerOptions), - new winston.transports.Console({ - handleExceptions: true, - format: winston.format.combine( - timestampFormatter, - winston.format.colorize(), - consoleLoggerFormat - ) - }) - ], - exitOnError: true -}) +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 () { + return function (...params: any[]) { let meta = null - let args: any[] = [] - args.concat(arguments) + let args = [].concat(params) if (arguments[0] instanceof Error) { meta = arguments[0].toString() @@ -113,20 +109,100 @@ function bunyanLogFactory (level: string) { } 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, 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) +}