O que sentry-browser-sdk faz?
Configuração completa do SDK do Sentry para JavaScript no navegador. Use quando for solicitado a "adicionar Sentry a um site", "instalar @sentry/browser" ou configurar monitoramento de erros, rastreamento, reprodução de sessão ou registro para JavaScript vanilla, jQuery, sites estáticos ou WordPress.
Instalação
Para começar, instale o pacote via npm:
npm install @sentry/browser
Alternativamente, você pode usar o CDN:
<script src="https://browser.sentry-cdn.com/7.120.3/bundle.min.js" crossorigin="anonymous"></script>
Configuração Inicial
Adicione o seguinte código ao seu ponto de entrada principal (por exemplo, index.js ou app.js):
import * as Sentry from "@sentry/browser";
Sentry.init({
dsn: "https://[email protected]/0",
// Habilita o rastreamento de desempenho
integrations: [Sentry.browserTracingIntegration()],
tracesSampleRate: 1.0, // Altere para um valor menor em produção
// Habilita a reprodução de sessão
replaysSessionSampleRate: 0.1,
replaysOnErrorSampleRate: 1.0,
});
Captura de Erros
Erros não tratados são automaticamente capturados. Para capturar manualmente um erro:
try {
// código que pode lançar erro
} catch (error) {
Sentry.captureException(error);
}
Suporte para Frameworks
jQuery
Se você está usando jQuery, o Sentry se integra perfeitamente. Simplesmente adicione a configuração acima ao seu arquivo JavaScript principal.
WordPress
Para WordPress, você pode usar o plugin oficial do Sentry ou adicionar manualmente o SDK ao seu tema ou plugin:
// functions.php do seu tema
function add_sentry_script() {
?>
<script src="https://browser.sentry-cdn.com/7.120.3/bundle.min.js" crossorigin="anonymous"></script>
<script>
Sentry.init({ dsn: "https://[email protected]/0" });
</script>
<?php
}
add_action('wp_head', 'add_sentry_script');
Documentação Adicional
Para mais detalhes, consulte a documentação oficial do Sentry para JavaScript.