الشفافية

تشرح هذه الصفحة كيفية حساب عدد المشاهدات المعروض على هذا الموقع. ومصدر هذه المشاهدات هو Cloudflare Analytics Engine.

يُحتسب كل شخص يزور الموقع مشاهدةً واحدة. ويُقرأ هذا العدد من Workers Analytics Engine.

Workers Analytics Engine هو مخزن Cloudflare لبيانات العدّ التي يمكن أن تتزايد دون قائمة ثابتة من الفئات. وتصفه Cloudflare بأنه نظام تحليلات واسع النطاق لا يحدّ من عدد القيم المتميزة. يكتب Worker نقطة بيانات عبر واجهة برمجة تطبيقات مدمجة. ثم تُقرأ هذه النقاط لاحقًا من الحساب نفسه باستخدام SQL، عبر واجهة برمجة تطبيقات SQL تعمل عبر HTTP. وصيغة SQL المستخدمة هنا منفصلة عن صيغة واجهة Analytics SQL API الأخرى لدى Cloudflare.

وحدة التخزين هي مجموعة البيانات، أو dataset. وتشبّه Cloudflare مجموعة البيانات بجدول في SQL: ينبغي أن يظل لكل صف ولكل عمود معنى ثابت. يُحدَّد اسم dataset في إعدادات Worker وتُربط به. ويظهر الجدول عندما يبدأ Worker بالكتابة. ولا تُعرَّف الأعمدة في خطوة منفصلة.

نقطة البيانات هي حدث واحد، أي صف واحد. تضيف Cloudflare حقل timestamp عندما يسجّل Worker الحدث. أما بقية البيانات فيوفّرها Worker، ويجب أن يقدّمها بالترتيب نفسه في كل مرة. وتسمّي Cloudflare كل موضع في هذا الترتيب حقلًا.

الحقل هو موضع محدّد في ذلك الترتيب. فالسلسلة النصية الأولى تشغل دائمًا حقل النص الأول، والعدد الثاني يشغل دائمًا حقل العدد الثاني. ولا تخزّن قاعدة البيانات اسمًا إلى جانب القيمة، بل تخزّن موضعها. فإذا تغيّر الترتيب، تغيّر معه معنى الحقل. وتتحوّل هذه المواضع إلى أعمدة عند الاستعلام. حقول النص هي من blob1 إلى blob20، وحقول الأعداد من double1 إلى double20، ومفتاح أخذ العينات هو index1. ويحتوي كل صف أيضًا على timestamp وdataset و_sample_interval. ويمكن للاستعلام أن يمنح الحقل اسمًا آخر بحسب الغرض منه، مثل blob1 AS city. لكن اسم الحقل المخزَّن يظل blob1.

توجد ثلاثة أنواع من الحقول. حقول Blobs هي سلاسل نصية. وتسمّيها Cloudflare الأبعاد المستخدمة للتجميع والتصفية، وهي ما تسمّيه أنظمة أخرى تسميات. ويمكن لنقطة البيانات أن تتضمّن عشرين حقلًا نصيًا، على ألا يتجاوز حجمها مجتمعةً 16 كيلوبايت. أما حقول Doubles فهي أعداد تمثّل قياسات يمكن جمعها أو حساب متوسطها. ويمكن لنقطة البيانات أن تتضمّن عشرين حقلًا عدديًا. والفهرس سلسلة نصية واحدة لا يتجاوز حجمها 96 بايت. وتقبل عملية الكتابة قائمةً، لكن Cloudflare لا تخزّن نقطة البيانات إلا إذا احتوت تلك القائمة على فهرس واحد فقط. ووجود فهرس ثانٍ يعني أن النقطة لن تُسجَّل.

عندما يكون حجم البيانات كبيرًا جدًا، يأخذ Analytics Engine عينات منها للحفاظ على سرعة الاستعلامات. وقد يحدث أخذ العينات عند الكتابة وعند القراءة، ويعتمد على الفهرس. فقد تؤخذ عينات من بيانات فهرس يرتبط بعدد كبير من الأحداث، بينما تبقى بيانات فهرس أقل نشاطًا دون أخذ عينات. ويتضمّن كل صف مخزَّن حقل _sample_interval، وهو عدد الأحداث الأصلية التي يمثّلها ذلك الصف. ويُحسب العدد الإجمالي بجمع قيم _sample_interval. ولحساب مجموع قياس ما، تُضرب أولًا قيمة ذلك القياس في _sample_interval. أما المتوسط فيُحسب بقسمة المجموع المرجَّح على مجموع قيم _sample_interval.

يمكن لكل استدعاء لـ Worker كتابة 250 نقطة بيانات كحد أقصى. وتُخزَّن البيانات لمدة ثلاثة أشهر.