aks

Diagnose Azure Kubernetes Service cluster issues using Kusto queries and wiki search.

Updated Aug 13, 2026
One-click install
npx skills add https://github.com/crystalzhangbai/TS-Agent-Azure --skill aks-crystalzhangbai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aks
Source: https://github.com/crystalzhangbai/TS-Agent-Azure/tree/main/bridge/naniteagent-playground/naniteagent/skills/aks
Command: npx skills add https://github.com/crystalzhangbai/TS-Agent-Azure --skill aks-crystalzhangbai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Troubleshooting AKS cluster issues requires manually correlating control plane logs, cluster snapshots, and internal documentation across multiple Kusto databases and wikis, which is slow and error-prone for CSS engineers. ## Core Features & Use Cases - Guided Troubleshooting Workflow: Walks through information gathering, wiki search, cluster snapshot retrieval, KQL queries, and root-cause summarization in a structured sequence. - Pre-Built KQL Query Library: Provides schema-verified query templates for AKSprod, AKSccplogs, AKSinfra, and AKSmetrics databases covering cluster info, health checks, node lifecycle, autoscaler, and audit logs. - Schema-Aware Querying: Ships JSON table schemas and a quick-reference guide to prevent common column-name mistakes like using ccpNamespace instead of namespace on ManagedClusterSnapshot. - Use Case: A customer reports nodes stuck in NotReady after an upgrade. Provide the cluster resource ID and time range, and the skill retrieves the ccpNamespace, checks node events in AKSKubeEvents, inspects ClusterAutoscaler logs, and summarizes the root cause with evidence. ## Quick Start Ask the skill to investigate why pods are failing to schedule on your AKS cluster by providing the cluster resource ID and the time range when the issue occurred.

Frequently Asked Questions about aks

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

FAQPage Schema
How do I troubleshoot AKS node NotReady issues with Kusto?▼

Query the AKSKubeEvents table in AKSccplogs filtered by your ccpNamespace for reasons like NodeNotReady and RegisteredNode, then check ClusterAutoscaler logs for provisioning failures. The skill's node-troubleshooting guide provides the exact KQL templates and analysis steps.

How to query AKS control plane logs in Kusto?▼

First run the ManagedClusterSnapshot query in AKSprod to get the ccpNamespace value, then use it to filter tables like KubeAudit, Etcd, and ClusterAutoscaler in the AKSccplogs database. Most tables filter on the namespace or cluster_id column.

What databases does AKS troubleshooting require access to?▼

You need read access to four Kusto databases: AKSprod for cluster configuration and operations, AKSccplogs for control plane logs and audit events, AKSinfra for underlay infrastructure, and AKSmetrics for pod performance metrics.

Why does my AKS Kusto query fail with column not found errors?▼

Column names differ across tables, such as namespace versus ccpNamespace for cluster filtering, and size versus nodeCount on AgentPoolSnapshot. Verify schemas against the local table-schema JSON files or the TABLE_SCHEMA_REFERENCE guide before writing queries.

Can I analyze Kubernetes audit logs for who deleted a pod?▼

Yes, query the KubeAudit table or ControlPlaneEvents with category kube-audit in AKSccplogs, filtering by verb like delete or patch and parsing the user and objectRef fields. The audit-logs guide includes templates for pod status changes and API server client analysis.

What are the limitations of AKSinfra database for node troubleshooting?▼

AKSinfra only tracks Microsoft-owned underlay infrastructure nodes, not customer worker nodes in the MC_ resource group. For customer node issues, query AKSccplogs for control plane events or use kubectl and Container Insights instead.