Diagnóstico por sintoma¶
Comece por evidências, não por restart. Registre ambiente, versão, horário/fuso, loja/merchant_id, operação e request_id ou job ID. Não cole credenciais, mensagens pessoais ou payloads completos em tickets.
Primeiras consultas de produção¶
Com kubeconfig autorizado, confira contexto e use consultas de leitura:
kubectl config current-context
kubectl -n flow-prd get deployments,statefulsets,pods,jobs,ingress
kubectl -n flow-prd get events --sort-by=.lastTimestamp
kubectl -n flow-prd logs deployment/frontend-entrypoint --since=15m --tail=200
Respeite permissões e privacidade dos logs. Para HML isolada/autorizada, substitua o namespace; não a reative para diagnosticar produção.
Caminho de investigação¶
| Sintoma | Primeiro conferir | Próximo passo seguro |
|---|---|---|
| WhatsApp não responde | Evento no whatsapp-entrypoint, número/loja, status comercial, subscription e permissões |
Acompanhar B2B/B2C e erro de envio; separar recebimento, processamento e entrega |
| Produto não aparece | Produto publicado, loja selecionada e índice correspondente | Conferir webhook/sync e embeddings; sincronização |
| Frete/pagamento falha | WooCommerce, plugins, credenciais, endereço e dimensões | Diagnóstico individual autorizado; não repetir pedidos sem necessidade |
| E-mail não chega | Destinatário, remetente autorizado e SMTP efetivo | Conferir envio e entrega no provedor, sem disparar convites em massa |
| Campanhas não atualizam | Loja/base, importação/recálculo e tarefa em andamento | Conferir marketing-campaigns e persistência; editar texto não recalcula segmentação |
| Painel em branco | /login, carregamento JS/CSS e MIME |
Seguir cache do painel; evitar limpeza global da zona |
| Pipeline pending | Tags, runner online, proteção do MR/branch e capacidade | Logs do runner autorizado; não alterar runner compartilhado sem avaliar alcance |
| Rollout falha | Eventos, readiness, imagem/pull e recursos | Logs/describe do workload; não remover PVC nem refazer bootstrap |
| Healthcheck inconclusivo | Job, resultado anterior e reserva por loja | Aguardar proteção; não apagar locks nem repetir efeitos automaticamente |
| Docs não publicam | Build, flag, token e projeto Pages | Publicação dos docs; não executar deploy da aplicação |
Decisão e encerramento¶
- Diferencie configuração, falha externa, dados desatualizados e regressão.
- Identifique o menor recurso afetado e quem autoriza a mudança.
- Registre resultado esperado e forma de validação.
- Execute apenas a correção aprovada e confira o fluxo funcional.
Pipeline vermelha depois da atualização não significa deploy desfeito. Confira versão efetiva. Rollback usa rollback_production, conforme produção; não reverte banco nem cancela pedidos/mensagens enviados.
Registre causa, alteração, validação, impacto e prevenção. Restauração de dados é separada: backup e recuperação.