A visualização dos registros do pod geralmente é a primeira etapa para diagnosticar um problema com as cargas de trabalho do cluster. Veja como usar o Kubectl para transmitir registros ao vivo para o seu terminal, permitindo que você inspecione a saída do seu aplicativo.
Começando
Certifique-se de ter o Kubectl instalado e conectado ao seu cluster. Você pode especificar um arquivo Kubeconfig definindo o KUBECONFIG variável de ambiente em seu shell:
export KUBECONFIG=~/.kube/my-cluster.yaml Em seguida, use o Kubectl para listar seus pods:
kubectl get pods Lembre-se de adicionar o --namespace sinalizar quando seus pods estiverem fora do namespace padrão:
kubectl --namespace my-namespace get pods Adicionar um alias temporário ao shell é uma boa maneira de encurtar essa etapa, ajudando você a executar vários comandos no mesmo namespace:
alias k="kubectl --namespace my-namespace"
k get pods Acessando logs de pod
o kubectl logs comando permite inspecionar os registros produzidos por um pod nomeado:
kubectl logs pod-name Os registros existentes do pod serão emitidos para seu terminal. Quando o pod é formado a partir de mais de um contêiner, você também deve especificar o nome do contêiner que deseja inspecionar:
kubectl logs pod-name container-name 
Alternativamente, defina o --all-containers sinalizador para incluir linhas de registro produzidas por qualquer um dos contêineres no pod. Esteja ciente de que você pode ver uma saída detalhada e repetitiva quando este sinalizador é usado em um pod ocupado:
kubectl logs pod-name --all-containers Você também pode obter os registros de um conjunto de pods com um determinado rótulo. Isso permite agregar registros de diferentes pods, desde que todos compartilhem o mesmo rótulo:
kubectl logs -l my-label=my-value --all-containers Logs de streaming contínuo
O plano logs O comando emite os logs do pod atualmente armazenados e, em seguida, sai. Adicione o -f (--follow) sinalize o comando para seguir os registros e transmiti-los ao vivo para o seu terminal.
O Kubectl emitirá cada nova linha de log em seu terminal até que você interrompa o comando com Ctrl + C. Isso é equivalente a usar tail -f com um arquivo de log local em um ambiente sem contêineres.
Ver registros mais antigos
kubectl logs não incluirá linhas de registro produzidas por contêineres antigos que já foram membros do pod, mas que foram substituídos. Esses registros podem ser acessados adicionando o -p (--previous) bandeira.
O Kubectl irá então revelar todo o log armazenado para o Pod, incluindo linhas que foram emitidas por contêineres que já foram encerrados.
Obtendo registros recentes
Às vezes, você não precisa ver todo o fluxo de registro. Kubectl suporta um --since sinalizar quais linhas de registro de superfície emitidas após um determinado tempo:
kubectl logs pod-name --since=2h Este comando mostrará a saída do log de pod-name que foi produzido nas últimas duas horas. Outra variante, --since-time, suporta uma string de carimbo de data / hora compatível com RFC3339 em vez da expressão de tempo relativo mostrada acima.
o --tail flag é outra opção para condensar logs. Isso limita o número de linhas que são exibidas, evitando um terminal cheio quando você só precisa ver uma saída muito recente:
# Shows the last 10 lines of the log
kubectl logs pod-name --tail=10 O Kubectl não mostra carimbos de data / hora de linha por padrão, pois muitos aplicativos já os incluem em sua saída de registro. Adicione o --timestamps sinalize para que o Kubectl adicione carimbos de data / hora ao início das linhas quando sua carga de trabalho não os fornecer.

Você também pode acrescentar os nomes dos pods e contêineres inspecionados às linhas de registro. Esta funcionalidade é ativada com o --prefix bandeira. Pode ser combinado com --timestamps para exibir a hora em que cada linha foi criada e a fonte de onde se originou.
Acessando registros de outros tipos de recursos
kubectl logs funciona com implantação e recursos de trabalho, além de pods:
kubectl logs job/my-job
kubectl logs deployment/my-deployment Você obterá os logs do primeiro contêiner no trabalho ou implantação. Use o --all-containers sinalizar para exibir os logs criados por qualquer um dos contêineres correspondentes. Você pode usar todos os sinalizadores descritos acima se estiver visualizando um pod, implantação ou trabalho.
Gerenciamento de registro mais avançado
O Kubectl não inclui uma maneira de filtrar, pesquisar ou transformar seus registros. É melhor canalizar o kubectl logs saída em ferramentas de terminal estabelecidas, como awk, grep ou sed para este propósito.
kubectl logs my-pod | grep search-expression Da mesma forma, use os recursos de redirecionamento existentes em seu shell para salvar os registros em um arquivo:
kubectl logs my-pod > my-pod-logs.txt Resumo
O Kubectl permite acessar registros de seus recursos por contêiner ou de forma agregada. Você pode ver um instantâneo dos logs coletados atualmente, transmitir continuamente novas linhas para o seu terminal e acessar linhas históricas emitidas por contêineres encerrados.
O comando vem com algumas opções de personalização limitadas, incluindo um limitador de contagem de linha e filtragem de data simplista. Quando uma análise mais exigente é necessária, canalize a saída para os comandos do terminal Unix para analisar rapidamente seus logs e encontrar as causas dos erros em seus aplicativos.
O Kubectl coleta registros da saída padrão e fluxos de erro de seus contêineres. É importante garantir que você escreva a saída para esses fluxos corretamente, pois um contêiner mal configurado resultará em uma saída vazia quando você executar kubectl logs.



