Get started with Error Tracking

Create a project, send a test error from Node.js with the official Sentry SDK, open the issue it becomes, and delete the project again.

Last updated 18 November 2026View as Markdown

This takes about ten minutes. Replace my-app with a name of your own, project-id with the project's id and issue-id with the issue's short id.

Prerequisites

  • Permission for errors:CreateProject, errors:ListProjects, errors:ListIssues, errors:GetEvents and errors:DeleteProject. In the console, Projects shows an access-denied notice without errors:ListProjects, a project's pages are not found without it on that project, the Issues tab says "You cannot see this project's issues." without errors:ListIssues, and an issue's page says "You can see this issue but not its events." without errors:GetEvents.
  • Node.js and npm, to send the test error with the official Sentry SDK for Node.js.

Step 1: Create a project

  1. In Error Tracking, open Projects, then choose Create project.
  2. For Name, enter my-app.
  3. For Platform, choose Node.js.
  4. Choose Create.

The console opens the project's Setup tab. Copy the DSN from the page header.

Step 2: Send a test error

In an empty directory, install the SDK and send one error. Replace dsn with the DSN.

npm install @sentry/node
cat > send.mjs <<'EOF'
import * as Sentry from '@sentry/node';
Sentry.init({ dsn: process.env.SENTRY_DSN });
Sentry.captureException(new Error('Hello from my-app'));
await Sentry.flush(2000);
EOF
SENTRY_DSN='dsn' node send.mjs

Step 3: Open the issue

  1. Open the project, then the Issues tab.
  2. Choose the issue Error: Hello from my-app (an issue's title is the exception's type and message).

The issue page shows the event with its stack trace and tags.

Clean up

Deleting the project revokes its DSN keys and deletes its issues and events.

  1. Open the project's Settings tab.
  2. Under Danger zone, choose Delete project, enter the project's name and confirm.

Next steps

Did this page help you?