Ir para o conteúdo
Promovaweb

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
  1. Três perguntas diferentes sobre a mesma aplicação
  2. Horizon: a fila no Redis com painel
  3. Pulse: desempenho e uso de relance
  4. Telescope: o registro de cada evento
  5. Qual painel entra no seu projeto

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:

  1. Despacho

    SendInvoice::dispatch()

    O controller coloca o job na fila e responde sem esperar.

  2. Fila no Redis

    QUEUE_CONNECTION=redis

    O job espera na fila, que o Horizon exige no Redis.

  3. Supervisor

    config/horizon.php

    O Horizon distribui os jobs entre os processos do ambiente.

  4. Worker

    php artisan horizon

    O processo executa o job e marca sucesso ou falha.

  5. Registro

    /horizon

    O Horizon mede vazão e falhas, o Pulse marca jobs lentos e o Telescope grava o job.

O caminho de um job numa aplicação Laravel com Horizon e o que cada painel registra nesse caminho, segundo a documentação oficial do Laravel 13.

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.