Before you start / Requirements

Run workshop commands in Linux Bash, not PowerShell, CMD, or Git Bash. We recommend the supplied Dev Container in GitHub Codespaces on your own fork. WSL2 with Ubuntu, a local Linux Dev Container, or native Ubuntu are alternatives. Confirm Azure access, regional quota, and separate Azure/Codespaces costs before deploying.

Read requirements and environment setup →

Then run pre-flight checks in your Linux terminal and resolve failures with your coach: Azure Operations prerequisites or SQL Server DBA prerequisites. Container setup installs tools; it does not log in to Azure or deploy the lab.

Azure Operations Track

Challenges 00–06 cover SRE Agent configuration primitives. Challenges 07–09 establish observability baselines. Challenges 10–15 are live incident scenarios spanning PaaS, IaaS, and network layers. Challenges 16–18 are advanced operational skills and automation tasks. Challenge 19 is the capstone: bring your own use case and build a production-ready agent. Coaches: press Shift+C to unlock solution guides.

00
Setup CH — 00

Prerequisites &
Lab Setup

Deploy the lab workload infrastructure with Terraform, then create your own Azure SRE Agent resource via the portal or CLI — an empty agent with zero configuration. Generate baseline traffic to seed the observability pipeline before Challenges 01–06.

01
Config CH — 01

Connect Your
Codebase

Your agent is running but isolated from source code. Connect a GitHub OAuth Connector and link your repository so the agent can read code and open pull requests.

02
Config CH — 02

Explore the
Knowledge Base

Your agent answers from training data alone — it knows nothing about your lab. Attach knowledge documents so it gives grounded, accurate answers about your environment.

03
Config CH — 03

Discover Operational
Skills

Your agent can answer questions but can't act. Author a skill YAML so it can execute KQL queries, inspect Container App health, and run operational runbooks.

04
Config CH — 04

Discover Connected
Systems

Your agent relies on stale training data for best practices. Connect MCP servers to give it access to live, curated knowledge and tools beyond its training cutoff.

05
Config CH — 05

Discover Specialist
Agents

A generalist handles everything from one system prompt. Define specialist subagents — each with its own identity, tools, and runbooks — and route incidents to the right expert.

06
Config CH — 06

Understand
Response Plans

Everything so far is chat-driven — you ask, it answers. Configure incident filters and response plans so the agent acts autonomously when alerts fire at 3 AM.

07
Autonomous CH — 07

Hybrid Ecosystem
Telemetry

The Parking Manager spans Container Apps, VMs, and a third-party OpenTelemetry API. Use the agent to query all three platforms and produce a unified cross-system view.

08
Autonomous CH — 08

Application Dependency
Mapping

When an app fails, which dependency is the culprit? Drive the agent to map the full Parking Manager dependency graph using App Insights — the foundation for every root-cause investigation.

09
Autonomous CH — 09

Daily Application
Health Report

Ask the agent to generate a structured health report for all four Parking Manager APIs — CPU, memory, error rate, response time — with a health score and recommended remediation for any service falling below threshold.

10
Autonomous CH — 10

Incident to
GitHub Issue

Trigger a Parking Manager incident and let the agent investigate, then close the loop by automatically opening a GitHub issue with the root cause, timeline, and remediation steps — no copy-paste required.

11
Autonomous CH — 11

Guest OS Failure
Investigation

Stop NGINX inside the web-tier VMs and watch the agent discover the failure from Syslog telemetry, assess the full blast radius across both VMs, and restore the service autonomously on every affected instance.

12
Autonomous CH — 12

Network Security
Investigation

Inject an NSG misconfiguration that silently drops database traffic. The agent finds the blocking rule from flow log evidence and remediates it autonomously — no application-level error message to guide it.

13
Interactive CH — 13

Routing Failure
Investigation

Introduce an asymmetric routing black hole where return packets never arrive. Drive a diagnostic conversation with the network-traffic-analyst over effective routes and next-hop analysis to find and fix the return path.

14
Autonomous CH — 14

Application Root
Cause Analysis

From a 5xx spike the agent traces through container logs, Application Insights telemetry, and source code to the exact line causing an OOM crash — then opens a GitHub issue linking evidence to code. No human switches tools.

15
Autonomous CH — 15

Autonomous
Remediation

Trigger a Parking Manager backend failure, then watch the agent detect it, apply the automated fix, and validate recovery — closing the full remediation loop without human intervention.

16
Scheduled CH — 16

Daily Network
Health Report

Create a scheduled task that reviews 24 hours of network telemetry every morning and produces a decision-ready summary: denied flows, top talkers, missing VNet coverage, and unusual ports.

17
Scheduled CH — 17

Observability
Freshness Verification

Build a scheduled task that proves the monitoring pipeline itself is alive — checking VNet Flow Log ingestion end-to-end so silent telemetry loss is caught before it masks real failures.

18
Autonomous CH — 18

Subscription Cost
Optimization Review

Run a subscription-wide cost review: resource inventory, actual spend, utilization, and Azure Advisor recommendations — grounded in business context so the savings table is actionable, not just technically correct.

19
Capstone CH — 19

Build Your Own
Production-Ready SRE Agent

Bring a real reliability problem from your own environment. Design and implement a custom subagent — skills, knowledge docs, incident filter or scheduled trigger — then demo it end-to-end to the group and defend its production readiness.

SQL Server DBA track

Deploy a hardened SQL Server MCP server, then teach Azure SRE Agent to separate database facts from assumptions. Every investigation is bounded, observable, and deliberately non-destructive.

Managed identity SELECT only Estimated plans No auto-tuning
00
Trust boundary DBA — 00

Deploy the Read-Only
DBA Path

Deploy the supplied .NET MCP container, map its managed identity into the least-privilege observer role, secure the Streamable HTTP endpoint, and prove that Azure SRE Agent can inspect SQL without receiving a write path.

01
Discover DBA — 01

Orient to the
Database

Turn catalog metadata into a business map while keeping declared relationships separate from inferred domain meaning.

02
Baseline DBA — 02

Establish a Query
Store Baseline

Seed repeatable activity and define a trustworthy historical observation window before diagnosing regressions.

03
Interpret DBA — 03

Separate Duration
from Pressure

Observe a long-running wait and prevent elapsed time from becoming a false performance diagnosis.

04
Concurrency DBA — 04

Trace a
Blocking Chain

Identify the head blocker, blocked request, wait resource, and transaction age without terminating either session.

05
Tune DBA — 05

Build an Evidence-Based
Index Case

Correlate Query Store, the existing index set, and an estimated plan before recommending a change.

06
Query shape DBA — 06

Diagnose Query
Shape Problems

Find non-SARGable predicates and implicit conversions, then explain their access-path impact without rewriting production code.

07
Plan behavior DBA — 07

Investigate Parameter
Sensitivity

Compare skewed parameter populations, plan history, and runtime distributions before claiming parameter sensitivity.

08
Incident room DBA — 08

Triage a Combined
Database Incident

Correlate concurrent signals, rank findings by demonstrated impact, preserve alternative explanations, and deliver a decision-ready read-only handoff.

09
Capstone DBA — 09

Build Your Own SQL
Server DBA Agent

Design and validate a focused read-only investigation workflow for a database reliability question of your choosing.

Subagents

Each subagent is a specialist with its own system prompt, tool grants, and incident routing. The network-traffic-analyst supports both interactive and autonomous modes.

aca-app-incident-handler
PaaS Incident Handler
Investigates Grubify Container Apps 5xx incidents. Queries App Insights, identifies bad revisions, deactivates or rolls back, optionally analyzes source code and opens GitHub PRs.
Write CLI GitHub OAuth App Insights
iaas-vm-incident-handler
IaaS VM Recovery Agent
Handles NGINX and other VM service failures detected via Syslog. Uses az vm run-command to restart services and verify recovery.
Write CLI Log Analytics
network-traffic-analyst
Network Observability & Remediation
Analyzes VNet Flow Logs, Traffic Analytics KQL, and NSG/UDR configs. Supports interactive investigation (CH-13) and autonomous remediation (CH-12).
Write CLI NTANetAnalytics
issue-triager
GitHub Issue Classifier
Runs on a schedule to triage [Customer Issue] GitHub issues. Classifies as Bug/Performance/Feature/Question, adds labels, and posts a structured bot comment.
GitHub OAuth Scheduled
cost-optimization-agent
Cost & Efficiency Analyst
Reviews Azure resource costs on a weekly schedule. Queries Cost Management, correlates with workload usage, and reports optimization opportunities.
Scheduled Cost Management
azure-resource-config-auditor
Compliance & Config Auditor
Audits Azure resource configuration against best practices. Checks SKU selection, redundancy settings, diagnostic settings, and security posture on demand.
Read-only
Coach Solution guides — visible only to coaches. Press Shift+C to hide.

Solution Guides

Mini-lectures, expected agent behavior, common failure modes, and debrief discussion guides. See the Azure Operations index or the SQL Server DBA index.

00
SOL — 00
Prerequisites & Lab Setup
TF deploy walkthrough, manual agent creation pitfalls, workload vs. control-plane split, pre-flight validation.
Open →
01
SOL — 01
Connect Your Codebase
GitHub connector vs. repo scope, apply order, source-boundary refusal demo.
Open →
02
SOL — 02
Explore the Knowledge Base
Retrieval-augmented grounding, the three knowledge families, before/after topology demo.
Open →
03
SOL — 03
Discover Operational Skills
Skill YAML anatomy, the nine certified skills, description-driven routing vs. least-privilege tools.
Open →
04
SOL — 04
Discover Connected Systems
Skills vs. connectors, Microsoft Learn MCP setup, before/after citation demo.
Open →
05
SOL — 05
Discover Specialist Agents
Subagents as scoped domain experts, the specialist roster, narrow tool grants as governance.
Open →
06
SOL — 06
Understand Response Plans
Incident filter routing stack, exact filter/task names, alert-driven vs. chat-driven response.
Open →
07
SOL — 07
Hybrid Ecosystem Telemetry
Azure-native vs. third-party telemetry planes, Berlin MCP connector, cross-plane summary reporting.
Open →
08
SOL — 08
Application Dependency Mapping
Requests vs. dependencies, Mermaid/ASCII topology output, dependency hotspot discovery.
Open →
09
SOL — 09
Daily Application Health Report
SLI/SLO reporting, Healthy/Degraded/Critical scoring, explicit N/A handling for missing telemetry.
Open →
10
SOL — 10
Incident to GitHub Issue
Incident report template, telemetry-to-backlog lifecycle, follow-up comment discipline.
Open →
11
SOL — 11
Guest OS Failure Investigation
Platform health vs. guest-OS health, Syslog/AMA evidence, run-command remediation and blast-radius check.
Open →
12
SOL — 12
Network Security Investigation
Denied-flow forensics via Traffic Analytics, NSG rule identification, autonomous routing path.
Open →
13
SOL — 13
Routing Failure Investigation
UDR precedence, effective routes, asymmetric-path outages, autonomous vs. Review governance debate.
Open →
14
SOL — 14
Application Root Cause Analysis
End-to-end telemetry → source-code correlation → GitHub artifact, the workshop's signature "wow" moment.
Open →
15
SOL — 15
Autonomous Remediation
Detect → remediate → validate → retry/escalate loop, autonomous MTTR vs. human-driven recovery.
Open →
16
SOL — 16
Daily Network Health Report
Proactive scheduled-task reporting, five report dimensions, narrative -only safety without a write path.
Open →
17
SOL — 17
Observability Freshness Verification
"Monitoring the monitoring," flow-log ingestion evidence chain, desired-state vs. actual telemetry.
Open →
18
SOL — 18
Subscription Cost Optimization Review
Evidence-backed FinOps review, cost-optimization-agent cadence, recommendations-only governance showcase.
Open →
19
SOL — 19
Build Your Own Production-Ready SRE Agent (Capstone)
Design checklist, building-blocks synthesis, production-readiness criteria, demo facilitation and debrief guide.
Open →
SQL Server DBA solutions