Hub documentation

发布者分析

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

发布者分析

此功能属于 Team & Enterprise 计划的一部分。

发布者分析仪表板

通过详细的下载概览跟踪您仓库的所有活动,该概览会显示您组织发布的所有 Models 和 Datasets 的总下载量。在“全部时间”和“上个月”视图之间切换,以获取不同时间段内各仓库的洞察信息。

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" \
  "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、部分内容、重定向及其他请求模式进行分类。

列描述
timestamp请求时间戳
statusHTTP 状态码(例如 200、206、302、307、304)
methodHTTP 方法(例如 GET、HEAD)
repoName完整的仓库名称(例如 nvidia/segformer-b0)
repoType仓库类型:model、dataset 或 space
hashedUserId用户 ID 的不可逆哈希值(如果已认证)
hashedIpIP 地址的不可逆哈希值(如果未通过身份验证)
country国家 ISO 代码
region区域或城市名称
userAgentHTTP User-Agent 请求头

由于需要我们在内部搭建自定义数据导出管道(例如自定义 Elastic 索引等),此功能仅作为 Enterprise Plus 的附加组件提供。

Update on GitHub