المدونة والأدلة
كيف تقيس NanoFlags سرعة انتشار الأعلام علنًا
المنهجية وراء أرقام الانتشار الحيّة في صفحتي السرعة والحالة: مسبار ينشر تغييرًا حقيقيًا كل 5 دقائق، ومستمعون على شبكة Cloudflare، وتعريف دقيق للعيّنة، وما لا يخبرك به الرقم.
فريق هندسة NanoFlagsنُشر في 3 دقائق قراءة
في هذه الصفحة
يعرض موقع NanoFlags زمن الانتشار في الترويسة وفي الصفحة الرئيسية وفي صفحة السرعة. هذا الرقم ليس قياسًا أجريناه مرة واحدة، بل يُعاد حسابه كل دقيقة من عيّنات يجمعها مسبار طوال اليوم، والعيّنات البطيئة تُحتسب تمامًا كالسريعة. يشرح هذا المقال كيف تُصنع العيّنات لتحكم على الرقم بنفسك.
- p50
- 279 ms
- p95
- 424 ms
- عيّنة
- 1,406
- مواقع قياس
- 6
- KIX · p50 243 ms · p95 373 ms · n=282
- MEL · p50 248 ms · p95 384 ms · n=281
- LHR · p50 289 ms · p95 423 ms · n=280
- DEN · p50 303 ms · p95 446 ms · n=282
- ATL · p50 314 ms · p95 415 ms · n=146
- IAD · p50 333 ms · p95 462 ms · n=135
آخر 24 ساعة، كل مواقع القياس. أحدث عيّنة 2026-11-19 23:15 UTC. جداول كل موقع في صفحة الحالة
ماذا تقيس العيّنة الواحدة
العيّنة هي الزمن بين طابع وقت الالتزام في قاعدة البيانات لنسخة منشورة، ولحظة استلام المستمع للحزمة الموقّعة لتلك النسخة عبر اتصال WebSocket حيّ بالحافة. وهذا هو المسار نفسه الذي يسلكه SDK متصل: معاملة النشر تدفع النسخة الجديدة إلى خدمة النشر، فتوقّعها بخوارزمية Ed25519 وتسلّمها إلى Durable Object واحد لكل بيئة، وهو بدوره يرسل الحزمة الموقّعة عبر كل اتصال مفتوح. ويطبّقها الـ SDK دون طلب ثانٍ.
المسبار
المسبار Worker مستقل على Cloudflare لا يلمس إلا بيئة مخصّصة للقياس، ولا يقترب من بيئات العملاء. وكل 5 دقائق يفعل ما تفعله لوحة التحكم عندما ينشر أحدهم:
- يسجّل الدخول بحساب المسبار ويعدّل مسودة علم واحد (
probe-tick). - يستدعي
publish_environment، وهي دالة قاعدة البيانات نفسها التي تستدعيها لوحة التحكم، ثم يسلّم النسخة الجديدة إلى خدمة النشر كما يفعل الدفع المباشر في لوحة التحكم. - يقرأ طابع وقت الالتزام للنسخة (
revisions.published_at) من قاعدة البيانات. - ينتظر 15 ثانية، ثم يسأل كل مستمع عمّا استلمه، ويسجّل عيّنة واحدة لكل مستمع عبر
probe_record.
المستمعون كائنات Durable Object موزّعة بتلميحات المواقع في Cloudflare. يحتفظ كل منها باتصال WebSocket صادر واحد إلى wss://edge.nanoflags.io/v1/live بمفتاح خادم لبيئة المسبار، ويسجّل وقت الوصول في أول سطر من معالج الرسائل. يعمل المسبار اليوم بمستمعين في خمسة تلميحات: غرب أمريكا الشمالية وشرقها، وغرب أوروبا، وآسيا والمحيط الهادئ، وأوقيانوسيا. والموقع المعروض بجانب كل رقم هو مركز بيانات Cloudflare الذي عمل فيه المستمع فعلًا كما أبلغت عنه بيئة التشغيل. والتلميح يسمّي منطقة لا مركز بيانات، لذا قد ترى خلال اليوم مواقع أكثر من عدد التلميحات.
الساعات وطابع وقت الالتزام
هناك تفصيلان يجعلان الرقم متشائمًا قليلًا أو مشوَّشًا قليلًا، ونفضّل أن نخبرك بهما على أن نخفيهما:
- تأخذ Postgres قيمة
now()عند بداية معاملة النشر، أي قبل الالتزام بقليل. لذا تتضمّن كل عيّنة الوقت الذي تستغرقه معاملة النشر نفسها. - وقت الالتزام يأتي من ساعة خادم قاعدة البيانات، ووقت الوصول من ساعة Cloudflare Workers. وكلتاهما تُضبطان بشكل مستقل، لذا فإن فرقًا ببضعة أجزاء من الثانية بينهما جزء من كل عيّنة.
تُفحص العيّنات قبل تخزينها: القيمة السالبة تعني أن الساعتين غير متفقتين فتُستبعد، وأي قيمة تتجاوز 60 ثانية تُعدّ عطلًا لا قياسًا:
// workers/probe/src/samples.ts (simplified)
const ms = Math.round(receivedAt - committedAt);
if (ms < 0) dropped.negative++; // the two clocks disagree
else if (ms > 60_000) dropped.tooLate++; // something else went wrong
else samples.push({ region, transport: "live", ms, revision });المستمع الذي لا يستلم النسخة خلال 15 ثانية لا يُنتج عيّنة. يعدّ المسبار حالات الفقد هذه بشكل منفصل وينبّه عليها نظام المراقبة، لكنها لا تدخل في حساب النسب المئوية؛ ولو دخلت لظهر انقطاع اتصال واحد كأنه زمن انتشار قدره 15 ثانية، وهذا عطل مختلف عن البطء.
من العيّنات إلى p50 وp95
تجمّع دالة قاعدة البيانات العامة latency_summary(p_hours) العيّنات المخزّنة بنسب مئوية بالاستيفاء الخطي، إجمالًا ولكل موقع قياس. وصفحة الحالة وصفحة السرعة وشارة الترويسة والعنصر أعلاه كلها تقرأ الدالة نفسها لآخر 24 ساعة. يحتفظ الموقع بالإجابة 60 ثانية، وإذا فشل الجلب يواصل عرض آخر إجابة سليمة موسومة بأنها قديمة مع وقتها؛ وإن لم يُحمَّل شيء قط فلا يعرض رقمًا أبدًا بدلًا من رقم مختلق.
ما لا يخبرك به الرقم
- شبكتك وأجهزتك ومتصفحاتك، والمسافة الأخيرة حتى تطبيقك.
- معالجة الـ SDK بعد استلام الحزمة (التحقق من التوقيع والاستبدال الذرّي).
- وسائل النقل الاحتياطية: عندما يتعذّر فتح WebSocket يستخدم الـ SDK أحداث الخادم (SSE) مع جلب مشروط، والاستطلاع الدوري كشبكة أمان. هذه المسارات أبطأ ولا تُقاس هنا.
- النسخ التي لم تصل خلال 15 ثانية، والعيّنات المرفوضة لعدم صلاحيتها (انظر أعلاه).
إنه انتشار مَقيس، لا ضمان ولا مستوى خدمة.
قِسه في عمليتك أنت
لست مضطرًا للثقة بمسبارنا. فـ SDK جافاسكريبت يُبلغ عن الكمية نفسها لكل نسخة تُدفع إلى عمليتك: الحقل latencyMs في حدث update هو الزمن من الالتزام في قاعدة البيانات حتى ذلك الحدث. ومثل المسبار، يقارن ساعتين (ساعة قاعدة البيانات وساعتك)، فدقّته بقدر اتفاقهما.
import { createClient } from "@nanoflags/sdk";
const flags = createClient({ sdkKey: process.env.NANOFLAGS_SDK_KEY!, baseUrl: "https://edge.nanoflags.io", service: "checkout-api" });
flags.on("update", (e) => {
// latencyMs: database commit → this event, only for pushed revisions that carry a commit time.
if (e.latencyMs !== null) console.log(`r${e.revision} via ${e.transport} in ${e.latencyMs} ms`);
});الجداول التفصيلية لكل موقع في صفحة الحالة، ومسار التسليم موصوف في صفحة السرعة. ونرحّب بأسئلتكم عن المنهجية على support@nanoflags.io.
- propagation
- methodology
- edge
- websocket