cso-kql-foundations

Teaches foundational KQL query writing against the Azure Log Analytics demo workspace.

2|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/jay-steenbergen/MSSAMentorAgent --skill cso-kql-foundations-jay-steenbergen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cso-kql-foundations
Source: https://github.com/jay-steenbergen/MSSAMentorAgent/tree/main/.github/skills/tracks/cybersecurity-ops/cso-kql-foundations
Command: npx skills add https://github.com/jay-steenbergen/MSSAMentorAgent --skill cso-kql-foundations-jay-steenbergen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New cybersecurity learners struggle to get hands-on practice with KQL, the query language used across Microsoft Sentinel, Defender XDR, and Azure Monitor, because setting up a data environment is a barrier. This Skill guides a learner through writing their first 8-10 real KQL queries against Microsoft's free, world-readable Log Analytics demo workspace with zero setup. ## Core Features & Use Cases - Guided five-phase curriculum: Progresses from counting rows, through where/project filtering, summarize/bin aggregation, and join, to writing three security queries from scratch. - Security-relevant practice: Every query answers a real analyst question, such as finding accounts with both failed and successful logons or hosts with the most unique users. - Concept coaching with guardrails: Each phase names concepts out loud, lists common gotchas (e.g., == vs =, case sensitivity, bin time units), and includes after-action reflection prompts. - Use Case: A career-switching learner in a cybersecurity operations program opens the demo workspace and, within about 60 minutes, writes queries that filter Windows SecurityEvent logs, aggregate failed logons by hour, and render a timechart. ## Quick Start Ask the mentor to start the cso-kql-foundations project and walk you through writing your first KQL queries in the Log Analytics demo workspace.

Frequently Asked Questions about cso-kql-foundations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I learn KQL for security analysis as a beginner?

Start with the free Azure Log Analytics demo workspace, which requires only an Azure sign-in and no resource setup. Practice core operators in order: where for filtering, project for columns, summarize with bin for aggregation, then join for combining tables.

How do I query failed logons in Azure Log Analytics with KQL?

Filter the SecurityEvent table for EventID 4625 within a time range, then aggregate with summarize count by bin(TimeGenerated, 1h) and Account. Add render timechart to visualize failure spikes over time.

Do I need my own Azure resources to practice KQL?

No. Microsoft hosts a world-readable demo workspace accessible via aka.ms/lademo that contains pre-populated sample tables. You only need an Azure account to sign in; no resources are created or billed.

Why does my KQL where clause return no results?

KQL uses == for equality, not a single =, and string comparison is case-sensitive by default. Use =~ for case-insensitive matching, and verify the column name with getschema if results are still empty.

When should I use join versus countif in KQL?

Use join when you need rows that exist in both of two separate result sets, such as accounts appearing in both failed and successful logon lists. Use countif when computing multiple conditional metrics on the same grouped data, which is often simpler.

What are the limitations of this KQL foundations project?

The project is read-only queries against a demo workspace. It deliberately excludes dashboards, saved queries, functions, parameterized let statements beyond basics, and alerting, which are covered in later track projects.