> Для получения чистого Markdown любой страницы добавьте .md к URL‑адресу страницы.  
> Для полного индекса документации см. https://api.vega.chat/docs/llms.txt.  
> Для полного содержания документации см. https://api.vega.chat/docs/llms-full.txt.  
> Для интеграции AI‑клиентов (Claude Code, Cursor и др.) подключитесь к серверу MCP по адресу https://api.vega.chat/docs/_mcp/server.

# Langfuse

[Langfuse](https://langfuse.com) — это открытая платформа для инженерии LLM, предназначенная для трассировки, оценки и отладки приложений LLM.

## Шаг 1: Создать API‑ключ Langfuse

В Langfuse перейдите в **Settings > API Keys** вашего проекта и создайте новую пару ключей. Скопируйте как Secret Key, так и Public Key.

![Langfuse API Keys](https://files.buildwithfern.com/openrouter.docs.buildwithfern.com/docs/2fda0df2def9f2d969130c4704f72937461f4cbb8bb9435aa2245bb07391a35e/content/pages/features/broadcast/broadcast-langfuse-keys.png)

## Шаг 2: Включить Broadcast в VEGA

Перейдите в [Settings > Observability](https://api.vega.chat/settings/observability) и переключите **Enable Broadcast**.

![Enable Broadcast](https://files.buildwithfern.com/openrouter.docs.buildwithfern.com/docs/3e095d95758bab05594f468011be81b7d5a2fb19293fa91d5b3923d9f09b81d8/content/pages/features/broadcast/broadcast-enable.png)

## Шаг 3: Настроить Langfuse

Нажмите значок редактирования рядом с **Langfuse** и введите:

* **Secret Key**: ваш Secret Key Langfuse  
* **Public Key**: ваш Public Key Langfuse  
* **Base URL** (необязательно): по умолчанию `https://us.cloud.langfuse.com`. Измените для других регионов или самохостинговых экземпляров

![Langfuse Configuration](https://files.buildwithfern.com/openrouter.docs.buildwithfern.com/docs/10178cb9915dae07364910b865f4dbdbfc18936d91ca39ab0a9f9f1d9892ad79/content/pages/features/broadcast/broadcast-langfuse-config.png)

## Шаг 4: Протестировать и сохранить

Нажмите **Test Connection**, чтобы проверить настройку. Конфигурация сохраняется только при успешном тесте.

![Langfuse Configured](https://files.buildwithfern.com/openrouter.docs.buildwithfern.com/docs/77277ddb0cd573d0efe91338a32735d6b710c4c7ecfdcd610f0750d0262b4202/content/pages/features/broadcast/broadcast-langfuse-configured.png)

## Шаг 5: Отправить тестовый трасс

Сделайте API‑запрос через VEGA и просмотрите трассировку в Langfuse.

![Langfuse Trace](https://files.buildwithfern.com/openrouter.docs.buildwithfern.com/docs/cbd93fc215244ec3906102bdfb3a46c4938c7dd92b076c6a3f3510cc701a9487/content/pages/features/broadcast/broadcast-langfuse-trace.png)

## Пользовательские метаданные

Langfuse поддерживает богатые иерархии трассировок и метаданные. Используйте поле `trace`, чтобы настроить отображение ваших трасс в Langfuse.

### Поддерживаемые ключи метаданных

| Ключ               | Отображение в Langfuse | Описание                                                                                                                                                                       |
| ----------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `trace_id`        | Trace ID               | Группировать несколько запросов в одну трассировку                                                                                                                             |
| `trace_name`      | Trace Name             | Пользовательское имя, отображаемое в списке трассировок Langfuse                                                                                                               |
| `span_name`       | Span Name              | Имя промежуточных спанов в иерархии                                                                                                                                           |
| `generation_name` | Generation Name        | Имя наблюдения генерации LLM                                                                                                                                                  |
| `parent_span_id`  | Parent Observation ID  | Ссылка на существующий спан в иерархии трассировки                                                                                                                             |
| `environment`     | Environment            | Заполняет первоклассное поле `Environment`, используемое фильтром проекта Langfuse (например, `production`, `staging`). Передаётся как атрибут ресурса и как атрибут наблюдения. |
| `release`         | Release                | Версия/релиз приложения, связанный с трассировкой. Передаётся как атрибут ресурса и как атрибут наблюдения.                                                                  |

### Пример

```json
{
  "model": "openai/gpt-4o",
  "messages": [{ "role": "user", "content": "Summarize this document..." }],
  "user": "user_12345",
  "session_id": "session_abc",
  "trace": {
    "trace_id": "workflow_12345",
    "trace_name": "Document Processing Pipeline",
    "span_name": "Summarization Step",
    "generation_name": "Generate Summary",
    "environment": "production",
    "release": "2.1.0",
    "pipeline_version": "2.1.0"
  }
}
```

Это создаёт иерархическую структуру трассировки в Langfuse:

```
Document Processing Pipeline (trace)
└── Summarization Step (span)
    └── Generate Summary (generation)
```

### Дополнительный контекст

* Поле `user` сопоставляется с User ID в Langfuse для аналитики на уровне пользователей.  
* Поле `session_id` сопоставляется с Session ID в Langfuse для группировки разговоров.  
* Любые дополнительные ключи в `trace` передаются как метаданные трассировки и могут использоваться для фильтрации и анализа в Langfuse.

## Режим конфиденциальности

Когда [Privacy Mode](/docs/guides/features/broadcast#privacy-mode) включён для этого назначения, содержимое запросов и ответов исключается из трассировок. Все остальные данные трассировки — использование токенов, затраты, время выполнения, информация о модели и пользовательские метаданные — продолжают отправляться как обычно. См. [Privacy Mode](/docs/guides/features/broadcast#privacy-mode) для подробностей.