SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor

Alternativas ao Sentry para error tracking self-hosted

Compare Sentry e GlitchTip antes de escolher: o Sentry completo pede 16 GB de RAM, enquanto o GlitchTip documenta 512 MB. Veja disco, containers e upgrades.

O custo do error tracking self-hosted antes de armazenar um único evento

O error tracking self-hosted tem um número que determina toda a escolha: o requisito mínimo de RAM. A documentação oficial do self-hosted do Sentry exige 4 CPU cores, 16 GB de RAM, mais 16 GB de swap, e 20 GB de espaço livre em disco para a stack completa, antes de a sua aplicação enviar um único evento. O perfil apenas com erros tem requisitos mínimos de instalação mais baixos: 2 CPU cores e 7000 MB de RAM disponíveis para o Docker. O GlitchTip documenta 512 MB. Todas as opções aqui aceitam eventos dos mesmos Sentry SDKs. Portanto, esta não é uma decisão sobre como instrumentar o seu código. É uma decisão sobre o tamanho do servidor que está disposto a pagar e manter em execução.

Recursos publicados, lado a lado

Estes são os números que cada projeto publica sobre si próprio, em outubro de 2026. Não representam o mesmo tipo de medição, por isso leia a nota de cada linha antes de os comparar.

GráficoPublished RAM figures per error tracking stack, October 2026
Os dados por trás deste gráfico
[
  {
    "tool": "Sentry feature-complete",
    "published_ram_gb": 16,
    "notes": "documented minimum for the feature-complete profile, plus 16 GB of swap"
  },
  {
    "tool": "Bugsink",
    "published_ram_gb": 4,
    "notes": "the vendor's own published benchmark box, 2 vCPU"
  },
  {
    "tool": "GlitchTip",
    "published_ram_gb": 0.5,
    "notes": "documented recommendation, 256 MB stated as the minimum"
  }
]

Os 16 GB do Sentry são um mínimo documentado para o perfil com todas as funcionalidades, e a mesma página recomenda 32 GB. Os 0.5 GB do GlitchTip são uma recomendação, e o projeto indica 256 MB como mínimo funcional, ou 128 MB mais swap com uma configuração cuidadosa. Os 4 GB do Bugsink não correspondem a nenhum desses casos: representam o sistema utilizado pelo fornecedor no seu próprio benchmark de desempenho. Um valor publicado é um ponto de partida, não uma garantia para o volume de eventos do seu ambiente.

Sentry self-hosted: a maior parte do produto e toda a fatura

A stack oficial é getsentry/self-hosted, um projeto Docker Compose que executa os mesmos componentes que o Sentry usa em produção. A documentação lista exclusões, incluindo o Seer e outras funcionalidades de IA e ML de código fechado, faturação, proteção contra picos e algum suporte de plataforma. Obtém a maior parte das funcionalidades do Sentry e também os componentes necessários para as executar.

Instale a partir de uma release identificada, em vez de usar master:

VERSION=$(curl -Ls -o /dev/null -w %{url_effective} https://github.com/getsentry/self-hosted/releases/latest)
VERSION=${VERSION##*/}
git clone https://github.com/getsentry/self-hosted.git
cd self-hosted
git checkout ${VERSION}
./install.sh

O perfil com todas as funcionalidades é o predefinido. Para instalar a stack menor, apenas para erros, defina COMPOSE_PROFILES=errors-only em .env antes de executar ./install.sh.

Depois, inicie-a:

docker compose up --wait

Por predefinição, o Sentry publica a porta 9000 em todas as interfaces do host; defina SENTRY_BIND=127.0.0.1:9000 em .env para a associar apenas a localhost. São necessários Docker Engine 19.03.6 ou posterior e Docker Compose 2.32.2 ou posterior, e o instalador verifica ambos: uma versão mais antiga do Compose interrompe ./install.sh com uma linha iniciada por FAIL: Expected minimum que indica a versão encontrada, e o script termina com um erro. Em hosts x86-64, as imagens oficiais do ClickHouse 26.6 e posteriores também exigem o conjunto completo de funcionalidades de CPU x86-64-v3, incluindo AVX2.

Verifique o que iniciou efetivamente:

docker compose ps
free -h

docker compose ps apresenta todos os serviços da stack, e a lista é longa: Postgres, ClickHouse, Kafka, Valkey, com o nome de serviço Compose redis, Relay, Snuba, Symbolicator e vários processos de workers e cron. Conte-os uma vez, porque esse número corresponde à carga de manutenção. Cada entrada é um processo que pode falhar, encher um disco ou falhar durante uma migração.

Se um serviço permanecer no estado Restarting, verifique primeiro a memória:

dmesg -T | grep -i 'out of memory'

Uma linha como Out of memory: Killed process 3412 (java) significa que o OOM killer do kernel, o mecanismo de eliminação por falta de memória, terminou um contentor porque o sistema ficou sem RAM. Por isso, o serviço nunca fica saudável e a stack nunca termina de iniciar. O instalador também verifica a RAM disponível e rejeita uma máquina abaixo do mínimo definido. A documentação também assinala a velocidade do disco: iowait acima de 10% provavelmente significa que a máquina não consegue acompanhar o pipeline de ingestão. Leia esse valor na coluna wa de top ou em iostat -x 5, se tiver sysstat instalado.

As atualizações são a parte que as pessoas subestimam

O Sentry self-hosted lança versões mensalmente segundo o CalVer, um esquema de versões baseado no calendário, com uma release principal no dia 15 de cada mês. Não pode saltar diretamente de uma versão antiga para a mais recente. O projeto define versões de paragem obrigatória, e tem de fazer checkout de cada uma pela ordem correta para aplicar as migrações da base de dados. Em outubro de 2026, as versões de paragem obrigatória publicadas são 9.1.2, 21.5.0, 21.6.3, 23.6.2, 23.11.0, 24.8.0, 25.5.1, 26.5.0 e 26.7.0. A documentação também lista releases a evitar devido a problemas de migração, incluindo 23.7.0, 25.9.0, 25.12.0 e o intervalo entre 26.3.0 e 26.4.0.

Uma atualização consiste em fazer checkout e executar novamente o instalador:

git fetch
git checkout 26.7.0
./install.sh
docker compose up --wait

Crie um snapshot do servidor antes de começar, porque uma migração sobre um dataset grande do ClickHouse pode demorar horas e uma falha a meio deixa a base de dados entre dois esquemas. A causa direta da maioria das atualizações falhadas do Sentry self-hosted é esta: a máquina permaneceu durante um ano na mesma versão, por isso a atualização atravessa várias versões de paragem obrigatória de uma só vez e uma das migrações a evitar era precisamente a necessária.

Há mais um ponto a conhecer antes de se comprometer. O Sentry self-hosted está sujeito à Functional Source License (FSL), introduzida pelo próprio Sentry. Trata-se de código-fonte fair source, não de open source aprovado pela OSI: pode executá-lo para uso próprio, mas não pode vendê-lo como um serviço concorrente. Cada release é convertida para Apache 2.0 dois anos depois de ser lançada.

GlitchTip: a resposta para 512 MB

O GlitchTip é licenciado sob a MIT e recebe eventos dos SDKs open source do Sentry. Assim, uma aplicação instrumentada pode ser migrada alterando um único valor: o DSN (data source name, a URL para a qual o SDK envia os eventos). O GlitchTip 7.0 requer PostgreSQL 15 ou posterior. Valkey ou Redis 7 ou posterior é opcional e torna as instâncias maiores mais rápidas.

A instalação consiste no Docker e num único ficheiro compose:

sudo apt install docker.io
curl -O https://glitchtip.com/assets/compose.sample.yml
mv compose.sample.yml compose.yml

Edite a secção de ambiente antes de iniciar qualquer componente. Defina o segredo e o domínio. Configure também o email se quiser alertas por email e reposições de palavra-passe:

SECRET_KEY: <output of openssl rand -base64 50>
GLITCHTIP_DOMAIN: https://errors.example.com
DEFAULT_FROM_EMAIL: errors@example.com
EMAIL_URL: smtp://user:password@smtp.example.com:587

Defina DATABASE_URL como a string de ligação do PostgreSQL da sua instalação. GLITCHTIP_DOMAIN tem de incluir o esquema. Sem https:// no início, as ligações das mensagens de alerta são construídas incorretamente e apontam para um URL que não responde.

Inicie o serviço e monitorize o primeiro arranque:

docker compose up -d
docker compose logs -f web

Mantenha as tags das imagens fixas. Um ficheiro compose que contenha latest vai obter um novo motor de base de dados no próximo docker compose pull e mudar para ele na próxima vez que docker compose up -d recriar o contentor. Uma atualização da versão principal do Postgres num diretório de dados existente pode impedir o arranque de um gestor de erros que estava a funcionar.

Para usar entre 256 MB e 512 MB, desative o Valkey e as funcionalidades opcionais de logs e monitorização de uptime. Sem o Valkey, o GlitchTip usa a base de dados para cache e filas. Isso é mais lento, mas continua correto. O modo tudo-em-um executa o worker dentro do processo web. Assim, mantém um único contentor da aplicação em vez de dois.

Coloque um proxy à frente do serviço. A documentação do GlitchTip recomenda um proxy ou balanceador de carga que faça buffering dos pedidos e processe Transfer-Encoding em partes. O exemplo apresentado usa nginx. Sem buffering, um cliente lento mantém um worker da aplicação ocupado durante todo o upload. Alguns remetentes lentos podem ocupar todos os workers disponíveis, fazendo com que os clientes normais comecem a atingir o tempo limite.

Leia as notas da versão antes de atualizar entre versões principais. No GlitchTip 7.0, atualize primeiro para a versão 6.x se estiver na 5.x. Atualize também o PostgreSQL 14 enquanto ainda estiver no GlitchTip 6.x. Verifique as variáveis de ambiente renomeadas, as definições de arranque removidas, o novo valor predefinido de TRUSTED_PROXIES e as permissões alteradas antes de mudar a tag da imagem da aplicação para 7. Depois, faça pull e reinicie:

docker compose pull
docker compose stop
docker compose up -d

As migrações da base de dados são executadas automaticamente no arranque. Faça um dump antes, na mesma, porque uma migração automática continua a ser uma migração.

Bugsink: um contentor e uma licença que deve ler

Bugsink é o mais leve dos três. Fala o protocolo do Sentry SDK e funciona sem fila de mensagens e sem serviços externos além de uma base de dados. SQLite é a opção predefinida, com suporte para MySQL e PostgreSQL quando a instalação crescer.

Uma instância temporária, para ver a interface antes de se comprometer:

docker pull bugsink/bugsink:latest
docker run \
  -e SECRET_KEY=PUT_AN_ACTUAL_RANDOM_SECRET_HERE_OF_AT_LEAST_50_CHARS \
  -e CREATE_SUPERUSER=admin@example.org:admin \
  -e PORT=8000 \
  -p 8000:8000 \
  bugsink/bugsink

Abra http://localhost:8000/ e inicie sessão com o endereço e a palavra-passe fornecidos em CREATE_SUPERUSER. Esse contentor perde os dados quando é removido. Para uma instância real, use o exemplo de compose do projeto, que combina bugsink/bugsink:2 com postgres:17-alpine e define DATABASE_URL, BASE_URL e BEHIND_HTTPS_PROXY. Gere o segredo corretamente:

openssl rand -base64 50

BASE_URL tem de corresponder ao URL que os seus utilizadores e SDKs usam realmente, incluindo o esquema. Se o deixar como http://localhost:8000 num servidor acedido através de https://errors.example.com, todas as ligações numa mensagem de notificação apontarão para um host que não resolve para a pessoa que a lê. Defina BEHIND_HTTPS_PROXY como true quando nginx ou Caddy terminarem o TLS (transport layer security) à frente do serviço e encaminhe X-Forwarded-Proto: https, para que o Bugsink reconheça os pedidos seguros e as verificações de CSRF usem o esquema correto.

O fornecedor publica os seus próprios números de desempenho: 18 eventos por segundo, com 50 KB cada, o que corresponde a 1.5 milhões de eventos por dia, num VPS com 2 vCPU e 4 GB. Considere estes valores como uma indicação da dimensão da ferramenta, não como uma garantia para a sua carga de trabalho. Ainda assim, mostram que o limite está muito acima do que uma aplicação pequena produz.

Agora, a licença. Esta é a parte que deve ler antes de a introduzir na sua stack. O Bugsink é distribuído ao abrigo da PolyForm Shield License 1.0.0. O código está disponível para consulta, mas não é open source: pode executá-lo e modificá-lo, mas não pode usá-lo para criar algo que concorra com o Bugsink. Para um sistema interno de acompanhamento de erros, esta restrição não costuma ser relevante. Se a sua empresa vende ferramentas para programadores, peça a alguém para ler primeiro o texto da licença.

O rastreio de erros e a observabilidade de LLM continuam a ser duas ferramentas

Procure uma ferramenta que faça simultaneamente rastreio de erros e observabilidade de modelos de linguagem de grande escala (LLM) e encontrará produtos que afirmam fazer ambas as coisas. As estruturas dos dados são diferentes, por isso a integração continua a não acontecer. Um sistema de rastreio de erros recebe uma exceção com um stack trace, calcula uma impressão digital a partir dela e agrupa milhares de ocorrências num único problema com um contador. Uma ferramenta de rastreio de LLM recebe um span com um prompt, uma resposta, uma contagem de tokens e uma latência. Tem de manter cada ocorrência, porque duas chamadas com entradas idênticas continuam a ser eventos distintos que vale a pena analisar.

Por isso, execute ambas. Envie as exceções para o sistema de rastreio de erros e envie as chamadas aos modelos para uma ferramenta concebida para esse fim: Langfuse self-hosted para rastreio de agentes cobre esse lado, enquanto as abordagens de observabilidade de IA self-hosted executam a mesma tarefa a partir de outra perspetiva. A sua aplicação já produz os dois tipos de falha. Uma chamada ao modelo que devolve disparates apresentados com confiança não gera qualquer exceção, por isso um sistema de rastreio de erros nunca lha mostrará.

O crescimento do disco é a falha que só aparece mais tarde

Todo sistema de acompanhamento de erros é uma base de dados com muitas operações de escrita e entrada sem limite. A aplicação decide quanto escreve, e um novo bug num caminho de código muito utilizado pode gerar um milhão de eventos durante a noite.

O GlitchTip publica um valor útil para o planeamento: uma instância que processa um milhão de eventos por mês pode precisar de 30 GB de disco. A janela de retenção determina quanto dessa ingestão é mantido.

O Bugsink aborda o problema de outra forma. Em vez de aplicar uma quota fixa, usa um algoritmo de retenção baseado no número e na idade dos eventos, e expõe diretamente os limites: MAX_RETENTION_EVENT_COUNT calcula a soma das contagens de retenção configuradas para os projetos, e MAX_RETENTION_PER_PROJECT_EVENT_COUNT limita a configuração de cada projeto. Estes são limites de segurança da configuração. MAX_EVENT_AGE_DAYS fornece um limite absoluto de idade quando se executa bugsink-manage delete_old_events ou bugsink-manage vacuum --old-events. Dimensione o orçamento de eventos com base no tamanho real dos eventos armazenados, porque a contagem de eventos não é um limite em bytes.

Monitorize os valores reais no servidor:

df -h /
docker system df -v
du -sh /var/lib/docker/volumes/*

docker system df -v mostra os tamanhos por volume, para que possa identificar qual serviço está a crescer. Um volume que ganhe vários gigabytes por semana sem alteração no tráfego normalmente indica que a janela de retenção continua a acumular dados ou que mantém mais dados do que a partição consegue suportar à sua taxa de eventos. Não deixar a retenção inalterada não significa que nada expire: o .env incluído no Sentry define SENTRY_EVENT_RETENTION_DAYS=90, e o valor predefinido do GlitchTip em GLITCHTIP_RETENTION_DAYS é 90. Reduza a janela para adequá-la ao disco, em vez de esperar que a partição fique cheia.

A memória apresenta o mesmo problema com outra forma. Uma stack sem limites consumirá toda a memória disponibilizada pelo kernel. Quando a máquina fica sem memória, o OOM killer termina o processo com a pontuação de gravidade mais elevada. O kernel calcula essa pontuação principalmente com base na memória utilizada por cada processo e ajusta-a pelo seu oom_score_adj. Esse processo pode ser o servidor Web, e não o tracker que causou o problema. Defina um limite para cada serviço: limites de memória no Docker Compose mostra a sintaxe e o comportamento de um contentor quando atinge o limite. Um contentor terminado pelo seu próprio limite representa uma falha contida. A exaustão da memória do host também põe em risco os serviços vizinhos.

Qual stack é adequado para cada VPS

  • 1 GB, ou 2 GB com margem: GlitchTip no modo all in one com o Valkey desativado, ou Bugsink com SQLite. Ambos funcionam confortavelmente com algumas aplicações.
  • 4 GB: Bugsink com PostgreSQL, ou GlitchTip com o Valkey ativado e um serviço worker separado. A partir deste tamanho, deixa de ser necessário ajustar tudo e pode simplesmente executar a stack.
  • 8 GB: o perfil oficial do Sentry apenas para erros passa na verificação de RAM do instalador quando o Docker deteta pelo menos 7000 MB; também requer 2 núcleos de CPU. Defina COMPOSE_PROFILES=errors-only em .env antes da instalação.
  • 16 GB no mínimo, 32 GB recomendados: a stack oficial self-hosted do Sentry com todas as funcionalidades, e apenas quando precisar de uma funcionalidade do Sentry que os projetos mais leves não implementam. Verifique primeiro a funcionalidade específica na documentação de cada projeto, porque os projetos compatíveis abrangem as funcionalidades comuns.

Seja qual for a opção, o sistema de monitorização de erros não consegue comunicar a própria falha. Configure uma verificação a partir de outra máquina: o Uptime Kuma a monitorizar a partir de outro servidor informará quando o sistema de monitorização estiver indisponível. Esse é precisamente o momento em que a aplicação começa a gerar erros que ninguém está a registar.

Quando um plano hospedado é a opção mais barata

A auto-hospedagem de um sistema de acompanhamento de erros compensa quando as regras de residência dos dados a exigem ou quando o volume de eventos é suficientemente alto para que o preço por evento pese no orçamento. Fora desses casos, faça as contas com honestidade. O requisito mínimo documentado do Sentry com todas as funcionalidades é um servidor com 16 GB, 4 cores e armazenamento rápido, e um VPS desse tamanho não é barato; o perfil apenas para erros tem requisitos mínimos de instalação mais baixos: 2 cores e 7000 MB de RAM visível no Docker. Depois, some o trabalho operacional: ultrapassar cada bloqueio rígido pela ordem e criar um snapshot antes de cada migração, algumas vezes por ano.

O GlitchTip e o Bugsink alteram completamente essas contas, porque uma máquina com 512 MB a 4 GB é barata e as atualizações normais do Docker consistem em obter uma imagem e reiniciar o serviço, depois de verificar as notas de versão e os requisitos da base de dados antes das atualizações principais. É por isso que a maioria das pessoas que fazem esta pergunta acaba por escolher um dos projetos compatíveis, em vez da stack oficial. Queriam acompanhamento de erros, não um pipeline de dados distribuído para manter.

Se ainda estiver a decidir o que deve sequer ficar no servidor, a lista mais abrangente do que vale a pena alojar por conta própria coloca o acompanhamento de erros ao lado dos outros serviços que concorrem pela mesma RAM.

FAQ

Posso alojar o Sentry num VPS com 2 GB?

Não. Mesmo o perfil do Sentry apenas com erros requer 2 núcleos de CPU e pelo menos 7000 MB de RAM disponíveis para o Docker. A documentação completa indica um mínimo de 4 núcleos de CPU, 16 GB de RAM, mais 16 GB de swap, e 20 GB de espaço livre em disco. A stack executa Postgres, ClickHouse, Kafka, Valkey e vários processos de trabalho em simultâneo. O instalador rejeita um servidor com 2 GB durante a verificação de RAM. Se os contentores estiverem a ser terminados, verifique dmesg -T | grep -i 'out of memory'. Esse comando mostra uma linha com o processo terminado. Para um VPS com 2 GB, use o GlitchTip, que documenta 512 MB, ou o Bugsink, que executa como um único contentor com SQLite.

Tenho de alterar o código da aplicação para mudar do Sentry para o GlitchTip ou Bugsink?

Não. Ambos aceitam eventos dos SDKs open source do Sentry. Pode manter o SDK que já instalou e alterar apenas um valor: o DSN, que é o URL para onde o SDK envia os eventos. Se ainda estiver definido diretamente no código, passe-o para uma variável de ambiente. Aponte-o para o novo host. Depois, provoque uma exceção de teste e monitorize a chegada do evento. Se nada aparecer, confirme que o identificador do projeto no DSN corresponde a um projeto existente no novo servidor. Confirme também que a firewall permite que a aplicação aceda a esse host e porta.

De quanto espaço em disco precisa o rastreamento de erros autoalojado?

Isso depende mais do volume de eventos e do período de retenção do que da ferramenta. O GlitchTip publica 30 GB para uma instância que processa um milhão de eventos por mês. O Bugsink permite definir a retenção configurada de cada projeto com MAX_RETENTION_EVENT_COUNT e aplicá-la através de MAX_EVENT_AGE_DAYS nos respetivos comandos de limpeza. O dimensionamento do disco continua a depender do tamanho dos eventos e da sobrecarga da base de dados. Verifique a retenção no primeiro dia. O Sentry e o GlitchTip incluem ambos um período de 90 dias, que pode ocupar mais espaço do que o disco disponível à sua taxa de eventos. Um sistema de rastreamento que retém mais dados do que o disco comporta cresce até df -h indicar 100%. Nesse ponto, a ingestão para e perde os erros que mais precisava de consultar.

Porque é que a atualização do Sentry autoalojado continua a falhar?

Porque foi ignorado um ponto de paragem obrigatório. O Sentry autoalojado define versões específicas que incluem migrações da base de dados pelas quais tem de passar. Em outubro de 2026, essas versões são 9.1.2, 21.5.0, 21.6.3, 23.6.2, 23.11.0, 24.8.0, 25.5.1, 26.5.0 e 26.7.0. Passar diretamente de uma versão antiga para a mais recente ignora essas migrações. O esquema e o código deixam de estar sincronizados, e a atualização para a meio. Faça checkout de cada ponto de paragem pela ordem correta e execute ./install.sh em cada um. Crie um snapshot do servidor antes de começar. Consulte também a lista documentada de versões a evitar, que inclui 23.7.0, 25.9.0 e 25.12.0.

Este artigo foi útil?

#error-tracking#sentry#glitchtip#observability#self-hosting