
Troubleshoot observability
Coordinate Azure observability troubleshooting for application or agent health, runtime failures, operational latency, telemetry, monitoring
- Scripts
- Python
- Platforms
- Claude Code, Codex, Cursor
- GitHub stars
- 3.2K
- Last commit
- today
- License
- MIT
- Listing updated
- today
When your agent uses it
Coordinate Azure observability troubleshooting for application or agent health, runtime failures, operational latency, telemetry, monitoring, alerts, evidence-backed fixes and recovery. Use for an end-to-end observability investigation or explicit instrumentation, collection or alerting guidance. Not general resource/app/agent creation, model deployment, RBAC, cost or coding. Conceptual questions need no journey; explicit specialist requests stay direct. Actions require applicable approval.
From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.
What it can access
- Runs Python scripts(see the files on GitHub)
- Network calls found in its scripts(see the files on GitHub)
- License: MIT(see the files on GitHub)
From a static check of its 24 files (172 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.
Install
Copy the skill folder to ~/.claude/skills/troubleshoot-observability to use it in all your projects:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/troubleshoot-observability &&
cp -R "$tmp/.github/plugins/azure-observability/skills/troubleshoot-observability" ~/.claude/skills/troubleshoot-observability &&
rm -rf "$tmp"For one project only, put the folder in .claude/skills/troubleshoot-observability inside it instead.
Copy the skill folder to ~/.agents/skills/troubleshoot-observability to use it in every repository:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/troubleshoot-observability &&
cp -R "$tmp/.github/plugins/azure-observability/skills/troubleshoot-observability" ~/.agents/skills/troubleshoot-observability &&
rm -rf "$tmp"For one repository only, put the folder in .agents/skills/troubleshoot-observability inside it instead.
Copy the skill folder to ~/.cursor/skills/troubleshoot-observability to use it in every project:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/troubleshoot-observability &&
cp -R "$tmp/.github/plugins/azure-observability/skills/troubleshoot-observability" ~/.cursor/skills/troubleshoot-observability &&
rm -rf "$tmp"For one project only, put the folder in .cursor/skills/troubleshoot-observability inside it instead.
Run in a terminal (add --scope workspace to install it for the current workspace only):
gemini skills install https://github.com/microsoft/skills.git --path .github/plugins/azure-observability/skills/troubleshoot-observabilityOr copy the folder to ~/.gemini/skills/troubleshoot-observability yourself.
For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/troubleshoot-observability:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/troubleshoot-observability &&
cp -R "$tmp/.github/plugins/azure-observability/skills/troubleshoot-observability" ~/.copilot/skills/troubleshoot-observability &&
rm -rf "$tmp"For one project only, put the folder in .github/skills/troubleshoot-observability inside it instead.
Get the folder:
git clone --depth 1 https://github.com/microsoft/skills.gitThen copy skills/.github/plugins/azure-observability/skills/troubleshoot-observability into your agent's skills folder as troubleshoot-observability. Agents that support SKILL.md read one folder per skill.
Troubleshoot observability FAQ
How do I install Troubleshoot observability in Claude Code?
Copy the skill folder from GitHub to ~/.claude/skills/troubleshoot-observability to use it in all your projects, or to .claude/skills/troubleshoot-observability in one project.
Does Troubleshoot observability run scripts?
Yes. It runs Python scripts. Its scripts contain network calls. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.
Which AI agents can use Troubleshoot observability?
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.
More from microsoft/skills


Diagnose Day-2 AKS GPU and KAITO incidents using profile-aware, read-only evidence
- Open source
- 3.2K GitHub stars

Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk;
- Open source
- 3.2K GitHub stars

Collects bounded packet captures from AKS nodes and Azure network configuration for wire-level evidence
- Open source
- 3.2K GitHub stars

Debug live Azure Kubernetes Service (AKS) incidents with a read-only, evidence-first investigation
- Open source
- 3.2K GitHub stars

Builds an Azure portal deep link to a specific blade/menu item for supported Microsoft.ContainerService, Microsoft.Kubernetes, and Microsoft
- Open source
- 3.2K GitHub stars
- Cloud and infrastructure