Аналитика издателя

Эта функция входит в планы Team & Enterprise.

Панель аналитики издателя

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

Разбивка по репозиториям

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

Экспорт аналитики издателя в CSV

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

Вы также можете получить доступ к этим данным программно через следующий API-эндпоинт:

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://huggingface.co/organizations/YOUR_ORG_NAME/settings/publisher-analytics/download-breakdown" \
  --output breakdown.csv

Структура ответа

Файл CSV содержит записи о ежедневных загрузках для каждой из ваших моделей и наборов данных.

repoType,repoName,total,timestamp,downloads
model,huggingface/CodeBERTa-small-v1,4362460,2021-01-22T00:00:00.000Z,4
model,huggingface/CodeBERTa-small-v1,4362460,2021-01-23T00:00:00.000Z,7
model,huggingface/CodeBERTa-small-v1,4362460,2021-01-24T00:00:00.000Z,2
dataset,huggingface/documentation-images,2167284,2021-11-27T00:00:00.000Z,3
dataset,huggingface/documentation-images,2167284,2021-11-28T00:00:00.000Z,18
dataset,huggingface/documentation-images,2167284,2021-11-29T00:00:00.000Z,7

Структура объекта репозитория

Каждая запись в CSV содержит:

• repoType: тип репозитория (например, «model», «dataset»)
• repoName: Полное имя репозитория с указанием организации (например, “huggingface/documentation-images”)
• total: накопленное количество загрузок этого репозитория
• timestamp: дата в формате ISO 8601 (UTC)
• downloads: количество загрузок за этот день

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

Диаграммы загрузок не дедуплицируются по пользователям. Если вам нужны уникальные количества загрузок, обратитесь к следующему разделу.

Уникальные загрузчики и более детальные журналы

Эта функция является дополнением к плану Enterprise Plus.

В качестве расширенной функции Hugging Face позволяет экспортировать анонимизированные журналы доступа на уровне запросов для всех моделей и наборов данных, опубликованных вашей организацией. Каждая строка представляет собой отдельный запрос, связанный с загрузкой, что обеспечивает полную детализацию данных о загрузках ваших моделей и наборов данных.

Ваша команда отвечает за сбор этих журналов и выполнение вычислений на их основе. Экспорт намеренно включает необработанные коды состояния HTTP и методы, чтобы вы могли классифицировать запросы HEAD, частичного содержимого, перенаправления и другие паттерны запросов в соответствии с собственными аналитическими потребностями.

Поскольку для этого необходимо настроить собственный конвейер экспорта данных на нашей стороне (собственный индекс Elastic и т. д.), эта функция доступна только как дополнение к Enterprise Plus.