rungutancommunity/sentry-base

Sentry性能监控

本文参考来源：Rungutan博客

镜像概述和主要用途

Sentry性能监控镜像是基于Sentry构建的基础镜像，用于监控数字平台的性能表现，追踪应用在云环境中的运行状况。通过收集关键性能指标（KPIs）、用户体验数据和错误信息，帮助开发团队定位性能瓶颈、优化应用响应速度，并确保用户获得稳定可靠的体验。该镜像支持定制化配置，可根据实际需求进行扩展和调整。

核心功能和特性

性能监控基础

性能监控是通过定期验证和跟踪数字平台的运行状况，使用仪表板和告警系统等工具，监控关键KPIs以快速识别性能变化并采取行动。对于分布式云应用，需通过专用工具追踪网络和应用间的流量，这一领域被称为应用性能监控（APM），可测量用户 latency、定位网络瓶颈等。

Sentry核心能力

Sentry是一款实时错误监控服务，服务端基于Python开发，提供全API支持，可从任何语言、任何应用发送事件。其性能监控功能主要包括：

Web生命力指标（Web Vitals）

通过收集真实用户的现场数据（网络速度、浏览器、设备、地区等），基于Google Web Vitals标准，帮助理解错误对用户体验的影响，如页面加载缓慢、内容异常变化或交互问题。

追踪（Tracing）

将性能不佳的页面追踪至其API调用及子调用，通过事件详情瀑布图可视化用户完整体验过程，并关联用户设备数据与预期操作。

事务监控（Transaction monitoring）

在统一视图中按持续时间、相关问题或用户数量查看事务，结合发布标记提供上下文，帮助团队评估新代码对用户体验的影响。

使用场景和适用范围

• 开发团队：追踪应用性能瓶颈，定位代码级问题
• 运维团队：监控生产环境应用健康状态，及时响应性能异常
• 产品团队：了解用户体验指标，优化产品可用性
• 大型分布式应用：适用于云原生环境，需跨网络、多服务追踪的复杂系统
• CI/CD流程：集成到发布流程中，验证新代码对性能的影响

使用方法和配置说明

部署方式

Sentry提供开源版本和SaaS云服务。对于自建部署，社区贡献了多种方式：

Docker Compose部署

参考Sentry官方GitHub仓库：https://github.com/sentry/onpremise

Helm部署

社区提供的Helm包：https://github.com/sentry-kubernetes/charts

AWS云环境部署（推荐）

针对AWS用户，提供基于以下AWS服务的可扩展、易维护、安全的基础设施：

• AWS ECS Fargate
• AWS RDS
• AWS ElastiCache
• AWS MSK (Kafka)
• AWS OpsWorks
• AWS VPC
• AWS CloudWatch

部署架构图：

部署步骤：

1. 通过CloudFormation创建堆栈：
   [***]

2. 至少填写以下参数并点击"创建堆栈"：

   • SentrySystemSecretKey：随机UUIDv4（可从UUID生成器获取）
   • InitialAdminUserEmail：初始管理员***
   • InitialAdminUserPassword：初始管理员密码（需高强度）
   • SslLoadBalancer：启用HTTPS（Sentry必需）
   • SentryEmailUsername：SMTP用户名（推荐使用AWS SES）
   • SentryEmailPassword：SMTP密码
   • SentryEmailHost：SMTP主机（SES端点格式：email-smtp.${aws_region}.amazonaws.com）
   • SentryEmailFrom：已验证的发件***（SES验证地址或域名）

注意：部署完成后，建议创建新管理员并删除初始管理员账户。

集成说明

Rungutan集成

在CI/CD pipeline中集成Rungutan负载测试，需在Sentry中创建指标告警。示例GitHub Actions流水线配置：

yaml
name: Load test with Rungutan

on:
  release:
    types:
      - created

jobs:
  load:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: Load test your platform with Rungutan
      uses: Rungutan/rungutan-actions@1.0.0
      env:
        RUNGUTAN_TEAM_ID: ${{ secrets.RUNGUTAN_TEAM_ID }}
        RUNGUTAN_API_KEY: ${{ secrets.RUNGUTAN_API_KEY }}
        RUNGUTAN_TEST_FILE: test_file.json
        RUNGUTAN_TEST_NAME: ${{ github.repository }}-${{ github.ref }}

Slack集成

Slack集成可将告警发送到指定频道，支持分配任务和解决问题。配置步骤：

1. 在Slack API创建新应用，命名（如"Sentry"）并选择工作区
2. 进入OAuth & Permissions，添加重定向URL：https://${SentryDnsRecord}/extensions/slack/setup/
3. 在Bot Token Scopes启用：incoming-webhook、links:read、links:write
4. 在User Token Scopes启用：links:read、links:write
5. 进入Interactivity & Shortcuts，启用并设置：
   • 请求URL：https://${SentryDnsRecord}/extensions/slack/action/
   • 选项加载URL：https://${SentryDnsRecord}/extensions/slack/options-load/
6. 进入Event Subscriptions，启用并设置请求URL：https://${SentryDnsRecord}/extensions/slack/event/
7. 添加Bot用户事件：link_shared
8. 添加应用展开域名：Sentry DNS记录
9. 安装应用，记录Client ID、Client Secret、Signing Secret

在Sentry中配置：

• 进入Settings > Integrations > Slack > Add Workspace > 点击"Allow"

注意：需使用Slack管理员账户完成配置。

Sentry与Rungutan协同工作

Rungutan模拟高用户活动，Sentry定位大规模场景下的代码问题，二者结合可全面监控平台在高负载下的表现，确保每次发布后平台性能稳定。

重要注意事项

Elastic IP限制

自1.4.0版本起，NAT网关支持高可用，需确保VPC Elastic IP配额至少增加3个。可在AWS服务配额查看"EC2-VPC Elastic IPs"当前值（从5增加到20可自动批准）。

Client Ingest DSN记录

创建新项目时生成的DSN格式：
https://some_random_public_key_string_here@o1.ingest.${the_sentry_dns_record}/2

若SentryDnsRecord为sentry.rungutan.com，则DSN为：
https://some_random_public_key_string_here@o1.ingest.sentry.rungutan.com/2

需确保SSL证书包含该ingest域名。若无法使用默认ingest记录，可通过SentryRelayAlternativeDnsRecord参数指定替代域名，例如：
https://some_random_public_key_string_here@sentry-relay.rungutan.com/2

安全参数提醒

务必为以下参数设置自定义值：

• SentrySystemSecretKey
• InitialAdminUserEmail
• InitialAdminUserPassword

总结

性能测试与性能监控相辅相成，是DevOps、开发和QA团队工具链的必备组件。Sentry与Rungutan已在生产环境中验证了其可靠性，可帮助团队快速定位性能问题，避免因猜测导致的时间浪费。