Minilição · Português

Como encontrar e corrigir erros no seu site no ar

Reproduza uma ação de visitante fornecida com defeito, peça a um assistente uma correção pontual e verifique a mesma ação após a alteração.

Começar a aula interativaLer as notas da aula

Para quem é esta lição?

Para quem quer encontrar e corrigir falhas vividas pelos visitantes. Você usará uma página quebrada fornecida; um assistente de programação pode alterar o código enquanto você descreve o problema e repete a ação.

Antes de começar

O site separado de prática fornecido e um assistente de programação. Um projeto Sentry de prática é opcional para a parte de monitoramento; envie apenas os erros fictícios fornecidos e não use dados privados de visitantes.

Tempo estimado: 19–31 min

Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. A configuração do provedor e a espera pela ingestão são adicionais. Uma chamada local de captura não prova que um alerta foi recebido.

O que você vai aprender

  • Reproduza uma ação realmente quebrada em vez de verificar apenas o carregamento da página.
  • Compartilhe contexto seguro suficiente para uma correção pontual pelo assistente.
  • Verifique a ação corrigida e o estado relevante do monitoramento.

Arquivos da oficina

Etapa 1

Experimente a ação do visitante

Uma página pode abrir enquanto sua funcionalidade útil está quebrada.

Peça ao assistente para servir public por HTTP e abra a página. Acione “Find contact section”. A versão practice-R1 procura deliberadamente um alvo ausente, então o estado informa que Contact falhou.

Informe ao assistente o botão exato, o destino esperado e o resultado visível. A seção Contact pode existir enquanto o botão não chega a ela; só conferir que a página carrega não encontraria isso.

Um exemplo concreto

Um relato útil é: “Pressionei Find contact section em practice-R1. Esperava chegar à seção Contact, mas o estado disse Contact action failed.”

Use o exemplo fornecido de ação de contato quebrada num site de prática separado. Reproduza a falha do botão, identifique uma causa pontual e altere só o necessário. Ajude-me a repetir a mesma ação e comparar antes/depois. Se o monitoramento estiver ativo, use apenas erros fictícios e meu próprio projeto de prática; não envie dados privados de página ou formulário. Não considere um problema corrigido só porque foi marcado como resolvido.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Encontre e corrija um erro do site no ar

Comece por uma ação do visitante que falhou e use o relatório para localizar a causa.

O monitoramento é útil quando liga um sintoma real a código que você consegue investigar. Esta página procura deliberadamente um elemento de contato inexistente, por isso a ação de contato falha.

Enviamos apenas um erro sintético fixo ao seu projeto Sentry. O relatório inclui uma identificação de versão e um local na pilha; o registro de incidente relaciona essas evidências ao que o visitante tentou fazer.

Exemplo resolvido

A página inicial carrega normalmente. Clicar em “Find contact section” (encontrar a seção de contato) falha porque o script procura #contact-missing, enquanto o HTML real tem id=contact.

Extra implementation exercise

Por que uma verificação HTTP 200 da página inicial não detecta este bug?

Mostrar uma solução comentada

O HTML pode carregar corretamente enquanto uma ação JavaScript posterior falha. Repita a tarefa de contato, não apenas a solicitação da página.

  • Testa a interação afetada depois do carregamento da página.
  • Distingue disponibilidade de funcionamento correto.

Etapa 2

Colete apenas contexto seguro e útil

Dê provas ao assistente sem dados privados de visitantes.

Dê ao assistente os arquivos, a versão e o sintoma da etapa anterior. É suficiente para começar a inspecionar o exemplo local sem enviar texto real de formulários ou informações de conta de visitantes.

Se usar o Sentry opcional, configure só seu valor público de loader e ative o monitoramento antes de reproduzir o erro controlado. Confira o evento correspondente e seus dados. Um evento aparecer no Sentry é diferente de um alerta chegar à caixa de entrada.

Um exemplo concreto

O erro permitido fornecido é “Practice: missing contact target”. Um evento útil pode incluir a versão de prática e o local no código sem mensagem real de usuário, endereço de e-mail ou token de conta.

Sentry: carregador de navegador e inicialização personalizada

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Envie um relatório de diagnóstico controlado

Colete o suficiente para investigar sem enviar conteúdo bruto do usuário.

Configure a URL pública do carregador conforme START-HERE.txt. O script define o callback de inicialização antes de carregar o SDK, desativa rastreamento e reprodução e usa uma lista de permissão beforeSend para este erro fixo de prática.

O evento de diagnóstico retornado exclui os dados da solicitação, os dados do usuário, os extras arbitrários e o histórico das ações anteriores ao erro (breadcrumbs). A consulta e o fragmento são removidos dos nomes de arquivo da pilha. Em um site real, revise todas as fontes de diagnóstico sensível; sendDefaultPii=false, sozinho, não garante que o texto livre ou as URLs não contenham informações pessoais.

O filtro beforeSend é estrito de propósito: só o texto sintético exato 'Practice: missing contact target' é enviado. As outras mensagens são descartadas. Se mudar o texto do erro, atualize a lista deliberadamente ou a ausência do evento é esperada. Não remova o filtro só para movimentar o painel; examine os dados permitidos em busca de informações indesejadas.

Se nenhum evento chegar, primeiro examine a mensagem fixa e a lista beforeSend em app.js. Um evento incompatível agora mostra uma mensagem local de evento filtrado; ele não é contado como enviado. O analisador de URL usa location.origin como base de nomes relativos e substitui um nome impossível de analisar por redacted em vez de encaminhar um original potencialmente sensível.

A opção documentada data-lazy="no" do carregador é definida por script.dataset.lazy="no"; ela pede para carregar o SDK completo antecipadamente. Os nomes de arquivo da pilha mantêm apenas origem e caminho HTTP(S) depois de remover consulta e fragmento. Esquemas não web são ocultados em vez de encaminhados intactos.

Exemplo resolvido

Uma mensagem fixa como “Practice: missing contact target” basta para este exercício. Enviar um objeto inteiro de formulário acrescentaria risco sem ajudar a identificar o destino DOM ausente.

Sentry: carregador de navegador e inicialização personalizada

Extra implementation exercise

Desativar dados pessoais padrão tornaria automaticamente seguro enviar mensagens arbitrárias de erro?

Mostrar uma solução comentada

Não. Revise os dados reais do evento e restrinja o que seu código envia. Informações pessoais podem aparecer em mensagens, URLs, breadcrumbs e extras mesmo sem a coleta padrão de dados pessoais.

  • Reconhece que textos e URLs da aplicação ainda podem conter dados privados.
  • Aplica ocultação e listas de permissão explícitas.

Etapa 3

Aplique uma correção pontual

Repita a ação exata que falhou após a alteração.

Peça ao assistente para comparar o destino do botão com a seção Contact existente. worked-solution/app.js contém a pequena correção; peça para aplicá-la e nomear a revisão corrigida practice-R2.

Abra practice-R2 atualizada e acione o mesmo botão. Deve chegar a Contact e mostrar “Contact section opened.” Só mudar a versão ou marcar o problema resolvido no Sentry não altera o comportamento do botão.

Um exemplo concreto

O script quebrado procura #contact-missing, mas o HTML define Contact em #contact. O assistente pode corrigir essa correspondência; você avalia usando o botão novamente.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Relacione o relatório, corrija a causa e teste novamente

Um rótulo de problema resolvido não corrige o código.

Ative o monitoramento, provoque a falha sintética e localize o evento real na sua conta. Compare a versão e o local com o código fornecido. Se não chegar, examine carregamento, bloqueadores, configuração e entrega pela rede antes de supor que não houve erro.

Substitua o script por worked-solution/app.js, atualize a identificação de versão e repita a ação de contato. O destino correto deve aparecer na área visível. Marcar o problema como resolvido no painel não substitui essa verificação de comportamento.

A troca do arquivo é uma pequena representação de correção no laboratório. Em um site de prática hospedado, registre o app.js e a versão alterados em um commit, revise e implante essa revisão e depois teste a URL pública. Atualizar apenas o estado do problema ou o rótulo da versão não aplica a correção do seletor.

Exemplo resolvido

R1 falha com #contact-missing; R2 usa #contact. A evidência relevante de recuperação é a ação de contato funcionar na revisão corrigida.

Extra implementation exercise

O problema está marcado como resolvido, mas o script implantado ainda consulta #contact-missing. Ele foi corrigido?

Mostrar uma solução comentada

Não. Um estado do painel não muda o script. Implante a correção pelo processo de revisão e verifique a ação naquela revisão.

  • Verifica o código e a revisão realmente implantados.
  • Repete a ação que falhava.

Etapa 4

Conclua uma nota útil de incidente

Mantenha sintoma, correção e verificação conectados.

Complete incident-record.txt com a falha original, a pequena correção e o resultado da ação repetida na página atualizada. Se publicar a mudança de prática, confira essa versão publicada exata, não apenas o arquivo local.

Separe as observações opcionais: se o evento chegou ao Sentry, se configurou um alerta e se a notificação chegou. O registro deve explicar essa tarefa corrigida e qualquer lacuna, não afirmar que o site inteiro não tem erros.

Um exemplo concreto

Uma nota curta relaciona a falha Contact de practice-R1, a correção do alvo e o teste bem-sucedido de practice-R2. “Problema resolvido”, sozinho, omite o resultado do visitante.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sua tarefa: escrever uma nota útil de incidente

Permita que a próxima pessoa entenda a causa e as evidências.

Preencha o registro com referência de evento sem dados sensíveis, ação afetada, local do código, causa raiz e teste bem-sucedido. Se configurar um alerta, verifique a notificação real separadamente da ingestão do evento.

Acrescente uma segunda falha sintética na sua cópia e repita o ciclo. Mantenha mensagens fixas e atualize a lista deliberadamente; não amplie o monitoramento enviando dados arbitrários de página ou formulário.

Exemplo resolvido

“Seletor ausente corrigido de #contact-missing para #contact; novo teste R2 passou” permite agir. “Sentry tinha um erro; resolvido” deixa a causa e a verificação desconhecidas.

O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.

Extra implementation exercise

Produza uma nota de incidente e prove que a ação corrigida funciona.

Mostrar uma solução comentada

Ative o carregador de prática configurado e provoque o erro sintético exato. Se mudar o texto, atualize a lista estrita intencionalmente; descartar uma mensagem não permitida é esperado. Examine o evento realmente recebido, sua versão, local e dados indesejados.

Aplique o script corrigido a public/app.js e mude RELEASE para practice-R2. Publique essa revisão pelo fluxo revisado e repita Find contact section na URL realmente implantada. Mudar apenas a versão ou o estado do problema não corrige o seletor.

Registre a ingestão do problema separadamente da entrega da notificação. O evento pode aparecer antes de um alerta configurado chegar; mantenha cada observação pendente até verificar. A nota de referência liga falha, local, mudança de seletor e novo teste visível ao usuário.

  • Liga sintoma, versão e causa no código.
  • Verifica o comportamento e mantém separadas as afirmações de entrega de evento e notificação.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.

Continue aprendendo

Explore as outras lições