O endereço usado pela biblioteca de monitoramento
O DSN (Data Source Name) do Sentry é o endereço que uma aplicação usa para encaminhar eventos ao projeto correto. A biblioteca de monitoramento, chamada SDK (Software Development Kit), lê esse endereço na inicialização para configurar o envio dos erros capturados.
O endereço combina o servidor de destino com uma chave pública e o identificador do projeto. A sigla DSN também aparece em outros sistemas, por isso o formato descrito aqui se aplica ao Sentry.
Como ler a configuração
Este exemplo didático usa um servidor fictício. Na sua aplicação, você utiliza o DSN fornecido pelo Sentry e a biblioteca já instalada:
Sentry.init({ dsn: "https://public@sentry.example.com/1", environment: "homologacao",});O servidor é sentry.example.com, a chave pública é public e o projeto tem identificador 1. O campo environment marca o ambiente do evento. Mudar esse campo para production mantém o mesmo projeto, pois é o DSN que define o destino. Para separar projetos, você configura o DSN correspondente a cada um.
A inicialização configura a biblioteca, mas a confirmação do envio exige encontrar um evento de teste no projeto indicado. Quando a integração falhar, a opção debug pode exibir mensagens da biblioteca para investigar o envio. O DSN permite submeter eventos, sem autorizar a leitura dos erros armazenados. A chave pode ser rotacionada ou revogada caso receba envios indevidos.
Dúvidas frequentes
Perguntas frequentes sobre DSN
- Onde encontro o DSN do meu projeto?
- O Sentry exibe o endereço nos exemplos de configuração e nas configurações do projeto, na seção Client Keys (DSN).
- O que acontece quando o DSN fica vazio?
- Com o DSN vazio, o SDK inicializado não envia eventos pela rede. Algumas plataformas podem ler SENTRY_DSN quando a opção não é fornecida, mas esse comportamento não se aplica ao JavaScript no navegador.
- Posso consultar os erros usando apenas o DSN?
- O DSN autoriza a submissão de eventos, sem acesso de leitura aos registros. Uma chave divulgada ainda pode receber envios indevidos e pode ser revogada nas configurações do projeto.
Para continuar
Recursos relacionados
Documentação
Sentry: destino e identificação dos eventos
Explica os campos do DSN, a localização da chave no projeto e os limites de acesso.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão de Desenvolvimento Colaborativo para investigar com você a configuração e os testes de uma integração de monitoramento.
Abrir recursoDocumentação
Sentry: opções do SDK JavaScript
Referência das opções dsn e environment usadas para configurar o destino e identificar o ambiente dos eventos.
Abrir recursoAplicação na formação
Formação DevOps
A configuração do Sentry exige identificar o projeto que recebe os erros e conferir o envio de um evento de teste.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.