Anthropic

Admin API Anthropic описывает потребление Claude API на уровне организации двумя отчётами. Usage Report считает токены в разбивке по кэшу промптов: uncached input, cache write (5-минутный и часовой кэш) и cache read. Cost Report показывает ежедневные затраты по статьям расходов в центах США.

Renta синхронизирует оба отчёта в хранилище данных в виде статистики по временным бакетам с разбивкой по воркспейсам, API-ключам, моделям, уровням сервиса и контекстным окнам.

Аутентификация

Renta аутентифицируется организационным ключом Admin API key. Создайте его в Anthropic Console в разделе Settings > Admin keys: ключ начинается с sk-ant-admin. Обычные API-ключи не подойдут: отчётные эндпоинты Admin API их отклоняют.

Создание пайплайна

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

Настройка пайплайна

На последнем шаге выберите, какой отчёт Anthropic выгружать и как Renta будет его загружать.

Тип отчёта и гранулярность

Выберите отчёт и размер его временных бакетов.

1. Report Types Выберите один из двух отчётов. Каждый пайплайн выгружает один отчёт в одну таблицу назначения.

   Тип отчёта	Данные
   Usage Report	Количество токенов по запросам к Claude API: некэшированные входные токены, запись в кэш промптов (5-минутный и часовой), чтение из кэша, выходные токены, а также количество серверных запросов веб-поиска.
   Cost Report	Ежедневные затраты в центах США по статьям расходов с привязкой к воркспейсу, модели, типу токенов и типу затрат.

2. Granularity Выберите размер временного бакета: Minute, Hour или Day. Каждая строка таблицы назначения соответствует одному бакету для одной комбинации значений измерений. Для Cost Report доступен только вариант Day: эндпоинт затрат Anthropic поддерживает только дневные бакеты.

Параметры

Выберите поля, которые попадут в таблицу назначения. Доступный набор зависит от типа отчёта: каждый отчёт сочетает колонки измерений, собственные метрики и поля временного бакета.

Отметьте поля в списке или нажмите Select All. Вкладка Selected показывает всё выбранное, а список Selected Parameters ниже позволяет убрать поле. В таблице назначения колонки называются API-именами, указанными под каждым полем: Workspace ID превращается в workspace_id.

В каждом отчёте есть также три временных поля: Bucket Starting At и Bucket Ending At (границы бакета в UTC) и Bucket Starting Date, дата с точностью до дня, по которой партиционируется таблица назначения. Поле Bucket Starting Date отмечено заранее, убрать его нельзя.

Имя таблицы и диапазон дат

Назовите пайплайн и задайте исторический период загрузки.

1. Integration name.
   Название пайплайна. Используется только в интерфейсе Renta.
2. Table name.
   Имя таблицы назначения. Можно оставить сгенерированное имя или указать своё.

3. Date start.
   Первая дата периода выгрузки.
4. Date end.
   Последняя дата периода выгрузки. Оставьте значение Today, чтобы продолжать собирать новые данные при каждом запуске.

Период перезаписи

Период перезаписи определяет, сколько последних дней Renta перезагружает при каждом запуске.

При каждом запуске Renta заново запрашивает отчёт начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и вставляются заново, более старые данные не меняются. Значение по умолчанию: Last 1 day.

Расписание

Выберите, как часто запускается пайплайн.

Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.

Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.

Стратегия синхронизации

Оба отчёта Anthropic представляют собой статистику по временным бакетам, поэтому у них одна стратегия синхронизации.