# @nesn/commons-lambda-logger

> A compact logger that works in both commonJS and ES module projects.

Latest version **1.0.20** (published 2023-10-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nesn/commons-lambda-logger
pnpm add @nesn/commons-lambda-logger
yarn add @nesn/commons-lambda-logger
bun add @nesn/commons-lambda-logger
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.20 |
| Published | 2023-10-16 |
| First published | 2023-08-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 14.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Lance Sims |
| Maintainers | nesn-admin |
| Keywords | logger |

## Links

- npm: https://www.npmjs.com/package/@nesn/commons-lambda-logger
- npm.io page: https://npm.io/package/@nesn/commons-lambda-logger

## Dependencies (2)

- [winston](https://npm.io/package/winston.md) ^3.11.0
- [lodash.uniq](https://npm.io/package/lodash.uniq.md) ^4.5.0

## Alternatives

- [cli-color](https://npm.io/package/cli-color.md) — 3.4M weekly downloads
- [log](https://npm.io/package/log.md) — 1.3M weekly downloads
- [logstash-client](https://npm.io/package/logstash-client.md) — 4.5K weekly downloads
- [@nocobase/plugin-logger](https://npm.io/package/@nocobase/plugin-logger.md) — 2.0K weekly downloads
- [child-process-debug](https://npm.io/package/child-process-debug.md) — 695 weekly downloads

## Recent versions

- 1.0.20 (latest) — 2023-10-16
- 1.0.19 — 2023-10-16
- 1.0.18 — 2023-10-16
- 1.0.17 — 2023-10-12
- 1.0.16 — 2023-10-12
- 1.0.8 — 2023-10-06
- 1.0.7 — 2023-09-27
- 1.0.6 — 2023-09-27
- 1.0.2 — 2023-09-05
- 1.0.1 — 2023-08-23

## README

# NESN LAMBDA LOGGER

A compact logger that works in both commonJS and ES module projects.

## Usage
```js
// CommonJS
const { lambdaLogger } = require('@nesn/lambda-logger');

// ES Modules
import { lambdaLogger } from '@nesn/lambda-logger';

lambdaLogger.info|error|warn(message:string, meta:Record<string, any>, ...tags | null);
```

## Example
```js
// CommonJS
const { lambdaLogger } = require('@nesn/lambda-logger');

// ES Modules
import { lambdaLogger} from '@nesn/lambda-logger';

lambdaLogger.info | error | warn('Your log message here', {
    metadata: 'goes here',
    nested: {
        objects: {
            description: 'are okay as well'
        },
        example: {
            user: {
                email: 'me@here.com',
                name: 'Some Juan'
            }
        }
    } // Use any number of LogTags
}, 'tag_1', 'tag_two', 'tag_3');
```

```text
Field	Value
@ingestionTime	1690917057370
@log	837502413404:/aws/lambda/<your-lambda-and-log-group>
@logStream	2023/08/01/[$LATEST]11221d14ce6c4c5ea715d4255fec83e0
@message	2023-08-01T19:10:52.522Z	2d82aa0d-915e-4d27-b21c-efc055cdef03	INFO	THIS IS A MESSAGE FROM STANDARD WINSTON LOGGER {"email":"me@here.com","nested":{"foo":{"id":"0u812"}},"tags":"get_user_tag,entitlement_tag,ip_lookup_tag"}
@requestId	2d82aa0d-915e-4d27-b21c-efc055cdef03
@timestamp	1690917052522
nested.objects.description are okay as well
nested.example.user.email	me@here.com
nested.example.user.name	Some Juan
tags	tag_1,tag_two,
```

---
_Source: https://npm.io/package/@nesn/commons-lambda-logger · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._