IICTPIICTP

Blog / Guides

Answers3 November 20265 min read

How do you read application logs and dashboards when something breaks?

Start from the symptom, find the time it began, then use the dashboard to see what changed and the logs to see why. Work from the broad view to the specific request, and write down what you learn as you go.

In this post
  1. What do the log levels mean?
  2. What should you check first on a dashboard?
  3. How do you find the right log lines?
  4. Why do structured logs and correlation IDs help?
  5. What should never appear in logs?
  6. Sources and further reading

What do the log levels mean?

DEBUG is detail for developers, INFO records normal events, WARN flags something unusual that did not fail, and ERROR records a failure. In production, ERROR and WARN entries are usually the first place to look.

What should you check first on a dashboard?

Look at the four golden signals from the Google SRE book: latency, traffic, errors and saturation. Compare them with normal. A jump in errors that starts exactly when a release went out points to the release.

How do you find the right log lines?

  1. Pin down the time window of the problem.
  2. Filter by service and by level.
  3. Search for the request, user or correlation ID from a failing example.
  4. Follow that ID through every service it touched.

Why do structured logs and correlation IDs help?

Structured logs, written as key-value fields instead of free text, can be filtered and counted. A correlation ID carried through every service lets you reconstruct one request across the whole system. See observability versus monitoring.

What should never appear in logs?

Passwords, tokens, full card numbers and other personal data. Logs are copied to many places and kept for a long time, so sensitive values become a second leak. Mask or leave them out.

Sources and further reading

  1. Beyer, B., Jones, C., Petoff, J. and Murphy, N. R. (eds.) (2016). Site Reliability Engineering, chapter 6, “Monitoring Distributed Systems”. O’Reilly Media.
  2. OWASP. Logging Cheat Sheet. cheatsheetseries.owasp.org.

Go deeper: CTP™ credential · the TPBOK™ standard · Check your experience

IICTP is an independent technical credentialing body.

Keep reading

← All posts

New guides in your inbox

Plain-language guides on technical practice, now and then. You confirm your address first, and you can unsubscribe at any time.

Where do you stand?

Find the credential that fits the work you do.