nasajon/sentry

Sentry Docker镜像文档

镜像概述

本镜像为https://sentry.io/%E7%9A%84%E5%AE%98%E6%96%B9Docker%E9%95%9C%E5%83%8F%EF%BC%8CSentry%E6%98%AF%E4%B8%80%E6%AC%BE%E5%BC%80%E6%BA%90%E7%9A%84%E5%BA%94%E7%94%A8%E7%A8%8B%E5%BA%8F%E7%9B%91%E6%8E%A7%E5%B7%A5%E5%85%B7%EF%BC%8C%E4%B8%93%E6%B3%A8%E4%BA%8E%E9%94%99%E8%AF%AF%E8%B7%9F%E8%B8%AA%E3%80%81%E6%80%A7%E8%83%BD%E7%9B%91%E6%8E%A7%E5%92%8C%E5%AE%9E%E6%97%B6%E5%91%8A%E8%AD%A6%EF%BC%8C%E5%B8%AE%E5%8A%A9%E5%BC%80%E5%8F%91%E8%80%85%E5%8F%8A%E6%97%B6%E5%8F%91%E7%8E%B0%E5%B9%B6%E8%A7%A3%E5%86%B3%E5%BA%94%E7%94%A8%E7%A8%8B%E5%BA%8F%E4%B8%AD%E7%9A%84%E9%97%AE%E9%A2%98%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%89%98%E7%AE%A1%E4%BA%8EDocker Hub，相关文档和贡献指南可参考https://github.com/docker-library/docs%E4%BB%93%E5%BA%93%E4%B8%AD%E7%9A%84https://github.com/docker-library/docs/tree/master/sentry%E3%80%82

核心功能和特性

• 错误跟踪：自动捕获应用程序运行时错误，提供详细的堆栈跟踪、上下文信息和用户操作记录
• 性能监控：监控应用程序响应时间、吞吐量和资源使用情况，识别性能瓶颈
• 实时告警：支持多种通知渠道（如邮件、Slack、短信等），及时推送异常和性能问题告警
• 多平台支持：兼容主流编程语言和框架（如Python、JavaScript、Java、Django、React等）
• 可扩展性：支持自定义集成和插件，满足不同团队的特定需求

使用场景和适用范围

• 开发环境：在开发阶段捕获并修复潜在错误，提高代码质量
• 测试环境：监控测试过程中的异常，确保发布前问题得到解决
• 生产环境：实时监控线上应用状态，快速响应并修复生产问题
• 团队协作：集中管理应用程序问题，促进开发、测试和运维团队协作

使用方法和配置说明

基本使用

通过Docker Hub拉取镜像：

bash
docker pull docker.xuanyuan.run/sentry

启动Sentry容器（需配合数据库和缓存服务，如PostgreSQL、Redis）：

bash
docker run -d \
  --name docker.xuanyuan.run/sentry \
  -e SENTRY_SECRET_KEY='your-secret-key' \
  -e SENTRY_DB_URL='postgresql://user:password@postgres:5432/sentry' \
  -e SENTRY_REDIS_URL='redis://redis:6379/0' \
  -p 9000:9000 \
  docker.xuanyuan.run/sentry

持久化数据

为确保数据持久化，建议挂载数据卷：

bash
docker run -d \
  --name docker.xuanyuan.run/sentry \
  -e SENTRY_SECRET_KEY='your-secret-key' \
  -e SENTRY_DB_URL='postgresql://user:password@postgres:5432/sentry' \
  -e SENTRY_REDIS_URL='redis://redis:6379/0' \
  -v /path/to/sentry/data:/var/lib/sentry \
  -p 9000:9000 \
  docker.xuanyuan.run/sentry

环境变量配置

常用环境变量：

• SENTRY_SECRET_KEY：Sentry应用密钥，用于加密敏感数据，需自行生成
• SENTRY_DB_URL：数据库连接URL（支持PostgreSQL、MySQL等）
• SENTRY_REDIS_URL：Redis连接URL，用于缓存和队列
• SENTRY_EMAIL_HOST：SMTP服务器地址，用于发送告警邮件
• SENTRY_EMAIL_PORT：SMTP服务器端口
• SENTRY_EMAIL_USER：SMTP认证用户名
• SENTRY_EMAIL_PASSWORD：SMTP认证密码
• SENTRY_SERVER_EMAIL：发件人***地址

Docker Compose示例

推荐使用Docker Compose管理多服务部署（包含Sentry、PostgreSQL、Redis）：

yaml
version: '3'

services:
  postgres:
    image: docker.xuanyuan.run/postgres:13
    environment:
      POSTGRES_USER: sentry
      POSTGRES_PASSWORD: sentry
      POSTGRES_DB: sentry
    volumes:
      - postgres-data:/var/lib/postgresql/data

  redis:
    image: docker.xuanyuan.run/redis:6
    volumes:
      - redis-data:/data

  sentry:
    image: docker.xuanyuan.run/sentry
    depends_on:
      - postgres
      - redis
    environment:
      SENTRY_SECRET_KEY: 'your-secret-key'
      SENTRY_DB_URL: 'postgresql://sentry:sentry@postgres:5432/sentry'
      SENTRY_REDIS_URL: 'redis://redis:6379/0'
      SENTRY_SERVER_EMAIL: 'sentry@example.com'
    ports:
      - "9000:9000"
    volumes:
      - sentry-data:/var/lib/sentry

volumes:
  postgres-data:
  redis-data:
  sentry-data:

启动服务：

bash
docker-compose up -d

初始化管理员账户

首次启动后，需创建管理员账户：

bash
docker exec -it sentry sentry createuser --superuser --email admin@example.com --password your-password

访问Sentry Web界面：打开浏览器访问http://localhost:9000，使用管理员账户登录即可开始配置和使用Sentry。