feat(logger): introduce loglevel trace (aws-powertools#1589)

Author: timo92

Diff for: packages/logger/src/Logger.ts

@@ -158,6 +158,7 @@ class Logger extends Utility implements LoggerInterface {
    * The levels are in ascending order from the most verbose to the least verbose (no logs).
    */
   private readonly logLevelThresholds: LogLevelThresholds = {
+    TRACE: 6,
     DEBUG: 8,
     INFO: 12,
     WARN: 16,
@@ -636,6 +637,17 @@ class Logger extends Utility implements LoggerInterface {
     return this.getLogEvent();
   }
 
+  /**
+   * It prints a log item with level TRACE.
+   *
+   * @param {LogItemMessage} input
+   * @param {Error | LogAttributes | string} extraInput
+   * @returns {void}
+   */
+  public trace(input: LogItemMessage, ...extraInput: LogItemExtraInput): void {
+    this.processLogItem(6, input, extraInput);
+  }
+
   /**
    * It prints a log item with level WARN.
    *

Diff for: packages/logger/src/constants.ts

@@ -15,6 +15,7 @@ const LogJsonIndent = {
 } as const;
 
 const LogLevel = {
+  TRACE: 'TRACE',
   DEBUG: 'DEBUG',
   INFO: 'INFO',
   WARN: 'WARN',

Diff for: packages/logger/src/types/Logger.ts

@@ -148,6 +148,7 @@ type LoggerInterface = {
   setLogLevel(logLevel: LogLevel): void;
   setPersistentLogAttributes(attributes?: LogAttributes): void;
   shouldLogEvent(overwriteValue?: boolean): boolean;
+  trace(input: LogItemMessage, ...extraInput: LogItemExtraInput): void;
   warn(input: LogItemMessage, ...extraInput: LogItemExtraInput): void;
 };