# langfuse

Плагин подключает MCP-сервер Langfuse: ищет трейсы, исключения и медленные сессии, управляет промптами и датасетами через 48 инструментов.

- плагин · `type=plugin` · Claude Code, Codex · ★ 1596 у репозитория
- Автор: Aviv Sinai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/avivsinai/langfuse-mcp
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 1 файл скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/plugins/aviv-sinai-langfuse

## Что делает

Плагин запускает локальный MCP-сервер, который работает через SDK Langfuse. Внутри 48 инструментов: трейсы (`fetch_traces`, `fetch_trace`), исключения (`find_exceptions`, `get_exception_details`), сессии (`get_session_details`, `get_user_sessions`), промпты (`list_prompts`, `create_chat_prompt`) и датасеты (`list_datasets`, `create_dataset_run_item`). Есть инструменты для анализа роутинга (`find_route_decisions`, `find_low_confidence_route_decisions`) и подсчёта ошибок (`get_error_count`).

Исключения детектируются по `level == "ERROR"` в наблюдениях; непустой `status_message` без уровня ошибкой не считается. Детали берутся из `exception.type`, `exception.message` и `exception.stacktrace` в метаданных. Без Python 3.10+ и ключей API (`LANGFUSE_PUBLIC_KEY`, `LANGFUSE_SECRET_KEY`, `LANGFUSE_HOST`) сервер не стартует.

Автор выпустил отдельный скилл `langfuse`, который учит агента, когда вызывать эти инструменты: для дебага трейсов, триажа исключений, анализа латентности.

## Установка

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

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
В чате агента (не в терминале):
```text
/plugin install langfuse@awesome-codex-plugins
```

## Когда брать
- найти все исключения за последние сутки и сгруппировать по файлам
- получить детали трейса с наблюдениями по `trace_id`
- посмотреть сессии конкретного пользователя
- создать чат-промпт или обновить лейблы промпта
- вывести список датасетов и элементы датасета

## Примеры запросов агенту
- Найди все исключения за последний день и покажи топ по файлам
- Покажи детали трейса `abc123` с наблюдениями
- Выведи сессии пользователя `user-456` за последнюю неделю

## Похожие
- [arize-migrate-langfuse](https://affpapa.org/nevibecode/skills/arize-migrate-langfuse.md) — скилл · 417 установок
- [migrate-to-langfuse](https://affpapa.org/nevibecode/skills/migrate-to-langfuse.md) — скилл · 186 установок
- [langfuse-observability](https://affpapa.org/nevibecode/plugins/langfuse-observability.md) — плагин · ★ 32 у репозитория
- [agent-observability-session-classify](https://affpapa.org/nevibecode/skills/agent-observability-session-classify.md) — скилл · 665 установок
- [exploring-ai-failures](https://affpapa.org/nevibecode/skills/exploring-ai-failures.md) — скилл · 198 установок
- [investigate](https://affpapa.org/nevibecode/skills/launchdarkly-investigate.md) — скилл · 718 установок

## Другие версии с тем же именем
- [langfuse · langfuse](https://affpapa.org/nevibecode/plugins/langfuse.md) — ★ 344 у репозитория

Из того же набора: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 карточка

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

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