Логи запросов (Request Logs)

Кому подходит

• Разработчикам — отладка интеграций, разбор ошибок и повторных попыток.
• Администраторам — обзор запросов всех участников организации.
• Финансам — сверка себестоимости и итоговой цены по каждому запросу.

Раздел «Логи» в кабинете

Пункт навигации «Логи» (в личном аккаунте — «Мои логи») находится в группе account. Доступ определяется тем же capability, что и раздел расходов (usage).

Что доступно без дополнительных настроек:

Данные появляются после каждого успешного или частично успешного запроса к API моделей.

Базовый список vs RAW I/O

Без включённого I/O-логирования в детализации запроса отображается подсказка и ссылка на раздел Политики. Полный JSON не выгружается архивом — только просмотр по одному запросу через API.

Расширенное I/O-логирование (политики)

Модуль logging в policy rule:

{ "logging": { "enabled": true } }

Включение в кабинете — шаг «Логирование I/O» в мастере Policy Rules:

• переключатель «Расширенное логирование (RAW запросы и ответы)»;
• выбор области действия — как у бюджета и контента (organization, api_key, member, system, virtual_group);
• подсказка: «+1% к комиссии на каждый запрос с включённым логированием. Данные хранятся 30 дней в защищённом хранилище.»

Объединение правил (приоритет более узкого scope)

В отличие от rateLimit (наиболее строгий) и access (пересечение), модуль logging работает по принципу «узкое правило важнее широкого» — как наследование с переопределением:

1. Собираются подходящие правила по уровням назначения: api_key → system → member → virtual_group → organization → глобальные.
2. От специфичного к общему: первое правило с модулем logging определяет итоговое значение.
3. Если ни одно правило не содержит logging — RAW не пишется.

Примеры:

Комиссия +1%

На запросы, где на момент обработки было включено I/O-логирование (logging_applied=true), к тарифу клиента добавляется +1% (loggingBps = 100). Надбавка начисляется при расчёте стоимости независимо от того, сохранился ли RAW-файл: если запись не удалась, метаданные остаются, RAW может отсутствовать (has_raw_payload=false).

Хранение RAW

• Срок хранения — 30 дней, после чего данные удаляются автоматически.
• Просмотр — только через API платформы (GET .../payload), по одному запросу.

В RAW JSON фиксируется тело запроса после применения маскирования; отдельный блок redaction описывает применённые фильтры.

Видимость: personal / member / admin

Один и тот же API применяет разный scope в зависимости от роли в организации:

Фильтр memberId в query доступен только администратору. Участник не может просмотреть запросы коллег даже зная request_id.

Таблица: цены и токены

Две колонки стоимости

Цены подтягиваются из расчёта стоимости запроса (как в разделе расходов):

Пока расчёт стоимости в статусе pending, в UI отображается —.

Токены

На узких экранах три значения могут объединяться в одну ячейку «Токены» (19 in · 185 out · 4 096 cache); на desktop — отдельные колонки Input / Output / Cache.

Дополнительно в таблице: модель, провайдер, система, скорость (tok/s), finish reason, API key alias, индикатор RAW.

Infinite scroll и CSV

Пагинация: первая загрузка limit=50, offset=0. При прокрутке к низу таблицы подгружается следующая страница, пока items.length < total. Смена периода или фильтров сбрасывает offset и прокручивает список наверх. Навигация prev/next в панели детализации работает по уже загруженным строкам; при необходимости догружается следующая страница.

CSV: кнопка «Скачать CSV» вызывает export с теми же фильтрами, что и таблица (from, to, model, apiKeyId, memberId, hasRaw). Лимит выгрузки — 50 000 строк; при превышении API возвращает 413 с подсказкой сузить период. Имя файла: generations-{orgSlug}-{from}-{to}.csv.

Колонки CSV зеркалируют таблицу UI, включая cache_read_tokens, provider_cost_rub, client_cost_rub. Для admin включена member_email; для member/personal — опускается.

API (кратко)

Базовый путь: /api/organization/generations. Требуется членство в организации.

Ответ списка содержит items[] с полями usageEventId, requestId, finishedAt, modelId, providerId, токены, providerCostRub, clientRub, settlementStatus, throughputTps, finishReason, apiKeyAlias, memberEmail (admin), streaming, latencyMs, fallbackCount, hasRawPayload, loggingApplied.

Что дальше

• Policy Rules (Guardrails) — включение модуля logging
• Расходы и лимиты — биллинг и расчёт стоимости
• Лимиты и квоты — другие модули политик
• Выгрузить расходы — агрегированные отчёты usage