# observability

Субагент по observability в Microsoft Agent Framework: разбирает, как подключить OpenTelemetry к чат-клиентам и агентам на C#, и как отправить трейсы, метрики и логи в нужный бэкенд.

- субагент · `type=agent` · Claude Code, Cursor, Codex · ★ 521 у репозитория
- Автор: eavanvalkenburg
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Frameworks/Microsoft-Agent-Framework/skills/microsoft-agent-framework/references/official-docs/agents/observability.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/observability

## Что делает

Субагент разбирает observability в Microsoft Agent Framework. Он показывает, как включить телеметрию для чат-клиента через `UseOpenTelemetry` в билдере и для агента через `WithOpenTelemetry`. Трейсы, логи и метрики идут по OpenTelemetry GenAI Semantic Conventions, поэтому ложатся в уже настроенный бэкенд.

Дальше начинается настройка экспортёров. Примеры используют Azure Monitor exporter и читают `APPLICATION_INSIGHTS_CONNECTION_STRING` из окружения — без этой переменной код падает с `InvalidOperationException`. Провайдер трейсов и метрик должен слушать то же имя источника, что вы передали в `sourceName`; если имя не задать, останется `Experimental.Microsoft.Agents.AI`. Для локальной разработки субагент советует Aspire Dashboard.

Две вещи, на которых легко споткнуться. Если включить инструментацию и на клиенте, и на агенте, промпты и ответы попадут в спаны дважды. `EnableSensitiveData` добавляет в телеметрию промпты, ответы, аргументы и результаты вызовов функций, так что включать его стоит только в разработке и на тестах.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/observability.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/observability.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/observability.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Frameworks/Microsoft-Agent-Framework/skills/microsoft-agent-framework/references/official-docs/agents/observability.md

## Когда брать
- включить трейсы OpenTelemetry для чат-клиента на C#
- вывести метрики агента в Azure Monitor
- убрать дубли спанов, когда инструментированы и клиент, и агент
- сверить имя источника в `AddSource` с тем, что ушло в `UseOpenTelemetry`
- не пустить промпты и аргументы функций в прод-логи

## Примеры запросов агенту
- Покажи, как обернуть `IChatClient` в `UseOpenTelemetry` с именем источника `MyApplication`.
- Собери `TracerProvider` с Azure Monitor exporter и `AddSource` для моего агента.
- Почему у меня дублируются спаны, если observability включена и на чат-клиенте, и на агенте?

## Похожие
- [agent-observability](https://affpapa.org/nevibecode/skills/agent-observability.md) — скилл · 373 установки
- [iii-observability](https://affpapa.org/nevibecode/skills/iii-observability.md) — скилл · 195 установок
- [golang-observability-opentelemetry](https://affpapa.org/nevibecode/skills/golang-observability-opentelemetry.md) — скилл · 430 установок
- [183-java-observability-tracing-opentelemetry](https://affpapa.org/nevibecode/skills/183-java-observability-tracing-opentelemetry.md) — скилл · 253 установки
- [monitoring-observability](https://affpapa.org/nevibecode/skills/travisjneuman-monitoring-observability.md) — скилл · 146 установок
- [implementing-observability](https://affpapa.org/nevibecode/skills/implementing-observability.md) — скилл · 1 установка

Из того же набора: [managedcode/dotnet-skills](https://affpapa.org/nevibecode/by/managedcode/dotnet-skills.md) — 38 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
