Quickstart

This guide walks you through creating an account, setting up a project, installing an SDK, and viewing your first error in Sentry.

Create an account

Sign up at sentry.io. You can also use GitHub or Google to authenticate.If you prefer to run Sentry on your own infrastructure, see Self-hosted Sentry instead.

Create an organization and project

After signing in, Sentry prompts you to create an organization. Organizations are the top-level container for all your teams, projects, and data.Once inside, go to Projects and click Create Project. Select your platform, name the project, and click Create Project. Sentry generates a DSN (Data Source Name) for the project — you’ll use this in the next step.

The DSN looks like: https://<public_key>@o<org_id>.ingest.sentry.io/<project_id>You can always find it again at Project Settings → Client Keys (DSN).

Install the SDK

Install the Sentry SDK for your language or framework.

Python / Django
JavaScript / Node.js

pip install --upgrade sentry-sdk

npm install --save @sentry/node

Configure the SDK

Initialize Sentry as early as possible in your application, before any other imports that might throw errors.

Python (plain)
Django
Node.js

import sentry_sdk

sentry_sdk.init(
    dsn="https://<public_key>@o<org_id>.ingest.sentry.io/<project_id>",
    # Capture 100% of transactions for performance monitoring
    traces_sample_rate=1.0,
)

In your settings.py:

import sentry_sdk

sentry_sdk.init(
    dsn="https://<public_key>@o<org_id>.ingest.sentry.io/<project_id>",
    # Set the environment so events appear under the right filter
    environment="production",
    # Associate errors with a release version
    release="[email protected]",
    traces_sample_rate=1.0,
)

The Django integration is activated automatically when sentry_sdk.init runs inside a Django project.

// instrument.js — import this file first, before anything else
const Sentry = require("@sentry/node");

Sentry.init({
  dsn: "https://<public_key>@o<org_id>.ingest.sentry.io/<project_id>",
  environment: "production",
  release: "[email protected]",
  tracesSampleRate: 1.0,
});

Replace the dsn value with the one from your project settings.

Trigger a test error

Verify the integration is working by throwing a deliberate error.

Python
Node.js

import sentry_sdk

# Capture an exception directly
try:
    raise ValueError("This is a test error from Sentry quickstart")
except Exception as e:
    sentry_sdk.capture_exception(e)

Or from a Django view:

def trigger_error(request):
    division_by_zero = 1 / 0

setTimeout(() => {
  throw new Error("This is a test error from Sentry quickstart");
}, 99);

View the error in Sentry

Open the Issues page in your Sentry project. Within a few seconds you should see the test error appear with a full stack trace, request context, and any extra data you attached.From here you can assign the issue to a team member, set an alert rule, or mark it as resolved.

What’s next

Projects

Learn how projects organize your data and where to find the DSN.

Environments

Filter issues and alerts by production, staging, or any custom environment.

Releases

Track deploys, suspect commits, and release health.

Organizations

Manage teams, members, and organization-wide settings.

Get Started

Core Concepts

What’s next

Projects

Environments

Releases

Organizations

Build docs developers (and LLMs) love

Get Started

Core Concepts

​What’s next

Projects

Environments

Releases

Organizations

Build docs developers (and LLMs) love

What’s next