Painel de Jobs BullMQ
O Painel de Filas é a tela técnica de acompanhamento dos jobs do sistema: envios de campanha, mensagens agendadas, limpezas automáticas, verificações periódicas. É onde se olha quando algo "não saiu" ou quando se quer confirmar que a operação automática está rodando.
Não confunda com o Painel de Atendimentos (supervisão de tickets). Aqui não há conversas — só o motor por trás delas.
Caminho: Configurações → Globais → Sistema → Painel de Filas → botão Abrir painel
Perfil típico: admin master (a tela pede login próprio).
[[FOTO]]
Acesso
O painel tem login separado do sistema, definido em Configurações → Globais → Sistema → Painel de Filas. Ali você escolhe usuário e senha, salva, e o acesso passa a valer imediatamente.
O navegador guarda esse login até você fechar as abas do site. Para trocar de usuário, feche o site ou use uma janela anônima.
O que você vê na tela
O painel tem cinco páginas, acessíveis pela barra superior:
Dashboard
Lista todas as filas com seus jobs — permite abrir um job e ver o erro em detalhe
Métricas
Números de cada fila (aguardando, ativos, completos, falhados, atrasados) e saúde do processo
Controles
Pausar, retomar e limpar filas
Logs
Últimas linhas do log real do sistema, com filtro por nível e busca
Alertas
Diagnóstico automático: o que precisa de atenção agora
Todas as páginas se atualizam sozinhas a cada 5 segundos.
[[FOTO]]
Métricas
Um cartão por fila, mais um cartão de Sistema (tempo no ar, memória, versão).
Aguardando
Jobs na fila esperando processamento
Ativos
Sendo processados agora
Completos
Concluídos com sucesso (mantidos por um tempo para consulta)
Falhados
Deram erro — clique no Dashboard para ver o motivo
Atrasados
Agendados para rodar mais tarde (normal em jobs recorrentes)
Fila com aguardando alto e ativos zerado por muito tempo indica processamento travado.
[[FOTO]]
Controles
Pausar todas / Retomar todas
Interrompe ou retoma o processamento de todas as filas
Pausar / Retomar fila específica
Mesmo efeito, só na fila escolhida
Limpar jobs antigos
Remove histórico antigo de concluídos e falhados
Limpar jobs falhados
Descarta os jobs com erro
Limpar jobs completos
Descarta o histórico de sucesso
Pausar uma fila não perde mensagens: os jobs ficam acumulados e voltam a ser processados ao retomar. Já as limpezas são irreversíveis.
O cartão Resumo rápido mostra os totais consolidados de todas as filas.
[[FOTO]]
Logs
Mostra as últimas linhas dos logs reais do sistema, coloridas por nível.
Filtro por nível
Erros, avisos, info, debug
Busca por texto
Filtra as linhas que contêm o termo
Pausar auto-refresh
Congela a tela para você ler com calma
Baixar .txt
Exporta o que está em tela para enviar ao suporte
[[FOTO]]
Alertas
Diagnóstico calculado na hora, sem configuração. As regras:
Jobs falhados
Existe job com erro na fila
Aviso (a partir de 20, crítico)
Backlog alto
100 ou mais jobs aguardando
Aviso (500 ou mais, crítico)
Fila pausada
A fila está parada
Aviso
Agendamento parado
Uma rotina recorrente deixou de disparar no horário
Crítico
No topo ficam os contadores de críticos, avisos e filas saudáveis. Sem nenhum alerta, a tela informa que está tudo certo.
[[FOTO]]
Regras importantes
Tela técnica: mexer em Controles afeta o sistema inteiro, não só um tenant.
Pausar filas interrompe envios de campanha e mensagens agendadas até retomar.
As limpezas apagam histórico e não têm desfazer.
"Agendamento parado" é o alerta mais sério: significa que uma rotina automática deixou de rodar.
Dicas de uso
Antes de abrir chamado por "campanha não enviou", olhe Alertas e Métricas da fila de campanha.
Fila com falhados: abra o job no Dashboard para ler a mensagem de erro exata.
Use Baixar .txt dos Logs ao acionar o suporte — economiza uma ida e volta.
Troque a senha do painel em Configurações → Globais → Sistema → Painel de Filas sempre que alguém sair da equipe técnica.
Atualizado