Back to Skills

sentry-elixir-sdk

Full Sentry SDK setup for Elixir. Use when asked to "add Sentry to Elixir", "install sentry for Elixir", or configure error monitoring, tracing, logging, or crons for Elixir, Phoenix, or Plug applications. Supports Phoenix, Plug, LiveView, Oban, and Quantum.

246stars30forksUpdated 8/4/2026

Security Assessment

Safe(94/100)
Security Score94/100

About sentry-elixir-sdk

This skill is an opinionated setup wizard for adding the Sentry SDK to Elixir applications, covering error monitoring, tracing, logging, and crons for Phoenix, Plug, LiveView, Oban, and Quantum. It solves the tedious, easy-to-get-wrong task of instrumenting an Elixir app for observability by first scanning the project to understand what is present, then guiding the developer through only the relevant configuration steps.

It runs a detection phase using read-only shell commands (grepping mix.exs and .tool-versions) to find an existing Sentry dependency, the Elixir version, and whether Phoenix, LiveView, Oban, Quantum, or OpenTelemetry are in use, mapping each signal to concrete recommendations such as adding Sentry.PlugCapture and Sentry.PlugContext, wiring Sentry.LiveViewHook, or enabling crons. Reference files break out error monitoring, tracing, logging, and crons in depth. It documents the logging architecture, contrasting the Erlang :logger-based Sentry.LoggerHandler (for issues) with the Sentry Logs protocol (for structured log search), including before_send_log filtering and telemetry processor routing, and notes minimum SDK versions and Elixir ~> 1.13 compatibility. It advises verifying against the official Sentry docs before implementing.

It is aimed at Elixir and Phoenix developers who want production-grade error monitoring and observability. This is a legacy/parent-linked SDK-setup skill with model invocation disabled, invoked when a user explicitly asks to add or configure Sentry for Elixir. Standard credential handling (a Sentry DSN via app config) is documented as normal setup, with no exfiltration or unsafe behavior.

FAQ

What Elixir stacks does it support?

Phoenix, Plug, LiveView, Oban, and Quantum, covering error monitoring, tracing, logging, and crons.

How does it decide what to configure?

A detection phase greps mix.exs and .tool-versions to find existing Sentry usage, the Elixir version, and which frameworks/integrations are present, then recommends only the relevant setup steps.

What are the version requirements?

The docs reference sentry v13.2.0 requiring Elixir ~> 1.13, with feature-specific minimums (LoggerHandler from v9.0.0, Sentry Logs protocol from v12.0.0). It advises verifying against the official Sentry Elixir docs before implementing.

What is the difference between LoggerHandler and the Sentry Logs protocol?

LoggerHandler feeds crash reports and unhandled errors into Sentry Issues, while the Logs protocol (enable_logs) powers structured log search and log-to-trace correlation; both can run simultaneously.

How are credentials handled?

Via a standard Sentry DSN in application config, following normal SDK setup with no data exfiltration.

All Files

5 files
references/logging.md7.8 KB
View
references/tracing.md7.0 KB
View
references/error-monitoring.md9.3 KB
View
SKILL.md13.5 KB
View
references/crons.md9.6 KB
View

Install sentry-elixir-sdk

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill