Sentry 25.9.0版本新增Logs功能配置指南：轻松开启高级日志分析能力

在Sentry的最新版本25.9.0中，开发者迎来了一个重要的功能升级——Ourlogs日志分析功能的全面支持。作为Sentry自托管版本的用户，您可能已经注意到，要充分利用这一功能，需要在配置文件中添加一系列新的特性标志（feature flags）。本文将为您详细解析如何正确配置这些新功能，让您的Sentry实例具备强大的日志分析能力。

为什么需要这些配置更新？

Sentry 25.9.0版本在原有基础上增加了对Ourlogs功能的全面支持，但需要注意的是，这些配置与25.8.0版本的配置并不完全一致。根据GitHub issue #3560的讨论，我们需要在原有配置基础上添加特定的特性标志，才能正确启用这些功能。

需要添加的关键配置

在您的Sentry配置文件中，找到SENTRY_FEATURES.update部分，将以下配置添加到对应位置：

SENTRY_FEATURES.update({
    feature: True
    for feature in (
        "organizations:discover",
        # ...其他现有配置...
        "organizations:performance-view",
        "organizations:performance-trace-explorer",  # 🟢 必须添加！
        "organizations:visibility-explore-view",    # 🟢 确保已存在！
        "organizations:transaction-metrics-extraction",
        # ...其他现有配置...
        # Ourlogs功能相关配置
        "organizations:ourlogs-enabled",
        "organizations:ourlogs-ingestion",
        "organizations:ourlogs-stats",
        "organizations:ourlogs-graph",
        "organizations:ourlogs-visualize-sidebar",
        "organizations:ourlogs-dashboards",
        "organizations:ourlogs-alerts",
        "organizations:ourlogs-live-refresh",
        "organizations:ourlogs-infinite-scroll",
        "organizations:ourlogs-replay-ui",  # 在SaaS版本中此功能已禁用，不影响自托管
        # "organizations:ourlogs-saved-queries",  # 可选，根据需要取消注释启用
    )
})

配置项详解

1. organizations:performance-trace-explorer：这是必须添加的配置，它启用了性能追踪探索功能，是Ourlogs功能的核心组件。

2. organizations:ourlogs-enabled：启用Ourlogs功能的基础标志。

3. organizations:ourlogs-ingestion：允许Sentry接收和处理日志数据。

4. organizations:ourlogs-stats：提供日志统计信息的视图。

5. organizations:ourlogs-graph：用于日志数据的可视化图表。

6. organizations:ourlogs-visualize-sidebar：在侧边栏中显示日志可视化选项。

7. organizations:ourlogs-dashboards：启用日志仪表盘功能。

8. organizations:ourlogs-alerts：设置日志相关的告警规则。

9. organizations:ourlogs-live-refresh：实现实时刷新日志数据。

10. organizations:ourlogs-infinite-scroll：支持无限滚动浏览大量日志。

11. organizations:ourlogs-replay-ui：在SaaS版本中已禁用，自托管版本中不影响功能。

12. organizations:ourlogs-saved-queries：可选配置，如需保存常用查询，取消注释即可启用。

配置步骤

1. 打开您的Sentry配置文件（通常位于config.yml或sentry.conf.py）

2. 找到SENTRY_FEATURES.update部分

3. 在适当的配置位置添加上述提到的Ourlogs相关配置项

4. 重启Sentry服务使配置生效

docker-compose restart 

5.首先进行相应的设置，导航至设置-常规设置，打开早期使用者开关

5. 登录Sentry界面，导航至logs区域，查看新功能

注意事项

• 确保您的Sentry版本已升级至25.9.0
• 如果您是从25.8.0升级，只需添加上述新配置项，无需修改其他现有配置
• organizations:ourlogs-replay-ui在自托管版本中是有效的，但在SaaS版本中已被禁用
• organizations:ourlogs-saved-queries默认被注释，如需使用请取消注释

结语

Sentry 25.9.0版本的Ourlogs功能为自托管用户提供了一个强大的日志分析解决方案，通过上述配置，您可以轻松启用这些功能，提升应用日志的收集、分析和可视化能力。

本文基于GitHub issue #3560的讨论内容整理，如需了解更多细节，可访问GitHub issue链接。

本文作者：运维技术团队：辣个男人Devin
发布日期：2025年9月20日
适用系统：Ubuntu 24.04 LTS