Comment installer Sentry avec Docker sur Ubuntu 22.04

Sentry est une plateforme de suivi des erreurs gratuite et open-source qui surveille et corrige les pannes en temps réel. Elle permet aux développeurs de logiciels de voir ce qui compte, de résoudre plus rapidement et d’apprendre continuellement sur leurs applications. Cette plateforme fournit un aperçu en temps réel des déploiements en production avec des informations pour reproduire et corriger les pannes. Sentry prend en charge tous les principaux langages et frameworks et s’intègre à vos applications et services préférés.

Ce tutoriel vous montrera comment installer le système de suivi des erreurs Sentry avec Docker sur Ubuntu 22.04.

Prérequis

Un serveur exécutant Ubuntu 22.04.
Un nom de domaine valide pointant vers l’IP de votre serveur.
Un mot de passe root configuré sur votre serveur.

Installer les dépendances requises

Avant de commencer, il est recommandé de mettre à jour vos paquets vers la dernière version. Vous pouvez les mettre à jour avec la commande suivante :

apt update -y  
apt upgrade -y

Une fois votre système mis à jour, installez tous les paquets requis avec la commande suivante :

apt-get install curl git build-essential apt-transport-https ca-certificates software-properties-common -y

Après avoir installé toutes les dépendances, vous pouvez passer à l’étape suivante.

Installer Docker et Docker Compose

Par défaut, la dernière version de Docker et du paquet Docker Compose n’est pas disponible dans le dépôt par défaut d’Ubuntu 22.04. Vous devrez donc ajouter le dépôt officiel de Docker à APT.

Tout d’abord, téléchargez et ajoutez la clé GPG de Docker avec la commande suivante.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Ensuite, ajoutez le dépôt Docker avec la commande suivante.

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null

Une fois le dépôt ajouté, mettez à jour le cache du dépôt avec la commande suivante.

apt update -y

Ensuite, installez à la fois Docker et Docker Compose avec la commande suivante.

apt install docker docker-compose -y

Une fois les deux paquets installés, démarrez le service Docker et activez-le pour qu’il démarre au redémarrage du système avec la commande suivante :

systemctl start docker  
systemctl enable docker

Vous pouvez maintenant vérifier l’état de Docker avec la commande suivante :

systemctl status docker

Vous devriez obtenir la sortie suivante :

? docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Tue 2023-01-10 04:37:27 UTC; 5s ago
TriggeredBy: ? docker.socket
       Docs: https://docs.docker.com
   Main PID: 45847 (dockerd)
      Tasks: 8
     Memory: 29.1M
        CPU: 220ms
     CGroup: /system.slice/docker.service
             ??45847 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

Jan 10 04:37:26 vultr dockerd[45847]: time="2023-01-10T04:37:26.903435377Z" level=info msg="scheme \"unix\" not registered, fallback to defau>
Jan 10 04:37:26 vultr dockerd[45847]: time="2023-01-10T04:37:26.903453803Z" level=info msg="ccResolverWrapper: sending update to cc: {[{unix:>
Jan 10 04:37:26 vultr dockerd[45847]: time="2023-01-10T04:37:26.903464761Z" level=info msg="ClientConn switching balancer to \"pick_first\"" >
Jan 10 04:37:26 vultr dockerd[45847]: time="2023-01-10T04:37:26.916581613Z" level=info msg="Loading containers: start."
Jan 10 04:37:26 vultr dockerd[45847]: time="2023-01-10T04:37:26.997807510Z" level=info msg="Default bridge (docker0) is assigned with an IP a>
Jan 10 04:37:27 vultr dockerd[45847]: time="2023-01-10T04:37:27.060381720Z" level=info msg="Loading containers: done."
Jan 10 04:37:27 vultr dockerd[45847]: time="2023-01-10T04:37:27.074467014Z" level=info msg="Docker daemon" commit=20.10.12-0ubuntu4 graphdriv>
Jan 10 04:37:27 vultr dockerd[45847]: time="2023-01-10T04:37:27.074649813Z" level=info msg="Daemon has completed initialization"
Jan 10 04:37:27 vultr systemd[1]: Started Docker Application Container Engine.
Jan 10 04:37:27 vultr dockerd[45847]: time="2023-01-10T04:37:27.092699576Z" level=info msg="API listen on /run/docker.sock"

Pour vérifier la version de Docker, exécutez la commande suivante :

docker --version

Vous devriez voir la sortie suivante :

Docker version 20.10.12, build 20.10.12-0ubuntu4

Vous pouvez également vérifier la version de Docker Compose en utilisant la commande suivante :

docker-compose --version

Vous devriez voir la sortie suivante :

docker-compose version 1.29.2, build unknown

Installer Sentry

Tout d’abord, téléchargez la dernière version de Sentry depuis le dépôt Git en utilisant la commande suivante :

git clone https://github.com/getsentry/onpremise

Une fois le téléchargement terminé, changez de répertoire vers le répertoire téléchargé et exécutez le script d’installation de Sentry pour commencer l’installation.

cd onpremise  
bash install.sh

Pendant l’installation, il vous sera demandé de créer un compte administrateur comme indiqué ci-dessous :

Voici les informations que nous pouvons collecter :

  - Nom d'utilisateur OS
  - Adresse IP
  - Journal d'installation
  - Erreurs d'exécution
  - Données de performance

Conservation de trente (30) jours. Pas de marketing. Politique de confidentialité sur sentry.io/privacy.

Souhaitez-vous créer un compte utilisateur maintenant ? [Y/n]: y

Email: Email: [email protected]
Mot de passe: 
Répéter pour confirmation: 
Ajouté à l'organisation: sentry
Utilisateur créé: [email protected]
Création des DSN manquants
Correction du compteur Group.num_comments

-----------------------------------------------------------------

Vous avez terminé ! Exécutez la commande suivante pour faire fonctionner Sentry :

  docker-compose up -d

-----------------------------------------------------------------

Ensuite, vérifiez toutes les images téléchargées en utilisant la commande suivante.

docker images

Vous devriez voir la sortie suivante.

REPOSITORY                               TAG             IMAGE ID       CREATED             SIZE
sentry-cleanup-self-hosted-local         latest          04fa0fce18f0   4 minutes ago       908MB
symbolicator-cleanup-self-hosted-local   latest          6837f5f48e6c   5 minutes ago       180MB
snuba-cleanup-self-hosted-local          latest          242b7b248e1c   5 minutes ago       486MB
sentry-self-hosted-local                 latest          101b00356aa6   5 minutes ago       907MB
sentry-self-hosted-jq-local              latest          83c66fd3f78f   6 minutes ago       82.5MB
getsentry/sentry                         nightly         cf0f404d102e   About an hour ago   907MB
getsentry/snuba                          nightly         fc6c2d286bf8   8 hours ago         484MB
getsentry/relay                          nightly         43cd2ba5497c   5 days ago          242MB
busybox                                  latest          66ba00ad3de8   6 days ago          4.87MB
tianon/exim4                             latest          12842ac621c1   2 weeks ago         158MB
debian                                   bullseye-slim   dd94cb611937   2 weeks ago         80.5MB
getsentry/sentry-cli                     latest          a585383ff864   2 weeks ago         26.3MB
getsentry/symbolicator                   nightly         80d9b41cd195   3 weeks ago         178MB
nginx                                    1.22.0-alpine   5685937b6bc1   3 months ago        23.5MB
postgres                                 9.6             027ccf656dc1   11 months ago       200MB
confluentinc/cp-kafka                    5.5.0           efc480c1c89c   15 months ago       598MB
confluentinc/cp-zookeeper                5.5.0           ddeb961d8e80   15 months ago       598MB
redis                                    6.2.4-alpine    500703a12fa4   18 months ago       32.3MB
memcached                                1.6.9-alpine    a0132b3398e4   18 months ago       8.09MB
curlimages/curl                          7.77.0          e062233fb4a9   19 months ago       8.26MB
maxmindinc/geoipupdate                   v4.7.1          8ec32cc727c7   21 months ago       10.6MB
clickhouse-self-hosted-local             latest          abe55fc6544d   2 years ago         497MB
yandex/clickhouse-server                 20.3.9.70       abe55fc6544d   2 years ago         497MB

Lancer le conteneur Sentry

À ce stade, Sentry est installé. Vous pouvez maintenant démarrer le conteneur Sentry en utilisant la commande suivante :

docker-compose up -d

Cela démarrera tous les conteneurs pour Sentry comme indiqué ci-dessous :

Starting sentry_onpremise_memcached_1            ... done
Starting sentry_onpremise_redis_1                ... done
Starting sentry_onpremise_symbolicator_1         ... done
Creating sentry_onpremise_symbolicator-cleanup_1 ... done
Starting sentry_onpremise_zookeeper_1            ... done
Starting sentry_onpremise_clickhouse_1           ... done
Starting sentry_onpremise_smtp_1                 ... done
Starting sentry_onpremise_postgres_1             ... done
Starting sentry_onpremise_kafka_1                ... done
Starting sentry_onpremise_snuba-consumer_1          ... done
Starting sentry_onpremise_snuba-outcomes-consumer_1 ... done
Starting sentry_onpremise_snuba-api_1               ... done
Starting sentry_onpremise_snuba-sessions-consumer_1 ... done
Starting sentry_onpremise_snuba-replacer_1          ... done
Creating sentry_onpremise_snuba-cleanup_1           ... done
Creating sentry_onpremise_relay_1                   ... done
Creating sentry_onpremise_web_1                     ... done
Creating sentry_onpremise_post-process-forwarder_1  ... done
Creating sentry_onpremise_cron_1                    ... done
Creating sentry_onpremise_sentry-cleanup_1          ... done
Creating sentry_onpremise_worker_1                  ... done
Creating sentry_onpremise_ingest-consumer_1         ... done
Creating sentry_onpremise_nginx_1                   ... done

Vous pouvez vérifier l’état de tous les conteneurs en utilisant la commande suivante.

docker-compose ps

Vous devriez voir la sortie suivante.

                         Name                                        Command                  State                      Ports                
----------------------------------------------------------------------------------------------------------------------------------------------
sentry-self-hosted_clickhouse_1                           /entrypoint.sh                   Up (healthy)   8123/tcp, 9000/tcp, 9009/tcp        
sentry-self-hosted_cron_1                                 /etc/sentry/entrypoint.sh  ...   Up             9000/tcp                            
sentry-self-hosted_geoipupdate_1                          /usr/bin/geoipupdate -d /s ...   Exit 1                                              
sentry-self-hosted_ingest-consumer_1                      /etc/sentry/entrypoint.sh  ...   Up             9000/tcp                            
sentry-self-hosted_kafka_1                                /etc/confluent/docker/run        Up (healthy)   9092/tcp                            
sentry-self-hosted_memcached_1                            docker-entrypoint.sh memcached   Up (healthy)   11211/tcp                           
sentry-self-hosted_nginx_1                                /docker-entrypoint.sh ngin ...   Up             0.0.0.0:9000->80/tcp,:::9000->80/tcp
sentry-self-hosted_post-process-forwarder-errors_1        /etc/sentry/entrypoint.sh  ...   Up             9000/tcp                            
sentry-self-hosted_post-process-forwarder-                /etc/sentry/entrypoint.sh  ...   Up             9000/tcp                            
transactions_1                                                                                                                                 
sentry-self-hosted_postgres_1                             /opt/sentry/postgres-entry ...   Up (healthy)   5432/tcp                            
sentry-self-hosted_redis_1                                docker-entrypoint.sh redis ...   Up (healthy)   6379/tcp                            
sentry-self-hosted_relay_1                                /bin/bash /docker-entrypoi ...   Up             3000/tcp                            
sentry-self-hosted_sentry-cleanup_1                       /entrypoint.sh 0 0 * * * g ...   Up             9000/tcp                            
sentry-self-hosted_smtp_1                                 docker-entrypoint.sh exim  ...   Up             25/tcp                               
sentry-self-hosted_snuba-api_1                            ./docker_entrypoint.sh api       Up             1218/tcp                            
sentry-self-hosted_snuba-cleanup_1                        /entrypoint.sh */5 * * * * ...   Up             1218/tcp                            
sentry-self-hosted_snuba-consumer_1                       ./docker_entrypoint.sh con ...   Up             1218/tcp                            
sentry-self-hosted_snuba-outcomes-consumer_1              ./docker_entrypoint.sh con ...   Up             1218/tcp                            
sentry-self-hosted_snuba-replacer_1                       ./docker_entrypoint.sh rep ...   Up             1218/tcp                            
sentry-self-hosted_snuba-sessions-consumer_1              ./docker_entrypoint.sh con ...   Up             1218/tcp                            
sentry-self-hosted_snuba-subscription-consumer-events_1   ./docker_entrypoint.sh sub ...   Up             1218/tcp                            
sentry-self-hosted_snuba-subscription-consumer-           ./docker_entrypoint.sh sub ...   Up             1218/tcp                            
transactions_1                                                                                                                                 
sentry-self-hosted_snuba-transactions-cleanup_1           /entrypoint.sh */5 * * * * ...   Up             1218/tcp                            
sentry-self-hosted_snuba-transactions-consumer_1          ./docker_entrypoint.sh con ...   Up             1218/tcp                            
sentry-self-hosted_subscription-consumer-events_1         /etc/sentry/entrypoint.sh  ...   Up             9000/tcp                            
sentry-self-hosted_subscription-consumer-transactions_1   /etc/sentry/entrypoint.sh  ...   Up             9000/tcp                            
sentry-self-hosted_symbolicator-cleanup_1                 /entrypoint.sh 55 23 * * * ...   Up             3021/tcp                            
sentry-self-hosted_symbolicator_1                         /bin/bash /docker-entrypoi ...   Up             3021/tcp                            
sentry-self-hosted_web_1                                  /etc/sentry/entrypoint.sh  ...   Up (healthy)   9000/tcp                            
sentry-self-hosted_worker_1                               /etc/sentry/entrypoint.sh  ...   Up             9000/tcp                            
sentry-self-hosted_zookeeper_1                            /etc/confluent/docker/run        Up (healthy)   2181/tcp, 2888/tcp, 3888/tcp

Une fois que vous avez terminé, vous pouvez passer à l’étape suivante.

Accéder à l’interface Web de Sentry

À ce stade, Sentry est démarré et écoute sur le port 9000. Maintenant, ouvrez votre navigateur Web et tapez l’URL http://your-server-ip:9000 pour accéder au tableau de bord Sentry. Vous serez redirigé vers la page de connexion Sentry comme indiqué ci-dessous :

Connexion Sentry

Fournissez votre nom d’utilisateur administrateur, votre mot de passe et cliquez sur le bouton Connexion. Vous devriez voir la page suivante :

Configuration Sentry

Authentification

Fournissez votre URL Sentry, votre adresse e-mail et vos détails SMTP, puis cliquez sur le bouton Continuer. Vous devriez voir le tableau de bord par défaut de Sentry sur la page suivante :

Tableau de bord de suivi des erreurs Sentry

Conclusion

Dans ce guide, nous avons expliqué comment installer Sentry sur Ubuntu 22.04. Maintenant, vous pouvez mettre en œuvre Sentry dans votre organisation pour suivre votre application à travers l’ensemble de la pile en temps réel. N’hésitez pas à me poser des questions si vous en avez.