Hub documentation

تحليلات الناشر

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

تحليلات الناشر

تُعد هذه الميزة جزءًا من خطط الفريق والمؤسسات.

لوحة تحليلات الناشر

تتبّع جميع نشاطات مستودعاتك عبر نظرة عامة مفصّلة على التنزيلات تعرض إجمالي التنزيلات لجميع النماذج (Models) ومجموعات البيانات (Datasets) التي نشرتها مؤسستك. بدّل بين عرضَي «كل الوقت» (All Time) و«الشهر الماضي» (Last Month) للحصول على رؤى حول مستودعاتك عبر فترات زمنية مختلفة.

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

تفصيل لكل مستودع

استكشف مقاييس المستودعات الفردية من خلال جدول التفصيل لكل مستودع. استخدم ميزة البحث المدمجة للعثور بسرعة على مستودعات محددة. كما يتضمن كل صف رسمًا بيانيًا للسلاسل الزمنية يوضح اتجاه التحميلات بمرور الوقت.

تصدير تحليلات الناشر بصيغة CSV

حمّل ملف CSV شامل يحتوي على تحليلات لجميع مستودعاتك، بما في ذلك نشاط تنزيل النماذج ومجموعات البيانات.

يمكنك أيضًا الوصول إلى هذه البيانات برمجيًا عبر نقطة النهاية التالية للواجهة البرمجية:

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طابع زمني للطلب
statusرمز حالة HTTP (على سبيل المثال 200، 206، 302، 307، 304)
methodطريقة HTTP (على سبيل المثال GET، HEAD)
repoNameاسم المستودع الكامل (مثل nvidia/segformer-b0)
repoTypeنوع المستودع: model أو dataset أو space
hashedUserIdتجزئة غير قابلة للعكس لمعرّف المستخدم (إذا كان مصادقًا)
hashedIpتجزئة غير قابلة للعكس لعنوان IP (في حالة عدم المصادقة)
countryرمز ISO للبلد
regionاسم المنطقة أو المدينة
userAgentترويسة HTTP User-Agent

بما أنه يتطلب إعداد خط أنابيب مخصص لتصدير البيانات من جانبنا (فهرس Elastic مخصص، إلخ)، فهو متاح فقط كإضافة إلى Enterprise Plus.

Update on GitHub