docs
Configuração

Logs

Visualize logs dos seus serviços em tempo real.

Acompanhe os logs dos seus serviços diretamente pelo terminal.

Logs recentes

veloz logs show

Por padrão, mostra as últimas 50 linhas.

veloz logs show --tail 100

Streaming em tempo real

veloz logs show --follow
  ℹ Streaming de logs ativo. Pressione Ctrl+C para sair.

  12:34:01 GET /api/users 200 12ms
  12:34:02 POST /api/auth 200 45ms
  12:34:05 GET /api/data 500 120ms
    → TypeError: Cannot read properties of undefined

Os logs são exibidos com timestamp formatado em pt-BR.

Pesquisar logs

Use veloz logs search para consultas avançadas com sintaxe LogsQL:

veloz logs search "error"                          # buscar por palavra
veloz logs search "connection refused"             # frase exata
veloz logs search '~"status=[45]\d{2}"'            # regex
veloz logs search "error" --start 2026-03-01       # filtro por data
veloz logs search "error" --limit 50               # limitar resultados
veloz logs search "error" --deployment abc123       # filtrar por deploy

Para ver todas as opções de sintaxe:

veloz logs query-help

Filtrar por serviço

Em monorepos com múltiplos serviços, filtre logs de um serviço específico:

veloz logs show --service api
veloz logs show --follow --service web
veloz logs search "error" --service api

Sem filtro, logs de todos os serviços são exibidos com tags coloridas para fácil identificação:

  [web] 12:34:01 GET / 200 5ms
  [api] 12:34:02 POST /auth 200 45ms

Selecionar serviço padrão

Use veloz use para definir o serviço padrão e não precisar passar --service toda vez:

veloz use api
veloz logs show     # agora mostra logs do api

Logs de build

Para ver logs de build (compilação/Dockerfile), use os comandos de builds:

veloz builds list                    # listar builds recentes
veloz builds logs abc12345           # ver logs do build
veloz builds show abc12345           # detalhes do build (status, duração, motivo da falha)

Os logs de build mostram os passos do Dockerfile com formatação: steps, cache hits e duração de cada etapa.

Próximos passos