菜单
Install and configure Sentry SDK authentication with DSN setup. Use when setting up Sentry error tracking, configuring DSN, or initializing Sentry in a Node.js or Python project. Trigger with "install sentry", "setup sentry", "sentry auth", "configure sentry DSN".
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill sentry-install-auth命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Implement user sign-up and sign-in flows with Clerk. Use when building authentication UI, customizing sign-in experience, or implementing OAuth social login. Trigger with phrases like "clerk sign-in", "clerk sign-up", "clerk login flow", "clerk OAuth", "clerk social login".
Implement session management and middleware with Clerk. Use when managing user sessions, configuring route protection, or implementing token refresh and custom JWT templates. Trigger with phrases like "clerk session", "clerk middleware", "clerk route protection", "clerk token", "clerk JWT".
Configure enterprise SSO, role-based access control, and organization management. Use when implementing SSO integration, configuring role-based permissions, or setting up organization-level controls. Trigger with phrases like "clerk SSO", "clerk RBAC", "clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".
基于 SOC 职业分类
正在显示 SKILL.md
| name | sentry-install-auth |
| description | Install and configure Sentry SDK authentication with DSN setup. Use when setting up Sentry error tracking, configuring DSN, or initializing Sentry in a Node.js or Python project. Trigger with "install sentry", "setup sentry", "sentry auth", "configure sentry DSN". |
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep |
| version | 1.51.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","sentry","monitoring","error-tracking"] |
| compatibility | Designed for Claude Code |
Install the Sentry SDK, configure DSN-based authentication, and verify error tracking is operational. Covers Node.js (@sentry/node), browser (@sentry/browser), and Python (sentry-sdk) with environment-based configuration and auth token setup for CLI/CI workflows.
Node.js / TypeScript:
npm install @sentry/node
# For profiling support (optional):
npm install @sentry/profiling-node
Browser / Framework-specific:
npm install @sentry/browser
# Or pick your framework:
npm install @sentry/react # React
npm install @sentry/nextjs # Next.js
npm install @sentry/vue # Vue
Python:
pip install sentry-sdk
The DSN (Data Source Name) tells the SDK where to send events. It looks like https://<key>@<org>.ingest.sentry.io/<project-id>. Never hardcode it — use environment variables.
# .env (add this file to .gitignore)
SENTRY_DSN=https://examplePublicKey@o0.ingest.sentry.io/0
SENTRY_ENVIRONMENT=development
SENTRY_RELEASE=1.0.0
For production, store the DSN in your secret manager (AWS Secrets Manager, GCP Secret Manager, Vault, etc.) and inject it at deploy time.
Node.js (ESM) — create instrument.mjs at project root:
This file MUST be imported before any other modules. The --import flag ensures Sentry instruments HTTP, database, and framework integrations via monkey-patching at load time.
* ;
.({
: process..,
: process.. || ,
: process..,
: process.. === ? : ,
: process.. !== ,
: ,
: [
],
});
Start your app with the --import flag:
node --import ./instrument.mjs app.mjs
Or in package.json:
{
"scripts": {
"start": "node --import ./instrument.mjs app.mjs"
}
}
Browser:
import * as Sentry from '@sentry/browser';
Sentry.init({
dsn: process.env.SENTRY_DSN, // injected at build time
environment: process.env.NODE_ENV,
release: process.env.SENTRY_RELEASE,
tracesSampleRate: 0.1,
replaysSessionSampleRate: 0.1,
replaysOnErrorSampleRate: 1.0,
integrations: [
Sentry.browserTracingIntegration(),
Sentry.replayIntegration(),
],
});
Python:
import os
import sentry_sdk
sentry_sdk.init(
dsn=os.environ.get("SENTRY_DSN"),
environment=os.environ.get("SENTRY_ENVIRONMENT", "development"),
release=os.environ.get("SENTRY_RELEASE"),
traces_sample_rate=0.1,
send_default_pii=False,
)
Send a test event and confirm it appears in the Sentry dashboard:
Node.js:
import * as Sentry from '@sentry/node';
Sentry.captureMessage('Sentry SDK installed successfully', 'info');
// Ensure the event is flushed before process exits
await Sentry.flush(2000);
Python:
import sentry_sdk
sentry_sdk.capture_message("Sentry SDK installed successfully")
# Ensure the event is flushed
sentry_sdk.flush(timeout=2)
Check the Issues tab in your Sentry project within 30 seconds. If the message appears, authentication is working.
The DSN authenticates the SDK for sending events. For the Sentry CLI (source maps, releases, deploys), you need a separate auth token.
Generate one at https://sentry.io/settings/auth-tokens/ with scopes:
project:releases — create releases and upload source mapsorg:read — read organization data# Install Sentry CLI
npm install -g @sentry/cli
# Set the token
export SENTRY_AUTH_TOKEN=sntrys_YOUR_TOKEN_HERE
# Verify auth works
sentry-cli info
In CI, store SENTRY_AUTH_TOKEN as a secret environment variable.
@sentry/node, @sentry/browser, or sentry-sdk)instrument.mjs created and loaded before app entry point (Node.js)| Error | Cause | Solution |
|---|---|---|
Invalid Sentry Dsn | Malformed DSN string | Copy DSN exactly from Project Settings > Client Keys (DSN). Format: https://<key>@<org>.ingest.sentry.io/<project-id> |
| Events not appearing in dashboard | DSN env var not loaded | Verify with console.log(process.env.SENTRY_DSN) before Sentry.init(). Check .env is loaded (use dotenv or framework equivalent) |
| HTTP 401 Unauthorized | Invalid or revoked auth token | Regenerate token at https://sentry.io/settings/auth-tokens/. Verify with sentry-cli info |
| HTTP 429 Too Many Requests | Rate-limited by Sentry | Lower tracesSampleRate. Check quota at Settings > Subscription. Events are dropped, not queued |
Express is not instrumented | SDK initialized after Express import | Move import './instrument.mjs' to first line or use --import flag. SDK must load before any framework imports |
| HTTP 403 Forbidden | Auth token missing required scopes | Regenerate token with project:releases and org:read scopes |
ECONNREFUSED / network errors | Sentry ingest endpoint unreachable | Check https://status.sentry.io for outages. Verify firewall allows *.ingest.sentry.io on port 443 |
| ESM compatibility error | Node.js < 18.19 or < 20.6 | Upgrade Node.js. SDK v8 requires these minimum versions for ESM --import support |
Express.js with full error handler:
// instrument.mjs
import * as Sentry from '@sentry/node';
Sentry.init({
dsn: process.env.SENTRY_DSN,
environment: process.env.SENTRY_ENVIRONMENT || 'development',
tracesSampleRate: 0.2,
});
// app.mjs — start with: node --import ./instrument.mjs app.mjs
import * as Sentry from '@sentry/node';
import express from 'express';
const app = express();
app.get('/api/health', (req, res) => {
res.json({ status: 'ok' });
});
app.get('/api/debug-sentry', (req, res) => {
throw new Error('Sentry test error');
});
// Sentry error handler must be registered after all routes
Sentry.setupExpressErrorHandler(app);
// Fallback error handler
app.use((err, req, res, next) => {
res.status(500).json({ error: 'Internal server error' });
});
app.listen(3000, () => console.log('Server running on :3000'));
Python Flask:
import os
import sentry_sdk
from flask import Flask
sentry_sdk.init(
dsn=os.environ.get("SENTRY_DSN"),
environment=os.environ.get("SENTRY_ENVIRONMENT", "development"),
traces_sample_rate=0.2,
send_default_pii=False,
)
app = Flask(__name__)
@app.route("/api/health")
def health():
return {"status": "ok"}
@app.route("/api/debug-sentry")
def debug_sentry():
raise Exception("Sentry test error") # Automatically captured
Graceful shutdown with flush:
import * as Sentry from '@sentry/node';
process.on('SIGTERM', async () => {
console.log('Shutting down gracefully...');
await Sentry.flush(5000); // wait up to 5s for pending events
process.exit(0);
});
For configuring alerts and issue management, see sentry-alerts-config.