Capture o contexto
Horario, rota, usuario, origem, versao, ambiente e impacto real.
Evidencias tecnicas
Antes de corrigir, colete sinais que tornam a correcao menos arriscada.
Esta biblioteca organiza o que guardar em relatos, APIs, logs, deploy, navegador, formulario, SMTP, DNS, campanhas, SEO, seguranca e IA para que a investigacao saia da opiniao e entre no terreno dos fatos.
Como pensar
Evidencia nao e burocracia. E o antidoto contra tentativa e erro.
O objetivo nao e criar um dossie enorme. E guardar o minimo suficiente para entender alcance, causa provavel, impacto, versao, rota e proximo passo seguro.
Proteja dados sensiveis
Remova senha, token, cookie, segredo, e-mail privado e dado pessoal desnecessario.
Use a evidencia
Leve o registro para playbook, priorizador, checklist, modelo ou diagnostico tecnico.
Biblioteca de evidencias
O que coletar em cada tipo de problema.
Use os cards como guia de investigacao. Cada item mostra quando coletar, o que guardar, o que evitar e onde usar a evidencia depois.
Relato do usuario e contexto do sintoma
Quando o problema chega como relato solto: esta lento, nao abre, deu erro, nao recebi e-mail ou a campanha nao converteu.
Coletar
- Pagina, rota ou fluxo afetado
- Horario aproximado e recorrencia
- Usuario, perfil ou origem do acesso quando fizer sentido
- Mensagem de erro visivel e passo a passo ate o problema
- Impacto percebido: lead perdido, compra travada, tela indisponivel ou lentidao
Evitar
- Tratar "esta lento" como causa tecnica confirmada
- Pedir senha ou dado sensivel em print
- Comecar corrigindo sem saber se o problema e geral ou isolado
Como registrar
Uma linha de incidente com data, fluxo, sintoma, impacto, evidencias recebidas e quem reportou.
Como usar depois
Usar o relato para escolher playbook, priorizar urgencia e decidir quais logs ou testes coletar depois.
Evidencias HTTP e API
Quando uma API retorna erro, lentidao, resposta inesperada, problema de autenticacao ou comportamento diferente entre local e producao.
Coletar
- Metodo, URL, status HTTP e tempo de resposta
- Headers importantes, sem expor tokens
- Payload usado no teste, mascarando dados sensiveis
- Resposta de erro e identificador de correlacao quando existir
- Ambiente testado: local, homologacao, producao, container ou dominio publico
Evitar
- Colar token real em chamado ou documentacao
- Medir apenas pelo navegador sem conferir a chamada real
- Comparar local e producao sem conferir variaveis e base URL
Como registrar
Um bloco curto com endpoint, status, tempo, request anonimizado, response e ambiente.
Como usar depois
Comparar com logs de backend, banco, proxy e deploy para confirmar onde a falha começa.
Logs de backend, proxy e container
Quando existe erro 500, lentidao, falha de SMTP, problema de rota, deploy recente ou comportamento diferente em producao.
Coletar
- Trechos de log do horario do problema
- Stack trace completo quando houver excecao
- ID do container, imagem, commit ou versao publicada
- Logs do Nginx/proxy quando o erro acontece antes da aplicacao
- Eventos de restart, falta de memoria, permissao ou variavel ausente
Evitar
- Apagar container ou reiniciar tudo antes de salvar log minimo
- Publicar log com senha, token ou dados pessoais
- Ficar apenas no ultimo erro se ha uma causa anterior no log
Como registrar
Um recorte com horario, origem do log, erro principal, erro anterior e acao executada.
Como usar depois
Separar causa provavel de causa confirmada e registrar o incidente com evidencia verificavel.
Deploy, ambiente e configuracao
Quando uma publicacao terminou, mas algo que deveria estar funcionando em producao ficou quebrado ou diferente.
Coletar
- Commit, tag, imagem ou artefato publicado
- Horario do deploy e quem executou
- Variaveis alteradas, sem registrar valores secretos
- Rotas e arquivos tecnicos validados depois da publicacao
- Plano de rollback e evidencia de que ele ainda funciona
Evitar
- Misturar mudanca de codigo, DNS, proxy e banco sem registro
- Executar hotfix sem saber qual versao esta no ar
- Deixar pagina nova fora de sitemap, busca interna ou mapa do site
Como registrar
Uma validacao pos-deploy com versao, checklist, rotas testadas, logs iniciais e decisao de manter ou voltar.
Como usar depois
Decidir entre rollback, hotfix curto, ajuste de proxy ou correcao de rota com base no impacto real.
Navegador, frontend e rotas publicas
Quando uma pagina carrega parcialmente, um botao nao responde, uma rota React volta para home ou um recurso visual nao aparece.
Coletar
- URL exata e caminho de navegacao ate o erro
- Console do navegador e aba Network da requisicao afetada
- Status de arquivos JS, CSS, imagens e chamadas de API
- Viewport usado: desktop, mobile, navegador e zoom
- Print somente quando nao expuser dado sensivel
Evitar
- Concluir que e bug de backend antes de olhar Network
- Testar apenas uma tela se o problema depende de mobile ou menu
- Enviar print com e-mail, telefone, token ou informacao privada
Como registrar
Um registro com URL, navegador, console, request com erro, status HTTP e evidencia visual quando util.
Como usar depois
Separar problema de rota SPA, build, cache, asset, API, CSS ou permissao.
Formulario, SMTP e e-mail de notificacao
Quando o formulario salva contato, mas e-mail nao chega, chega sem origem ou o provedor rejeita remetente.
Coletar
- ID do contato salvo e horario do envio
- Origem da pagina, interesse e parametros UTM
- From, Reply-To e destinatario usados pela aplicacao
- Mensagem de erro SMTP completa
- Host, porta, SSL e autenticacao esperados, sem expor senha
Evitar
- Usar e-mail do visitante como remetente autenticado
- Salvar senha real em application.yml ou documentacao publica
- Trocar DNS de e-mail sem conferir MX, SPF, DKIM e provedor atual
Como registrar
Um teste de formulario com contato salvo, origem, UTM, log SMTP e resultado do recebimento.
Como usar depois
Corrigir remetente, reply-to, senha, SSL, DNS ou monitoramento antes de alterar campanha.
DNS, Cloudflare, Nginx e SSL
Quando dominio, subdominio, e-mail, SSL, redirecionamento, proxy ou rota publica se comporta de forma diferente do esperado.
Coletar
- Registros DNS alterados e horario da mudanca
- Status de proxy, TTL e destino do registro
- Resposta HTTP com e sem www quando aplicavel
- Certificado SSL, host servido e redirecionamentos
- Logs de Nginx para o host afetado
Evitar
- Apontar registro mail para proxy HTTP
- Misturar mudanca de site e e-mail sem conferir MX
- Remover entrada antiga antes de confirmar propagacao e rota nova
Como registrar
Um quadro com dominio, tipo de registro, destino, proxy, TTL, status HTTP e impacto em site/e-mail.
Como usar depois
Separar problema de DNS, proxy, container, aplicacao, certificado ou provedor de e-mail.
Campanhas, tags, UTMs e conversao
Quando Google Ads, Analytics, Tag Assistant, formulario ou e-mail mostram sinais diferentes sobre a mesma visita.
Coletar
- URL final com parametros UTM
- Evento visto no Tag Assistant
- Contato recebido com origem e campanha
- Pagina de destino usada no anuncio
- Horario do teste e navegador usado
Evitar
- Aumentar orcamento antes de validar conversao
- Criar multiplas tags duplicadas sem entender qual dispara
- Testar campanha sem URL final e sem formulario real
Como registrar
Um teste de campanha com URL, evento, contato recebido, UTM, print do Tag Assistant e conclusao.
Como usar depois
Ajustar tag, evento, UTM, formulario ou pagina de destino antes de mexer em lance e segmentacao.
SEO tecnico, sitemap e indexacao
Quando uma pagina importante foi publicada, mas nao aparece no sitemap, busca interna, Search Console ou caminhos de navegacao.
Coletar
- Status HTTP da pagina em producao
- Canonical, title, description e robots
- Presenca no sitemap.xml e mapa do site
- Links internos que chegam ate a pagina
- Resultado da busca interna por termos relevantes
Evitar
- Pedir revisao do AdSense com paginas novas escondidas
- Criar pagina sem entrada de descoberta real
- Usar schema que nao corresponde ao conteudo visivel
Como registrar
Uma validacao editorial com rota, sitemap, busca interna, links, schema e proximo passo de indexacao.
Como usar depois
Corrigir descoberta interna e solicitar indexacao quando a pagina estiver completa em producao.
Seguranca, IA e dados sensiveis
Quando existe segredo exposto, automacao com IA, RAG, documento sensivel ou codigo gerado sem revisao clara.
Coletar
- Tipo de dado ou segredo envolvido
- Fonte usada pela IA ou automacao
- Permissao de leitura e escopo de acesso
- Perguntas de teste e resposta esperada
- Registro de revisao humana
Evitar
- Colar dado sensivel em prompt sem criterio
- Usar documento sem origem ou sem data como fonte confiavel
- Aceitar codigo gerado por IA sem teste, revisao e contexto
Como registrar
Um mapa de fonte, permissao, limite, teste e revisao antes de automatizar fluxo critico.
Como usar depois
Definir se o caso pede bloqueio, ajuste de permissao, base confiavel, revisao humana ou adiamento da automacao.
Perguntas comuns
Boa evidencia deixa a conversa tecnica mais curta.
Quando o registro ja traz horario, rota, status, log e impacto, a investigacao comeca melhor e tende a mexer menos no que nao precisa.
Evidencia tecnica precisa ser perfeita?
Nao. Ela precisa ser suficiente para reduzir tentativa e erro: horario, rota, sintoma, log, status, versao e impacto ja mudam a qualidade da investigacao.
Posso enviar prints e logs completos?
Pode quando forem necessarios, mas antes remova senhas, tokens, dados pessoais, cookies, e-mails sensiveis e qualquer segredo de ambiente.
Qual evidencia coletar primeiro em producao?
Comece pelo impacto, horario, rota afetada, status HTTP, log do periodo e mudanca recente. Depois aprofunde em banco, proxy, SMTP, DNS ou tag conforme o sintoma.