Dashboard, logs e métricas do Traefik
O Traefik registra o próprio funcionamento em quatro fontes, cada uma voltada a uma parte do problema quando uma rota não abre. O dashboard exibe as rotas montadas a partir dos providers, o log do Traefik guarda os erros de configuração e de certificado, o access log anota cada requisição atendida e as métricas acompanham o tráfego ao longo do tempo.
Ficha e sumário da página
- Referência técnica
- Traefik v3.7.19
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
O dashboard e a API
O dashboard é a interface web do Traefik para as rotas ativas. Ele exibe cada entrypoint, router, service e middleware que o Traefik montou a partir dos providers, sem guardar informação própria: o conteúdo de cada página vem da API do Traefik, que expõe a mesma configuração em JSON.
A API e o dashboard são servidos por um service interno, o api@internal. Ligar a API com a opção api já liga o dashboard, porque api.dashboard vem ligada por padrão. Os endereços da API ficam sob o mesmo service e respondem só a requisições GET:
api@internalO service interno que serve a API e o dashboard./dashboard/A interface. A barra no fim do endereço é obrigatória./api/overviewOs totais de HTTP e TCP, os recursos ligados e os providers em uso./api/entrypointsAs portas de entrada e o endereço de cada uma./api/http/As peças HTTP, uma lista por tipo.routersCada router, com a condição, os entrypoints e o estado.servicesCada service e os servidores dele.middlewaresCada middleware declarado./api/tcp/ e /api/udp/As mesmas listas para o tráfego TCP e UDP./api/rawdataA configuração de roteamento inteira, com erros, estados e dependências./api/versionA versão do Traefik em execução.
A página inicial do dashboard traz os entrypoints e os totais de routers, services e middlewares, separados em sucesso, avisos e erros. Um clique num router abre a condição, o entrypoint, os middlewares e o service ligados a ele. Quando um app não aparece na lista de routers, o Traefik não leu o container, porque falta a label traefik.enable=true ou porque o container está fora da rede que o Traefik alcança.
O dashboard numa VPS
A documentação não recomenda ligar a API e o dashboard em produção, porque os dois expõem a configuração inteira, com domínios, serviços internos e nomes de middlewares. Quando você liga os dois, o acesso exige autenticação e rede restrita.
O atalho api.insecure publica a API e o dashboard no entrypoint chamado traefik, sem router nem senha. Esse atalho serve para estudo numa máquina local. Numa VPS, o caminho oficial é um router próprio apontado para o api@internal, com condição de domínio, certificado e um middleware na frente, como o BasicAuth ou o IPAllowList da página Middlewares. A stack de referência que a Promovaweb usa em produção mantém o dashboard desligado.
O log do Traefik
O log do Traefik registra o que acontece com o próprio Traefik, como erros de configuração, falhas na comunicação com um provider e problemas na emissão de certificados. É nesse log que aparece o motivo de uma rota que não foi montada ou de um certificado que não foi emitido.
O nível padrão é ERROR, que mostra só as falhas. Os níveis vão de TRACE, o mais detalhado, a PANIC, passando por DEBUG, INFO, WARN, ERROR e FATAL. Na investigação de uma falha, o nível DEBUG mostra cada passo da montagem das rotas e da emissão de certificados. Como esse nível gera muito texto, o log volta ao nível normal quando a investigação termina. Além do formato padrão common, em texto, o log aceita o formato json, mais fácil de ler por outra ferramenta.
Num container, o log sai na saída padrão. O comando docker compose logs traefik, executado na pasta da stack, mostra o que o Traefik registrou, com as falhas de certificado identificadas pelo nome do resolvedor, como letsencrypt.
O access log
O access log registra cada requisição atendida. Com ele, você confirma se a requisição chegou ao Traefik e vê o que aconteceu com ela no caminho. O access log vem desligado e liga com a opção accesslog.
Cada linha do formato padrão identifica a origem da requisição pelo IP e pela data, descreve o que foi solicitado pelo método e pelo caminho e mostra o resultado pelo status, pelo tamanho da resposta e pela duração. A mesma linha traz ainda o router que atendeu e a URL do servidor que respondeu. O formato json acrescenta campos como o nome do service, o status original devolvido pelo app e o número de novas tentativas.
Os filtros reduzem o volume de linhas guardadas:
- statusCodes: guarda só as faixas de status escolhidas, como os erros 4XX e 5XX.
- minDuration: guarda só as requisições mais lentas que um limite.
- retryAttempts: guarda as requisições que precisaram de nova tentativa.
Com tráfego alto, o bufferingSize grava as linhas em lote, para que o registro não atrase as requisições.
Métricas e tracing
As métricas mostram o comportamento ao longo do tempo: quantas requisições cada entrypoint recebeu, quantas cada router e cada service atenderam e quanto tempo elas levaram. Há também métricas gerais, como as recargas de configuração, as conexões abertas e o vencimento dos certificados. O Traefik exporta métricas para OpenTelemetry, Datadog, InfluxDB 2, Prometheus e StatsD. No Prometheus, as métricas saem por padrão no entrypoint traefik.
O tracing acompanha uma requisição de ponta a ponta, por todos os serviços que ela atravessa. A documentação descreve o tracing numa página própria, na mesma seção de observabilidade.
A fonte certa para cada sintoma
| Sintoma | Onde olhar |
|---|---|
| O router do app não aparece ou mostra erro | Dashboard, lista de routers |
| O certificado não foi emitido | Log do Traefik, pelo nome do resolvedor |
| A requisição pode não ter chegado ao Traefik | Access log, pela linha com o domínio |
| O app responde devagar | Access log, com o router e a duração |
| O tráfego mudou ao longo da semana | Métricas por entrypoint e por service |
Diante de uma rota quebrada, a investigação segue o caminho da requisição: primeiro o router no dashboard, depois o middleware e por fim o service e a porta do app. A página O Traefik nas stacks dos portais junta essas peças no desenho das stacks.