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로 Publisher Analytics 내보내기

모든 저장소의 분석 정보를 포함하는 포괄적인 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 헤더

Enterprise Plus에 추가 기능으로만 제공되며, 이는 Enterprise Plus 측에서 커스텀 데이터 내보내기 파이프라인(커스텀 Elastic 인덱스 등)을 설정해야 하기 때문입니다.

Update on GitHub