V2

Diagnóstico do Sistema

Configuração 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 queDepende de
Abrir a telausuário administrador
Item no menunão há: a tela é aberta pelo endereço
A rota é escondida de propósito. Para quem não é administrador, v2/diagnostico responde "página não encontrada" (e não "acesso negado"), para não revelar que a página existe.
A tela é somente leitura. Nenhuma seção se atualiza sozinha e nenhum teste roda sem um clique seu.

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

  1. Título com os botões Copiar resumo e Atualizar.
  2. 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".
  3. 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.
  4. 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.

Relacionado