Ponte Sentry, Bugsnag & Datadog RUM
Acelere desenvolvimento e controle de qualidade vinculando exceções JavaScript do navegador diretamente às gravações de vídeo de sessões do MousePlayer.
1. O problema: rastreamentos de pilha não mostram o contexto
Quando ocorre uma exceção JavaScript não tratada ou falha de rede no site, ferramentas como Sentry fornecem rastreamentos de pilha e strings de agente do navegador. Mas os desenvolvedores ainda perguntam: “Em qual botão o usuário clicou antes da falha?” ou “Quais dados foram inseridos no formulário?”
A ponte de rastreamento de erros do MousePlayer resolve automaticamente inserindo URLs de reprodução nos relatórios de erros. Quando ocorre uma exceção, basta um link no painel Sentry ou Bugsnag para ver a gravação da tela até o milissegundo exato da falha.
Integração sem sobrecarga: A ponte monitora silenciosamente em segundo plano dentro de mp.js. Detecta o SDK de rastreamento automaticamente sem sobrecarga mensurável nem impacto nos Core Web Vitals.
2. Ativação & associação de provedores
Você pode ativar a ponte pelo painel ou por programação com o objeto de configuração do SDK.
Método A: ativação pelo painel (sem código)
- Entre no espaço de trabalho MousePlayer e abra Suas propriedades.
- Clique no botão Configurações / Integrações ao lado do site desejado.
- Na janela de integrações, altere Ponte Sentry, Bugsnag & Datadog RUM para
ON. - Selecione o provedor (
sentry,bugsnag, oudatadog), e clique em Salvar alterações.
Método B: configuração manual do script
Se prefere definir a configuração no código, passe error_bridge_active: true no seu objeto window.mp_config de configuração:
3. Tabela técnica de chamadas ao SDK
Conforme o provedor, o MousePlayer executa automaticamente os métodos oficiais de marcação do SDK JavaScript:
| Provedor | Método JavaScript executado | Chave de metadados inserida |
|---|---|---|
| Sentry | window.Sentry.setTag(...) |
mouseplayer_session_url |
| Bugsnag | window.Bugsnag.addMetadata('MousePlayer', { ... }) |
session_url |
| Datadog RUM | window.DD_RUM.setGlobalContextProperty(...) |
mouseplayer_session_url |
4. Onde encontrar reproduções nos relatórios
Depois de ativar, as URLs aparecem imediatamente nos painéis de erros quando uma falha do navegador é registrada.
Detalhes do problema no Sentry
Abra um problema no projeto Sentry e role até a seção Tags . Você verá uma tag chamada mouseplayer_session_url. Também pode filtrar problemas pela barra de busca: mouseplayer_session_url:*.
Abas de metadados do Bugsnag
No relatório Bugsnag, verifique as abas inferiores. Uma nova aba personalizada chamada MousePlayer aparece com o link clicável session_url da reprodução.
Explorador de erros do Datadog RUM
No Datadog RUM, abra uma sessão com erro registrado e examine a árvore JSON Contexto global / Atributos . A URL está indexada em @mouseplayer_session_url.
Todas as marcas mencionadas pertencem aos respectivos proprietários. O MousePlayer não mantém relação comercial com esses fornecedores.