Ako nainštalovať Sentry pomocou Docker na Ubuntu 22.04


Tento návod existuje pre tieto verzie OS

  • Ubuntu 22.04 (Jammy Jellyfish)
  • Ubuntu 18.04 (Bionic Beaver)

Na tejto stránke

  1. Predpoklady
  2. Nainštalujte požadované závislosti
  3. Nainštalujte Docker a Docker Compose
  4. Nainštalujte Sentry
  5. Spustite Sentry Container
  6. Prístup k webovému používateľskému rozhraniu Sentry
  7. Záver

Sentry je bezplatná a open source platforma na sledovanie chýb, ktorá monitoruje a opravuje zlyhania v reálnom čase. Umožňuje vývojárom softvéru vidieť, na čom záleží, riešiť rýchlejšie a neustále sa učiť o svojich aplikáciách. Táto platforma poskytuje prehľad o produkčných nasadeniach v reálnom čase s informáciami na reprodukciu a opravu zlyhaní. Sentry podporuje všetky hlavné jazyky a rámce a integruje sa s vašimi obľúbenými aplikáciami a službami.

Tento tutoriál vám ukáže, ako nainštalovať Sentry Error Tracking System s Dockerom na Ubuntu 22.04.

Predpoklady

  • Server so systémom Ubuntu 22.04.
  • Platný názov domény ukazuje na IP vášho servera.
  • Na vašom serveri je nakonfigurované heslo používateľa root.

Nainštalujte požadované závislosti

Pred spustením sa odporúča aktualizovať balíky na najnovšiu verziu. Môžete ich aktualizovať pomocou nasledujúceho príkazu:

apt update -y
apt upgrade -y

Po aktualizácii systému nainštalujte všetky požadované balíky pomocou nasledujúceho príkazu:

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

Po nainštalovaní všetkých závislostí môžete prejsť na ďalší krok.

Nainštalujte Docker a Docker Compose

V predvolenom nastavení nie je najnovšia verzia balíka Docker a Docker Compose dostupná v predvolenom úložisku Ubuntu 22.04. Takže budete musieť pridať oficiálny repozitár Docker do APT.

Najprv si stiahnite a pridajte kľúč Docker GPG pomocou nasledujúceho príkazu.

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

Potom pridajte úložisko Docker pomocou nasledujúceho príkazu.

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

Po pridaní úložiska aktualizujte vyrovnávaciu pamäť úložiska pomocou nasledujúceho príkazu.

apt update -y

Potom nainštalujte Docker aj Docker Compose pomocou nasledujúceho príkazu.

apt install docker docker-compose -y

Po nainštalovaní oboch balíkov spustite službu Docker a povoľte jej spustenie pri reštarte systému pomocou nasledujúceho príkazu:

systemctl start docker
systemctl enable docker

Teraz môžete overiť stav Docker pomocou nasledujúceho príkazu:

systemctl status docker

Mali by ste dostať nasledujúci výstup:

? 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"

Ak chcete skontrolovať verziu Docker, spustite nasledujúci príkaz:

docker --version

Mali by ste vidieť nasledujúci výstup:

Docker version 20.10.12, build 20.10.12-0ubuntu4

Verziu zostavy Docker môžete skontrolovať aj pomocou nasledujúceho príkazu:

docker-compose --version

Mali by ste vidieť nasledujúci výstup:

docker-compose version 1.29.2, build unknown

Nainštalujte Sentry

Najprv si stiahnite najnovšiu verziu Sentry z úložiska Git pomocou nasledujúceho príkazu:

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

Po dokončení sťahovania zmeňte adresár na stiahnutý adresár a spustite inštalačný skript Sentry na spustenie inštalácie.

cd onpremise
bash install.sh

Počas inštalácie sa zobrazí výzva na vytvorenie účtu správcu, ako je uvedené nižšie:

Here's the info we may collect:

  - OS username
  - IP address
  - install log
  - runtime errors
  - performance data

Thirty (30) day retention. No marketing. Privacy policy at sentry.io/privacy.

Would you like to create a user account now? [Y/n]: y

Email: Email: [email 
Password: 
Repeat for confirmation: 
Added to organization: sentry
User created: [email 
Creating missing DSNs
Correcting Group.num_comments counter

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

You're all done! Run the following command to get Sentry running:

  docker-compose up -d

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

Potom skontrolujte všetky stiahnuté obrázky pomocou nasledujúceho príkazu.

docker images

Mali by ste vidieť nasledujúci výstup.

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

Spustite Sentry Container

V tomto bode je nainštalovaný Sentry. Teraz môžete spustiť kontajner Sentry pomocou nasledujúceho príkazu:

docker-compose up -d

Toto spustí všetky kontajnery pre Sentry, ako je uvedené nižšie:

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

Stav všetkých kontajnerov môžete overiť pomocou nasledujúceho príkazu.

docker-compose ps

Mali by ste vidieť nasledujúci výstup.

                         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        

Po dokončení môžete prejsť na ďalší krok.

Prístup k webovému používateľskému rozhraniu Sentry

V tomto bode sa Sentry spustí a počúva na porte 9000. Teraz otvorte webový prehliadač a zadajte adresu URL http://ip-adresa-vášho-serveru:9000, aby ste sa dostali na ovládací panel Sentry. Budete presmerovaní na prihlasovaciu stránku Sentry, ako je uvedené nižšie:

Zadajte svoje používateľské meno, heslo správcu a kliknite na tlačidlo Prihlásiť sa. Mali by ste vidieť nasledujúcu stránku:

Zadajte svoju Sentry URL, e-mailovú adresu a podrobnosti SMTP a kliknite na tlačidlo Pokračovať. Predvolený informačný panel Sentry by ste mali vidieť na nasledujúcej stránke:

Záver

V tejto príručke sme vysvetlili, ako nainštalovať Sentry na Ubuntu 22.04. Teraz môžete implementovať Sentry vo svojej organizácii na sledovanie vašej aplikácie v rámci celého zásobníka v reálnom čase. Ak máte nejaké otázky, neváhajte sa ma opýtať.