> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/configuracoes/configuracoes-globais/sistema/painel-de-jobs-bullmq.md).

# 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:

| Página    | Para que serve                                                                                |
| --------- | --------------------------------------------------------------------------------------------- |
| 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).

| Indicador  | O que significa                                              |
| ---------- | ------------------------------------------------------------ |
| 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

| Ação                             | Efeito                                                 |
| -------------------------------- | ------------------------------------------------------ |
| 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.

| Recurso             | Função                                            |
| ------------------- | ------------------------------------------------- |
| 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:

| Alerta             | Quando aparece                                      | Severidade                      |
| ------------------ | --------------------------------------------------- | ------------------------------- |
| 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.