feat(logger): add log sampling

Author: heitorlessa

README.md

@@ -1,6 +1,6 @@
 # Lambda Powertools
 
-[![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fawslabs%2Faws-lambda-powertools%2Fbadge%3Fref%3Ddevelop&style=flat)](https://actions-badge.atrox.dev/awslabs/aws-lambda-powertools/goto?ref=develop) ![PackageStatus](https://img.shields.io/static/v1?label=status&message=beta&color=blueviolet?style=flat-square) ![PythonSupport](https://img.shields.io/static/v1?label=python&message=3.6%20|%203.7&color=blue?style=flat-square&logo=python)
+![PackageStatus](https://img.shields.io/static/v1?label=status&message=beta&color=blueviolet?style=flat-square) ![PythonSupport](https://img.shields.io/static/v1?label=python&message=3.6%20|%203.7&color=blue?style=flat-square&logo=python)
 
 A suite of utilities for AWS Lambda Functions that makes tracing with AWS X-Ray, structured logging and creating custom metrics asynchronously easier - Currently available for Python only and compatible with Python >=3.6.
 
@@ -22,6 +22,8 @@ A suite of utilities for AWS Lambda Functions that makes tracing with AWS X-Ray,
 * Optionally log Lambda request when instructed (disabled by default)
     - Enable via `POWERTOOLS_LOGGER_LOG_EVENT="true"` or explicitly via decorator param
 * Logs canonical custom metric line to logs that can be consumed asynchronously
+* Log sampling enables DEBUG log level for a percentage of requests (disabled by default)
+    - Enable via `POWERTOOLS_LOGGER_SAMPLE_RATE=0.1`, ranges from 0 to 1, where 0.1 is 10% and 1 is 100%
 
 **Environment variables** used across suite of utilities
 
@@ -30,6 +32,7 @@ Environment variable | Description | Default | Utility
 POWERTOOLS_SERVICE_NAME | Sets service name used for tracing namespace, metrics dimensions and structured logging | "service_undefined" | all
 POWERTOOLS_TRACE_DISABLED | Disables tracing | "false" | tracing
 POWERTOOLS_LOGGER_LOG_EVENT | Logs incoming event | "false" | logging
+POWERTOOLS_LOGGER_SAMPLE_RATE | Debug log sampling  | 0 | logging
 LOG_LEVEL | Sets logging level | "INFO" | logging
 
 ## Usage
@@ -85,6 +88,7 @@ Globals:
     Environment:
         Variables:
             POWERTOOLS_SERVICE_NAME: "payment" 
+            POWERTOOLS_LOGGER_SAMPLE_RATE: 0.1 # enable debug logging for 1% of requests, 0% by default
             LOG_LEVEL: "INFO"
 ```
 
@@ -185,9 +189,7 @@ This library may change its API/methods or environment variables as it receives
 
 ## TODO
 
-* [ ] Enable CI
 * [ ] Add an example code using powertools
-* [ ] Automate release and version bumping in CI
 
 ## Credits
 

python/HISTORY.md

@@ -1,5 +1,11 @@
 # HISTORY 
 
+## February 20th, 2020
+
+**0.4.0**
+
+* Introduces log sampling for debug - Thanks to [Danilo's contribution](https://github.com/awslabs/aws-lambda-powertools/pull/7)
+
 ## November 15th, 2019 
 
 * Public beta release

python/README.md

@@ -22,6 +22,8 @@ A suite of utilities for AWS Lambda Functions that makes tracing with AWS X-Ray,
 * Optionally log Lambda request when instructed (disabled by default)
     - Enable via `POWERTOOLS_LOGGER_LOG_EVENT="true"` or explicitly via decorator param
 * Logs canonical custom metric line to logs that can be consumed asynchronously
+* Log sampling enables DEBUG log level for a percentage of requests (disabled by default)
+    - Enable via `POWERTOOLS_LOGGER_SAMPLE_RATE=0.1`, ranges from 0 to 1, where 0.1 is 10% and 1 is 100%
 
 **Environment variables** used across suite of utilities
 
@@ -30,6 +32,7 @@ Environment variable | Description | Default | Utility
 POWERTOOLS_SERVICE_NAME | Sets service name used for tracing namespace, metrics dimensions and structured logging | "service_undefined" | all
 POWERTOOLS_TRACE_DISABLED | Disables tracing | "false" | tracing
 POWERTOOLS_LOGGER_LOG_EVENT | Logs incoming event | "false" | logging
+POWERTOOLS_LOGGER_SAMPLE_RATE | Debug log sampling  | 0 | logging
 LOG_LEVEL | Sets logging level | "INFO" | logging
 
 ## Usage
@@ -85,6 +88,7 @@ Globals:
     Environment:
         Variables:
             POWERTOOLS_SERVICE_NAME: "payment" 
+            POWERTOOLS_LOGGER_SAMPLE_RATE: 0.1 # enable debug logging for 1% of requests, 0% by default
             LOG_LEVEL: "INFO"
 ```
 
@@ -185,7 +189,6 @@ This library may change its API/methods or environment variables as it receives
 
 ## TODO
 
-* [ ] Enable CI
 * [ ] Add an example code using powertools
 
 ## Credits