chore: docs

Author: dreamorosi

docs/core/logger.md

@@ -805,7 +805,7 @@ You can use values ranging from `0` to `1` (100%) when setting the `sampleRateVa
 
     This feature takes into account transient issues where additional debugging information can be useful.
 
-Sampling decision happens at the Logger initialization. When using the `injectLambdaContext` method either as a decorator or middleware, the sampling decision is refreshed at the beginning of each Lambda invocation for you, except for cold starts.
+Sampling decision happens at the Logger initialization. When using the `injectLambdaContext` method either as a decorator or Middy.js middleware, the sampling decision is refreshed at the beginning of each Lambda invocation for you, except for cold starts.
 
 If you're not using either of these, you'll need to manually call the `refreshSamplingRate()` function at the start of your handler to refresh the sampling decision for each invocation.
 
@@ -815,6 +815,9 @@ If you're not using either of these, you'll need to manually call the `refreshSa
     --8<-- "examples/snippets/logger/logSampling.ts"
     ```
 
+    1. The log level must be set to a more verbose level than `DEBUG` for log sampling to kick in.
+    2. You need to call `logger.refreshSamplingRate()` at the start of your handler if you're not using the `injectLambdaContext()` class method decorator or Middy.js middleware.
+
 === "Example CloudWatch Logs excerpt - Invocation #1"
 
     ```json

examples/snippets/logger/logSampling.ts

@@ -1,27 +1,16 @@
 import { Logger } from '@aws-lambda-powertools/logger';
 
-// Notice the log level set to 'ERROR'
 const logger = new Logger({
-  logLevel: 'ERROR',
+  logLevel: 'ERROR', // (1)!
   sampleRateValue: 0.5,
 });
 
-export const handler = async (
-  _event: unknown,
-  _context: unknown
-): Promise<void> => {
-  // Refresh sample rate calculation on runtime, only when not using injectLambdaContext
-  logger.refreshSampleRateCalculation();
-  // This log item (equal to log level 'ERROR') will be printed to standard output
-  // in all Lambda invocations
-  logger.error('This is an ERROR log');
+export const handler = async () => {
+  logger.refreshSampleRateCalculation(); // (2)!
 
-  // These log items (below the log level 'ERROR') have ~50% chance
-  // of being printed in a Lambda invocation
-  logger.debug('This is a DEBUG log that has 50% chance of being printed');
-  logger.info('This is an INFO log that has 50% chance of being printed');
-  logger.warn('This is a WARN log that has 50% chance of being printed');
+  logger.error('This log is always emitted');
 
-  // Optional: refresh sample rate calculation on runtime
-  // logger.refreshSampleRateCalculation();
+  logger.debug('This log has ~50% chance of being emitted');
+  logger.info('This log has ~50% chance of being emitted');
+  logger.warn('This log has ~50% chance of being emitted');
 };