用途:在任意项目中配置 Sentry 结构化日志功能,适用于用户要求添加 Sentry 日志、启用结构化日志、捕获控制台日志或将现有日志库接入 Sentry 的场景。
主要能力:先检测项目平台(JS/TS 检查 package.json 与 @sentry/* 包;Python 检查 requirements.txt、pyproject.toml 等与 sentry-sdk;Ruby 检查 Gemfile 与 sentry-ruby),再按平台启用日志。JS/TS 需 SDK 9.41.0+(Consola 集成需 10.12.0+),在 Sentry.init() 中加 enableLogs: true;Python 需 sentry-sdk 2.35.0+,加 enable_logs=True;Ruby 需 sentry-ruby 5.24.0+,加 config.enable_logs = true。可选配置控制台捕获(如 Sentry.consoleLoggingIntegration)、日志过滤(beforeSendLog / before_send_log)以及 Pino、Winston、Consola、Python LoggingIntegration、Loguru、Ruby :logger 补丁等第三方集成。
使用方式:技能会先询问日志方案(控制台集成、结构化日志或两者)与日志级别(默认 info、warn、error,或全部级别),然后定位并修改初始化文件,例如 Next.js 的 instrumentation-client.ts、sentry.server.config.ts、sentry.edge.config.ts,Django 的 settings.py,Rails 的 config/initializers/sentry.rb。结构化日志通过 Sentry.logger.info 等 API 调用,支持属性与模板格式化。
适用场景:为已有 Sentry 项目补充日志能力、统一多语言日志上报、将现有日志库接入 Sentry。
限制:需满足各平台最低 SDK 版本,否则需先升级;日志需在 Sentry 控制台 Logs 区域查看;日志过多时需用过滤函数或降低级别控制;资料未提供收费、价格与效果数据。