# @lumigo/node-core

> Lumigo core node sdk

Latest version **1.17.1** (published 2025-06-11) · 0 weekly downloads

## Install

```sh
npm install @lumigo/node-core
pnpm add @lumigo/node-core
yarn add @lumigo/node-core
bun add @lumigo/node-core
```

## Health

**Score 35/100 (D)** — status: maintenance-mode.

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

Warnings: low downloads; no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.17.1 |
| Published | 2025-06-11 |
| First published | 2022-04-26 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 234.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Lumigo LTD |
| Maintainers | lumigo-dev, doriaviram-lumigo, mosesguy, moshe-shaham |

## Links

- npm: https://www.npmjs.com/package/@lumigo/node-core
- Repository: https://github.com/lumigo-io/node-core
- Homepage: https://github.com/lumigo-io/node-core.git
- Issues: https://github.com/lumigo-io/node-core/issues
- npm.io page: https://npm.io/package/@lumigo/node-core

## Dependencies (2)

- [utf8](https://npm.io/package/utf8.md) ^3.0.0
- [shimmer](https://npm.io/package/shimmer.md) ^1.2.1

## Recent versions

- 1.17.1 (latest) — 2025-06-11
- 1.17.0 — 2025-06-11
- 1.16.1 — 2024-11-12
- 1.16.0 — 2024-07-23
- 1.15.1 — 2024-07-11
- 1.15.0 — 2024-02-08
- 1.14.2 — 2023-06-01
- 1.14.1 — 2023-05-24
- 1.14.0 — 2023-05-05
- 1.13.1 — 2023-04-10
- 1.13.0 — 2023-01-15
- 1.12.4 — 2022-11-07
- 1.12.1 — 2022-05-26
- 1.12.0 — 2022-05-02
- 1.11.0 — 2022-05-02
- … 8 more at https://npm.io/package/@lumigo/node-core/versions

## README

# node-core :stars:

[![CircleCI](https://circleci.com/gh/lumigo-io/lumigo-node.svg?style=svg&circle-token=47f40cb5e95e8532e73f69754fac65830b5e86a1)](https://circleci.com/gh/lumigo-io/lumigo-core)
[![codecov](https://codecov.io/gh/lumigo-io/lumigo-node/branch/master/graph/badge.svg?token=mUkKlI8ifC)](https://codecov.io/gh/lumigo-io/lumigo-core)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)

This is [`@lumigo/node-core`](https://github.com/lumigo-io/node-core), Lumigo's Node.js agent core tracing logic for distributed tracing and performance monitoring.
it is used by all our Node tracers to perform many of the shared logic across services

Supported NodeJS runtimes: 8.10, 10.x, 12.x, 14.x, 16.x, 18.x

## Configuration

`@lumigo/node-core` offers several different configuration options. Pass these to the Lambda function as environment variables:

* `LUMIGO_DEBUG=TRUE` - Enables debug logging
* `LUMIGO_SECRET_MASKING_REGEX='["regex1", "regex2"]'` - Prevents Lumigo from sending values for keys that match the supplied regular expressions. All regular expressions are case-insensitive. We support also more granular masking using `LUMIGO_SECRET_MASKING_REGEX_HTTP_REQUEST_BODIES`, `LUMIGO_SECRET_MASKING_REGEX_HTTP_REQUEST_HEADERS`, `LUMIGO_SECRET_MASKING_REGEX_HTTP_RESPONSE_BODIES`, `LUMIGO_SECRET_MASKING_REGEX_HTTP_RESPONSE_HEADERS`, `LUMIGO_SECRET_MASKING_REGEX_HTTP_QUERY_PARAMS` and `LUMIGO_SECRET_MASKING_REGEX_ENVIRONMENT`. By default, Lumigo applies the following regular expressions: `[".*pass.*", ".*key.*", ".*secret.*", ".*credential.*", ".*passphrase.*", ".*token.*"]`. The "magic" value `all` will prevent any value to be sent to Lumigo.
* `LUMIGO_DOMAINS_SCRUBBER='[".*secret.*"]'` - Prevents Lumigo from collecting both request and response details from a list of domains. This accepts a comma-separated list of regular expressions that is JSON-formatted. By default, the tracer uses `["secretsmanager\..*\.amazonaws\.com", "ssm\..*\.amazonaws\.com", "kms\..*\.amazonaws\.com"]`. **Note** - These defaults are overridden when you define a different list of regular expressions.

## Functionality

### Secret masking

Secrets scrubbing by list for regexes:

* support only json data secrets scrubbing

---
_Source: https://npm.io/package/@lumigo/node-core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._