Why Logs Matter: The Support Engineer's First Instinct

Logging & Log Analysis

Chapter 1 · Why Logs Matter: The Support Engineer's First Instinct

Two support engineers get the same ticket: "the site is slow." One opens a browser, clicks around, shrugs, and starts guessing — maybe it's the database, maybe it's the network, maybe it's just Tuesday. The other opens the logs first. This course is entirely about becoming the second engineer — not because guessing never works, but because logs turn "maybe" into evidence, and evidence is what actually gets a ticket closed correctly the first time.

The Guessing Trap

Guessing feels faster than it is. A plausible-sounding theory — "it's probably the database" — sends you off to check database metrics, find nothing obviously wrong, move on to the next guess, and repeat. Each wrong guess costs real time and produces no evidence toward the actual answer. Worse, a confident wrong guess can lead to a wrong fix — restarting a service that was never the problem, "just in case" — which doesn't just fail to help, it can actively muddy the diagnostic trail for whoever looks at this next.

The log-first habit inverts this. Instead of theorizing and then checking, you check first and let what you find narrow the theories that are even worth considering. It's slower to start — reading log output isn't as immediately satisfying as taking an action — but it's dramatically faster to actually finish, because every minute spent reading logs is a minute spent on real evidence, not a guess that might be completely wrong.

What a Log Actually Is

Strip away the specifics of any particular system, and a log is simple: a timestamped record of an event a system was told to record. A web server logs each request it receives. An authentication system logs each login attempt. An application logs errors when something goes wrong internally. Different systems, same underlying idea.

127.0.0.1 - - [08/Aug/2026:14:32:07 +0100] "GET /login HTTP/1.1" 500 1204

Even without knowing this exact format yet — Chapter 4 covers it in full — a few things are already readable: something happened at a specific moment (14:32:07), it involved a request to /login, and the outcome was a 500, a server-side error. That's already more than a guess would have given you for free.

What Logs Can Actually Tell You

What logs are good atWhy it matters
Exact timingWhen something happened, down to the second — critical for correlating events across different systems
SequenceWhat happened before and after a given event, in the order it actually occurred
Error detailThe specific error message or stack trace a system produced, often far more precise than a user's own description of "it's broken"
Volume & frequencyWhether something is a one-off blip or a repeating pattern — a single error looks very different from the same error every 30 seconds

What Logs Can't Tell You — An Honest Limit

Logs are not a complete recording of everything that happened; they're a recording of everything someone chose to record. That distinction matters more than it sounds:

  • Silent failures aren't logged at all. If nobody wrote a log line for a particular failure case, it simply won't appear — the absence of an error in the logs is not proof nothing went wrong
  • A single log line is often missing context. One line might tell you a request failed, but the actual cause could be recorded in a completely different system's log, at roughly the same timestamp — Chapters 6 and 7 both depend on this kind of cross-referencing
  • Logs can be actively misleading if misconfigured. A server with its clock set to the wrong timezone will log technically accurate events at confusingly wrong-looking times; an overly generic error message can point you toward the wrong subsystem entirely
Never delete logs to "fix" a problem mid-investigation
Clearing a log file to free up disk space during an active incident is a genuinely common, genuinely damaging mistake — it destroys the exact evidence you're trying to use to diagnose the incident, often permanently. If disk space is a real concern, move or compress the log file instead of deleting it, and only once you're confident you no longer need what's in it.

A Concrete Example: One Symptom, Three Different Causes

A user reports "the site gave me an error." That single symptom could mean genuinely different things underneath — a failed database connection, a bug in the application code, or the server running out of memory under load — and each of those has a completely different fix. Without logs, you're choosing between three guesses. With logs, the error message, the timing, and what else was happening at that exact moment usually point clearly at just one of them. Chapters 6 and 7 build this exact skill in full, working through a slow-response scenario and an incorrect-response scenario end to end.

Read the timestamp before you read the message
It's tempting to jump straight to an error message and start reasoning about what it means. Checking the timestamp first — and confirming it actually lines up with when the reported problem happened — catches a surprising number of false leads early, before you spend time investigating an error that turns out to be unrelated, from before or after the actual incident.

What This Course Covers

Log levels and severity, where to actually find logs on Linux and Windows, reading web server and authentication logs in real depth, two full diagnostic walkthroughs built around genuinely common support scenarios, an orientation to log aggregation at scale, and — closing the loop — how to write to logs yourself, both appending to an existing application's log and building a well-behaved custom one. The capstone ties all of it together against three realistic support tickets.

Hands-On Exercises

Exercise 1

Explain, in your own words, why this chapter argues that checking logs first is actually faster overall than guessing first, even though reading logs takes real time up front.

📄 View solution
Exercise 2

A colleague says "there's nothing in the logs, so nothing went wrong." Explain why this chapter would consider that conclusion unsafe, and what a "silent failure" actually is.

📄 View solution
Exercise 3

During a live incident, disk space runs low on the server you're investigating. A colleague suggests deleting the log file that's taking up the space. Explain why this chapter says that's a mistake, and what to do instead.

📄 View solution

Chapter 1 Quick Reference

  • Log-first, not guess-first — checking logs before theorizing turns diagnosis into evidence-gathering rather than trial and error
  • A log is a timestamped record of an event a system was told to record — nothing more, nothing less
  • Logs are good at: exact timing, sequence, error detail, and frequency/volume
  • Logs can't guarantee completeness (silent failures), can lack context (needing cross-referencing), and can mislead if misconfigured (e.g. wrong server timezone)
  • Never delete a log file mid-investigation to free disk space — move or compress it instead
  • Always confirm a log entry's timestamp actually matches the reported incident before trusting its message
  • Next chapter: Log Levels & Severity