sentry

KO | EN

gitlite — search

#python #react #llm #golang #go #android #rust #nodejs #java #windows #awesome #awesome-list #ios #openai

(★ 48)

A wrapper around the Sentry SDK to make it easier to use in a AdonisJS application

sentry Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![typescript-image]][typescript-url]
[![gh-workflow-image]][gh-workflow-url]
[![npm-image]][npm-url]
[![npm-download-image]][npm-download-url]
[![license-image]][license-url]

</div>

<hr />

`@rlanz/sentry` is a simple wrapper around the Sentry SDK to make it easier to use in a AdonisJS application.

## Installation

```sh
node ace add @rlanz/sentry
```

## Usage

The package will automatically register a middleware and configure the Sentry SDK.

```ts
import type { HttpContext } from '@adonisjs/core/http'
import { Sentry } from '@rlanz/sentry'

export default class HelloController {
  greet({ params, response}: HttpContext) {
    Sentry.captureMessage(`Hello, ${params.name}!`)

return response.ok({ message: `Hello, ${params.name}!` })
  }
}
```

The SDK is automatically scoped to the current request.

```ts
import { inject } from '@adonisjs/core'
import { Sentry } from '@rlanz/sentry'

@inject()
export class GreetingService {  
  greet(name: string) {
    Sentry.captureMessage(`Hello, ${name}!`)
    
    return `Hello, ${name}!`
  }
}
```

### Capturing Errors

You can capture errors by calling the `captureException` method on the SDK inside your exception handler.

```ts
import { Sentry } from '@rlanz/sentry'

export default class HttpExceptionHandler extends ExceptionHandler {
  // ...

async report(error: unknown, ctx: HttpContext) {
    if (this.shouldReport(error as any)) {
      Sentry.captureException(error)
    }

return super.report(error, ctx)
  }
}
```

### Assigning User Context

You can assign user context to the Sentry SDK by calling the `setUser` method on the SDK once you are logged in.

```ts
import { Sentry } from '@rlanz/sentry'

export default class SilentAuthMiddleware {
  async handle(ctx: HttpContext, next: NextFn) {
    // We are authenticating the user
    await ctx.auth.check()

// If the user is authenticated, we assign the user context to Sentry
    if (ctx.auth.isAuthenticated) {
      const user = ctx.auth.getUserOrFail()
      
      Sentry.setUser({
        id: user.id, 
        email: user.email, 
        username: user.username,
      });
    }
    
    return await next();
  }
}
```

### Adding Integrations

Sentry provides multiple integrations to enhance the data captured by the SDK. You can add integrations by changing the `integrations` array inside the configuration `config/sentry.ts`.

For example, if you want to add profiling to your application, you can add the `Profiler` integration.

```sh
npm install @sentry/profiling-node
```

```ts
// config/sentry.ts

import { nodeProfilingIntegration } from '@sentry/profiling-node';

export default defineConfig({
  // ...
  integrations: [nodeProfilingIntegration()],
  profilesSampleRate: 0.2,
})
```

[gh-workflow-image]: https://img.shields.io/github/actions/workflow/status/RomainLanz/sentry/checks.yml?branch=0.3&style=for-the-badge
[gh-workflow-url]: https://github.com/RomainLanz/sentry/actions/workflows/checks.yml
[npm-image]: https://img.shields.io/npm/v/@rlanz/sentry.svg?style=for-the-badge&logo=npm
[npm-url]: https://www.npmjs.com/package/@rlanz/sentry
[npm-download-image]: https://img.shields.io/npm/dm/@rlanz/sentry?style=for-the-badge
[npm-download-url]: https://www.npmjs.com/package/@rlanz/sentry
[typescript-image]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
[typescript-url]: https://www.typescriptlang.org
[license-image]: https://img.shields.io/npm/l/@rlanz/sentry?color=blueviolet&style=for-the-badge
[license-url]: LICENSE.md

sentry

sentry Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

sentry

sentry Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README