Como configurar log centralizado de erros de aplicação com Sentry no VPS imprimir

Como configurar log centralizado de erros de aplicação com Sentry no VPS

Olá, querido(a) desenvolvedor(a) ou administrador(a) de sistema! Seja bem-vindo(a) ao seu novo guia de confiança na GeHost. Aqui, você não precisa se preocupar com tecnologia complexa ou jargões que parecem de outro planeta. Vamos juntos, passo a passo, deixar seu aplicativo mais seguro, mais transparente e mais fácil de manter — com um sistema de log centralizado usando o Sentry.

Imagine que seu aplicativo está rodando no seu VPS (um servidor dedicado que você controla por completo). Toda vez que algo dá errado — um erro de código, uma falha de conexão, um acesso inválido — ele gera um registro. Mas se esses registros estiverem espalhados por diferentes arquivos, é difícil ver o todo.

É aí que entra o Sentry. Ele é como um detetive digital que reúne todos esses erros em um único lugar, com detalhes, tempo, contexto e até o código que falhou. Isso torna o diagnóstico muito mais rápido e preciso.

Seu VPS na GeHost é um ambiente poderoso — e com o Sentry, você tira o máximo dele. Vamos lá?

Passo 1: Acesse o painel do cPanel

Primeiro, entre no seu painel de controle. Ele é o centro de comando do seu servidor.

Use o login e senha que você recebeu ao contratar o serviço. Se não lembrar, entre em contato com o suporte no painel.gehost.com.br — estamos aqui para te ajudar.

Passo 2: Acesse o terminal (Shell Access)

Para instalar o Sentry, precisamos de acesso direto ao sistema. No cPanel, vá até a seção “Terminal” (ou “Shell Access”).

Se você não ver essa opção, entre em contato com o suporte — pode ser que o acesso ao terminal esteja restrito no seu plano. No entanto, em planos com acesso completo (como os VPS), ele está disponível.

Selecione o terminal e clique em “Launch” para abrir uma janela de comando.

Passo 3: Instale o Sentry usando o pacote oficial

O Sentry é um sistema que pode ser instalado via linha de comando. Vamos usar o pip (gerenciador de pacotes do Python) para instalar o servidor do Sentry.

Abra o terminal e execute os comandos abaixo um por um:

1. Atualize o sistema:

   sudo apt update && sudo apt upgrade -y

2. Instale o Python e o pip (se não estiverem instalados):

   sudo apt install python3 python3-pip -y

3. Instale o Sentry:

   pip3 install sentry

Esse processo pode levar alguns minutos. Não se preocupe — o terminal vai te mostrar o que está acontecendo.

Passo 4: Inicialize o servidor Sentry

Após a instalação, vamos iniciar o serviço do Sentry. Execute este comando:

sentry init

Ele vai pedir algumas informações, como:

• Endereço do banco de dados (use SQLite para começar — mais simples).
• Usuário administrador (crie um nome e senha forte).
• URL do Sentry (ex: https://seu-dominio.com/sentry).

Se você não souber qual URL usar, consulte o suporte ou use o domínio do seu site. O Sentry vai rodar em um subdomínio, como sentry.seudominio.com.

Passo 5: Configure o acesso via navegador

Depois de inicializar, o Sentry vai gerar um link de acesso. Ele será algo como:

http://localhost:9000

Como você está no VPS, precisamos tornar esse acesso público. Para isso, você pode:

• Usar um subdomínio (ex: sentry.seudominio.com) com redirecionamento via DNS.
• Usar um proxy reverso (como Nginx) para expor o Sentry na porta 80/443.

Se você não sabe como fazer isso, pedimos que entre em contato com o suporte da GeHost. Nós podemos te ajudar a configurar o acesso seguro com SSL.

Passo 6: Instale o SDK no seu aplicativo

Agora que o Sentry está rodando, é hora de conectar seu aplicativo. Você precisa instalar o SDK do Sentry no seu código.

Por exemplo, se você usa Node.js, execute:

npm install @sentry/node

Se for Python (Flask, Django, etc.), use:

pip install sentry-sdk

Depois, no código do seu aplicativo, adicione a inicialização do Sentry com a URL do seu servidor:

import sentry_sdk
from sentry_sdk.integrations.flask import FlaskIntegration

sentry_sdk.init(
    dsn="https://seu-dsn-aqui@sentry.seudominio.com/1",
    integrations=[FlaskIntegration()],
    traces_sample_rate=1.0,
)

Substitua o dsn pelo valor que o Sentry gerou durante a inicialização.

Passo 7: Teste o envio de erro

Para garantir que tudo está funcionando, provoque um erro intencional no seu aplicativo. Por exemplo, tente acessar uma variável que não existe.

Se tudo estiver certo, você verá o erro aparecer no painel do Sentry — com data, hora, código, contexto e até o navegador do usuário (se aplicável).

Dicas importantes (como um amigo que te ensina)

⚠️ Cuidado com a segurança: Nunca exponha o Sentry publicamente sem SSL. Use HTTPS. Se você não souber como configurar SSL, peça ajuda ao suporte da GeHost — oferecemos suporte técnico para isso.

💡 Dica de ouro: Use o Sentry apenas para erros de aplicação. Ele não substitui logs de sistema, mas complementa. Combine com ferramentas como journalctl ou tail -f para ver o fluxo geral.

🔐 Acesso ao painel: O Sentry é uma ferramenta de monitoramento. Não é necessário que todos tenham acesso. Crie usuários com permissões limitadas e evite compartilhar credenciais.

Conclusão: Você está no controle

Parabéns! Agora você tem um log centralizado de erros que te ajuda a entender o que acontece com seu aplicativo em tempo real. Isso significa menos tempo perdido em “achar o erro” e mais tempo criando coisas incríveis.

Se precisar de ajuda com qualquer passo — instalação, configuração de SSL, SDK, ou até com o painel do Sentry — entre em contato com o suporte da GeHost. Estamos aqui para te ajudar, com o mesmo carinho com que criamos este guia.

Com carinho,
Sensei da GeHost
*G e Soluções e Eventos LTDA — CNPJ: 46.647.904/0001-04*