docker logs
100%

Docker · Lição 6

docker logs

Aprenda a ler a saída coletada de um contêiner e usá-la para escolher o próximo passo da investigação.

Um contêiner chamado preview terminou. Na lista de contêineres, você encontra o estado e o código de saída. Para descobrir o que o programa informou, veja a saída que o Docker coletou desse contêiner.

Escolhendo o contêiner

Passe o nome do contêiner para docker logs. O comando consegue ler a saída armazenada de um contêiner parado que ainda existe. Neste exemplo, uma tarefa curta tentou ler um arquivo em /site/title.txt antes de parar.

$ docker logs preview
cat: can't open '/site/title.txt': No such file or directory

Aqui, cat é o programa que tentou ler o arquivo. A mensagem indica o caminho que ele não conseguiu encontrar dentro do contêiner.

Preview e report usaram a mesma imagem. Qual comando lê a saída de preview?

Lendo a mensagem no contexto

Os logs guardam mensagens escritas pelo programa. Uma mensagem de inicialização pode indicar que o programa começou a aceitar solicitações. Um erro pode mostrar qual operação ele não conseguiu concluir. Neste exemplo, a mensagem aponta para um caminho ausente em preview. Confira se o contêiner deveria ter um arquivo exatamente nesse caminho. A mensagem indica por onde começar.

O que a mensagem de arquivo ausente permite afirmar?

Consultando a saída recente

Para um contêiner com muitas linhas de saída, use --tail seguido de um número. O Docker retorna até esse número de linhas, contando do fim da saída coletada. Comece com poucas linhas. Se o primeiro erro estiver antes delas, aumente o limite.

$ docker logs --tail 5 web

Terminal da LabEx mostrando o erro de arquivo ausente em preview e as cinco últimas linhas de web

Os dois comandos consultam contêineres diferentes. Na execução da LabEx, preview mostra a falta do arquivo e web informa que o Nginx iniciou.

Você quer ver só as duas linhas mais recentes disponíveis de web. Qual comando serve?

O que fazer quando a saída está vazia

O Docker só pode mostrar a saída que coletou. Um comando pode rodar sem exibir nada, ou o programa pode escrever suas mensagens em um arquivo que o Docker não coleta. Se docker logs funcionar sem exibir saída, use docker ps -a para ver o estado do contêiner. Uma saída vazia não esclarece o estado por si só.

A tarefa cleanup não tem linhas nos logs. Como saber se ela ainda está em execução ou já terminou?

Lição concluída

Você concluiu docker logs

Agora você pode usar a saída de um contêiner para decidir o que verificar a seguir.

  • Ler a saída coletada de um contêiner pelo nome, mesmo que ele tenha terminado.

  • Usar a mensagem do programa para localizar o problema relatado.

  • Limitar a saída com --tail.

  • Fazer uma verificação separada quando o log deixar uma pergunta em aberto.

Salve seu progresso

Crie uma conta gratuita para salvar esta lição e continuar em qualquer dispositivo.

Criar uma conta gratuita
Próxima Lição
Voltar para Docker