azure-observability — Claude Code hook: features and setup
azure-observability is a Claude Code hook for troubleshooting Azure web/API issues and Foundry agents, then checking recovery against evidence. It runs at session start and after tool use.
The hook runs track-telemetry.sh on SessionStart and PostToolUse. Its command passes the --harness claude-code argument.
It guides read-only investigation of Azure web/API problems and Foundry agents, supports approved fixes, and helps validate recovery using evidence. The script is invoked with bash from the plugin directory.
What it helps with
investigate an Azure web/API failure in read-only mode
troubleshoot a Foundry agent
apply an approved fix and validate recovery with evidence
Example prompts for the agent
Investigate this Azure web/API failure and verify recovery against evidence.
Troubleshoot the Foundry agent and suggest an approved fix.
How to install azure-observability
1Plugin marketplace
/plugin marketplace add microsoft/skills
/plugin install azure-observability@skills
2Manually: put the files in place
.claude/settings.json
The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json
How do I install azure-observability in Claude Code?
Run /plugin marketplace add microsoft/skills, then /plugin install azure-observability@skills. Add the hook to .claude/settings.json.
What does azure-observability do?
It guides troubleshooting for Azure web/API issues and Foundry agents, approved fixes, and evidence-based recovery checks. Its telemetry script runs at session start and after tool use.
Which events trigger azure-observability?
It runs on SessionStart and PostToolUse.
Source text
claude-hooks.json · MIT
Hooks bundle shipped with the azure-observability plugin for Claude Code.
Guide read-only Azure web/API and Foundry-agent troubleshooting, approved fixes, and evidence-based recovery validation.
Triggers on: PostToolUse, SessionStart.
```json
{
"hooks": {
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/scripts/track-telemetry.sh\" --harness claude-code"
}
]
}
],
"PostToolUse": [
{
"hooks": [
{
"type": "command",
"command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/scripts/track-telemetry.sh\" --harness claude-code"
}
]
}
]
}
}
```