# @toruslabs/loglevel-sentry

> A package to allow logging and monitoring with sentry

Latest version **9.0.0** (published 2026-02-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install @toruslabs/loglevel-sentry
pnpm add @toruslabs/loglevel-sentry
yarn add @toruslabs/loglevel-sentry
bun add @toruslabs/loglevel-sentry
```

## Health

**Score 60/100 (C)** — status: stable.

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

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 9.0.0 |
| Published | 2026-02-06 |
| First published | 2021-01-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.x |
| Dependencies | 2 |
| Unpacked size | 28.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 9 |
| Author | Torus Labs |
| Maintainers | torusresearch, chaitanyapotti, tetratorus, archit_web3, himanshunpm009 |
| Keywords | loglevel, sentry, torus |

## Links

- npm: https://www.npmjs.com/package/@toruslabs/loglevel-sentry
- Repository: https://github.com/torusresearch/loglevel-sentry
- Homepage: https://github.com/torusresearch/loglevel-sentry#readme
- Issues: https://github.com/torusresearch/loglevel-sentry/issues
- npm.io page: https://npm.io/package/@toruslabs/loglevel-sentry

## Dependencies (2)

- [loglevel](https://npm.io/package/loglevel.md) ^1.9.2
- [@sentry/core](https://npm.io/package/@sentry/core.md) ^10.38.0

## Alternatives

- [@sentry/react-native](https://npm.io/package/@sentry/react-native.md) — 2.6M weekly downloads
- [@ardatan/aggregate-error](https://npm.io/package/@ardatan/aggregate-error.md) — 708.1K weekly downloads
- [custom-error-generator](https://npm.io/package/custom-error-generator.md) — 2.0K weekly downloads
- [@technik-sde/prosemirror-recreate-transform](https://npm.io/package/@technik-sde/prosemirror-recreate-transform.md) — 1.5K weekly downloads
- [@suchipi/error-utils](https://npm.io/package/@suchipi/error-utils.md) — 78 weekly downloads

## Recent versions

- 9.0.0 (latest) — 2026-02-06
- 8.1.0 — 2025-04-04
- 8.0.2 — 2025-03-11
- 8.0.1 — 2025-03-11
- 8.0.0 — 2025-03-10
- 7.2.0 — 2024-12-03
- 7.1.0 — 2024-12-02
- 7.0.1 — 2024-08-13
- 7.0.0 — 2024-06-14
- 6.1.3 — 2024-04-09
- 6.1.2 — 2024-04-04
- 6.1.1 — 2024-04-04
- 6.1.0 — 2024-03-21
- 6.0.1 — 2023-09-07
- 6.0.0 — 2023-08-08
- … 19 more at https://npm.io/package/@toruslabs/loglevel-sentry/versions

## README

# loglevel-sentry

[![npm version](https://badge.fury.io/js/%40toruslabs%2Floglevel-sentry.svg)](https://badge.fury.io/js/%40toruslabs%2Floglevel-sentry)
![npm](https://img.shields.io/npm/dw/@toruslabs/loglevel-sentry)

## Introduction

This repo allows you to log + track logs using sentry

## Features

- Typescript compatible. Includes Type definitions

## Installation

### Bundling

This module is distributed in 3 formats

- `lib.esm` build `dist/lib.esm/index.js` in es6 format
- `lib.cjs` build `dist/lib.cjs/index.js` in es5 format
- `umd` build `dist/loglevelSentry.umd.min.js` in es5 format without polyfilling corejs minified

By default, the appropriate format is used for your specified usecase
You can use a different format (if you know what you're doing) by referencing the correct file

The cjs build is not polyfilled with core-js.
It is upto the user to polyfill based on the browserlist they target

### Directly in Browser

CDN's serve the non-core-js polyfilled version by default. You can use a different

jsdeliver

```js
<script src="https://cdn.jsdelivr.net/npm/@toruslabs/loglevel-sentry"></script>
```

unpkg

```js
<script src="https://unpkg.com/@toruslabs/loglevel-sentry"></script>
```

## Usage

Add [`@toruslabs/loglevel-sentry`](https://www.npmjs.com/package/@toruslabs/loglevel-sentry) to your project:

To use this module:

1. Install the package
   `npm i @toruslabs/loglevel-sentry`

2. Create your `loglevel` instance and install this plugin to enable Sentry:

```js
import loglevel from "loglevel";
import * as Sentry from "@sentry/browser";
// Node.js: import * as Sentry from "@sentry/node";
import LoglevelSentryPlugin from "@toruslabs/loglevel-sentry";

logger = loglevel.getLogger("__LOGGER_NAME__");

const plugin = new LoglevelSentryPlugin(Sentry);
sentry.install(logger);
```

(Optional) You can replace loglevel with other logging library by using loglevel `methodFactory` API:

```js
import loglevel from "loglevel";
import pino from "pino";
import * as Sentry from "@sentry/browser";
// Node.js: import * as Sentry from "@sentry/node";
import LoglevelSentryPlugin from "@toruslabs/loglevel-sentry";

const logger = loglevel.getLogger("__LOGGER_NAME__");
logger.methodFactory = (method, level, name) => {
  const alt = pino(name, level);
  return alt[method];
};

const sentry = new LoglevelSentryPlugin(Sentry);
sentry.install(logger);
```

## Info

Is 100% compatible with `loglevel` API. Events/errors will be reported for all enabled log functions.

## Best practices

Though it isn't compulsory, it is recommended to call log functions with following signatures:

- `log.trace`, `log.debug`, `log.info`, and `log.warn`: `(msg: string, ...others: any[])`.

- `log.error`: `(err: Error, ...others: any[])`.

If you always want to monitor a specific event regardless of configured log level, use the plugin API:

```js
const sentry = new LoglevelSentryPlugin(Sentry);
sentry.install(logger);

sentry.trace("this", "message", "will always be reported.");
```

## Requirements

- This package requires a peer dependency of `@babel/runtime`
- Node 20+

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