kubectl logs에서 --tail과 -l 옵션, 제대로 알고 쓰자

🤖 AI Assisted Content
이 글은 AI(Claude, Anthropic)의 도움을 받아 작성되었습니다.
작성자가 내용을 검토하고 편집했으나, AI가 초안 작성 및 구성에 참여했음을 밝힙니다.

kubectl logs에서 --tail과 -l 옵션, 제대로 알고 쓰자

들어가며

Kubernetes 환경에서 Pod 로그를 확인하는 건 일상적인 작업이다. 그런데 kubectl logs를 쓰다 보면 한 가지 당황스러운 순간이 온다. 분명 로그가 더 있을 텐데, -l 옵션으로 조회하면 최근 몇 줄만 보이는 것이다. 이 글에서는 --tail 옵션의 역할과, -l 레이블 셀렉터 사용 시 로그가 잘려 보이는 이유를 정리한다.

kubectl logs 기본 동작

Pod 이름을 직접 지정해서 로그를 조회하면, 해당 컨테이너에 쌓인 전체 로그가 처음부터 끝까지 출력된다.

kubectl logs aws-load-balancer-controller-68995d974b-d2955 -n kube-system

오래 돌고 있는 Pod라면 로그가 수만 줄 이상 쌓여 있을 수 있어서, 출력에 시간이 꽤 걸리고 터미널이 한동안 멈춘 것처럼 보이기도 한다.

--tail 옵션으로 최근 로그만 보기

--tail=N을 붙이면 최근 N줄만 출력한다.

# 최근 100줄만 출력
kubectl logs aws-load-balancer-controller-68995d974b-d2955 -n kube-system --tail=100

실무에서는 보통 최근 로그만 확인하면 되는 경우가 대부분이라, --tail=100이나 --tail=200 정도를 붙여서 쓰는 게 일반적이다. 전체 로그를 다 볼 필요가 없다면, 네트워크 트래픽과 출력 시간 측면에서도 --tail을 쓰는 게 훨씬 효율적이다.

💡 팁: 실시간 로그를 따라가고 싶다면 -f(follow)와 함께 쓰는 조합이 편하다.

# 최근 50줄 출력 후, 새 로그를 실시간 스트리밍
kubectl logs -f --tail=50 aws-load-balancer-controller-68995d974b-d2955 -n kube-system

-l 레이블 셀렉터의 함정

여기서 많은 사람들이 헷갈리는 부분이 나온다. -l 옵션으로 레이블 셀렉터를 사용하면, 기본적으로 --tail=10이 자동 적용된다.

# Pod 이름 직접 지정 → 전체 로그 출력
kubectl logs aws-load-balancer-controller-68995d974b-d2955 -n kube-system

# 레이블 셀렉터 사용 → 각 Pod당 최근 10줄만 출력
kubectl logs -l app=aws-load-balancer-controller -n kube-system

같은 kubectl logs인데 동작이 다르다. "로그가 분명 더 있는데 왜 안 보이지?"라는 의문이 드는 건 바로 이 때문이다.

왜 이렇게 설계했을까

-l로 조회하면 해당 레이블에 매칭되는 Pod가 여러 개일 수 있다. Deployment로 관리되는 Pod가 10개, 20개씩 있는 상황에서 전부 전체 로그를 쏟아내면 터미널이 감당할 수 없다. 그래서 Kubernetes는 안전장치로 Pod당 10줄이라는 보수적인 기본값을 적용해둔 것이다.

해결 방법

전체 로그를 보고 싶다면 --tail=-1을 명시하면 된다.

# 레이블 셀렉터 + 전체 로그
kubectl logs -l app=aws-load-balancer-controller -n kube-system --tail=-1

-1은 "제한 없음"을 의미한다. 다만 매칭되는 Pod가 많을 경우 출력량이 폭발할 수 있으니, 적당한 숫자를 지정하는 게 안전하다.

# 레이블 셀렉터 + Pod당 최근 500줄
kubectl logs -l app=aws-load-balancer-controller -n kube-system --tail=500

정리

조회 방식	기본 동작	비고
Pod 이름 직접 지정	전체 로그 출력	로그가 많으면 출력이 오래 걸림
-l 레이블 셀렉터	Pod당 10줄만 출력	--tail=-1로 전체 로그 조회 가능
--tail=N 명시	최근 N줄만 출력	두 방식 모두에 적용 가능

핵심은 하나다. Pod 이름 직접 지정과 -l 셀렉터의 기본 tail 값이 다르다는 것. 이걸 알고 있으면 "로그가 왜 안 보이지?"라는 삽질을 줄일 수 있다.