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:GetEventsanderrors:DeleteProject. In the console, Projects shows an access-denied notice withouterrors:ListProjects, a project's pages are not found without it on that project, the Issues tab says "You cannot see this project's issues." withouterrors:ListIssues, and an issue's page says "You can see this issue but not its events." withouterrors:GetEvents. - Node.js and npm, to send the test error with the official Sentry SDK for Node.js.
Step 1: Create a project
- In Error Tracking, open Projects, then choose Create project.
- For Name, enter my-app.
- For Platform, choose Node.js.
- Choose Create.
The console opens the project's Setup tab. Copy the DSN from the page header.
dcloud errors projects create --name my-app --platform nodeThe answer carries the project's id and dsn.
POST /errors/api/projects
{ "name": "my-app", "platform": "node" }The answer is 201 with the project, its id and its dsn.
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.mjsStep 3: Open the issue
- Open the project, then the Issues tab.
- 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.
dcloud errors issues list project-id
dcloud errors events latest issue-idGET /errors/api/projects/project-id/issuesGET /errors/api/issues/issue-id/events/latestClean up
Deleting the project revokes its DSN keys and deletes its issues and events.
- Open the project's Settings tab.
- Under Danger zone, choose Delete project, enter the project's name and confirm.
dcloud errors projects delete project-idDELETE /errors/api/projects/project-idNext steps
- Connect an app, so a deployed app gets its DSN without copying it.
- Upload source maps
- Set the default alerts
Did this page help you?