К основному содержанию
скилл CX Codex

troubleshoot-observability — скилл для Claude Code: диагностика Azure

Скилл troubleshoot-observability для Claude Code координирует поиск неисправностей в Azure. Направляет агента при анализе ошибок выполнения, задержек и настройке мониторинга.

MIT ★ 3 232 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add microsoft/skills
/plugin install azure-observability@skills
Открыть на GitHub

Что делает troubleshoot-observability

Этот скилл помогает выявлять причины сбоев в работе приложений и агентов. При запуске агент проверяет наличие конкретного запроса на диагностику, будь то медленная работа API, неудачное развертывание или вопросы по настройке телеметрии. Для работы требуются внешние зависимости, такие как azure-diagnostics и microsoft-foundry, которые обнаруживаются через инструменты хоста.

Система не выполняет автоматическое создание ресурсов или правку кода, а предоставляет пошаговые инструкции для расследования. Если данных для вывода недостаточно, агент помечает статус как неопределённый. Все действия по изменению инфраструктуры или доступу к данным требуют отдельного подтверждения пользователя.

Какие задачи решает

  • диагностика задержек API
  • поиск причин сбоев развертывания
  • настройка телеметрии и алертов
  • верификация исправлений после инцидентов

Примеры запросов агенту

  • /plugin marketplace add microsoft/skills
  • troubleshoot-observability, мой API стал работать медленнее, помоги найти причину
  • проверь состояние observability для текущего окружения

Как установить troubleshoot-observability

1Через маркетплейс плагинов

/plugin marketplace add microsoft/skills
/plugin install azure-observability@skills

Команда ставит плагин azure-observability целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add microsoft/skills --skill troubleshoot-observability -a claude-code

3Вручную: положить файлы

~/.claude/skills/troubleshoot-observability/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/troubleshoot-observability/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о troubleshoot-observability

Как установить troubleshoot-observability в Claude Code?

Выполните последовательно команды /plugin marketplace add microsoft/skills и /plugin install azure-observability@skills.

Что делает troubleshoot-observability?

Он структурирует процесс поиска неисправностей в Azure, помогая агенту выявлять проблемы производительности и телеметрии, не допуская случайных изменений инфраструктуры.

Что нужно для работы troubleshoot-observability?

Необходим доступ к инструментам хоста для обнаружения внешних зависимостей, таких как azure-diagnostics и microsoft-foundry.

Исходный текст

SKILL.md · MIT
---
name: troubleshoot-observability
description: "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."
license: MIT
metadata:
  author: Microsoft
  version: "1.0.1"
---

# Azure Observability skill plugin

Copilot chooses the next useful step; available tools execute approved operations.
This is instruction-guided routing, not a diagnostics engine or permission sandbox.

## Current-request intent gate

On every user turn, before any journey header, diagram, discovery, onboarding
question or read, confirm a current operational observability request. "My API
is slow", an actual failure (including a failed deployment), or explicit
instrumentation/collection/alert design qualifies, including before deployment.
Conceptual questions get direct answers. Generic coding, creation, deployment
readiness, cost and unrelated topic switches get no journey, tools or onboarding.
Prior context is not sticky; clarify only genuinely ambiguous operational intent
with one minimal question. Explicit specialist requests stay direct.
Read [intent details](references/intent.md) only for an ambiguous admission decision.

## Standalone availability gate

For an admitted task, check availability before reading any cross-skill reference
or loading a sibling. Individual installation may omit them.
Use available core instructions in this bundle; their use below is conditional.
Unknown availability follows the missing-reference fallback.
Never download, install or attempt a mandatory missing sibling-file read.
Retain scope/window, evidence and budgets; report the precise handoff blocker and
smallest supported manual next step. Do not claim an absent specialist executed.
Canonical `azure-diagnostics` and `microsoft-foundry` are external dependencies:
discover them through the host under [dependency selection](references/canonical-dependencies.md),
never by assumed sibling paths. Missing external instructions do not block
the local evidence-only affected-path workflow or imply permission to install.
For agent/model/tool failures or AI-specific analysis, check the host's exposed
skills and load enabled, relevant `microsoft-foundry` instructions before
choosing a core fallback. Not bundled does not mean unavailable. Follow the
dependency selection checkpoint; unknown discovery is not confirmed absence.

## Select one path

Load only the applicable guidance below, not every reference.

| Current need | Instructions to select |
|---|---|
| Find telemetry or resolve missing target/source | Available `connect-observability` |
| Broad health | Available `assess-observability-health` |
| Completed ranked health, no finding selected | Ask for selection; never auto-select rank 1 or reassess |
| Named alert, failure, slow operation or selected finding | [Bounded affected-path investigation](references/investigation/README.md); host-discover canonical `azure-diagnostics` for service-specific expertise or `microsoft-foundry` for AI-specific expertise when needed |
| Missing scope/access or a live-read plan | [Scope and permissions](references/scope-permissions.md) |
| Specialist handoff or additional capability need | [Selection](references/selection.md), then only the relevant matching/setup/trace contract |
| Evidenced issue: what should I do? | [Next actions](references/next-actions.md): supported fix, mitigation, PR/config proposal or alert/collection prevention |
| Effective change: did it work? | Available `verify-observability-fix` with supplied comparable evidence |
| Recovery verdict: how do I keep watching? | [Monitoring follow-up](references/monitoring-follow-up.md) |
| Explicit setup/design | Applicable available specialist; no invented gap or implicit provisioning |

## Boundaries and presentation

Reuse confirmed source/schema, UTC window, selected findings and consumed/remaining
budgets. Supplied evidence needs no cloud, installation, scripts, jobs or saves.
Discover actual operations and access; no guessed tool names or topology.
Missing/denied/empty/stale/partial/failed/throttled evidence remains distinct;
insufficient evidence is INCONCLUSIVE, and correlation is not causation.
Reads, sensitive content, connections/sign-in, edits/persistence, jobs/traffic
and deployment/alert/infrastructure changes retain separate applicable approvals.
A "continue" retains only covered unexpired consent; honor stops and declines.

At journey entry, before a scope/approval question or specialist handoff, read
the [indicator](references/journey-indicator.md) and show its fenced Mermaid
stepper below actual **Using:** / **Stage:**. Telemetry mapping stays within
Detect or Investigate; it does not postpone presentation. Repeat only at meaningful
transitions. On reported rendering failure use its text fallback, not an SVG file.
Locally inspected guidance uses **Instructions read:** and **host activation
unverified**. Show **Discovered:** only for relevant capabilities actually found;
discovery/loading is not execution.
Apply [next actions](references/next-actions.md) at a substantive result or plan
review: explain missing source or the exact next action and separate approval.
Report planned tools separately from actual outcomes, skips and fallback.

Remediate means options and a reviewed plan, not automatic changes. Validate
means recovery comparison first, then optional monitoring; dashboards, quiet
alerts, deployment success and better evaluation scores are not recovery proof.
No dashboard or monitoring setup is required. Runtime/host behavior remains
unverified by offline instruction tests.

© Microsoft · MIT · microsoft/skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
setting-up-cloudwatch-observability aws Скилл setting-up-cloudwatch-observability для Claude Code помогает настроить CloudWatch Omni или подключить сервис к Application Signals. Он разбирает запрос на первичное подключение и направляет к нужным инструкциям. CX Codex +1 2 100установок database-observability grafana Подключает базу к Database Observability в Grafana Cloud: образцы запросов, explain plans и метрики по каждому digest — без правок в коде приложения. CX Codex +1 4 700установок observability-csp-investigation elastic Скилл observability-csp-investigation для Claude Code разбирает проблемы облачных сервисов по метрикам в Elastic. Запускается при расследовании сбоев AWS, от ошибок Lambda до перегрузки RDS. CX Codex +1 419установок cargo-observability getcargo Скилл cargo-observability для Claude Code настраивает мониторинг воркфлоу Cargo и шлёт оповещения при сбоях. Отслеживает процент ошибок, задержки запусков или свежесть моделей по расписанию cron. CX Codex +1 7 900установок python-azure-iot-edge-modules официальный github Скилл python-azure-iot-edge-modules для GitHub Copilot помогает проектировать и проверять Python-модули Azure IoT Edge. Включается при работе с обработкой телеметрии, развёртыванием и устойчивостью к сбоям сети. CX Codex +1 47установок azure-analysis-services MicrosoftDocs Скилл помогает разбирать Azure Analysis Services и искать причины сетевых сбоев. Подключает локальные справочные материалы и документацию Microsoft. CX Codex +1 173установок

Из того же набора250

Весь набор →
azure-ai-voicelive-dotnet Скилл azure-ai-voicelive-dotnet по Azure AI Voice Live SDK для .NET: помогает собрать голосового ассистента с двусторонним обменом аудио по WebSocket. CX Codex +1 1установок azure-ai-projects-dotnet Скилл azure-ai-projects-dotnet помогает писать код на .NET для Azure AI Foundry: управлять агентами, подключениями, датасетами и развёртываниями моделей. CX Codex +1 1установок azure-ai-document-intelligence-dotnet Скилл azure-ai-document-intelligence-dotnet для Claude и GitHub Copilot: помогает писать код на C# с Azure AI Document Intelligence — извлекать текст, таблицы и поля из счетов, чеков и удостоверений. CX Codex +1 1установок azure-ai-agents-persistent-dotnet Скилл azure-ai-agents-persistent-dotnet помогает писать код на C# для Azure AI Agents Persistent SDK. Он настраивает клиент, потоки сообщений, вызовы функций и поиск по файлам. CX Codex +1 1установок connect-observability Скилл connect-observability для Claude Code находит телеметрию приложений Azure и агентов Foundry для запросов о мониторинге, алертах и диагностике. Он подключается только при явной задаче по наблюдаемости. CX Codex +1 ★ 3 232звёзд репо assess-observability-health Скилл assess-observability-health для Claude Code оценивает состояние сервисов Azure и агентов Foundry по телеметрии или логам. Запускается при сбоях API, росте задержек и ошибках среды выполнения. CX Codex +1 ★ 3 232звёзд репо azure-observability Хук azure-observability для Claude Code помогает разбирать сбои Azure Web/API и агентов Foundry, а затем проверять восстановление по фактам. Срабатывает при запуске сессии и после использования инструмента. ★ 3 232звёзд репо azure-observability Плагин azure-observability для Claude Code выстраивает диагностику сбоев веб-приложений и агентов Foundry в Azure. Система помогает разобрать логи и проверить восстановление после внесения правок. ★ 3 232звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой