Filas e pub/sub nos apps
Uma fila no Redis é uma chave que guarda as tarefas gravadas pelo app web até um worker, em outro processo, retirar e executar cada uma. O app responde ao navegador assim que grava a tarefa, enquanto o Redis repassa cada tarefa a um só worker, por isso um pico de mensagens no Chatwoot ou de execuções no n8n espera na fila até um worker ficar livre.
Ficha e sumário da página
- Referência técnica
- Redis 8.10.3
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Por que os apps põem uma fila no meio
Enviar um e-mail, baixar um anexo do WhatsApp ou rodar um workflow com dez Nodes leva de segundos a minutos. Se o processo web fizesse esse trabalho dentro da requisição, o navegador esperaria até o fim, enquanto um pico de mensagens ocuparia todos os processos web de uma vez. A fila tira esse trabalho da requisição: os workers executam as tarefas em outro processo, pela ordem das filas, no ritmo que a VPS aguenta.
O Redis cumpre bem esse papel por dois motivos. A gravação e a retirada são comandos únicos, que o servidor aplica por inteiro, de modo que dois workers não recebem a mesma tarefa da lista. O worker também espera na conexão com comandos como BRPOP, que só respondem quando chega uma tarefa ou quando o prazo acaba, sem consultar o Redis em laço.
Chatwoot: o Sidekiq e as filas por prioridade
O Chatwoot é um app Rails com as tarefas em segundo plano no Sidekiq, num container separado do serviço web. O Sidekiq grava cada tarefa com LPUSH numa lista queue:<nome> e o worker retira com BRPOP, esperando até dois segundos por chamada, valor fixo no arquivo fetch.rb do Sidekiq.
O arquivo config/sidekiq.yml do Chatwoot declara 18 filas em ordem, começando por critical, high, medium e default, com mailers e low mais abaixo. Como as filas não têm pesos, o comentário do próprio arquivo explica a consequência: uma fila de posição mais baixa só é atendida quando as de cima estão vazias, de modo que um volume grande na critical deixa a low esperando. A concorrência padrão é de dez tarefas por processo, ajustável pela variável SIDEKIQ_CONCURRENCY.
n8n: o modo fila com workers
O n8n usa o Redis só no modo fila, ligado pela variável EXECUTIONS_MODE=queue na instância principal e em cada worker. A documentação oficial descreve o percurso de uma execução assim:
Instância principal
EXECUTIONS_MODE=queueRecebe o gatilho, como um webhook ou um timer. Gera a execução sem rodar o workflow.
Fila no Redis
QUEUE_BULL_REDIS_HOSTRecebe o ID da execução e guarda a fila de execuções pendentes.
Worker
n8n workerO próximo worker livre retira o ID da fila.
Banco de dados
O worker lê o workflow pelo ID e grava o resultado da execução.
Aviso de fim
O worker avisa o Redis que terminou. O Redis notifica a instância principal.
Dois detalhes da documentação explicam falhas comuns nessa montagem. Todos os workers precisam da mesma chave de criptografia da instância principal, porque leem do banco as credenciais cifradas por ela. O n8n também procura o Redis, por padrão, em localhost na porta 6379, sem senha, de modo que num Compose a variável QUEUE_BULL_REDIS_HOST precisa apontar para o nome do serviço do Redis. Cada worker é um processo Node.js capaz de rodar várias execuções ao mesmo tempo, por isso você aumenta a capacidade acrescentando workers.
Laravel: a conexão redis das filas
O Laravel oferece uma API única de filas sobre vários backends, como o banco de dados, o Amazon SQS e o Redis. Com QUEUE_CONNECTION=redis, os jobs vão para o Redis pela conexão default do config/database.php. O comando php artisan queue:work roda o worker que retira e executa os jobs. A opção --queue=high,default define a ordem das filas que o worker atende, no mesmo espírito das prioridades do Sidekiq.
A documentação do Laravel registra dois limites da conexão redis nas filas. As opções serializer e compression do cliente Redis não funcionam no driver de fila. Num Redis Cluster, o nome da fila precisa de uma hash tag, como {default}, para todas as chaves da fila caírem no mesmo slot. Para acompanhar as filas por um painel, o Laravel tem o Horizon, feito para filas no Redis.
Pub/sub: aviso para vários, sem guardar nada
No pub/sub, cada mensagem vai para vários destinos de uma vez: quando um processo publica uma mensagem num canal com PUBLISH, o Redis repassa a mensagem, no mesmo instante, a todos os clientes inscritos naquele canal com SUBSCRIBE. Ninguém retira a mensagem, que também não fica guardada no Redis. A documentação classifica esse comportamento como at-most-once, no máximo uma vez: um assinante desconectado durante a publicação perde a mensagem.
Fila em lista
- Cada tarefa vai para um único worker.
- A tarefa espera na lista até um worker retirar.
- Um worker parado não perde tarefas, que acumulam na lista.
- Uso nas stacks: Sidekiq, n8n e filas do Laravel.
Pub/sub em canal
- Cada mensagem vai para todos os inscritos.
- A mensagem existe só no instante da publicação.
- Um assinante desconectado perde o que foi publicado.
- Uso nas stacks: ActionCable do Chatwoot.
O Chatwoot usa o pub/sub no ActionCable, configurado com o adaptador redis no config/cable.yml. Quando o worker do Sidekiq registra uma mensagem nova, o Rails publica o aviso num canal do Redis, de onde o processo web que mantém a conexão do navegador do atendente recebe o aviso e atualiza a tela. Uma mensagem perdida ali só atrasa a atualização da tela, porque a conversa já está gravada no PostgreSQL.
Quando a mensagem precisa ficar guardada até um consumidor confirmar o processamento, a documentação do pub/sub indica os streams, que gravam cada entrada num log e aceitam grupos de consumidores com confirmação por XACK. Como uma fila também precisa sobreviver a um reinício do Redis, a página Persistência: RDB e AOF mostra quanto de escrita cada modo de gravação em disco preserva.