生产环境自托管Sentry 23.5.2：配置外部独立组件方法咨询

生产环境部署Sentry 23.5.2对接外部PostgreSQL、Redis、Kafka、ClickHouse，核心是修改Sentry的两个核心配置文件sentry.conf.py和config.yml，同时确保外部服务的网络、权限配置到位。以下是分组件的具体配置步骤：

一、外部PostgreSQL配置 #

前置准备 #

• 在外部Postgres上创建Sentry专用数据库（如sentry），并创建专用账号，授予该账号对sentry数据库的全部操作权限
• 确保Sentry部署机器能访问Postgres的5432端口（防火墙开放对应规则）

配置修改 #

1. 打开sentry.conf.py，注释掉默认的数据库配置块，替换为：

DATABASES = {
    'default': {
        'ENGINE': 'sentry.db.postgres',
        'NAME': 'sentry',  # 你的Postgres数据库名
        'USER': 'sentry_user',  # 专用账号
        'PASSWORD': 'your_strong_password',  # 账号密码
        'HOST': 'postgres_host_ip',  # 外部Postgres机器IP/域名
        'PORT': 5432,
        'OPTIONS': {
            'connect_timeout': 5,
        },
    }
}

2. 首次部署时，执行数据库初始化命令：sentry upgrade

二、外部Redis配置 #

前置准备 #

• 外部Redis设置强密码（生产环境必须），确保Sentry机器能访问6379端口
• 若使用Redis集群，提前完成集群节点的配置与网络打通

配置修改 #

1. 打开config.yml，找到redis配置段，替换为：

redis:
  cluster: false  # 单实例设为false，集群环境改为true
  hosts:
    - host: redis_host_ip
      port: 6379
      password: 'your_redis_password'
      db: 0  # 建议给Sentry单独分配DB编号

2. 集群模式下，将cluster设为true，并在hosts列表中添加所有集群节点信息
3. （可选）在sentry.conf.py中添加Redis连接优化参数：

SENTRY_REDIS_OPTIONS = {
    'socket_timeout': 3,
    'socket_connect_timeout': 3,
}

三、外部Kafka配置 #

前置准备 #

• 在外部Kafka集群创建Sentry所需主题：sentry-events、sentry-transactions、sentry-ingest-metrics等，可通过kafka-topics.sh命令创建
• 配置Kafka ACL权限，允许Sentry专用账号读写上述主题，确保Sentry机器能访问Kafka的9092端口（或SSL端口）

配置修改 #

1. 打开config.yml，找到kafka配置段，替换为：

kafka:
  brokers:
    - kafka_broker1_ip:9092
    - kafka_broker2_ip:9092  # 填写所有Kafka Broker节点
  security_protocol: PLAINTEXT  # 生产环境建议用SSL，改为SSL
  # SSL模式下添加以下配置：
  # ssl_cafile: '/path/to/ca.crt'
  # ssl_certfile: '/path/to/client.crt'
  # ssl_keyfile: '/path/to/client.key'
  topic_prefix: ''  # 若有自定义主题前缀，填写对应值

2. 打开sentry.conf.py，指定事件流使用外部Kafka：

SENTRY_EVENTSTREAM = 'sentry.eventstream.kafka.KafkaEventStream'
SENTRY_EVENTSTREAM_OPTIONS = {
    'bootstrap_servers': ['kafka_broker1_ip:9092', 'kafka_broker2_ip:9092'],
    'security_protocol': 'PLAINTEXT',
}

四、外部ClickHouse配置 #

前置准备 #

• 在外部ClickHouse上创建Sentry专用数据库（如sentry），并创建专用账号，授予读写权限
• 确保Sentry机器能访问ClickHouse的8123端口（HTTP）或9000端口（TCP）

配置修改 #

1. 打开config.yml，找到clickhouse配置段，替换为：

clickhouse:
  enabled: true
  host: clickhouse_host_ip
  port: 8123  # HTTP端口，用TCP连接则改为9000
  database: sentry
  username: clickhouse_user
  password: 'your_clickhouse_password'
  # SSL连接模式下添加：
  # ssl: true
  # ssl_ca: '/path/to/ca.crt'

2. （可选）在sentry.conf.py中添加ClickHouse连接优化参数：

SENTRY_CLICKHOUSE_OPTIONS = {
    'http_timeout': 10,
}

通用注意事项 #

• 所有外部服务的网络访问需做严格限制：通过防火墙规则仅允许Sentry部署机器的IP访问对应端口
• 配置完成后，重启所有Sentry服务（web、worker、relay等）
• 首次部署需执行sentry upgrade --noinput完成数据库迁移和初始化
• 生产环境建议对所有外部服务连接开启SSL加密，避免敏感数据明文传输

内容的提问来源于stack exchange，提问作者林平君