Typescript Sentry

Error monitoring and performance tracking with Sentry SDK - error capture, breadcrumbs, performance spans, cron monitoring, source maps, structured logging, profiling, and enrichment helpers for Bun/Node.js/Next.js. Use when this capability is needed.

tomevault-io d3f0806 2 files · 6.0 KB Updated Sep 17, 2026

Install

Press C to copy

$ npx skillmds@latest add tomevault-io/typescript-sentry

Installs into ~/.claude/skills (or .claude/skills inside a project). Restart Claude Code to pick it up.

＋ Add to collection

README badge

[![SkillMD](https://skillmd.com/badge/tomevault-io/typescript-sentry.svg)](https://skillmd.com/skills/tomevault-io/typescript-sentry)

Trust & safety

Audits pending

Not yet audited · commit d3f0806

Works with: Claude Code Claude.ai OpenAI Codex +

File contents

TypeScript Sentry

When to Use This Skill

Use this skill when...	Use another approach when...
Adding error monitoring to a project	Setting up logging (use a logger library)
Instrumenting performance spans	Monitoring infrastructure metrics (use Prometheus/Grafana)
Setting up cron job monitoring	Setting up uptime monitoring (use Pingdom/UptimeRobot)
Configuring source maps for Sentry	Debugging errors locally (use debugger)
Adding structured logging to Sentry	Configuring project-level Sentry compliance (use `/configure:sentry`)
Setting up profiling, replay, or enrichment helpers	Managing Sentry project settings in the dashboard
Implementing error/transaction filtering	Creating Sentry alerting rules

Core Expertise

Sentry provides error monitoring and performance tracking:

Automatic error capture with stack traces
Performance monitoring with distributed tracing
Cron job monitoring for scheduled tasks
Source map integration for readable TypeScript traces
Rich context with tags, breadcrumbs, and user data
Structured logging forwarded to Sentry (enableLogs)
CPU/JS profiling (Node.js + browser)
Session replay with privacy controls
User feedback widget
Enrichment helpers (custom contexts, breadcrumb categories, fingerprinting)

Installation

Bun

bun add @sentry/bun

Node.js

bun add @sentry/node

Next.js

bun add @sentry/nextjs @sentry/profiling-node

React/Browser

bun add @sentry/react
# or
bun add @sentry/browser

Error Capturing

captureException

try {
  await riskyOperation();
} catch (error) {
  Sentry.captureException(error);
  throw error; // Re-throw if needed
}

With Context

Sentry.captureException(error, {
  tags: {
    feature: "checkout",
    paymentProvider: "stripe",
  },
  extra: {
    orderId: order.id,
    userId: user.id,
    cartItems: cart.items.length,
  },
  level: "error", // fatal, error, warning, info, debug
});

captureMessage

// Simple message
Sentry.captureMessage("User completed onboarding");

// With level
Sentry.captureMessage("Rate limit approaching", "warning");

// With context
Sentry.captureMessage("Payment failed", {
  level: "error",
  tags: { gateway: "stripe" },
  extra: { errorCode: "card_declined" },
});

Agentic Optimizations

Context	Command
Install Bun	`bun add @sentry/bun`
Install Node	`bun add @sentry/node`
Install Next.js	`bun add @sentry/nextjs @sentry/profiling-node`
Install React	`bun add @sentry/react`
Install CLI	`bun add -D @sentry/cli`
Upload maps	`npx sentry-cli sourcemaps inject ./dist && npx sentry-cli sourcemaps upload ./dist`
Setup wizard	`npx @sentry/wizard@latest -i sourcemaps`
Test capture	`Sentry.captureMessage("Test from dev")`

Quick Reference

Capture Methods

Method	Purpose
`captureException(error)`	Capture error with stack trace
`captureMessage(msg)`	Capture text message
`captureCheckIn(opts)`	Cron job check-in
`addBreadcrumb(crumb)`	Add navigation/action trail

Context Methods

Method	Purpose
`setTag(key, value)`	Add filterable tag
`setExtra(key, value)`	Add debug data
`setUser(user)`	Set user context
`withScope(callback)`	Scoped context

Performance Methods

Method	Purpose
`startSpan(opts, callback)`	Create performance span
`withMonitor(slug, callback)`	Monitor cron job

Severity Levels

Level	Use Case
`fatal`	App crash, unrecoverable
`error`	Error requiring attention
`warning`	Potential issue
`info`	Informational
`debug`	Debugging only

Configuration Options

Option	Description
`dsn`	Project data source name
`environment`	Environment name (production, staging)
`release`	Application version
`tracesSampleRate`	Transaction sample rate (0.0-1.0)
`tracesSampler`	Dynamic sampling function
`sendDefaultPii`	Capture IP/headers
`integrations`	SDK integrations array
`enableLogs`	Forward structured logs to Sentry
`profileSessionSampleRate`	Profiling sample rate (0.0-1.0)
`profileLifecycle`	`"trace"` profiles every traced request
`replaysSessionSampleRate`	Session replay sample rate
`replaysOnErrorSampleRate`	Replay capture rate on errors
`ignoreErrors`	Array of error patterns to suppress
`beforeSend`	Filter/modify events before sending
`beforeSendTransaction`	Filter transactions before sending
`beforeSendLog`	Filter structured logs before sending

For detailed examples, advanced patterns, and best practices, see REFERENCE.md.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: typescript-sentrydescription: Error monitoring and performance tracking with Sentry SDK - error capture, breadcrumbs, performance spans, cron monitoring, source maps, structured logging, profiling, and enrichment helpers for Bun/Node.js/Next.js. Use when this capability is needed.---# TypeScript Sentry## When to Use This Skill| Use this skill when... | Use another approach when... ||------------------------|------------------------------|| Adding error monitoring to a project | Setting up logging (use a logger library) || Instrumenting performance spans | Monitoring infrastructure metrics (use Prometheus/Grafana) || Setting up cron job monitoring | Setting up uptime monitoring (use Pingdom/UptimeRobot) || Configuring source maps for Sentry | Debugging errors locally (use debugger) || Adding structured logging to Sentry | Configuring project-level Sentry compliance (use `/configure:sentry`) || Setting up profiling, replay, or enrichment helpers | Managing Sentry project settings in the dashboard || Implementing error/transaction filtering | Creating Sentry alerting rules |## Core ExpertiseSentry provides error monitoring and performance tracking:- Automatic error capture with stack traces- Performance monitoring with distributed tracing- Cron job monitoring for scheduled tasks- Source map integration for readable TypeScript traces- Rich context with tags, breadcrumbs, and user data- Structured logging forwarded to Sentry (`enableLogs`)- CPU/JS profiling (Node.js + browser)- Session replay with privacy controls- User feedback widget- Enrichment helpers (custom contexts, breadcrumb categories, fingerprinting)## Installation### Bun```bashbun add @sentry/bun```### Node.js```bashbun add @sentry/node```### Next.js```bashbun add @sentry/nextjs @sentry/profiling-node```### React/Browser```bashbun add @sentry/react# orbun add @sentry/browser```## Error Capturing### captureException```typescripttry { await riskyOperation();} catch (error) { Sentry.captureException(error); throw error; // Re-throw if needed}```### With Context```typescriptSentry.captureException(error, { tags: { feature: "checkout", paymentProvider: "stripe", }, extra: { orderId: order.id, userId: user.id, cartItems: cart.items.length, }, level: "error", // fatal, error, warning, info, debug});```### captureMessage```typescript// Simple messageSentry.captureMessage("User completed onboarding");// With levelSentry.captureMessage("Rate limit approaching", "warning");// With contextSentry.captureMessage("Payment failed", { level: "error", tags: { gateway: "stripe" }, extra: { errorCode: "card_declined" },});```## Agentic Optimizations| Context | Command ||---------|---------|| Install Bun | `bun add @sentry/bun` || Install Node | `bun add @sentry/node` || Install Next.js | `bun add @sentry/nextjs @sentry/profiling-node` || Install React | `bun add @sentry/react` || Install CLI | `bun add -D @sentry/cli` || Upload maps | `npx sentry-cli sourcemaps inject ./dist && npx sentry-cli sourcemaps upload ./dist` || Setup wizard | `npx @sentry/wizard@latest -i sourcemaps` || Test capture | `Sentry.captureMessage("Test from dev")` |## Quick Reference### Capture Methods| Method | Purpose ||--------|---------|| `captureException(error)` | Capture error with stack trace || `captureMessage(msg)` | Capture text message || `captureCheckIn(opts)` | Cron job check-in || `addBreadcrumb(crumb)` | Add navigation/action trail |### Context Methods| Method | Purpose ||--------|---------|| `setTag(key, value)` | Add filterable tag || `setExtra(key, value)` | Add debug data || `setUser(user)` | Set user context || `withScope(callback)` | Scoped context |### Performance Methods| Method | Purpose ||--------|---------|| `startSpan(opts, callback)` | Create performance span || `withMonitor(slug, callback)` | Monitor cron job |### Severity Levels| Level | Use Case ||-------|----------|| `fatal` | App crash, unrecoverable || `error` | Error requiring attention || `warning` | Potential issue || `info` | Informational || `debug` | Debugging only |### Configuration Options| Option | Description ||--------|-------------|| `dsn` | Project data source name || `environment` | Environment name (production, staging) || `release` | Application version || `tracesSampleRate` | Transaction sample rate (0.0-1.0) || `tracesSampler` | Dynamic sampling function || `sendDefaultPii` | Capture IP/headers || `integrations` | SDK integrations array || `enableLogs` | Forward structured logs to Sentry || `profileSessionSampleRate` | Profiling sample rate (0.0-1.0) || `profileLifecycle` | `"trace"` profiles every traced request || `replaysSessionSampleRate` | Session replay sample rate || `replaysOnErrorSampleRate` | Replay capture rate on errors || `ignoreErrors` | Array of error patterns to suppress || `beforeSend` | Filter/modify events before sending || `beforeSendTransaction` | Filter transactions before sending || `beforeSendLog` | Filter structured logs before sending |For detailed examples, advanced patterns, and best practices, see [REFERENCE.md](REFERENCE.md).---> Converted and distributed by [TomeVault](https://tomevault.io/claim/laurigates) — claim your Tome and manage your conversions.

tomevault-io/skills-registry/tree/main/laurigates--claude-plugins--typescript-sentry commit d3f08067d8

Frequently asked questions

npx skillmds@latest add tomevault-io/typescript-sentry