fix(logger): Output a warning when the ALC log level is less verbose than log buffer

Author: ConnorKirk

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

@@ -1378,6 +1378,14 @@ class Logger extends Utility implements LoggerInterface {
       this.#bufferConfig.bufferAtVerbosity =
         LogLevelThreshold[bufferAtLogLevel];
     }
+    const AlcLogLevel =
+      this.getEnvVarsService().getAwsLogLevel() as keyof typeof LogLevelThreshold;
+
+    if (LogLevelThreshold[AlcLogLevel] > this.#bufferConfig.bufferAtVerbosity) {
+      this.#warnOnce(
+        'Advanced Loggging Controls (ALC) Log Level is higher than Log Buffering Log Level. Buffered logs will be filtered by ALC'
+      );
+    }
   }
 
   /**

Diff for: packages/logger/tests/unit/logBuffer.test.ts

@@ -92,6 +92,28 @@ describe('Buffer logs', () => {
     );
   });
 
+  it('outputs a warning when the Advanced Logging Configuration Log Level is higher than the Log Buffering Log Level', () => {
+    // Assemble
+    process.env.AWS_LAMBDA_LOG_LEVEL = 'INFO';
+    const logger = new Logger({
+      logLevel: LogLevel.DEBUG,
+      logBufferOptions: { enabled: true, bufferAtVerbosity: 'DEBUG' },
+    });
+
+    // Act
+    logger.debug('This is a debug');
+
+    // Assess
+    expect(console.warn).toHaveLogged(
+      expect.objectContaining({
+        message: expect.stringContaining(
+          'Advanced Loggging Controls (ALC) Log Level is higher than Log Buffering Log Level. Buffered logs will be filtered by ALC'
+        ),
+        level: LogLevel.WARN,
+      })
+    );
+  });
+
   it('outputs a warning when there is an error buffering the log', () => {
     // Prepare
     const logger = new Logger({ logBufferOptions: { maxBytes: 100 } });