Diagnóstico do Sistema
v2/diagnostico
5 min de leitura
Uma página de leitura com a saúde técnica da instalação do SNDesk: versão, migrations, banco, filas, tempo real, erros recentes, logs e ambiente. Serve para o suporte e para a equipe de implantação responderem rápido "está tudo certo para usar?".
Antes de começar
| O que | Depende de |
|---|---|
| Abrir a tela | usuário administrador |
| Item no menu | não há: a tela é aberta pelo endereço |
v2/diagnostico responde "página não encontrada" (e não "acesso negado"), para não revelar que a página existe.Onde fica
Digite o endereço v2/diagnostico depois do domínio da sua empresa (por exemplo, https://suaempresa.sndesk.com.br/v2/diagnostico). A versão anterior da mesma página continua em /diagnostico, na interface V1.
O que você vê, de cima para baixo
- Título com os botões Copiar resumo e Atualizar.
- Faixa da versão: a versão do SNDesk, o ambiente, a data e hora em que a página foi gerada e o lembrete "rota escondida · somente leitura".
- Semáforo: uma fileira de indicadores coloridos (verde, amarelo, vermelho) para Migrations, Banco, Filas, Reverb (tempo real), Falhas 24 h e Disco. Clicar em um leva ao cartão correspondente.
- Cartões, que carregam um a um conforme aparecem na tela:
- Versão e Git: branch, tag, commit, divergência do servidor de origem; Ver remotes e versão do git.
- Migrations: executadas, pendentes (com a lista) e as últimas executadas.
- Banco de dados: conexão, versão, tamanho e as maiores tabelas.
- Filas Redis: por fila, os jobs pendentes, atrasados (Delayed) e reservados, e os erros recentes do worker. Clique no número para ver os jobs.
- Reverb: a configuração do servidor de tempo real (com a chave mascarada) e o botão Testar publicação.
- Últimos erros do Laravel: os erros mais recentes do registro da aplicação, com Copiar.
- Falhas de fila: total nas últimas 24 horas e 7 dias, por fila, e as últimas falhas.
- Logs: a lista de arquivos de registro; clique em um para ver as últimas 100 linhas.
- Ambiente: se o modo de depuração está ligado, disco livre e total, cache de configuração e de rotas, e a linha chaves compartilhadas: se a instalação leu as chaves comuns do servidor (inteligência artificial, mapas, suporte) e quantas delas a instalação substituiu por uma chave própria. Os valores nunca aparecem.
- Aplicação: versões, fuso horário, cache, sessão, fila e extensões.
- Composer: os pacotes de destaque; Ver pacotes instalados.
Senhas, tokens e chaves aparecem sempre mascarados, nos cartões e nos logs.
Copiar o resumo
Copiar resumo monta um texto curto com versão, ambiente, endereço, branch e commit, migrations pendentes, filas, falhas das últimas 24 horas e disco, e copia para a área de transferência. Se o navegador bloquear a cópia, o texto aparece numa caixa logo abaixo da faixa da versão, pronto para selecionar. É o texto para colar no chamado de suporte ou no chat da equipe depois de uma atualização.
Atualizar e testar
- Atualizar recarrega a página inteira. Cada cartão também tem a sua recarga, e um cartão que falhou mostra Tentar de novo: o erro fica contido nele, sem derrubar os outros.
- Testar publicação, no cartão Reverb, envia uma mensagem de teste pelo servidor de tempo real e mostra o resultado numa linha do tempo (as cinco últimas tentativas desta visita). Use quando notificações, chat ou painéis deixarem de atualizar sozinhos. O teste só acontece no clique; a tela nunca repete sozinha.
Exemplos práticos
Situação: depois de uma atualização, uma tela nova dá erro. O que fazer: abra v2/diagnostico, olhe o chip Migrations e o cartão Últimos erros do Laravel; clique em Copiar resumo. Resultado: você sabe se faltou rodar alguma migration e já tem o resumo para mandar ao suporte.
Situação: os técnicos dizem que as notificações e o chat pararam de chegar em tempo real. O que fazer: cartão Reverb > Testar publicação. Resultado: a linha do tempo mostra se a publicação funcionou; se falhou, o problema está no servidor de tempo real, não nas telas.
Situação: e-mails de abertura de chamado não estão saindo. O que fazer: olhe o chip Filas e o cartão Falhas de fila. Resultado: um backlog alto ou falhas recentes na fila de e-mail indicam que o worker parou.
Perguntas frequentes
Por que a página demora para carregar tudo? Cada cartão busca a sua parte só quando aparece na tela. Alguns, como Git e Logs, levam alguns segundos.
Posso estragar algo clicando aqui? Não. Tudo é leitura. O único botão que envia algo é Testar publicação, que manda uma mensagem de teste pelo tempo real e não grava nada no sistema.
Um técnico pode ver esta página? Não. Só administradores; para os demais, o endereço responde "página não encontrada".
Limites e comportamentos que não são defeito
- Não há item no menu nem atalho no sistema: o endereço é passado pelo suporte.
- Os números são uma foto do momento em que cada cartão carregou. Para ver de novo, use Atualizar ou a recarga do cartão.
- Os cartões técnicos (Git, Composer, Filas, Logs) são pensados para o suporte e a implantação. Para o uso do dia a dia, o que importa é o semáforo estar verde.