O que Integrador de Rastreamento de Erros faz?
Integra serviços de rastreamento de erros em aplicações para melhor depuração em produção e monitoramento.
Quando Usar
- O usuário solicita monitoramento ou rastreamento de erros
- Configuração de logs de erro em produção
- O usuário menciona "Sentry", "rastreamento de erros", "relatório de falhas" ou "depuração em produção"
Instruções
1. Detectar Framework
Identifique o framework da aplicação:
- React, Vue, Angular (frontend)
- Express, Fastify (Node.js backend)
- Django, Flask (Python)
- Rails (Ruby)
2. Escolher Serviço de Rastreamento de Erros
Serviços populares:
- Sentry: Mais popular, abrangente
- Rollbar: Bom para backend
- Bugsnag: Multiplataforma
- Airbrake: Focado em Ruby
- LogRocket: Replay de sessão + erros
3. Instalar e Configurar
Sentry (exemplo React):
npm install @sentry/react
import * as Sentry from "@sentry/react";
Sentry.init({
dsn: process.env.REACT_APP_SENTRY_DSN,
environment: process.env.NODE_ENV,
tracesSampleRate: 1.0,
integrations: [
new Sentry.BrowserTracing(),
new Sentry.Replay()
],
});
Sentry (Node.js/Express):
const Sentry = require("@sentry/node");
Sentry.init({
dsn: process.env.SENTRY_DSN,
environment: process.env.NODE_ENV,
tracesSampleRate: 1.0,
});
// Request handler (primeiro middleware)
app.use(Sentry.Handlers.requestHandler());
// Error handler (após todas as rotas, antes do middleware de erro)
app.use(Sentry.Handlers.errorHandler());
4. Adicionar Limites de Erro (React)
import { ErrorBoundary } from '@sentry/react';
function App() {
return (
<ErrorBoundary fallback={<ErrorFallback />}>
<YourApp />
</ErrorBoundary>
);
}
5. Adicionar Contexto
Contexto do usuário:
Sentry.setUser({
id: user.id,
email: user.email,
username: user.username
});
Tags:
Sentry.setTag("page_locale", "en-US");
Sentry.setTag("feature_flag", "new_ui");
Contexto:
Sentry.setContext("order", {
id: order.id,
total: order.total,
items: order.items.length
});
6. Breadcrumbs
Rastreie ações do usuário que levam ao erro:
Sentry.addBreadcrumb({
category: "auth",
message: "Usuário logado",
level: "info"
});
Sentry.addBreadcrumb({
category: "ui",
message: "Botão clicado",
data: { buttonId: "submit-form" }
});
7. Captura Manual de Erro
try {
riskyOperation();
} catch (error) {
Sentry.captureException(error, {
tags: { section: "payment" },
level: "error",
extra: { orderId: order.id }
});
}
8. Filtrar Dados Sensíveis
Remover PII:
Sentry.init({
beforeSend(event, hint) {
// Não enviar se contiver dados sensíveis
if (event.request?.data?.password) {
delete event.request.data.password;
}
return event;
},
ignoreErrors: [
// Ignorar erros de extensão do navegador
/extensions\//i,
/^Non-Error promise rejection/,
]
});
9. Mapas de Origem (Produção)
Ative mapas de origem para rastreamentos legíveis:
Webpack:
// webpack.config.js
module.exports = {
devtool: 'source-map',
plugins: [
new SentryWebpackPlugin({
org: "sua-org",
project: "seu-projeto",
authToken: process.env.SENTRY_AUTH_TOKEN,
include: "./dist",
}),
],
};
10. Configuração de Alertas
Configure alertas para:
- Novos problemas
- Regressão (problema resolvido que ocorre novamente)
- Pico na taxa de erros
- Erros críticos (falhas de pagamento, autenticação)
11. Monitoramento de Desempenho
Adicione rastreamento de transações:
const transaction = Sentry.startTransaction({
name: "processOrder",
op: "task"
});
try {
await processOrder();
} finally {
transaction.finish();
}
12. Melhores Práticas
- Separação de ambientes: Projetos diferentes para dev/staging/prod
- Rastreamento de versão: Marcar erros com a versão da release
- Taxas de amostragem: 100% para erros, menor% para desempenho
- Notificações da equipe: Integração com Slack/e-mail
- Atribuição de problemas: Atribuição automática para responsáveis pelo código
- Agrupamento de erros: Fingerprinting personalizado para melhor agrupamento
- Não registrar dados sensíveis: PII, senhas, tokens
Arquivos de Suporte
templates/sentry-react.js: Template de integração Reacttemplates/sentry-node.js: Template de integração Node.jstemplates/sentry-python.py: Template de integração Python