Using Sentry

What it does

This skill, "Using Sentry," allows an AI agent to integrate with Sentry for application monitoring and error tracking. It enables capturing exceptions, adding contextual information (user details, custom tags, order IDs), creating performance spans around operations, utilizing structured logging, and adding breadcrumbs to provide context for errors. This helps developers understand and resolve issues within their applications more effectively.

When to use it

• When you need to automatically track and debug application errors in a production environment.
• To gain insights into the performance of specific code sections or user interactions.
• For adding detailed contextual information (like user IDs, order details) to error reports for easier troubleshooting.
• To monitor and log important events within your application's workflow.
• When implementing user sign-out functionality and need to clear associated Sentry user context.

Key capabilities

• Exception Capture: Manually capture errors that occur during code execution.
• Contextual Data Addition: Attach user information (ID, email) and custom data (tags, order details) to error reports.
• Performance Tracing: Create spans to measure the duration of specific operations.
• Structured Logging: Utilize Sentry's logging capabilities for structured log messages with associated data.
• Breadcrumbs: Add breadcrumbs to provide a history of events leading up to an error.
• User Context Management: Set and clear user context within Sentry.

Example prompts

• "Capture this error and add the current order ID as extra context."
• "Create a performance span around the API call to /api/users."
• "Log an informational message indicating payment processing with the order ID 123 and amount 99.99."
• "Clear the user's Sentry context upon sign-out."

Tips & gotchas

• This skill requires familiarity with and configuration of a Sentry project.
• The source content focuses on integration within a Next.js environment, but principles apply to other frameworks as well.
• Ensure the @sentry/nextjs package (or equivalent for your framework) is installed and configured correctly.