Why kubectl logs for debugging in Kubernetes? - Purpose & Use Cases

The Big Idea

What if you could find your app's hidden problems in seconds instead of hours?

The Scenario

Imagine you have a big app running on many computers, and something goes wrong. You try to find out what happened by asking each computer one by one, opening files, and reading long texts. It feels like searching for a needle in a haystack.

The Problem

Checking logs manually is slow and confusing. You might miss important clues or make mistakes copying info. It's hard to keep track of what you found, and fixing problems takes much longer.

The Solution

Using kubectl logs lets you quickly see what your app says while it runs. It gathers all messages from the right place in seconds, so you can spot errors fast and fix them before users notice.

Before vs After

✗ Before

ssh server1
cat /var/log/app.log
ssh server2
cat /var/log/app.log

✓ After

kubectl logs pod-name

What It Enables

You can instantly peek inside your app's heart to understand and solve problems without wasting time.

Real Life Example

When a website suddenly stops working, a developer runs kubectl logs to see error messages from the app's pod and quickly finds a missing file causing the crash.

Key Takeaways

Manual log checking is slow and error-prone.

kubectl logs gives fast, direct access to app messages.

This helps fix problems quickly and keep apps running smoothly.

Practice

1. What does the kubectl logs command do in Kubernetes?

easy

A. Deletes a pod from the cluster

B. Lists all pods running in the cluster

C. Creates a new pod with specified configuration

D. Shows the output logs of a container inside a pod

Solution

1. Step 1: Understand the purpose of kubectl logs

   This command is used to view the logs generated by containers running inside pods in Kubernetes.

2. Step 2: Differentiate from other commands

   Deleting pods uses kubectl delete, creating pods uses kubectl create, and listing pods uses kubectl get pods. None of these show logs.

3. Final Answer:

   Shows the output logs of a container inside a pod -> Option D

4. Quick Check:

   Logs = Output from container [OK]

Hint: Logs show container output, not pod creation or deletion [OK]

Common Mistakes:

• Confusing logs with pod creation or deletion
• Thinking logs list pods instead of showing output
• Assuming logs show cluster-wide events

2. Which of the following is the correct syntax to follow logs live from a pod named webapp-123?

easy

A. kubectl logs webapp-123 --follow

B. kubectl logs --tail webapp-123

C. kubectl logs webapp-123 -t

D. kubectl logs -t webapp-123

Solution

1. Step 1: Recall correct flag placement

   The --follow flag comes after the pod name in the kubectl logs command syntax.

2. Step 2: Check distractor flags

   Distractors use --tail (shows last lines, no streaming) or -t (timestamps, no follow). Only --follow streams live.

3. Final Answer:

   kubectl logs webapp-123 --follow -> Option A

4. Quick Check:

   Pod name first, then flags [OK]

Hint: Put pod name before flags like --follow [OK]

Common Mistakes:

• Placing flags before pod name
• Using --tail or -t instead of --follow
• Mixing order of arguments

3. Given the command kubectl logs mypod --tail=5, what will be the output?

medium

A. Shows all logs except the last 5 lines from the pod named mypod

B. Shows the first 5 lines of logs from the pod named mypod

C. Shows the last 5 lines of logs from the pod named mypod

D. Shows logs only if the pod has more than 5 containers

Solution

1. Step 1: Understand the --tail option

   The --tail=5 option limits the output to the last 5 lines of the logs.

2. Step 2: Confirm it applies to the specified pod

   The command targets the pod named mypod, so logs shown are from that pod only.

3. Final Answer:

   Shows the last 5 lines of logs from the pod named mypod -> Option C

4. Quick Check:

   --tail = last lines [OK]

Hint: --tail shows last lines, not first [OK]

Common Mistakes:

• Thinking --tail shows first lines
• Confusing pod logs with container logs
• Assuming it filters by container count

4. You run kubectl logs mypod -c mycontainer but get an error saying container not found. What is the likely cause?

medium

A. The pod mypod is not running

B. The container name mycontainer does not exist in pod mypod

C. You forgot to add the --follow flag

D. The pod mypod has multiple containers but you did not specify one

Solution

1. Step 1: Analyze the error message

   The error says container not found, which means the container name given is incorrect or missing in the pod.

2. Step 2: Check command correctness

   You specified -c mycontainer, so if the container name is wrong, the error appears. Pod running state or missing --follow flag does not cause this error.

3. Final Answer:

   The container name mycontainer does not exist in pod mypod -> Option B

4. Quick Check:

   Container name must match exactly [OK]

Hint: Check container name spelling matches pod's containers [OK]

Common Mistakes:

• Assuming pod state causes container not found error
• Forgetting to specify container when multiple exist
• Using wrong flag for container name

5. You want to debug a pod with two containers named frontend and backend. Which command correctly streams live logs from the backend container only?

hard

A. kubectl logs podname -c backend --follow

B. kubectl logs podname --tail -c backend

C. kubectl logs -c backend podname --tail

D. kubectl logs --tail podname -c backend

Solution

1. Step 1: Recall correct argument order

   The pod name must come immediately after kubectl logs, followed by flags like -c and --follow.

2. Step 2: Confirm container and follow flag usage

   Using -c backend specifies the backend container, and --follow streams logs live.

3. Final Answer:

   kubectl logs podname -c backend --follow -> Option A

4. Quick Check:

   Pod name first, then container and flags [OK]

Hint: Pod name first, then container (-c) and --follow [OK]

Common Mistakes:

• Placing flags before pod name
• Mixing order of container and follow flags
• Using unsupported shorthand flags