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 の合計ダウンロード数を表示する詳細なダウンロード概要により、リポジトリのすべてのアクティビティを追跡できます。「All Time」と「Last Month」の表示を切り替えることで、異なる期間にわたるリポジトリのインサイトを得ることができます。

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ファイルは、各モデルおよびデータセットの1日ごとのダウンロード記録で構成されています。

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: その日のダウンロード数

レコードは時系列で並べられており、各リポジトリのダウンロードアクティビティの1日ごとの詳細なビューを提供します。

ダウンロード数には、ユーザーによる重複排除は行われていません。ユニークなダウンロード数が必要な場合は、次のセクションを参照してください。

固有のダウンローダーとより詳細なログ

この機能は、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