Core Track Guardrails-first chapter in core learning path.

Estimated Time

  • Reading: 20-25 min
  • Lab: 45-60 min
  • Quiz: 10-15 min

Prerequisites

Source Code References

  • backend-alerts.yaml Members
  • servicemonitor.yaml Members

Sign in to view source code.

What You Will Produce

A reproducible lab result plus quiz verification and incident-safe operating evidence.

3 Signals, 1 Incident Exercise

For one controlled incident (e.g., triggering a /panic or /status/500 route), capture all three artifacts:

  1. Metrics Symptom: Latency or error-rate spike in Grafana.
  2. Trace Path: Showing the failing route and span chain in Uptrace.
  3. Log Evidence: Matching backend log with the correct trace_id.

Success Condition: All three artifacts must point to the same causal path.

Core Exercises (Required)

  1. Find a Trace: Trigger an action in the frontend. Find its end-to-end trace in Uptrace.
  2. Correlate with Logs: Copy the trace_id from the Uptrace span. Use kubectl logs to find the matching backend log entry.
  3. Verify Alert: Trigger a high error rate and observe the alert rule in Prometheus. Verify if the alert is captured by k8s-ai-monitor.
  4. SLO Check: Identify the backend availability SLI/SLO in your Prometheus rules and explain the burn-rate alert.

Challenge Exercise (Optional)

End-to-End Signal Correlation: Trigger a controlled backend error, then trace it end-to-end through all three signals: find the metric spike in Grafana, locate the trace in Uptrace, and correlate the log entry using only the trace_id.

Done When

You have completed this chapter when:

  • You can find an end-to-end trace from frontend to backend.
  • You can match a backend log entry by trace_id.
  • You can explain why the current alert path goes through k8s-ai-monitor.
  • You have successfully run the incident workflow: metrics -> traces -> logs.
  • You understand why metrics alone are not enough for root cause analysis.

Knowledge Check

Before finishing this chapter, complete the Quiz to verify your understanding of the guardrail principles.