Hub documentation

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

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

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

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

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

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

screenshot of the Dataset Viewer on a private dataset owned by a Team or Enterprise organization.

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

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

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

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

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

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "/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, частичного содержимого, перенаправления и другие паттерны запросов в соответствии с собственными аналитическими потребностями.

СтолбецОписание
timestampМетка времени запроса
statusКод состояния HTTP (например, 200, 206, 302, 307, 304)
methodHTTP-метод (например, GET, HEAD)
repoNameПолное имя репозитория (например, nvidia/segformer-b0)
repoTypeТип репозитория: model, dataset или space
hashedUserIdНеобратимый хэш идентификатора пользователя (если аутентифицирован)
hashedIpНеобратимый хэш IP-адреса (если пользователь не аутентифицирован)
countryКод страны ISO
regionНазвание региона или города
userAgentЗаголовок HTTP User-Agent
pathПуть к файлу в репозитории или бакете, полученный из URL запроса (может быть пустым для запросов, не соответствующих маршруту файла)

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

Update on GitHub