К основному содержанию
плагин

azure-observability — плагин для Claude Code: что делает и установка

Плагин azure-observability для Claude Code выстраивает диагностику сбоев веб-приложений и агентов Foundry в Azure. Система помогает разобрать логи и проверить восстановление после внесения правок.

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

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

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

Плагин делит разбор инцидентов на четыре шага: обнаружение проблем, исследование пути сбоя, подготовку плана исправлений и валидацию восстановления. Внутрь входят четыре навыка: connect-observability, assess-observability-health, troubleshoot-observability и verify-observability-fix.

Для первичного анализа подключение к облаку не требуется: можно передать сохранённые логи и метрики без чувствительных данных. В таком сценарии плагину не нужны Python, Azure Developer CLI или права на запись в подписку.

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

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

  • разобрать причины срабатывания алерта в Azure
  • найти источник задержек в запросах к веб-API
  • проверить сбои вызова инструментов в агентах Foundry
  • сравнить метрики до и после внесения правок

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

  • Изучи алерт, который только что сработал на моём приложении в Azure.
  • Веб-API отвечает с задержками, найди сбойный участок и предложи варианты исправления.
  • Используй только эти логи. Не делай запросы в Azure и ничего не устанавливай.

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

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

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

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

Вопросы об azure-observability

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

Сначала добавьте каталог командой /plugin marketplace add microsoft/skills, затем установите плагин через /plugin install azure-observability@skills.

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

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

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

Для анализа готовых логов доступ к Azure не требуется. Для сбора живой телеметрии нужен доступ на чтение целевых ресурсов, а для углублённого анализа — установленные навыки azure-diagnostics или microsoft-foundry.

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

azure-observability · MIT
# Azure Observability skill plugin

**Start with the problem. Let Copilot help assemble the troubleshooting path.**

An alert fires. Requests slow down. An agent's tool calls start failing.
You shouldn't have to know which observability tool or specialist to reach
for first.

Describe the symptom. Copilot follows the plugin's guidance to connect your
question to evidence, investigate the affected path, review fix options, and
check recovery. Start troubleshooting without self-assembling an entire
observability toolbox.

**Detect -> Investigate -> Remediate -> Validate**

## From a troubleshooting question to a useful next step

| Stage | What Copilot helps you do | What you get |
|---|---|---|
| **Detect health issues** | Assess existing signals or supplied evidence. | Ranked findings, coverage gaps and a choice of what to investigate. |
| **Investigate the affected path** | Follow relevant application, dependency, infrastructure or agent/tool evidence. | Findings, hypotheses and a bounded next step. |
| **Guide an approved fix** | Review correction, mitigation or recurrence-detection options. | A plan with risks and recovery criteria; execution needs applicable approval. |
| **Validate recovery** | Compare original and post-change evidence after an actual change. | A verdict against agreed symptom and guardrail thresholds, with explicit limitations. |

Start at the stage your question needs. A known failed request can go directly
to investigation; a completed assessment doesn't need another health sweep.
The instructions carry confirmed scope, evidence and approvals across handoffs.

These are guided troubleshooting stages, not continuous detection or automatic
remediation.

## Get Started: Install or Migrate

In Copilot CLI:

1. Add the marketplace: `/plugin marketplace add microsoft/azure-skills`
2. Install this plugin: `/plugin install azure-observability@azure-skills`
3. Update it later with `/plugin update azure-observability@azure-skills`

Start a fresh conversation and try a question below. Keep Azure Skills enabled
for canonical diagnostics/Foundry expertise. Installation grants no telemetry
access or permission to query Azure.
Disable or remove older draft copies through supported plugin management
before enabling `azure-observability`; renamed packages do not update them.

## Start with your question

Enable the plugin in a supported Copilot host and start a fresh chat.

**An alert just fired**

```text
Investigate this alert that just fired on my app.
```

**Requests are slow**

```text
My web API has slow requests. Help me investigate the affected path and review fix options.
```

**An agent needs attention**

```text
Review the health of my agent and its dependencies, and prioritize the top issues by impact.
```

**Infrastructure is affecting the workload**

```text
Why is this cluster throwing OOMKill errors? Help me fix it.
```

**A tool call needs a closer look**

```text
Show me performance and usage insights for this tool call.
```

Share missing scope details when asked; you don't need skill names or query recipes.

### Bring evidence without connecting to Azure

Provide evidence with sensitive details removed and say:

```text
Use only this evidence. Do not query Azure, run scripts, install anything,
edit files, or save data.
```

Initial evidence review doesn't require Python, Azure Developer CLI (`azd`),
saved mappings, write permissions, or a new connection.

## Relevant capabilities, discovered when needed

The instructions guide Copilot to:

1. **Confirm the question**, affected target and evidence.
2. **Reuse available tools and connections.**
3. **Discover relevant specialists** in supported skill locations.
4. **Explain benefits and prerequisites** before proposing additional capabilities.
5. **Retain scope and approval limits** across handoffs.

For service-specific diagnostics, Copilot looks for the canonical
`azure-diagnostics` skill. For applicable AI-specific investigation, it looks
for `microsoft-foundry`. **The plugin does not ship duplicate copies of either.**
Copilot checks skills exposed by the host, including other enabled plugins,
and loads a relevant enabled specialist before choosing a core fallback.
Direct Monitor tools do not establish that Foundry instructions are absent.
If the host does not expose a specialist or a discovery mechanism, Copilot
reports availability as unverified in that session rather than uninstalled.

Azure Monitor is the operational foundation. Foundry is an optional AI-specific
branch, not a requirement for web/API or infrastructure troubleshooting.
Trace Store, an existing connected SRE Agent, and Azure Managed Grafana may be
considered when they address the question and are available.

For missing specialists, Copilot offers a supported host setup path or the
[Azure Skills installation guidance](https://github.com/microsoft/azure-skills#install-in-60-seconds).
Specialists are not installed automatically. Discovery, loading, access and execution
are separate checks. Declined setup still permits sufficient evidence-only
analysis; missing expertise remains explicit.

## What's included

| Core skill | Role |
|---|---|
| `connect-observability` | Confirm deployment context, telemetry associations and task-specific readiness. |
| `assess-observability-health` | Assess existing evidence, rank findings and identify coverage gaps. |
| `troubleshoot-observability` | Coordinate the next useful stage and retain bounded affected-path investigation guidance. |
| `verify-observability-fix` | Compare supplied original and post-change evidence after an effective approved change. |

Core skills are independently usable, subject to host discovery and loading support.

## What you need

| Path | Prerequisites |
|---|---|
| **Review supplied evidence** | A supported host and evidence with sensitive details removed. No Azure access required. |
| **Investigate live telemetry** | A deployed target, confirmed sources, authorized tools, task-specific access and an approved read plan. |
| **Use optional capabilities** | Available specialists/tools, their prerequisites, and applicable setup and execution approvals. |

## You stay in control

Copilot selects instructions; tools execute operations; you approve applicable
actions. Instructions aren't a security sandbox: retain host approvals and least privilege.

- Agree the target, source, UTC window and read limits before live access.
- Approve installation, sign-in, sensitive content, persistence, jobs, edits,
  alert changes and deployment separately when applicable.
- Reviewing a fix, PR proposal or SRE option doesn't authorize execution,
  evidence transfer or publication.
- Missing, stale or noncomparable required evidence yields **INCONCLUSIVE**.
  A successful deployment alone doesn't prove recovery.
- Optional dashboard, alert or later-check guidance follows the recovery verdict;
  it doesn't create automatic monitoring.

## When something is unavailable

| Situation | Next step |
|---|---|
| Guidance isn't loading | Confirm the plugin is enabled, check for duplicate installations, and start a fresh chat. Inspect load events if available. |
| A specialist or tool is missing | Ask for the missing prerequisite and supported setup path. Setup needs applicable approval. |
| Access is denied | Use the normal access process; don't switch identities or broaden permissions to bypass a denial. |
| Evidence is empty, stale or partial | Keep that limitation visible. Missing telemetry is not healthy and doesn't by itself prove missing instrumentation. |

Never share tokens, connection strings, sensitive prompts or unredacted telemetry.
Report issues with the host/version, expected behavior and a safe error description.

## License

This plugin is licensed under the [MIT License](LICENSE).

## Telemetry

The `track-telemetry` hook installs a pinned native `ghcfa-telem` release asset
when needed, verifies its platform-specific SHA-256 digest before extraction,
and caches the executable for reuse. To opt out of telemetry collection, set
`AZURE_MCP_COLLECT_TELEMETRY=false` in the environment of the process running
the agent.

© Microsoft · MIT · microsoft/skills

Похожие плагины

Все плагины по теме «Облака: AWS, Azure, GCP» →
database-observability grafana Подключает базу к Database Observability в Grafana Cloud: образцы запросов, explain plans и метрики по каждому digest — без правок в коде приложения. CX Codex +1 4 700установок dt-obs-azure Dynatrace Скилл dt-obs-azure помогает строить запросы DQL к ресурсам Azure через Dynatrace Smartscape. Он находит виртуальные машины, сети, базы данных и проверяет безопасность облака. CX Codex +1 2 400установок azure-analysis-services MicrosoftDocs Скилл помогает разбирать Azure Analysis Services и искать причины сетевых сбоев. Подключает локальные справочные материалы и документацию Microsoft. CX Codex +1 173установок azure-monitor MicrosoftDocs Скилл для платформ Claude Code, Codex, Cursor и GitHub Copilot с экспертными знаниями по Azure Monitor. CX Codex +1 373установок azure-cost-health-check Shayne Boyer Плагин azure-cost-health-check для GitHub Copilot показывает расходы Azure, прогнозы, бюджеты и рекомендации Advisor в одном канвасе. Включается в FinOps-мониторинг, чтобы проверить, куда уходят деньги. ★ 11звёзд репо setting-up-cloudwatch-observability aws Скилл setting-up-cloudwatch-observability для Claude Code помогает настроить CloudWatch Omni или подключить сервис к Application Signals. Он разбирает запрос на первичное подключение и направляет к нужным инструкциям. CX Codex +1 2 100установок

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

Весь набор →
troubleshoot-observability Скилл troubleshoot-observability для Claude Code координирует поиск неисправностей в Azure. Направляет агента при анализе ошибок выполнения, задержек и настройке мониторинга. CX Codex +1 ★ 3 232звёзд репо 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-advisor-cost-optimization Скилл azure-advisor-cost-optimization для Claude Code анализирует находки Azure Advisor по простаивающим ресурсам и проверяет безопасность их удаления. Запускается на запросы о неиспользуемых ресурсах и экономии на них. CX Codex +1 ★ 3 232звёзд репо aks-cost-optimization Скилл aks-cost-optimization для Claude Code анализирует расходы AKS-кластера: размещение подов, масштабирование узлов и стоимость хранилища. Запускается для проверки NAP, bin packing и заблокированного scale-down. CX Codex +1 ★ 3 232звёзд репо azure Хук azure для Claude Code запускает скрипт телеметрии при старте сессии и после использования инструмента. Он передаёт скрипту метку claude-code. ★ 3 232звёзд репо ui-widget-developer Скилл ui-widget-developer для Claude Code помогает создавать MCP-серверы и интерактивные виджеты для Copilot Chat. Он охватывает создание нового сервера и добавление виджетов к существующему. CX Codex +1 ★ 3 232звёзд репо

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

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