Added tests and documentation

Author: stevrobu

examples/logger/src/logging_stacktrace.py

@@ -0,0 +1,19 @@
+import requests
+
+from aws_lambda_powertools import Logger
+from aws_lambda_powertools.utilities.typing import LambdaContext
+from aws_lambda_powertools.logging.formatter import LambdaPowertoolsFormatter
+
+ENDPOINT = "http://httpbin.org/status/500"
+logger = Logger(logger_formatter=LambdaPowertoolsFormatter(include_stacktrace=True))
+
+
+def lambda_handler(event: dict, context: LambdaContext) -> str:
+    try:
+        ret = requests.get(ENDPOINT)
+        ret.raise_for_status()
+    except requests.HTTPError as e:
+        logger.exception(e)
+        raise RuntimeError("Unable to fullfil request") from e
+
+    return "hello world"

examples/logger/src/logging_stacktrace_output.json

@@ -0,0 +1,26 @@
+{
+    "level": "ERROR",
+    "location": "lambda_handler:16",
+    "message": "500 Server Error: INTERNAL SERVER ERROR for url: http://httpbin.org/status/500",
+    "timestamp": "2023-09-28 19:25:09,781+0000",
+    "service": "service_undefined",
+    "stack_trace": [
+        {
+            "File": "/var/task/app.py",
+            "Line": 14,
+            "Column": 8,
+            "Function": "lambda_handler",
+            "Statement": "ret.raise_for_status()"
+        },
+        {
+            "File": "/var/task/requests/models.py",
+            "Line": 1021,
+            "Column": 12,
+            "Function": "raise_for_status",
+            "Statement": "raise HTTPError(http_error_msg, response=self)"
+        }
+    ],
+    "exception": "Traceback (most recent call last):\n  File \"/var/task/app.py\", line 14, in lambda_handler\n    ret.raise_for_status()\n  File \"/var/task/requests/models.py\", line 1021, in raise_for_status\n    raise HTTPError(http_error_msg, response=self)\nrequests.exceptions.HTTPError: 500 Server Error: INTERNAL SERVER ERROR for url: http://httpbin.org/status/500",
+    "exception_name": "HTTPError",
+    "xray_trace_id": "1-6515d315-07fbcb5e693988c6480a98e2"
+}