npx skills add ...
npx skills add getsentry/sentry-for-cursor --skill sentry-setup-logging
Setup Sentry Logging in any project. Use this when asked to add Sentry logs, enable structured logging, setup console log capture, or integrate logging with Sentry. Supports JavaScript, TypeScript, Python, Ruby, React, Next.js, and other frameworks.
npx skills add getsentry/sentry-for-cursor --skill sentry-setup-logging
This skill helps configure Sentry's structured logging feature across multiple platforms and frameworks.
Invoke this skill when:
Sentry.logger or sentry_sdk.loggerBefore configuring, detect the project's platform:
Check for these files:
package.json - Read to identify framework and Sentry SDK version@sentry/nextjs, @sentry/react, @sentry/node, @sentry/browser, etc.Check for:
requirements.txt, pyproject.toml, setup.py, or Pipfilesentry-sdk version 2.35.0+ (required for logging)Check for:
Gemfile or *.gemspecsentry-ruby gem version 5.24.0+ (required for logging)Ask the user:
9.41.0+10.12.0+If version is below 9.41.0, inform user to upgrade:
Find the Sentry.init() call and add enableLogs: true.
Locate init files:
instrumentation-client.ts, sentry.server.config.ts, sentry.edge.config.tssrc/index.tsx, src/main.tsx, or dedicated sentry config fileModify init:
If user wants console log capture, add the integration:
Available console levels: debug, info, warn, error, log, assert, trace
If user wants to filter logs before sending:
Provide these examples to the user:
Pino Integration:
Winston Integration:
Consola Integration (SDK 10.12.0+):
sentry-sdk version 2.35.0+If version is below 2.35.0:
Find sentry_sdk.init() and add enable_logs=True.
Common locations:
settings.pyapp.py or __init__.pymain.pyModify init:
To capture Python's stdlib logging:
Available levels: logging.DEBUG, logging.INFO, logging.WARNING, logging.ERROR, logging.CRITICAL
sentry-ruby version 5.24.0+If version is below 5.24.0:
Then run bundle update sentry-ruby
Find Sentry.init block and add config.enable_logs = true.
Common locations:
config/initializers/sentry.rbModify init:
To capture Ruby's stdlib Logger:
instrumentation-client.ts, sentry.server.config.ts, sentry.edge.config.tsSentry.logger from @sentry/nextjsSentry.logger from @sentry/reactSentry.logger from @sentry/nodesettings.pyconfig/initializers/sentry.rb:logger patch for stdlib Logger captureAfter setup, provide these verification instructions:
Tell user to check their Sentry dashboard under Logs section to verify logs are arriving.
Solutions:
enableLogs: true (JS) or enable_logs=True (Python/Ruby) is setSolutions:
beforeSendLog / before_send_log to filterSolutions:
integrations arraylevels arraySolutions:
npm install @sentry/nextjs@latestpip install --upgrade sentry-sdkbundle update sentry-rubyProvide this checklist after setup:
| Platform | SDK Version | Enable Flag | Logger API |
|---|---|---|---|
| JavaScript | 9.41.0+ | enableLogs: true | Sentry.logger.* |
| Python | 2.35.0+ | enable_logs=True | sentry_sdk.logger.* |
| Ruby | 5.24.0+ | config.enable_logs = true | Sentry.logger.* |
| Log Level | JavaScript | Python | Ruby |
|---|---|---|---|
| Trace | trace() | trace() | trace() |
| Debug | debug() | debug() | debug() |
| Info | info() | info() | info() |
| Warning | warn() | warning() | warning() |
| Error | error() | error() | error() |
| Fatal | fatal() | fatal() | fatal() |