Horizon, Pulse e Telescope: os painéis oficiais
O Horizon, o Pulse e o Telescope são os três painéis oficiais que você instala dentro da aplicação Laravel pelo Composer, cada um numa rota própria. O Horizon comanda os workers das filas no Redis e o Pulse junta medições de desempenho e uso, enquanto o Telescope grava cada requisição, consulta e job para você abrir um por um quando algo falha.
Ficha e sumário da página
- Referência técnica
- Laravel 13.42.0
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Três perguntas diferentes sobre a mesma aplicação
Os três painéis leem a mesma aplicação, mas respondem a perguntas diferentes. O Horizon mostra se a fila está andando: quantos jobs por minuto saem, quanto tempo cada um leva e quais falharam. O Pulse mostra onde a aplicação está lenta, com as rotas, os jobs e as consultas que mais demoram. O Telescope guarda o registro detalhado de cada evento, com a requisição completa, as consultas SQL que ela disparou e o e-mail que ela enviou.
Os três vivem dentro da própria aplicação como dependências do Composer. Cada um abre numa rota dela: /horizon, /pulse e /telescope. Fora do ambiente local, nenhum deles abre para qualquer visitante. Cada um traz um gate de autorização (viewHorizon, viewPulse e viewTelescope) num service provider, onde você define os usuários com acesso em produção.
Horizon: a fila no Redis com painel
O Laravel processa filas com o comando php artisan queue:work, um worker por processo. O Horizon troca essa configuração espalhada por um arquivo só, o config/horizon.php, versionado com o código. Nele, cada ambiente declara os seus supervisores, com o número máximo de processos e as filas que eles atendem. O mesmo arquivo pode definir 10 processos em production e 3 em local, conforme o exemplo da documentação.
Na VPS, um único comando, php artisan horizon, inicia todos os supervisores do ambiente atual, lido do APP_ENV. O painel em /horizon acompanha a vazão, o tempo de execução e as falhas de cada fila. O Horizon exige o Redis como conexão da fila e não funciona com o Redis Cluster:
Despacho
SendInvoice::dispatch()O controller coloca o job na fila e responde sem esperar.
Fila no Redis
QUEUE_CONNECTION=redisO job espera na fila, que o Horizon exige no Redis.
Supervisor
config/horizon.phpO Horizon distribui os jobs entre os processos do ambiente.
Worker
php artisan horizonO processo executa o job e marca sucesso ou falha.
Registro
/horizonO Horizon mede vazão e falhas, o Pulse marca jobs lentos e o Telescope grava o job.
O painel também guarda os jobs que falharam com a exceção e os parâmetros. Os comandos horizon:pause e horizon:continue param e retomam o processamento sem derrubar o processo, útil durante a manutenção de um serviço externo.
Pulse: desempenho e uso de relance
O Pulse grava medições agregadas, não eventos completos. O painel em /pulse é feito de cards: uso dos servidores, uso da aplicação por usuário, exceções, filas, requisições lentas, jobs lentos, consultas lentas, requisições HTTP de saída lentas e cache. Uma rota que demora dois segundos para responder aparece no card de requisições lentas, com o número de ocorrências no período escolhido.
A maior parte das medições vem dos eventos que o próprio Laravel dispara, sem código extra. O card de servidores é a exceção: ele depende do comando php artisan pulse:check rodando em cada servidor, que mede processador, memória e disco. O armazenamento oficial do Pulse exige MySQL, MariaDB ou PostgreSQL. Uma aplicação com outro banco precisa de um desses à parte, só para as tabelas do Pulse.
O painel é feito em Livewire. A disposição dos cards fica numa view publicada em resources/views/vendor/pulse/, que você edita para trocar a ordem ou o tamanho de cada card sem compilar JavaScript.
Telescope: o registro de cada evento
O Telescope foi pensado como companheiro do desenvolvimento local. Ele registra as requisições, as exceções, as entradas de log, as consultas ao banco, os jobs da fila, os e-mails, as notificações, as operações de cache, as tarefas agendadas e os dumps de variável. Cada item abre com os detalhes registrados pelo watcher correspondente: no registro da requisição, você consulta os cabeçalhos, a sessão e a resposta. As consultas SQL têm registros próprios no Query Watcher.
A documentação apresenta a instalação comum com composer require laravel/telescope e uma opção só para o ambiente local, com --dev. Na opção local, você também condiciona o registro dos service providers ao ambiente local, conforme o exemplo oficial. Assim, o servidor de produção pode instalar as dependências sem carregar o Telescope. Na instalação comum, o filtro padrão registra todos os eventos no ambiente local. Nos demais ambientes, ele retém exceções, jobs falhos, tarefas agendadas e eventos com tags monitoradas.
Qual painel entra no seu projeto
Uma aplicação com fila no Redis ganha mais com o Horizon, porque ele substitui a configuração dos workers e mostra as falhas num lugar só. O Pulse cabe em produção para acompanhar a lentidão ao longo do tempo, porque guarda só medições agregadas. O Telescope responde melhor no desenvolvimento, quando você precisa ver exatamente o que uma requisição fez.
Os três convivem na mesma aplicação, cada um na própria rota e com o próprio gate. Nenhum deles publica a aplicação num servidor: essa parte fica com as plataformas de deploy, assunto de Forge, Vapor e Cloud.