How to Install Sentry on Centos 6

In this step-by-step guide, we will install and configure Sentry on CentOS 6. Sentry is one of the most popular error monitoring solution that helps in tracking errors and bugs.

System Package Installation

1
2
sudo yum -y install wget gcc-c++ vim
sudo yum -y install python-setuptools python-devel libxslt-devel gcc gcc-c++ libffi-devel libjpeg-devel libxml2-devel libxslt-devel libyaml-devel

Creating Sentry User

1
sudo useradd sentry -r -s /sbin/nologin

Redis Installation

1
2
3
4
5
6
7
8
sudo yum install -y tcl
cd /tmp/
wget http://download.redis.io/releases/redis-4.0.14.tar.gz
tar xzf redis-4.0.14.tar.gz
cd redis-4.0.14
make
make test 
sudo make install

Execute install script to generate redis config file,  /etc/init.d script, install them and run redis server.

1
2
3
4
5
sudo REDIS_PORT=6379 \
     REDIS_CONFIG_FILE=/etc/redis/6379.conf \
     REDIS_LOG_FILE=/var/log/redis_6379.log \
     REDIS_DATA_DIR=/var/lib/redis/6379 \
     REDIS_EXECUTABLE=/usr/local/bin/redis-server ./utils/install_server.sh

Set overcommit_memory to 1 (always overcommit, never check)

1
2
3
4
5
6
7
8
9
sudo sysctl vm.overcommit_memory=1
sudo sysctl -w fs.file-max=100000

# to make the change permanent
# open sysctl.conf for editing
sudo vim /etc/sysctl.conf

# add below line
vm.overcommit_memory=1

Redis guidances  on why vm.overcommit_memory should be set to 1.

Start redis on system restart

1
sudo chkconfig --add redis_6379

Postgres Installation

Install Postres using rpm :

1
2
sudo yum -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-6-x86_64/pgdg-redhat-repo-latest.noarch.rpm
sudo yum -y install postgresql95-server postgresql95-contrib postgresql95 libpqxx-devel postgresql-devel

Initialize database environment:

1
sudo service postgresql-9.5 initdb

Configure it to start at boot up and start the software:

1
2
sudo chkconfig postgresql-9.5 on
sudo service postgresql-9.5 start

psql setup

1
2
sudo mv /usr/bin/psql /usr/bin/psql-bk
sudo ln -sfn /usr/pgsql-9.5/bin/psql /usr/bin/psql

enable password based login in postgres

1
2
3
4
5
sudo vim /var/lib/pgsql/9.5/data/pg_hba.conf

change ident to md5

service  postgresql-9.5 restart

Python & Supervisor Installation

Python 2.7 installation

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
sudo yum -y install sqlite-devel zlib zlib-devel gcc httpd-devel bzip2-devel openssl openssl-devel
cd /tmp/
wget https://www.python.org/ftp/python/2.7.15/Python-2.7.15.tgz
tar zxvf Python-2.7.15.tgz
cd Python-2.7.15
./configure --prefix=/usr/local --with-threads --enable-shared --with-zlib=/usr/include --enable-optimizations
make
sudo make altinstall

sudo sh -c "echo '/usr/local/lib' >> /etc/ld.so.conf.d/python2.7.conf"
sudo /sbin/ldconfig
sudo ln -sfn /usr/local/bin/python2.7 /usr/bin/python2.7

Pip installation for Python 2.7

1
2
3
4
cd /tmp/
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
sudo python2.7 get-pip.py
sudo ln -sfn /usr/local/bin/pip2.7 /usr/bin/pip2.7

Supervisor installation

1
2
3
4
5
6
sudo pip2.7 install supervisor

sudo ln -sfn /usr/local/bin/supervisord /usr/bin/supervisord
sudo ln -sfn /usr/local/bin/supervisorctl /usr/bin/supervisorctl

sudo mkdir -p /etc/supervisor/conf.d/

create configuration file

1
sudo sh -c "/usr/local/bin/echo_supervisord_conf >> /etc/supervisord.conf"

config update

1
2
3
4
5
sudo vim /etc/supervisord.conf

add below lines:
[include]
files = /etc/supervisor/conf.d/*.conf

start supervisor

1
sudo /usr/bin/supervisord -c /etc/supervisord.conf

Creating virtual environment

installing virtualenv

1
2
sudo pip2.7 install virtualenv
sudo ln -sfn /usr/local/bin/virtualenv /usr/bin/virtualenv2.7

creating virtual environment

1
2
3
sudo mkdir -p /opt/sentry/

sudo virtualenv2.7 /opt/sentry/venv/

Sentry installation

Sentry installation

1
2
3
4
5
yum -y install xmlsec1-openssl xmlsec1 libxml2 libxml2-devel xmlsec1-devel xmlsec1-openssl-devel libtool-ltdl-devel

cd /opt/sentry/
source venv/bin/activate
pip install sentry==9.0.0

Initializing config files

1
2
# below command will create config.yml and sentry.conf.py in /etc/sentry
sentry init /etc/sentry

Creating database for sentry in postgres

1
2
3
4
5
6
## create database and user
sudo -u postgres psql template1
template1=# CREATE DATABASE sentry;
template1=# CREATE USER sentry WITH PASSWORD 'sentry';
template1=# GRANT ALL PRIVILEGES ON DATABASE sentry to sentry;
template1=# \q

verify user/password is working correctly

1
psql -h localhost -U sentry

Config file update

1
2
3
4
5
6
7
8
sudo vim /etc/sentry/sentry.conf.py
# update below entries
- DATABASES - name, user, password, host
- SENTRY_WEB_PORT - 10000
- SENTRY_WEB_OPTIONS - workers 3
# add below line in /etc/sentry/sentry.conf.py to disable uesr registration and set timezone
SENTRY_FEATURES["auth:register"] = False
SENTRY_DEFAULT_TIME_ZONE = 'Asia/Kolkata'

setup citext before running migrations

1
2
3
4
5
6
sudo -u postgres psql

postgres=# \c sentry
You are now connected to database "sentry" as user "postgres".
sentry=# CREATE EXTENSION IF NOT EXISTS citext;
CREATE EXTENSION

Running migrations

1
2
3
4
5
6
cd /opt/sentry/
source venv/bin/activate


SENTRY_CONF=/etc/sentry sentry upgrade
>> select Y for creating superuser

Supervisor configuration

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
sudo mkdir -p /var/log/gunicorn/

sudo vim /etc/supervisor/conf.d/sentry.conf

[program:sentry-web]
directory=/opt/sentry/
environment=SENTRY_CONF="/etc/sentry"
command=/opt/sentry/venv/bin/sentry run web
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/gunicorn/sentry-web-std.log
stderr_logfile=/var/log/gunicorn/sentry-web-err.log

[program:sentry-worker]
directory=/opt/sentry/
environment=SENTRY_CONF="/etc/sentry"
command=/opt/sentry/venv/bin/sentry run worker
user=sentry
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/gunicorn/sentry-worker-std.log
stderr_logfile=/var/log/gunicorn/sentry-worker-err.log

[program:sentry-cron]
directory=/opt/sentry/
environment=SENTRY_CONF="/etc/sentry"
command=/opt/sentry/venv/bin/sentry run cron
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/gunicorn/sentry-cron-std.log
stderr_logfile=/var/log/gunicorn/sentry-cron-err.log


sudo supervisorctl shutdown

sudo supervisord -c /etc/supervisord.conf

sudo supervisorctl status

nginx Installation & Configuration

installation

1
2
3
4
5
6
7
8
9
# nginx installation
sudo vim /etc/yum.repos.d/nginx.repo
[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/centos/6/$basearch/
gpgcheck=0
enabled=1

sudo yum -y install nginx

starting nginx server

1
sudo service nginx start

adding configuration file

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# remove default nginx config file
sudo rm /etc/nginx/conf.d/default.conf

sudo vim /etc/nginx/conf.d/sentry.conf
------
upstream rd_servers {
  server 127.0.0.1:10000;
}

server {

  server_tokens off;

  listen 80 default;

  access_log /var/log/nginx/rd.access.log;

  gzip on;
  gzip_types *;
  gzip_proxied any;

  location / {
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_pass       http://rd_servers;
  }
}
-------
# restart nginx 
sudo service nginx restart

# access site
http://localhost/

sentry page

setup

Upgrading sentry

Upgrade sentry

1
2
3
cd /opt/sentry/
source venv/bin/activate
pip install --upgrade sentry

Run migrations

1
SENTRY_CONF=/etc/sentry sentry upgrade

Restart supervisor

1
2
3
sudo supervisorctl shutdown
sudo /usr/bin/supervisord -c /etc/supervisord.conf
sudo supervisorctl status

Miscellaneous

Below is the docker container used for testing above scripts. Make sure that the allocated RAM to docker is more than 5GB (Docker > Preferences > Resouces - Memory). Otherwise the container will be limited to the max docker RAM size.

1
docker run -t -d --memory="5g" --name sentry -p 80:80 centos:6.8