---
title: "Логи запросов AI Gateway: просмотр, анализ и выгрузка"
description: "Логи запросов AI Gateway: просмотр, поиск, анализ стоимости и ошибок, выгрузка в CSV. Документация по созданию и настройке облачных сервисов Timeweb Cloud."
---

# Логи AI Gateway

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

Логи запросов — это журнал обращений к моделям по ключам AI Gateway. Для каждого запроса логируются такие данные, как модель, расход токенов, стоимость, время выполнения и результат. 

С помощью логов можно просмотреть статистику запросов, определить, на какие запросы расходовались ресурсы, как долго шла обработка, почему запрос завершился ошибкой, и так далее.

## Ограничения

-   Записи в логе хранятся 90 дней, после чего автоматически удаляются.
-   Запрос появляется в панели через несколько секунд после ответа модели, а не мгновенно.
-   Запросы, выполненные до 9 октября 2026 года, отсутствуют в логах.
-   В логах доступны только запросы по ключам AI Gateway. Запросы агентов и баз знаний в логи не попадают.

## Как формируется лог

Лог фиксирует состояние запроса на момент его выполнения.

Запись в логе формируется в несколько этапов:

1.  Приложение отправляет запрос в AI Gateway по своему ключу. 
2.  AI Gateway передает запрос провайдеру, при необходимости переключается на резервную модель и параллельно фиксирует ход выполнения. 
3.  Сервис логов дополняет запись ценами и именем ключа. После этого строка появляется во вкладке «Логи».

### Состав данных

Из запроса в лог попадают:

-   модель, указанная в запросе, и модель, которая фактически ответила;
-   ключ;
-   время запроса;
-   количество входящих и исходящих токенов, а также доля токенов, взятых из кэша;
-   IP-адрес и user-agent, с которых пришел запрос (доступны в RAW JSON в детализации). 

При сохранении запись дополняется тремя значениями:

-   стоимость, рассчитанная по ценам на момент запроса с учетом индивидуальных скидок;
-   имя ключа на момент запроса;
-   цепочка резервных моделей, с которой запрос поступил в AI Gateway.

> [!NOTE]
> Тексты промпта и ответа модели не сохраняются в логе, в том числе в RAW JSON в детализации. 

## Просмотр логов

Чтобы просмотреть логи:

1.  Перейдите в раздел «ИИ-сервисы» → «AI Gateway».
2.  Откройте вкладку [«Логи»](https://timeweb.cloud/my/cloud-ai/gateway/logs).
3.  (Опционально) Выберите конкретный ключ и интересующий вас период.
4.  (Опционально) Отфильтруйте вывод по имени провайдера и причине завершения запроса.

Удаленные ключи будут доступны в списке, если за последние 90 дней по ним выполнялись запросы.

### Чтение графика

На графике можно вывести данные по запросам, токенам и стоимости. Для периодов до 48 часов данные группируются по часам, для более длинных — по суткам. 

Три самые часто используемые модели выделяются отдельно, остальные объединяются в серию «Остальное». 

![Ии Сервисы 2026 10 20 10 55](https://content.timeweb.com/assets/3a76a70e-c584-4e12-b0de-72ae02177f46.png?width=1099&height=564)

### Чтение таблицы

В таблице для каждого запроса указаны ключ и модель, дата в часовом поясе браузера, цена, токены, кэш, скорость, задержка, TTFT (время до первого токена, отображается только у стриминговых запросов) и результат.

По клику на строку таблицы откроется [детализация запроса](https://timeweb.cloud/docs/ai-agents/api-usage/logs#detalizaciya-zaprosa).

![Ии Сервисы 2026 10 20 13 54](https://content.timeweb.com/assets/7d53cc4f-6a56-4541-9f31-abf8fbe55136.png?width=1105&height=605)

## Поиск и фильтрация

Чтобы найти конкретный лог, можно воспользоваться поиском и фильтрами.

Поиск работает по трем полям: имени ключа, названию модели и ID запроса. ID необходимо указывать в поле поиска целиком. 

Дополнительно доступны фильтры по провайдеру и по причине завершения запроса.

Если нужный запрос не удается найти, проверьте, какой ключ и период выбраны над графиком и какие фильтры применены, а также обратите внимание [на ограничения логов](https://timeweb.cloud/docs/ai-agents/api-usage/logs#ogranicheniya).

## Анализ логов

### Детализация запроса

Кликните по строке в таблице логов, чтобы открыть детализацию запроса. В ней можно посмотреть:

-   **Модель запроса** — модель, указанная приложением в поле `model`. Если запрос обработан без переключений, совпадает с моделью ответа.
-   **Модель ответа** — модель, которая фактически ответила. Отличается от модели запроса, если [сработал фолбэк](https://timeweb.cloud/docs/ai-agents/api-usage/logs#analiz-raboty-rezervnyh-modelej). Провайдер в логе определяется по модели ответа.
-   **Ключ AI Gateway** — если ключ еще существует, по клику на имя можно [перейти к управлению им](https://timeweb.cloud/docs/ai-agents/api-usage/ai-gateway#upravlenie-api-kluchami).
-   **ID запроса** — уникальный идентификатор запроса, который можно скопировать в один клик. По ID запрос ищется через поиск. Его же можно передать в тикете при обращении в поддержку.
-   **Стриминг** — признак того, что ответ передавался частями по мере генерации, а не целиком после завершения. 
-   **Задержка провайдера** — длительность запроса целиком: от момента поступления в AI Gateway до последнего токена ответа, включая все попытки.
-   **Скорость** — количество токенов ответа в секунду, рассчитанное по времени генерации. Если ответ пустой или сгенерирован быстрее чем за 0,1 секунды, указывается прочерк.
-   [**Стоимость / токены**](https://timeweb.cloud/docs/ai-agents/api-usage/logs#proverka-stoimosti) — входящие и исходящие токены, кэш и итог в рублях и токенах. 
-   **Фолбэки** — блок отображается, если был [переход на резервную модель](https://timeweb.cloud/docs/ai-agents/api-usage/logs#analiz-raboty-rezervnyh-modelej). В логе видна вся цепочка и точка, на которой она остановилась.
-   **Ответы провайдеров** — время обработки, а при неуспешном обращении — [коды и причины отказа](https://timeweb.cloud/docs/ai-agents/api-usage/logs#diagnostika-oshibok) по каждой попытке.
-   **RAW JSON** — вся строка лога целиком, включая поля, которых нет в интерфейсе. Ее можно скачать файлом и приложить к обращению в поддержку.

![Ии Сервисы 2026 10 20 13 56](https://content.timeweb.com/assets/92d546bc-5fb2-48b4-8c4f-0128e8f82536.png?width=1713&height=862)

### Проверка стоимости

Стоимость показана для входящих и исходящих токенов, кэша и итога, в рублях и токенах. 

Кэш отображается в виде скидки, то есть суммы, сэкономленной на повторном контексте. 

Сумма меньше одной тысячной рубля отображается как «< 0,001 ₽». 

Прочерк означает, что цену на момент запроса получить не удалось: модель неизвестна биллингу или биллинг не ответил. 

У запросов, завершившихся отказом, токенов нет, поэтому стоимость нулевая.

> [!NOTE]
> Сумма в логах может отличаться от фактических списаний. Логи в первую очередь помогают определить, какие именно запросы дали расход.

### Анализ работы резервных моделей

Если основная модель не ответила, AI Gateway последовательно пробует [резервные модели](https://timeweb.cloud/docs/ai-agents/api-usage/fallback) из настроек ключа. В этом случае модель ответа в детализации будет отличаться от модели запроса. 

В детализации для такого запроса доступны:

-   Блок «Фолбэки» с основной моделью и резервами по порядку, где зеленая точка отмечает модель, давшую ответ.
-   Коды и причины отказа по каждой попытке в блоке «Ответы провайдеров», например, таймаутом, превышением лимита запросов или ошибкой провайдера.

![U P9 Ffuc Ugx 2026 10 20 13 57](https://content.timeweb.com/assets/96b3cf17-decb-4155-b5b0-414591cd65e1.png?width=614&height=502)

Повторные попытки к одной и той же модели не выводятся — в «Ответах провайдеров» отображается одна строка на каждую модель цепочки, до которой дошел запрос. 

Стоимость такого запроса рассчитывается по модели, которая ответила.

### Диагностика ошибок

Итог каждого запроса отображается в таблице в колонке «Результат», а в детализации — в пункте «Причина завершения».

Успешные завершения помечаются зеленым и бывают трех видов: 

-   «Успешный ответ», когда модель закончила ответ сама;
-   «Лимит длины ответа», когда достигнут `max_tokens` и ответ обрезан;
-   «Вызов инструмента», когда модель запросила вызов функции.

Отказы помечаются красным, а в детализации выводится код ошибки. 

Статус «В обработке» ошибкой не является. Так помечается генерация видео, которая выполняется у провайдера в течение нескольких минут. Итог такой строки в лог не дописывается: статус и пустая стоимость сохраняются как есть, а списание за видео проходит в обычном порядке.

Код и имя ошибки отображаются в блоке «Ответы провайдеров» в детализации. Полный текст ошибки можно найти в RAW JSON, в поле `error_message`.

| **Код** | **Значение** | **Причина и рекомендуемые действия** |
| --- | --- | --- |
| 400 | Некорректный запрос | Провайдер не принял запрос: неподдерживаемый параметр, слишком длинный контекст, неверный формат сообщений или отказ фильтра безопасности. Необходимо исправить запрос с учетом текста ошибки. |
| 402 | Недостаточно средств | AI Gateway не смог зарезервировать оплату: на балансе недостаточно средств или аккаунт заблокирован. Необходимо пополнить баланс, а при положительном балансе проверить, не заблокирован ли аккаунт. |
| 404 | Модель недоступна | Модель с таким названием неизвестна. Название необходимо сверить с каталогом моделей. |
| 408, 504 | Таймаут ответа | Модель не ответила вовремя. Запрос можно повторить, для длинных ответов включить стриминг, а при частых таймаутах настроить резервные модели. |
| 410 | Модель недоступна | Модель снята с поддержки. Необходимо перейти на другую модель. |
| 422 | Превышен лимит ключа | Исчерпан лимит расхода, заданный на ключ. Лимит можно поднять или снять в настройках ключа. |
| 429 | Превышен лимит запросов | Провайдер ограничил частоту запросов или не располагает свободной мощностью. Можно повторить запрос позже, снизить частоту или настроить резервные модели. |
| 5xx | Ошибка провайдера | Сбой на стороне провайдера или в канале связи с ним. Можно повторить запрос, резервные модели переключат его автоматически. |
| Другой код | Ошибка | Любой другой отказ. Причину необходимо искать в тексте ошибки в детализации. |

## Выгрузка логов

Вы можете выгрузить логи в формате CSV.  В один файл попадают 10 000 последних запросов. Если запросов больше, измените период, ключ или фильтры, чтобы сузить выборку и выгрузить данные частями.

Чтобы скачать логи в CSV:

1.  Перейдите в раздел «ИИ-сервисы» → «AI Gateway».
2.  Откройте вкладку [«Логи»](https://timeweb.cloud/my/cloud-ai/gateway/logs).
3.  (Опционально) Выберите ключ и период.
4.  (Опционально) Отфильтруйте вывод по имени провайдера и причине завершения запроса.
5.  Нажмите на иконку скачивания справа над графиком.

![Ии Сервисы 2026 10 20 13 59](https://content.timeweb.com/assets/c4e70ae7-d121-4026-aeb2-be1f63c4c517.png?width=1110&height=570)