docker compose logs

O comando docker compose logs permite visualizar os logs gerados pelos containers de um projeto Docker Compose. Esses logs incluem saídas de aplicativos e mensagens de erro, sendo uma ferramenta essencial para monitorar e depurar os serviços em execução.

Uso Básico

docker compose logs [OPTIONS] [SERVICE...]

• SERVICE: O nome de um ou mais serviços definidos no arquivo docker-compose.yml dos quais você deseja visualizar os logs. Se não for especificado, os logs de todos os serviços serão exibidos.

Principais Opções

• -f, --follow: Mantém a exibição dos logs em tempo real, semelhante ao comando tail -f. Útil para monitoramento contínuo de um ou mais serviços.

• --tail string: Exibe apenas as últimas linhas dos logs. Você pode especificar um número (por exemplo, --tail 100 para as últimas 100 linhas) ou usar all para exibir todos os logs.

• -t, --timestamps: Inclui carimbos de data e hora em cada linha de log, o que pode ser útil para análise temporal.

• --no-color: Remove a coloração dos logs, útil em scripts ou em ambientes onde a cor não é suportada ou necessária.

• --since: Exibe apenas os logs gerados a partir de um determinado tempo, usando o formato RFC3339 ou um tempo relativo, como 10m para os últimos 10 minutos.

• --until: Mostra os logs gerados até um determinado tempo, útil para delimitar o período de tempo dos logs visualizados.

Exemplos de Uso

1. Exibir logs de todos os serviços:

   docker compose logs

   Este comando exibe os logs de todos os serviços definidos no projeto Docker Compose.

2. Exibir logs de um serviço específico:

   docker compose logs web

   Exibe apenas os logs do serviço web, filtrando os demais serviços.

3. Monitorar logs em tempo real:

   docker compose logs -f

   Mantém a exibição contínua dos logs em tempo real para todos os serviços.

4. Exibir os últimos 50 registros de log de um serviço:

   docker compose logs --tail 50 db

   Exibe apenas as últimas 50 linhas de log do serviço db.

5. Incluir timestamps nos logs:

   docker compose logs -t app

   Exibe os logs do serviço app com carimbos de data e hora.

6. Filtrar logs de um período específico:

   docker compose logs --since "2024-09-03T10:00:00Z" --until "2024-09-03T12:00:00Z" web

   Mostra apenas os logs do serviço web gerados entre 10:00 e 12:00 UTC no dia 3 de setembro de 2024.

Casos de Uso Comuns

• Depuração e Resolução de Problemas: Visualizar os logs é fundamental para identificar erros, falhas e comportamentos inesperados dos serviços.

• Monitoramento: Usar a opção -f permite acompanhar em tempo real o que está acontecendo nos containers, ajudando a reagir rapidamente a problemas.

• Análise Histórica: As opções --since e --until são úteis para revisar logs de períodos específicos, como durante uma janela de manutenção ou após um incidente.

Considerações Finais

O comando docker compose logs é uma ferramenta essencial para a administração de aplicações containerizadas, oferecendo uma forma centralizada de acessar e monitorar os logs de todos os serviços gerenciados pelo Docker Compose. Com suas diversas opções, você pode filtrar, seguir e analisar os logs conforme necessário, permitindo uma gestão eficaz e uma resolução de problemas mais rápida.