README.md

Official Sentry SDK for Nitro

Links

• Official Nitro SDK Docs

Compatibility

The minimum supported version of Nitro is 3.0.0-alpha.1.

General

This package is a wrapper around @sentry/node with added instrumentation for Nitro's features like:

• HTTP handlers and error capturing.
• Middleware instrumentation.

Manual Setup

1. Prerequisites & Installation

1. Install the Sentry Nitro SDK:

   # Using npm
   npm install @sentry/nitro
   
   # Using yarn
   yarn add @sentry/nitro
   
   # Using pnpm
   pnpm add @sentry/nitro

2. Nitro Config Setup

1. Import withSentryConfig from @sentry/nitro and call it with your Nitro config.

In nitro.config.ts

If you are using a dedicated nitro.config.ts file, you can import withSentryConfig from @sentry/nitro and call it with your Nitro config.

import { defineNitroConfig } from 'nitro/config';
import { withSentryConfig } from '@sentry/nitro';

const config = defineNitroConfig({
  // ...
});

export default withSentryConfig(config, {
  // Sentry Build Options
});

In vite.config.ts

If you are using nitro as a Vite plugin, you can import withSentryConfig from @sentry/nitro and call it with your Nitro config.

import { defineConfig } from 'vite';
import { nitro } from 'nitro/vite';
import { withSentryConfig } from '@sentry/nitro';

export default defineConfig({
  plugins: [nitro()],
  nitro: withSentryConfig(
    {
      // Nitro options
    },
    {
      // Sentry Build Options
    },
  ),
});

3. Sentry Config Setup

TODO: UPDATE THIS

Uploading Source Maps

To upload source maps...

Troubleshoot

If you encounter any issues with error tracking or integrations, refer to the official Sentry Nitro SDK documentation. If the documentation does not provide the necessary information, consider opening an issue on GitHub.