Ir para o conteúdo
Promovaweb

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
  1. O dashboard e a API
  2. O dashboard numa VPS
  3. O log do Traefik
  4. O access log
  5. Métricas e tracing
  6. A fonte certa para cada sintoma

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.
O dashboard é uma interface sobre essas listas. Tudo o que ele exibe também sai pela API, em JSON.

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.

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.