
Minilição 30 de 30 · Operar e manter seu site
Experimente a ação do visitante
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.
Uma página pode abrir enquanto sua funcionalidade útil está quebrada.
Objetivo desta lição
- 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.
Explicação, exemplo resolvido e prática
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.
Confira os conhecimentos iniciais
São habilidades úteis, não cursos obrigatórios bloqueados. Se já as domina, comece aqui; caso contrário, abra a preparação. Os arquivos fornecidos dispensam um site pessoal anterior.
- Como publicar seu site pelo GitHub
Conecte um repositório de prática à hospedagem.
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.
Entenda a ideia
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
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
O que falhou quando você experimentou a ação de visitante fornecida?
Mostrar uma solução comentada
No caso practice-R1 fornecido, pressionar “Find contact section” falha e a página mostra o erro intencional da prática. Esperava chegar a Contact. A página carregou, então conferir só sua disponibilidade não detectaria o problema do botão.
O que uma boa resposta inclui
- Identifica o botão real, o resultado Contact esperado e a falha visível.
- Distingue a ação do visitante com falha do carregamento normal da página.
Como funciona (opcional)
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.
Exercício técnico complementar
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 1 · Como encontrar e corrigir erros no seu site no ar
Colete apenas contexto seguro e útil
Dê provas ao assistente sem dados privados de visitantes.
Explicação, exemplo resolvido e prática
Entenda a ideia
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.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Que contexto você compartilhará e que dados privados excluirá?
Mostrar uma solução comentada
Eu compartilharia os arquivos practice-R1, a ação “Find contact section” e sua falha. Com monitoramento, procuraria “Practice: missing contact target” e a versão correspondente no projeto de teste. Excluiria e-mails, textos e tokens; o alerta por e-mail é outra verificação.
O que uma boa resposta inclui
- Compartilha a ação fictícia reproduzível, a versão de prática e o contexto relevante dos arquivos.
- Exclui conteúdo real dos visitantes e distingue eventos recebidos de alertas entregues.
Como funciona (opcional)
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
Exercício técnico complementar
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 2 · Como encontrar e corrigir erros no seu site no ar
Aplique uma correção pontual
Repita a ação exata que falhou após a alteração.
Explicação, exemplo resolvido e prática
Entenda a ideia
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
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
O que mudou e o que aconteceu quando você repetiu a ação original?
Mostrar uma solução comentada
Na solução, o assistente troca o alvo ausente pela seção existente #contact e identifica practice-R2. O novo teste esperado é o mesmo botão chegar a Contact e mostrar “Contact section opened.” Um rótulo resolvido sem esse teste não comprova a correção.
O que uma boa resposta inclui
- Relaciona a pequena correção de destino à seção Contact existente.
- Repete a mesma ação na versão atualizada e verifica o resultado visível ao usuário.
Como funciona (opcional)
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.
Exercício técnico complementar
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 3 · Como encontrar e corrigir erros no seu site no ar
Conclua uma nota útil de incidente
Mantenha sintoma, correção e verificação conectados.
Explicação, exemplo resolvido e prática
Entenda a ideia
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
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Apresente o registro do incidente e a verificação real da ação corrigida.
O que entregar: Um breve registro de incidente com sintoma reproduzido, alteração delimitada e novo teste real bem-sucedido.
Mostrar uma solução comentada
Registro ilustrativo de incidente: Contact em practice-R1 informou falha; o assistente corrigiu o alvo; em practice-R2, o mesmo botão chegou à seção e mostrou sucesso. O evento fictício foi verificado separadamente no monitoramento de teste. Nenhuma regra de alerta foi configurada, então a entrega de notificação não foi testada. Isso cobre esse defeito Contact, não todos os erros futuros.
O que uma boa resposta inclui
- Relaciona sintoma original, mudança pontual e teste real da mesma ação na versão identificada.
- Separa observações de evento/alerta do provedor e identifica qualquer cobertura ainda não testada.
Como funciona (opcional)
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.
Exercício técnico complementar
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.