Skip to content

A comprehensive, highly configurable TypeScript logging library designed specifically for AWS serverless applications

License

Notifications You must be signed in to change notification settings

nicknaddaf/lambda-logger

Repository files navigation

Lambda Logger

A comprehensive, production-ready and highly configurable logging library designed specifically for AWS Lambda functions built with TypeScript. Features numerical log levels, automatic log enrichment, multiple destinations, complete configurability, and complete abstraction of logging details.

npm version License: MIT

Features

Numerical Log Levels - Industry-standard priority scale (0=FATAL to 5=TRACE)
Structured Logging - JSON-formatted logs with consistent structure
Multiple Destinations - CloudWatch, S3, Console, File, or custom destinations
Auto-Enrichment - AWS Lambda context, X-Ray tracing, and custom enrichers
Type-Safe - Full TypeScript support with strong typing
Configurable - Flexible formatters, log levels, and destinations
Sensitive Data Redaction - Automatic redaction of passwords, tokens, etc.
Batching & Buffering - Efficient log delivery with configurable batching
Zero Core Dependencies - Only AWS SDK as peer dependency

Installation

npm install @nicknaddaf/lambda-logger

Contributing

Contributions are welcome! Please submit pull requests or open issues on GitHub.

License

MIT License - See LICENSE file for details.

Support


Demo

Here is simple demo that shows how to use this package: https://github.com/nicknaddaf/lambda-logger-demo


Changelog

v0.1.0

  • Initial release
  • Numerical log levels (0-5)
  • Multiple destinations support
  • AWS Lambda enrichers
  • Automatic sensitive data redaction
  • TypeScript support

v0.2.0

  • Fix package configuration issue with JavaScript code
  • Add documentation section

v0.2.1

  • Fix documentation link in readme.md

v0.3.1

  • Support multi-configuration for TypeScript
  • Add demo link to Readme file.

About

A comprehensive, highly configurable TypeScript logging library designed specifically for AWS serverless applications

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published