Documentation/Specialized/Sentry
đŸ”Ŧ

Sentry

v1.3.0Apache 2.0

Best practices and patterns for Sentry error monitoring and observability.

specializedskillhooksentryerror-monitoringobservabilityperformancetracingqualitydebugging

Installation

Install han binary (required for hooks to work):

curl -fsSL https://han.guru/install.sh | bash

Then install this plugin:

han plugin install sentry

Overview

Best practices and patterns for Sentry error monitoring and observability.

What This Plugin Provides

Validation Hooks

  • Sentry Info: Verifies sentry-cli configuration and authentication using sentry-cli info

Skills

This plugin provides the following skills:

  • SDK Configuration: Initialization, integrations, sampling, filtering
  • Error Capturing: Exception handling, context, breadcrumbs, fingerprinting
  • Performance Monitoring: Transactions, spans, distributed tracing, metrics
  • Release Management: Source maps, deployments, release health
  • Alerts & Issues: Alert rules, issue triage, notifications, integrations

Installation

Install via the Han marketplace:

bash
han plugin install sentry

Usage

Once installed, this plugin provides skills for Sentry best practices. The validation hook verifies your sentry-cli configuration is correct.

Requirements

  • sentry-cli installed
  • .sentryclirc or sentry.properties configuration file
  • Valid Sentry authentication token

Configuration

Create .sentryclirc in your project root:

ini
[defaults]
org = your-org
project = your-project

[auth]
token = your-auth-token

Or use environment variables:

bash
export SENTRY_ORG=your-org
export SENTRY_PROJECT=your-project
export SENTRY_AUTH_TOKEN=your-auth-token

Skills

📖

sentry-alerts-issues

Use when configuring Sentry alerts, managing issues, or setting up notifications. Covers alert rules, issue triage, and integrations.

📖

sentry-error-capturing

Use when capturing and reporting errors to Sentry, adding context, or handling exceptions. Covers error boundaries, context enrichment, and fingerprinting.

📖

sentry-performance-monitoring

Use when setting up performance monitoring, distributed tracing, or profiling with Sentry. Covers transactions, spans, and performance insights.

📖

sentry-release-management

Use when managing Sentry releases, uploading source maps, or tracking deployments. Covers release health and commit association.

📖

sentry-sdk-configuration

Use when initializing Sentry in applications, configuring SDK options, or setting up integrations across different frameworks and platforms.

Hooks

⚠ī¸

Token Usage Notice

Hooks run automatically during Claude Code sessions and their output is sent to the model for processing. This may increase token usage and associated costs. Consider disabling hooks you don't need via han-config.yml.

🛑

Stop

Runs when the main Claude Code agent has finished responding. Can verify task completion, check quality gates, or ensure documentation requirements are met before the session ends.

sentry-cli info