Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amancevice/python-lambo
Simple and visually pleasing logger for AWS Lambda
https://github.com/amancevice/python-lambo
Last synced: about 2 months ago
JSON representation
Simple and visually pleasing logger for AWS Lambda
- Host: GitHub
- URL: https://github.com/amancevice/python-lambo
- Owner: amancevice
- License: mit
- Created: 2021-02-13T13:44:03.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-03-10T15:31:15.000Z (10 months ago)
- Last Synced: 2024-10-10T04:07:55.003Z (2 months ago)
- Language: Python
- Size: 92.8 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Lambo
[](https://pypi.org/project/lambo/)
[](https://pypi.org/project/lambo/)
[](https://github.com/amancevice/python-lambo/actions/workflows/pytest.yml)
[](https://codeclimate.com/github/amancevice/python-lambo/test_coverage)
[](https://codeclimate.com/github/amancevice/python-lambo/maintainability)
Simple and visually pleasing logger for AWS Lambda that prepends your log lines with the log level and the AWS request ID, making searching CLoudWatch for event logs a cinch!
Before installing lambo…
```
START RequestId: 03cf3256-f2e1-461c-a4a0-60eb91ac8149 Version: $LATEST
This log line was generated with ``print()``
END RequestId: 03cf3256-f2e1-461c-a4a0-60eb91ac8149
REPORT RequestId: 03cf3256-f2e1-461c-a4a0-60eb91ac8149 Duration: 3000.00 ms Billed Duration: 3000 ms Memory Size: 128 MB Max Memory Used: 128 MB
```
After installing lambo…
```
START RequestId: 03cf3256-f2e1-461c-a4a0-60eb91ac8149 Version: $LATEST
DEBUG RequestId: 03cf3256-f2e1-461c-a4a0-60eb91ac8149 This log line was generated with ``logger.debug()``
INFO RequestId: 03cf3256-f2e1-461c-a4a0-60eb91ac8149 This log line was generated with ``logger.info()``
WARNING RequestId: 03cf3256-f2e1-461c-a4a0-60eb91ac8149 This log line was generated with ``logger.warning()``
ERROR RequestId: 03cf3256-f2e1-461c-a4a0-60eb91ac8149 This log line was generated with ``logger.error()``
END RequestId: 03cf3256-f2e1-461c-a4a0-60eb91ac8149
REPORT RequestId: 03cf3256-f2e1-461c-a4a0-60eb91ac8149 Duration: 3000.00 ms Billed Duration: 3000 ms Memory Size: 128 MB Max Memory Used: 128 MB
```
> Why not use [aws_lambda_powertools](https://github.com/awslabs/aws-lambda-powertools-python/)? If you are already building your Lambda package with external dependencies well then you could probably use that great tool by AWS.
>
> But if you are looking for a lighter-weight solution with no external dependencies, then this might help you.
## Installation
```bash
pip install lambo
```
## Usage
Create a logger using the `getLogger()` method and bind it to your Lambda handler functions with the `@bind` decorator.
```python
import lambo
logger = lambo.getLogger('my-logger')
@logger.bind
def handler(event, context):
logger.info('HELLO!')
return {'ok': True}
```
Or, if brevity is your thing, import the built-in logger:
```python
from lambo import logger
@logger.bind
def handler(event, context):
logger.info('HELLO!')
return {'ok': True}
```
## Customization
The default log level for lambo loggers is `INFO` and the default format string is `%(levelname)s %(awsRequestId)s %(message)s`, where `awsRequestId` is extracted from the Lambda execution context.
You can override these values at runtime…
```python
import lambo
logger = lambo.getLogger('my-logger', 'DEBUG', '%(message)s')
```
Or with ENV variables…
```bash
export LAMBO_LOG_LEVEL=DEBUG
export LAMBO_LOG_FORMAT="%(message)"
```