azure-troubleshoot

Diagnose Azure infrastructure issues across VMs, AKS, and storage.

1|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/timbuchinger/loadout --skill azure-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-troubleshoot
Source: https://github.com/timbuchinger/loadout/tree/main/skills/azure-troubleshoot
Command: npx skills add https://github.com/timbuchinger/loadout --skill azure-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies and accelerates troubleshooting across various Azure services by guiding you through a systematic, tool-first diagnostic process. It helps you quickly pinpoint root causes and recommend targeted corrections.

Core Features & Use Cases

  • Service-Specific Diagnostics: Provides targeted troubleshooting for Virtual Machines, AKS, Azure Container Registry, Storage Accounts, and Log Analytics.
  • Tool-First Approach: Prioritizes using efficient tool-based queries (e.g., Log Analytics Kusto) for logs, metrics, and diagnostic data, falling back to Azure CLI only when necessary.
  • Systematic Workflow: Guides through identifying the service, querying scoped logs/metrics/Activity Logs, interpreting patterns, and recommending targeted fixes.
  • Use Case: Your AKS pods are failing to schedule due to node pressure. This Skill helps you query KubeEvents and KubePodInventory in Log Analytics to diagnose the problem efficiently.

Quick Start

Troubleshoot why my Azure Virtual Machine is failing to boot, checking boot diagnostics logs and Activity Logs for failures.

Frequently Asked Questions about azure-troubleshoot

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

FAQPage Schema
How do I troubleshoot an Azure Virtual Machine that won't boot?

Troubleshoot VM boot failures by checking boot diagnostics logs and Activity Logs through Azure's diagnostic tools. This Skill guides you through querying these logs systematically to identify OS, disk, or configuration issues preventing startup.

How can I diagnose why my AKS pods are failing to schedule?

Diagnose pod scheduling failures by querying KubeEvents and KubePodInventory in Log Analytics to detect node pressure, resource constraints, or RBAC issues. This Skill provides scoped Kusto queries to pinpoint the root cause efficiently.

What's the fastest way to troubleshoot Azure infrastructure issues across multiple services?

Use a tool-first diagnostic approach: query Log Analytics, metrics, and Activity Logs before resorting to CLI commands. This Skill applies this workflow to VMs, AKS, ACR, and Storage Accounts to isolate and resolve issues quickly.

Can I use this to troubleshoot Azure Container Registry image pull problems?

Yes. This Skill covers ACR image pull failures by walking through firewall access restrictions, RBAC token validation, and authentication issues using Log Analytics diagnostics and targeted remediation steps.

How do I investigate Azure Storage Account or Log Analytics access issues?

Investigate access failures by reviewing firewall rules, NIC/IP misconfigurations, and Activity Logs through Log Analytics queries. This Skill provides a systematic diagnostic workflow to identify and correct connectivity and permission problems.