CentOS6基于Python安装Sentry

Thursday, March 30, 2017

概述

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

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

Linux CentOS Python Sentry

书童造轮子之自动生成数据字典CentOS6升级PHP7.0及安装ZIP扩展