CentOS6 基于 Python 安装 Sentry

概述

Sentry 是一款可用于Production环境的错误跟踪工具,可实时通知Production环境中用户由于一些不可预料行为(或者程序写的有问题)导致程序Crash或Exception,Sentry可以通过Integration如HipChat来发送通知,并且可以通过JIRA Integration来快速创建Issue,然后开发者可以根据这个Issue快速修复程序,并把这个已修复的Hotfix快速部署到生产环境,这样就快速开发快速修补。

Sentry 提供了两种使用方式:

  1. 厂商的服务,提供14天无限制免费服务,点击查看 官网价格服务使用简介
  2. 源码 自行搭建,包括 DockerPython 两种方式, Python 安装方式Here Docker 安装方式Here

安装依赖软件

安装Sentry需要以下满足以下条件:

  • 基于UNIX的操作系统
  • PostgreSQL:版本 9.5 以上,推荐最新版本 9.6
  • Redis:最低版本 2.8.9, 推荐 2.8.18, 3.0
  • Python 2.7 :点击查看安装方式
  • Pip 8.1+
  • 安装下列软件:python-setuptools, python-dev, libxslt1-dev, gcc, libffi-dev, libjpeg-dev, libxml2-dev, libxslt-dev, libyaml-dev, libpq-dev,推荐 yum 安装。

实际安装过程中,最好预留1G的内存,我安装时因为预留内存不够折腾了好久,最后翻 githubissue 才意识到是内存的问题。

安装PostgreSQL

安装新版的yum源

我使用的是官方当前最新版本 9.6,其他版本详见官方文档,根据自己要安装的版本及操作系统选择下载 rpm 文件即可。

$ cd ~
$ wget https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-6-x86_64/pgdg-redhat96-9.6-3.noarch.rpm
$ rpm -ivh ./pgdg-redhat96-9.6-3.noarch.rpm

移除之前的版本

$ rpm -qa | grep postgre
postgresql84-devel-8.4.3-2PGDG.rhel6.x86_64
postgresql84-libs-8.4.3-2PGDG.rhel6.x86_64
postgresql84-contrib-8.4.3-2PGDG.rhel6.x86_64
postgresql84-server-8.4.3-2PGDG.rhel6.x86_64
postgresql84-8.4.3-2PGDG.rhel6.x86_64

$ yum remove postgresql84 postgresql84-devel postgresql84-libs postgresql84-contrib postgresql84-server

查看安装新版 yum 源后可以安装的版本

$ yum list postgres* | grep 96
postgresql96.x86_64                        9.6.2-2PGDG.rhel6             @pgdg96
postgresql96-contrib.x86_64                9.6.2-2PGDG.rhel6             @pgdg96
postgresql96-devel.x86_64                  9.6.2-2PGDG.rhel6             @pgdg96
postgresql96-libs.x86_64                   9.6.2-2PGDG.rhel6             @pgdg96
postgresql96-server.x86_64                 9.6.2-2PGDG.rhel6             @pgdg96
postgresql-jdbc.noarch                     42.0.0-1.rhel6                pgdg96
postgresql-jdbc-javadoc.noarch             42.0.0-1.rhel6                pgdg96
postgresql-unit96.x86_64                   2.0-1.rhel6                   pgdg96
postgresql-unit96-debuginfo.x86_64         2.0-1.rhel6                   pgdg96
postgresql96-debuginfo.x86_64              9.6.2-2PGDG.rhel6             pgdg96
postgresql96-docs.x86_64                   9.6.2-2PGDG.rhel6             pgdg96
postgresql96-odbc.x86_64                   09.06.0100-1PGDG.rhel6        pgdg96
postgresql96-plperl.x86_64                 9.6.2-2PGDG.rhel6             pgdg96
postgresql96-plpython.x86_64               9.6.2-2PGDG.rhel6             pgdg96
postgresql96-pltcl.x86_64                  9.6.2-2PGDG.rhel6             pgdg96
postgresql96-tcl.x86_64                    2.1.1-1.rhel6                 pgdg96
postgresql96-tcl-debuginfo.x86_64          2.1.1-1.rhel6                 pgdg96
postgresql96-test.x86_64                   9.6.2-2PGDG.rhel6             pgdg96

从结果可以看出新版 yum 源可以安装很多依赖,但实际上我们只需要安装 postgresql96postgresql96-develpostgresql96-libspostgresql96-server 四项即可。

$ yum install postgresql96 postgresql96-devel postgresql96-libs postgresql96-server
$ # 初始化数据库
$ /etc/init.d/postgresql-9.6 initdb
$ # 开启数据库
$ /etc/init.d/postgresql-9.6 start

至此,新版 PostgreSQL 就安装好了,接下来是做些连接配置:

$ vim /var/lib/pgsql/9.6/data/pg_hba.conf

将相关连接的 Method 改为 trust

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local           all              all                                            trust
# IPv4 local connections:
host            all                 all             127.0.0.1/32            trust
# IPv6 local connections:
host            all                 all             ::1/128                     trust
# Allow replication connections from localhost, by a user with the
# replication privilege.
#local   replication     postgres                                peer
#host    replication     postgres        127.0.0.1/32            ident
#host    replication     postgres        ::1/128                 ident

安装Redis

安装redis相对简单,使用 yum 安装即可

$ yum install redis
$ # 开启redis
$ /etc/init.d/redis start

安装Sentry

安装软件

$ # 安装环境
$ pip install -U virtualenv
$ virtualenv /www/sentry/
$ source /www/sentry/bin/activate
$ # 安装sentry
$ pip install -U sentry

相关配置

初始化配置,如果不设置路径的话,默认会生成在 ~/.sentry 目录中,推荐使用默认路径。初始化配置包含两个文件,分别是 config.ymlsentry.conf.py

$ sentry init

邮件配置项保存在 config.yml 文件中,Sentry 收到异常时会给自己的邮箱发送邮件通知,所以需要配置下邮件,当然也可以不启用,但不建议这样做。

# 如果不想启用邮件通知,可以将 mail.backend 设置为 dummy 
mail.backend: 'smtp'
mail.host: 'localhost'
mail.port: 25
mail.username: ''
mail.password: ''
mail.use-tls: false
mail.from: 'sentry@localhost'

数据库配置项保存在 sentry.conf.py 文件中,使用默认即可,只需要修改 HOSTPORT 项。

# ~/.sentry/sentry.conf.py

# for more information on DATABASES, see the Django configuration at:
# https://docs.djangoproject.com/en/1.6/ref/databases/
DATABASES = {
    'default': {
        'ENGINE': 'sentry.db.postgres',
        'NAME': 'sentry',
        'USER': 'postgres',
        'PASSWORD': '',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

Redis 项使用默认即可,另外一个需要注意的是 Web 使用的端口配置项 SENTRY_WEB_PORT,默认为 9000 ,实际安装时可以检测下端口是否已被占用,我安装时发现被占用,所以改用了 9999

使用数据迁移初始化数据

创建数据库

$ createdb -U postgres -E utf-8 sentry

执行数据更新,数据填充完成后会提示是否创建用户,可以选择不创建后续再创建,另外,这一步比较 耗内存,我就是在执行这一步的时候出了很多意外,比如进程被 killed,报很多异常等等。

$ sentry upgrade
$ # 如果没有使用默认目录的话,需要使用如下命令
$ # SENTRY_CONF=/path/to/sentry sentry upgrade

创建用户,需要填写邮箱和密码,创建好后会提示是否作为超级用户,根据自己情况选择即可。

$ sentry createuser
$ # 如果没有使用默认目录的话,需要使用如下命令
$ # SENTRY_CONF=/path/to/sentry sentry createuser

开启服务

开启 web 服务,开启后可以访问 http://[IP或域名]:[前面配置的端口] 进行访问。

$ sentry run web
$ # 如果没有使用默认目录的话,需要使用如下命令
$ # SENTRY_CONF=/path/to/sentry sentry run web

开启后台 worker 服务

$ sentry run worker
$ # 如果没有使用默认目录的话,需要使用如下命令
$ # SENTRY_CONF=/path/to/sentry sentry run worker

开启 cron 进程

$ sentry run cron
$ # 如果没有使用默认目录的话,需要使用如下命令
$ # SENTRY_CONF=/path/to/sentry sentry run cron

Laravel集成扩展包

Sentry官方针对各种语言的不同框架都提供了相应的扩展包,当然也包括 laravel

配置好后就可以在自己的项目中愉快的使用了,悟禅小书童 已经使用上了,参考图如下:

本帖由 Summer 于 2年前 加精
jormin
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
讨论数量: 9
Summer

大家都在搞 Sentry 哈

2年前 评论
Destiny

来 我们互相给个关联地址,亲,让我们串联起来! 博客:Sentry 自动化异常提醒

2年前 评论
jormin

@Summer 是啊,Sentry 确实是个好东东 :smile: :smile:

2年前 评论
jormin

@Destiny 已串联,哈哈 :smile: :smile:

2年前 评论
Destiny

@jormin :+1:

2年前 评论
haobing

阿里云 1Core1GB,安装不起来,看上去CPU 100%直接挂起,请问文章用的什么配置?

1年前 评论

emm......

启动sentry run worker遇到以下错误,google半天无果....

(sentry) ➜  sentry sentry run worker
01:35:31 [INFO] sentry.bgtasks: bgtask.spawn (task_name=u'sentry.bgtasks.clean_dsymcache:clean_dsymcache')
Running a worker with superuser privileges when the
worker accepts messages serialized with pickle is a very bad idea!

If you really want to continue then you have to set the C_FORCE_ROOT
environment variable (but please think about this before you do).

User information: uid=0 euid=0 gid=0 egid=0

如果有遇到这个错误的小伙伴

  • 看下官方文档
  • 如果你是supervisord挂起的服务,那么设置指定用户启动服务

我的supervisord配置

[program:sentry-worker]
user=sentry
directory=/www/sentry/
environment=SENTRY_CONF="/etc/sentry"
command=/www/sentry/bin/sentry run worker -l WARNING
autostart=true
autorestart=true
redirect_stderr=true
killasgroup=true
stdout_logfile=/var/log/sentry/sentry-worker.log
stderr_logfile=/var/log/sentry/sentry-worker.log
1年前 评论

@罗阳 启动sentry run worker 这个命令用非root用户启动 可能会避免报
sentry.bgtasks: bgtask.spawn (task_name=u'sentry.bgtasks.clean_dsymcache:clean_dsymcache')
Running a worker with superuser privileges when the
worker accepts messages serialized with pickle is a very bad idea! 信息

1年前 评论

@xudeliang 这个应该是不建议用root账户运行吧...
另外,我在博客上记录了,较为详细的安装过程,希望可以供你参考点这里

1年前 评论

请勿发布不友善或者负能量的内容。与人为善,比聪明更重要!