自建Sentry重启后需每次执行./install.sh吗？服务异常求助

核心疑问解答 #

不需要每次重启电脑或Docker服务后执行./install.sh。该脚本仅需在首次部署Sentry、版本升级、需要重置/初始化核心配置时运行，日常重启仅需执行docker-compose up -d即可。

具体排查步骤 #

• 检查容器运行状态
  执行docker-compose ps，确认所有Sentry核心容器（web、worker、relay、postgres、redis）状态均为Up。若有容器退出，执行docker-compose logs <异常容器名>查看具体报错，重点关注数据库连接失败、端口占用、配置文件错误等信息。

• 验证Relay服务可用性
  Relay是Sentry接收上报事件的关键入口，需确认其正常连接到Sentry主服务：

  1. 查看Relay容器日志确认无连接超时或认证错误
  2. 若Relay配置有自定义修改，检查relay/config.yml中的upstream地址是否指向正确的Sentry web服务

• 测试事件上报链路
  用简单代码发送测试事件（以Python为例）：

  import sentry_sdk
  sentry_sdk.init("<你的DSN>")
  try:
      1 / 0
  except ZeroDivisionError:
      sentry_sdk.capture_exception()
  

  同时查看web和worker容器日志，若有事件接收、处理的日志则说明链路正常，若无则排查DSN是否正确、网络是否存在端口映射问题。

• 确认存储服务正常

  • 测试PostgreSQL连接：docker-compose exec postgres psql -U postgres -d sentry，若能正常进入数据库则说明存储正常
  • 测试Redis连接：docker-compose exec redis redis-cli ping，返回PONG则服务正常

• 重置缓存并重启服务
  若怀疑缓存或临时配置异常，执行以下操作：

  docker-compose exec redis redis-cli FLUSHALL
  docker-compose down
  docker-compose up -d
  

内容的提问来源于stack exchange，提问作者Riddle