> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# إنترنت الأشياء IoT: من الحساس إلى لوحة المتابعة
- URL: https://arabroot.io/articles/انترنت-الاشياء-iot-من-الحساس-الى-لوحة-المتابعة/
- Published: 2026-11-06T01:43:31.000Z
- Updated: 2026-11-11T07:53:10.000Z
- Description: نمشي مع غرفة تبريد على المسار كاملاً من الحساس إلى الجوال، ونبنيه في Docker ثم نوقف الوسيط لنعرف كم قراءة تضيع ولماذا.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الإلكترونيات والطائرات المسيرة والطباعة ثلاثية الأبعاد

إذا كنت تعمل في شركة تخزن منتجات مبردة، أغذية أو أدوية، فأنت تعرف المشهد جيداً: غرفة تبريد يجب أن تبقى حرارتها بين 2 و8 درجات مئوية، وموظف يمر عليها مرتين في اليوم ويكتب الرقم من شاشة صغيرة على الباب في دفتر ورقي، ثم في صباح أحد الأيام يجد الحرارة 14 درجة والمنتجات تالفة، ولا أحد يعرف متى بدأت المشكلة، هل توقف الضاغط Compressor في منتصف الليل أم ترك أحدهم الباب مفتوحاً قبل نهاية الدوام؟ وعندها يطلب المدير الطلب الطبيعي: «أريد أن أعرف حرارة الغرفة من جوالي، وأن يصلني تنبيه قبل أن تتلف البضاعة». والطلب يبدو بسيطاً، حساس حرارة صغير وشبكة Wi-Fi ورسالة، ولكن بين الحساس وشاشة الجوال سلسلة كاملة من القرارات، وكل حلقة فيها لها طريقة خاصة في الفشل، وهذه السلسلة هي ما نسميه إنترنت الأشياء Internet of Things، واختصاراً IoT.

وفي هذا المقال سوف نمشي على هذه السلسلة حلقة حلقة مع غرفة التبريد نفسها، ثم نبنيها كاملة على جهازك في Docker: جهاز حرارة محاكى وحساس باب لا يعرف إلا الراديو وبوابة Gateway ووسيط MQTT وخدمة تخزن القراءات وتعرضها وتنبه، ثم نوقف الوسيط عن قصد ونرى كم قراءة ضاعت ولماذا. والمحاكاة هنا هي الطريقة نفسها التي يعمل بها فريق المنتج قبل أن يصل العتاد، فالكود الذي يتحدث MQTT لا يفرق بين متحكم حقيقي وبرنامج على سيرفر.

وهذا المقال هو بداية سلسلة إنترنت الأشياء، والمواضيع في السلسلة:

- إنترنت الأشياء IoT من الحساس إلى لوحة المتابعة (الموضوع الحالي).
- [بروتوكول MQTT مع Mosquitto: المواضيع ومستويات التسليم QoS والرسائل المحفوظة والتشفير](https://arabroot.io/articles/%D8%A8%D8%B1%D9%88%D8%AA%D9%88%D9%83%D9%88%D9%84-mqtt-%D9%85%D8%B9-mosquitto-%D9%83%D9%8A%D9%81-%D8%AA%D8%AA%D9%83%D9%84%D9%85-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9/).
- [Home Assistant مع ESPHome: أجهزة حقيقية البرنامج وأتمتة على سيرفرك](https://arabroot.io/articles/home-assistant-%D9%85%D8%B9-esphome-%D8%A7%D8%AA%D9%85%D8%AA%D8%A9-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-%D8%B9%D9%84%D9%89-%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D9%83/).
- [لوحات المتابعة لإنترنت الأشياء مع Node-RED وGrafana](https://arabroot.io/articles/%D9%84%D9%88%D8%AD%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AA%D8%A7%D8%A8%D8%B9%D8%A9-%D9%84%D8%A7%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D8%A7%D8%B4%D9%8A%D8%A7%D8%A1-node-red-%D9%85%D8%B9-grafana/).
- [تحديث الأجهزة عن بعد OTA دون أن تتعطل](https://arabroot.io/articles/%D8%AA%D8%AD%D8%AF%D9%8A%D8%AB-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9-%D8%B9%D9%86-%D8%A8%D8%B9%D8%AF-ota-%D8%AF%D9%88%D9%86-%D8%A7%D9%86-%D8%AA%D8%AA%D8%B9%D8%B7%D9%84/).
- [أمن إنترنت الأشياء: الأجهزة التي ينساها الجميع](https://arabroot.io/articles/%D8%A7%D9%85%D9%86-%D8%A7%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D8%A7%D8%B4%D9%8A%D8%A7%D8%A1-iot-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9-%D8%A7%D9%84%D8%AA%D9%8A-%D9%8A%D9%86%D8%B3%D8%A7%D9%87%D8%A7-%D8%A7%D9%84%D8%AC%D9%85%D9%8A%D8%B9/).

وسوف نناقش في هذا المقال ما يلي:

- ما الذي يجعل نظام إنترنت الأشياء مختلفاً عن تطبيق ويب عادي، والطبقات الست التي يمر بها كل رقم.
- الحساس Sensor والجهاز Device والبرنامج الثابت Firmware، وما يجب أن يضيفه الجهاز إلى كل قراءة.
- طرق الاتصال Connectivity، ومتى تحتاج بوابة Gateway بين الجهاز والإنترنت.
- الوسيط Broker ونموذج النشر والاشتراك Publish/Subscribe، ولماذا انتشر MQTT في هذا المجال.
- تصميم اسم الموضوع Topic ومحتوى الرسالة Payload، ومشكلة الوقت بين الجهاز والسيرفر.
- التخزين ولوحة المتابعة والتنبيه، ثم الأوامر في الاتجاه المعاكس.
- مختبر يعمل على جهازك بمخرجات حقيقية، ومشكلة واجهتنا في التخزين وكيف حللناها.
- تجربة «ماذا يحدث إذا توقف الوسيط؟» مرتين، بأرقام القراءات المفقودة في كل مرة.
- أخطاء شائعة وقائمة تحقق قبل أن تركب أول حساس.

## ما هو إنترنت الأشياء IoT؟ ولماذا يختلف عن تطبيق الويب؟

إنترنت الأشياء هو أن تتصل أشياء مادية بالشبكة، حساس حرارة أو عداد كهرباء أو قفل باب أو مضخة ماء، فترسل قراءاتها إلى برنامج يحفظها ويحللها، وتستقبل منه الأوامر. والتعريف بهذا الشكل يبدو كأنه تطبيق ويب آخر، فالجهاز كلاينت والسيرفر سيرفر، ولكن الفرق يظهر في ثلاث نقاط تحكم كل قرار في بقية المقال.

النقطة الأولى أن الطرف الآخر ليس متصفحاً على حاسوب قوي، وإنما متحكم دقيق Microcontroller ذاكرته بالكيلوبايت، وقد يعمل على بطارية يجب أن تكفيه سنة أو أكثر، وبالتالي كل بايت يرسله وكل ثانية يبقى فيها الراديو شغالاً لها ثمن من عمر البطارية. والنقطة الثانية أن الشبكة غير موثوقة بطبيعتها، فغرفة التبريد نفسها جدرانها معزولة بالمعدن، وإشارة Wi-Fi داخلها ضعيفة، والكهرباء تنقطع، والراوتر يعاد تشغيله، ولذلك يجب أن تصمم النظام على أن الانقطاع حالة عادية وليس استثناء. والنقطة الثالثة أن الجهاز يعيش سنوات في مكان لا يصل إليه أحد بسهولة، فلا يمكنك أن تفترض أن أحداً سوف يعيد تشغيله أو يحدثه بيده، وكل خطأ في البرنامج يبقى معك في الميدان حتى تحدثه عن بعد، وهذا موضوع مقال كامل في السلسلة.

وقد يتساءل البعض: لماذا لا نجعل الجهاز يرسل طلب HTTP عادياً إلى API كما يفعل أي تطبيق؟ والإجابة أن هذا ممكن ويعمل في حالات كثيرة، وخصوصاً للأجهزة المتصلة بالكهرباء التي ترسل قراءة كل بضع دقائق، ولكنه يصبح مكلفاً عندما يكون الجهاز على بطارية، لأن كل طلب يفتح اتصالاً جديداً ويحمل ترويسات Headers أكبر من القراءة نفسها، ويصبح مستحيلاً تقريباً عندما تريد أن ترسل أمراً إلى الجهاز، لأن الجهاز خلف راوتر وNAT ولا يستطيع السيرفر أن يبدأ الاتصال به. ولذلك ظهرت بروتوكولات صممت لهذه الظروف، وأشهرها MQTT الذي يبقي اتصالاً واحداً مفتوحاً في الاتجاهين، وسوف نصل إليه بعد أن نفهم الطبقات.

## الطبقات الست Layers: المسار من الحساس إلى الشاشة

كل رقم يظهر على جوال مدير المستودع يمر بست محطات، ولكل محطة مسؤولية واضحة، والصورة التالية تبين المسار كما سوف نبنيه في المختبر:

![ست بطاقات من اليمين إلى اليسار: الحساس Sensor يحول الحرارة أو فتح الباب إلى إشارة، ثم الجهاز Device / MCU يقرأ ويضيف الوقت والتسلسل، ثم البوابة Gateway تترجم البروتوكولات وتحتفظ بالقراءات، ثم الوسيط MQTT Broker يوزع الرسائل، ثم التخزين Ingest + Time Series، ثم المتابعة والتنبيه Dashboard / Alerts، وتحتها شريط الحافة Edge للثلاث الأولى وشريط السيرفر أو السحابة للثلاث الأخيرة، وسهم متقطع يبين أن الأوامر تعود في الاتجاه المعاكس](https://arabroot.io/content/images/2026/11/iot-architecture-01-path-1.webp)

المسار من الحساس إلى لوحة المتابعة، والأوامر تعود في الاتجاه المعاكس

- **الحساس Sensor:** القطعة التي تحول الظاهرة الفيزيائية، الحرارة أو الرطوبة أو تماس الباب، إلى إشارة كهربائية يقرؤها المتحكم.
- **الجهاز Device:** المتحكم الدقيق مع برنامجه، يقرأ الحساس كل فترة ويحول الإشارة إلى رقم، ويضيف إليه الوقت والرقم التسلسلي، ثم يرسله.
- **البوابة Gateway:** جهاز وسيط يظهر عندما لا يستطيع الحساس أن يتكلم IP بنفسه، فيستقبل منه بالراديو المحلي ويرسل إلى الشبكة.
- **الوسيط Broker:** السيرفر الذي تتصل به كل الأجهزة وكل البرامج، يستقبل الرسائل ويوزعها على من اشترك فيها، فلا يحتاج أي طرف أن يعرف عنوان الطرف الآخر.
- **الاستقبال والتخزين Ingest and Storage:** خدمة تشترك في رسائل الأجهزة، وتتحقق Validation منها وتحفظها في قاعدة بيانات للسلاسل الزمنية Time Series.
- **المتابعة والتنبيه Dashboard and Alerting:** الرسوم البيانية التي يراها الفريق، والقواعد التي ترسل التنبيه عندما يتجاوز الرقم حده.

ولاحظ أن الطبقات الثلاث الأولى تعيش في الحافة Edge، أي داخل المستودع بجانب الغرفة، والثلاث الأخيرة تعيش على سيرفر، في غرفة السيرفرات أو في السحابة. وهذا الخط بين الحافة والسيرفر هو أهم خط في التصميم، لأن الشبكة التي تعبره هي التي تنقطع، وكل ما يحدث أثناء الانقطاع يجب أن يكون قراراً اتخذته مسبقاً: من يحتفظ بالقراءات؟ ومن يرسلها بعد العودة؟ وهل تعمل قاعدة التنبيه المحلية دون سيرفر؟ وسوف نرى في التجربة أن ترك هذه الأسئلة للإعدادات الافتراضية يضيع البيانات حتى مع وجود تخزين مؤقت في الجهاز.

## الحساس Sensor: من الظاهرة إلى الرقم

الحساس هو أول مكان يدخل منه الخطأ إلى النظام، وأصعب مكان تكتشفه فيه، لأن كل ما بعده يثق بالرقم الذي يأتي منه. وهناك نوعان رئيسيان من الحساسات من جهة المبرمج: الحساس التماثلي Analog الذي يعطي جهداً كهربائياً يتغير مع الحرارة، ويحتاج المتحكم أن يحوله إلى رقم بمحول تماثلي رقمي ADC، والحساس الرقمي Digital الذي يقوم بالتحويل داخله ويرسل الرقم جاهزاً عبر بروتوكول مثل I2C أو سلك واحد، كما في الحساس الشائع DHT22 الذي يقيس الحرارة والرطوبة معاً، والصورة التالية له:

![حساس حرارة ورطوبة أبيض صغير بفتحات تهوية على وجهه وأربعة أرجل معدنية، ومكتوب عليه AOSONG AM2302](https://arabroot.io/content/images/2026/11/iot-architecture-02-dht22-1.webp)

حساس الحرارة والرطوبة DHT22، واسمه التجاري AM2302\. الصورة: Ubahnverleih، رخصة CC0، المصدر: [Wikimedia Commons](https://commons.wikimedia.org/wiki/File:DHT22-Temperatur-Sensor.jpg?ref=arabroot.io) (تم تحويلها إلى WebP).

وعند اختيار الحساس هناك ثلاثة أسئلة يجب أن تجيب عليها من ورقة البيانات Datasheet قبل السعر: ما مدى القياس Range، وهل يغطي حرارة غرفة التبريد وحرارة الصيف خارجها، وما الدقة Accuracy أي كم يبعد الرقم عن الحقيقة، وما زمن الاستجابة Response Time أي كم يحتاج الحساس ليشعر بأن الباب فتح. والسؤال الذي ينساه الكثيرون هو مكان الحساس نفسه: حساس بجانب مروحة التبريد يقرأ حرارة الهواء البارد الخارج منها، وحساس بجانب الباب يقفز مع كل فتحة، وحساس في وسط الرفوف يقرأ ما يهم المنتجات فعلاً، وبالتالي القرار هندسي قبل أن يكون برمجياً، والكثير من الشركات تضع أكثر من حساس في الغرفة الواحدة لهذا السبب.

وهناك أيضاً معايرة الحساس Calibration، فالحساسات الرخيصة تنحرف مع الزمن، والطريقة العملية أن تقارن قراءته كل فترة بميزان حرارة معاير، وتحفظ في النظام معامل تصحيح Offset لكل حساس بدل أن تغير الكود. ولاحظ هنا قاعدة سوف تتكرر: احفظ القراءة الخام كما جاءت من الحساس، واحفظ التصحيح منفصلاً، والسبب أنك إذا اكتشفت بعد شهرين أن المعامل كان خاطئاً فتستطيع أن تعيد الحساب، أما إذا حفظت الرقم المصحح فقط فقد ضاعت الحقيقة.

## الجهاز Device: المتحكم الدقيق والبرنامج الثابت Firmware

الجهاز في أغلب مشاريع اليوم متحكم دقيق صغير فيه معالج وذاكرة وراديو على شريحة واحدة، وأشهرها في المشاريع الصغيرة شرائح ESP32 من شركة Espressif، التي يصفها [موقع الشركة](https://www.espressif.com/en/products/socs/esp32?ref=arabroot.io) بأنها تجمع Wi-Fi وBluetooth في شريحة واحدة. والصورة التالية لوحدة ESP-WROOM-32 بعد نزع غطائها المعدني، فترى الشريحة نفسها وبجانبها شريحة ذاكرة الفلاش Flash التي يعيش فيها البرنامج، وعلى اليسار هوائي مطبوع على اللوحة:

![لوحة زرقاء صغيرة عليها شريحة سوداء مربعة مكتوب عليها ESP32-D0WD06 وبجانبها شريحة ذاكرة فلاش ومذبذب كريستالي، وعلى اليسار هوائي متعرج مطبوع، وحولها أرجل مرقمة مثل IO21 وGND وEN](https://arabroot.io/content/images/2026/11/iot-architecture-03-esp32-module-1.webp)

وحدة ESP-WROOM-32 دون الغطاء المعدني: الشريحة والذاكرة والهوائي المطبوع. الصورة: Brian Krent، رخصة CC BY-SA 4.0، المصدر: [Wikimedia Commons](https://commons.wikimedia.org/wiki/File:Espressif%5FESP-WROOM-32%5FWi-Fi%5F%26%5FBluetooth%5FModule.jpg?ref=arabroot.io) (تم تحويلها إلى WebP).

والبرنامج الذي يعمل على هذا الجهاز اسمه البرنامج الثابت Firmware، ولا يوجد تحته نظام تشغيل كامل مثل Linux في أغلب الحالات، وإنما حلقة تدور للأبد أو نظام تشغيل فوري صغير RTOS، وقد شرحنا الفرق بين البرنامج ونظام التشغيل في [مقال نظام التشغيل](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-%D9%86%D8%B8%D8%A7%D9%85-%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-operating-system/). والمهم في هذه المرحلة ليس لغة البرمجة، وإنما ما يجب أن يقوم به البرنامج مع كل قراءة، وهي خمسة أشياء رأيناها ضرورية في التصميم وسوف تراها في كود الجهاز المحاكى:

1. **الرقم التسلسلي Sequence Number:** عداد يزيد مع كل قراءة، وهو الطريقة الوحيدة التي يعرف بها السيرفر أن قراءة ضاعت في الطريق، فإذا وصلت القراءة 75 ثم 213 فهناك 137 قراءة مفقودة، وهذا بالضبط ما سوف نراه في التجربة.
2. **وقت القراءة Timestamp:** الوقت الذي قيست فيه القراءة، وليس الوقت الذي وصلت فيه، والفرق بينهما يصل إلى دقائق عند الانقطاع.
3. **هوية ثابتة Device ID:** اسم أو رقم لا يتغير بتغير عنوان IP أو مكان التركيب.
4. **التخزين المؤقت Buffering:** مكان في الذاكرة يحتفظ بالقراءات وقت الانقطاع، ويرسلها بعد العودة بأوقاتها الأصلية.
5. **إعادة الاتصال Reconnect:** محاولة مستمرة للعودة، بفترة انتظار تزيد ولكن لها حد أعلى معقول، وسوف نرى أن هذا الحد هو الذي حدد كم قراءة ضاعت.

وهنا يجدر الإشارة إلى أن ذاكرة المتحكم صغيرة، فالتخزين المؤقت له حد، وفي الجهاز المحاكى جعلناه 5000 قراءة، وفي جهاز حقيقي عليك أن تقرر ماذا يحدث عندما يمتلئ: هل تحذف الأقدم أم الأحدث، أم تحفظ في الفلاش، علماً أن الكتابة المتكررة على الفلاش تستهلك عمره. وهذا القرار يعتمد على المنتج: في غرفة التبريد آخر قراءة هي الأهم لأنها حالة الغرفة الآن، ولكن السجل الكامل هو الذي تحتاجه عند التحقيق في بضاعة تالفة.

## الاتصال Connectivity: مباشرة أو عبر بوابة Gateway

بعد أن أصبح لديك رقم، يجب أن يصل إلى الشبكة، وهنا يتحدد الكثير من تكلفة المشروع وعمر البطارية. والصورة التالية تجمع الخيارات الشائعة في مجموعتين:

![نصفان: على اليمين اتصال مباشر بالإنترنت IP من الجهاز إلى الراوتر إلى السحابة، مع ثلاث بطاقات Wi-Fi وEthernet / PoE وNB-IoT / LTE-M وصفات كل منها، وعلى اليسار راديو محلي من الحساس إلى بوابة ثم IP إلى السحابة، مع ثلاث بطاقات LoRaWAN وZigbee / Thread وBluetooth LE، وتحتها القاعدة: كلما قلت الطاقة قل حجم البيانات وظهرت البوابة](https://arabroot.io/content/images/2026/11/iot-architecture-04-connectivity-1.webp)

الجهاز إما يتكلم IP بنفسه، أو يتكلم راديو صغيراً تترجمه البوابة

في المجموعة الأولى يتكلم الجهاز IP بنفسه: Wi-Fi متاحة في كل مكتب وسريعة ولكنها تستهلك طاقة كبيرة، فهي مناسبة لجهاز موصول بالكهرباء مثل جهاز غرفة التبريد، وEthernet أثبت اتصال، ومع تقنية PoE تصل الكهرباء في الكابل نفسه، ولكنها تحتاج تمديد كابل، وشبكات الجوال المخصصة للأجهزة مثل NB-IoT وLTE-M تعمل في أي مكان فيه تغطية دون أي شبكة محلية، مقابل شريحة واشتراك لكل جهاز. وفي المجموعة الثانية يتكلم الحساس راديو صغيراً لا يعرف IP: Bluetooth LE لمسافة قصيرة وطاقة قليلة جداً، وZigbee أو Thread التي تبني شبكة متداخلة Mesh يمرر فيها كل جهاز رسائل جيرانه، ويصف [موقع Thread Group](https://www.threadgroup.org/What-is-Thread/Overview?ref=arabroot.io) بروتوكول Thread بأنه شبكة Mesh منخفضة الطاقة مبنية على IPv6، ثم LoRaWAN التي يقول [موقع LoRa Alliance](https://lora-alliance.org/about-lorawan/?ref=arabroot.io) إنها مصممة لأجهزة تعمل على البطارية وتتصل لمسافات بعيدة، وهي مناسبة للمزارع والعدادات التي ترسل رسالة صغيرة كل فترة طويلة.

والقاعدة العملية التي تختصر هذه الخيارات: كلما قلت الطاقة المتاحة للجهاز قل حجم البيانات وقل عدد مرات الإرسال، وعند نقطة معينة يصبح من الأفضل أن يتكلم الحساس راديو صغيراً إلى جهاز قريب موصول بالكهرباء، وهذا الجهاز القريب هو البوابة. وفي غرفة التبريد عندنا مثال على الاثنين: جهاز الحرارة موصول بالكهرباء ويتكلم Wi-Fi مباشرة، أما حساس الباب فهو قطعة صغيرة على بطارية تلصق على إطار الباب، ولا يعقل أن تشغل Wi-Fi فيها، فهي ترسل إطاراً قصيراً بالراديو عند كل فتح وإغلاق.

## البوابة Gateway: المترجم والمخزن المؤقت

البوابة جهاز بسيط في الشكل، قد يكون Raspberry Pi أو صندوقاً صناعياً صغيراً، ولكنه يقوم بثلاث وظائف مهمة. الوظيفة الأولى الترجمة: يستقبل الإطار الخام من الحساس، وهو في المختبر سطر مثل `D1,105,1,2921`، ويحوله إلى رسالة MQTT باسم واضح ووقت. والوظيفة الثانية الهوية: الحساس الصغير يعرف نفسه برقم راديو قصير، والبوابة هي التي تعرف أن `D1` هو باب الغرفة الأولى، وبالتالي إذا استبدلت الحساس بآخر فتغير الربط في البوابة ولا يتغير شيء في السيرفر. والوظيفة الثالثة التخزين المؤقت والقرار المحلي: البوابة موصولة بالكهرباء ولها ذاكرة أكبر، فهي المكان الطبيعي للاحتفاظ بالقراءات وقت انقطاع الإنترنت، وأحياناً لتشغيل قاعدة تنبيه محلية بسيطة، مثل صفارة تعمل إذا بقي الباب مفتوحاً خمس دقائق حتى لو كان السيرفر بعيداً.

ولاحظ نقطة مهمة في التصميم: الوقت الذي تضيفه البوابة هو وقت وصول الإطار إليها، وليس وقت حدوث الفتح، وفي حساس الباب الفرق أجزاء من الثانية فلا يهم، ولكن إذا كان الحساس يجمع قراءات ثم يرسلها دفعة واحدة فيجب أن يحمل كل إطار وقته، أو رقمه التسلسلي على الأقل، حتى تستطيع البوابة أن تعيد ترتيب الأحداث.

## الوسيط Broker: النشر والاشتراك Publish/Subscribe مع MQTT

الآن وصلت القراءة إلى الشبكة، فإلى أين ترسلها؟ الحل البسيط أن يرسل كل جهاز إلى عنوان قاعدة البيانات مباشرة، وهذا يعمل مع جهاز واحد وبرنامج واحد، ولكنه يصبح مشكلة في اليوم الذي تريد فيه أن يقرأ برنامج ثان القراءات نفسها، لوحة المتابعة مثلاً أو برنامج التنبيه، فتعود إلى كل جهاز في الميدان لتضيف عنواناً جديداً. والحل الأنسب هو نموذج النشر والاشتراك Publish/Subscribe: كل جهاز ينشر رسالته على موضوع Topic مثل `coldstore/store1/room1-temp/telemetry` إلى سيرفر واحد اسمه الوسيط Broker، وكل برنامج يريد القراءات يشترك Subscribe في الموضوع، والوسيط يوزع كل رسالة على كل المشتركين. وبهذا الشكل لا يعرف الجهاز من يقرأ رسالته، ولا يعرف البرنامج أين الجهاز، ويضاف برنامج جديد دون أن يلمس أحد الأجهزة.

وأشهر بروتوكول لهذا النموذج في إنترنت الأشياء هو MQTT، ويذكر [موقع MQTT](https://mqtt.org/faq/?ref=arabroot.io) أنه صمم للأجهزة المحدودة والشبكات قليلة السرعة وعالية التأخير وغير الموثوقة، وأن مخترعيه هما Andy Stanford-Clark من IBM وArlen Nipper من شركة Arcom عام 1999، وأن الإصدارين 3.1.1 و5.0 أصبحا معيارين لدى OASIS، والإصدار 3.1.1 معتمد أيضاً من ISO، وأن المنفذ 1883 مسجل له لدى IANA، والمنفذ 8883 لـ MQTT فوق TLS. ومواصفة [MQTT 5.0](https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html?ref=arabroot.io) منشورة كاملة على موقع OASIS لمن يريد التفاصيل.

والسبب في انتشاره أنه يحل المشاكل الثلاث التي ذكرناها في البداية: الاتصال واحد ومفتوح باستمرار، يبدؤه الجهاز من داخل الشبكة إلى الوسيط، فيعبر NAT والجدار الناري Firewall دون أي إعداد، ويستقبل عليه الأوامر أيضاً. والرسالة صغيرة، فالترويسة الثابتة في MQTT بايتان فقط في أصغر حالاتها، والباقي هو اسم الموضوع والمحتوى. ثم إن البروتوكول يعرف أن الشبكة غير موثوقة، ففيه ثلاثة مستويات للتسليم QoS، ورسالة وصية Last Will يرسلها الوسيط نيابة عن الجهاز إذا اختفى فجأة، ورسائل محفوظة Retained تصل لكل مشترك جديد فوراً، وجلسات دائمة Persistent Sessions يحتفظ فيها الوسيط برسائل المشترك الغائب. وكل واحدة من هذه سوف تظهر في المختبر، وسوف نشرحها بالتفصيل مع Mosquitto في [المقال التالي](https://arabroot.io/articles/%D8%A8%D8%B1%D9%88%D8%AA%D9%88%D9%83%D9%88%D9%84-mqtt-%D9%85%D8%B9-mosquitto-%D9%83%D9%8A%D9%81-%D8%AA%D8%AA%D9%83%D9%84%D9%85-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9/) من السلسلة.

وقد يتساءل البعض: هل MQTT هو الخيار الوحيد؟ لا، فهناك بروتوكول CoAP الذي تصفه [مواصفة RFC 7252](https://www.rfc-editor.org/rfc/rfc7252?ref=arabroot.io) بأنه بروتوكول نقل ويب للعقد والشبكات المحدودة، ويعمل بأسلوب REST فوق UDP، وهو مناسب للأجهزة الصغيرة جداً التي لا تستطيع أن تبقي اتصال TCP مفتوحاً. وهناك HTTP العادي الذي يكفي لجهاز يرسل قراءة كل ربع ساعة ولا يحتاج أوامر، وقد شرحنا الفرق بين الاستعلام المتكرر Polling والاتصال المفتوح في [مقال التواصل اللحظي](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D9%88%D8%A7%D8%B5%D9%84-%D8%A7%D9%84%D9%84%D8%AD%D8%B8%D9%8A-polling-%D9%88-sse-%D9%88-websockets/). ولكن عندما يكون لديك عشرات الأجهزة وبرامج متعددة تقرأ منها، وتحتاج أن ترسل لها أوامر، فـ MQTT هو الخيار الأشيع، ولهذا بنينا عليه السلسلة.

## اسم الموضوع Topic، ومحتوى الرسالة Payload

اسم الموضوع في MQTT نص مقسم بالشرطة المائلة إلى مستويات، والمشترك يستطيع أن يستخدم `+` بدل مستوى واحد و`#` بدل كل ما بعده، فالاشتراك `coldstore/store1/+/telemetry` يعني قراءات كل أجهزة المستودع الأول، والاشتراك `coldstore/#` يعني كل شيء. وهذا يجعل تصميم الأسماء قراراً مهماً لا يمكن تغييره بسهولة بعد أن تنتشر الأجهزة، والصورة التالية تبين الأسماء التي استخدمناها مع رسالة حقيقية من المختبر:

![في الأعلى أجزاء الموضوع coldstore ثم store1 ثم room1-temp ثم telemetry أو status وتحت كل جزء معناه: التطبيق والموقع والجهاز ونوع الرسالة، وفي الوسط رسالة JSON حقيقية فيها seq 618 وts وtemp_c 12.42 وhum_pct 77.6 وdoor open مع شرح كل حقل، وفي الأسفل ثلاثة أحجام للقراءة نفسها: 83 بايت JSON كما في المختبر، و74 بايت دون مسافات، و13 بايت كبنية ثنائية](https://arabroot.io/content/images/2026/11/iot-architecture-05-topic-payload-1.webp)

مستويات اسم الموضوع، ورسالة واحدة من المختبر بثلاثة أحجام

وفي التصميم أعلاه لاحظ التالي:

- المستوى الأول اسم التطبيق، والسبب أن الوسيط نفسه قد يخدم أنظمة أخرى في الشركة، وتستطيع لاحقاً أن تعطي كل نظام صلاحيات على فرعه فقط في ملف الصلاحيات ACL.
- الجهاز له موضوعان: `telemetry` للقراءات الدورية، و`status` لحالة الاتصال `online` أو `offline`، وهذا الأخير رسالة محفوظة Retained يكتبها الجهاز عند الاتصال، ويكتب الوسيط نيابة عنه `offline` عندما يختفي، وهذه هي الوصية Last Will.
- لا يوجد في الاسم شيء يتغير مثل عنوان IP، ولا شيء سري مثل رقم العميل، لأن أسماء المواضيع تظهر في السجلات وفي أدوات المراقبة.

أما المحتوى فقد اخترنا JSON، وحجمه في المختبر 83 بايت، و74 بايت إذا حذفت المسافات، أما القراءة نفسها كبنية ثنائية Binary فتكفيها 13 بايت حسبناها في المختبر بالدالة `struct.pack`. وقد يبدو الفرق كبيراً، ولكن على Wi-Fi لا يهم إطلاقاً، فالاتصال نفسه يكلف أكثر من المحتوى، أما على LoRaWAN حيث الرسالة محدودة الحجم والإرسال محدود المرات فيصبح كل بايت مهماً، ولذلك تجد الأجهزة هناك ترسل بنية ثنائية، والبوابة أو السيرفر يفكها إلى JSON. والقاعدة: ابدأ بـ JSON لأن أي إنسان يقرؤه وأي لغة تفهمه، وضع الوحدة في اسم الحقل مثل `temp_c`، ولا تنتقل إلى الثنائي إلا عندما يفرضه الراديو، وعندها اكتب مواصفة الحقول واحفظ معها رقم إصدار للصيغة.

## الوقت Time: وقت الجهاز أم وقت السيرفر؟

كل قراءة في المختبر تحمل وقتين: `ts_device` الذي كتبه الجهاز عند القياس، و`ts_ingest` الذي كتبته خدمة التخزين عند الاستقبال، والفرق بينهما هو التأخير من الجهاز إلى التخزين. وفي الحالة العادية كان هذا الفرق ملي ثانية واحدة أو اثنتين، وهذا منطقي لأن كل شيء على جهاز واحد. والسؤال: أي الوقتين نستخدم في الرسم البياني وفي التحقيق؟ والإجابة وقت الجهاز، لأنه وقت حدوث الشيء، ولكن هذا يفترض أن ساعة الجهاز صحيحة، والمتحكم الصغير لا يعرف الوقت عند التشغيل إطلاقاً، وإنما يأخذه من الشبكة ببروتوكول NTP الذي تصفه [مواصفة RFC 5905](https://www.rfc-editor.org/rfc/rfc5905?ref=arabroot.io).

ولنرى ماذا يحدث عندما تكون الساعة خاطئة، شغلنا في المختبر جهازاً ثالثاً `room3-temp` وجعلنا ساعته متأخرة 300 ثانية، كجهاز فشل في الوصول إلى سيرفر الوقت، فكانت نتيجة استعلام التأخير كما يلي:

```text
('room1-temp', 72, 0, 1.5416666666666667, 17)
('room2-temp', 33, 0, 26.636363636363637, 720)
('room3-temp', 33, 300000, 300093.69696969696, 302004)
```

الأعمدة هي الجهاز وعدد القراءات وأقل تأخير ومتوسطه وأكبره بالملي ثانية، ولاحظ أن الجهاز الثالث يظهر كأن كل قراءاته وصلت متأخرة 300 ثانية بالضبط، وهي في الحقيقة وصلت فوراً، والخطأ في ساعته. والأخطر من رقم التأخير أن قراءاته على الرسم البياني تظهر قبل خمس دقائق من حدوثها، فإذا فتح الباب في الساعة 10:05 فسوف يظهر الارتفاع في 10:00، وفي التحقيق في بضاعة تالفة هذه دقائق تغير القصة. والحل في ثلاث خطوات: لا يرسل الجهاز قراءات قبل أن يأخذ الوقت من NTP، أو يرسلها بعلامة واضحة أن الوقت غير موثوق، ثم يحفظ السيرفر الوقتين دائماً، ثم تراقب الفرق بينهما وتنبه عندما يتجاوز حداً معقولاً، فالفرق الثابت الكبير يعني ساعة خاطئة، والفرق المتغير يعني شبكة بطيئة أو تخزيناً مؤقتاً. وقد شرحنا UTC والمناطق الزمنية وأخطاءها في [مقال التاريخ والوقت](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%A7%D8%B1%D9%8A%D8%AE-%D9%88%D8%A7%D9%84%D9%88%D9%82%D8%AA-utc-%D9%88%D8%A7%D9%84%D9%85%D9%86%D8%A7%D8%B7%D9%82-%D8%A7%D9%84%D8%B2%D9%85%D9%86%D9%8A%D8%A9-%D9%88%D8%A7%D9%84%D8%AA%D9%82%D9%88%D9%8A%D9%85-%D8%A7%D9%84%D9%87%D8%AC%D8%B1%D9%8A/)، والقاعدة هنا نفسها: الجهاز يرسل UTC دائماً، والتحويل إلى بتوقيت السعودية يحدث في الشاشة فقط.

## التخزين Storage: السلاسل الزمنية Time Series

القراءات في إنترنت الأشياء لها شكل واحد تقريباً: جهاز ووقت وقيمة أو بضع قيم، تكتب باستمرار ولا تعدل أبداً، ويستعلم عنها بالفترات: آخر ساعة، متوسط كل خمس دقائق، أعلى قيمة في الليل. وهذا الشكل هو ما صممت له قواعد بيانات السلاسل الزمنية Time Series Databases، التي تضغط القيم المتتالية وتحذف القديم آلياً وتحسب المتوسطات على الفترات بسرعة، وقد شرحناها مع TimescaleDB وInfluxDB في [مقال قواعد بيانات السلاسل الزمنية](https://arabroot.io/articles/%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%B3%D9%84%D8%A7%D8%B3%D9%84-%D8%A7%D9%84%D8%B2%D9%85%D9%86%D9%8A%D8%A9-timescaledb-%D9%88-influxdb/). وفي المختبر استخدمنا SQLite عن قصد، لأنه ملف واحد لا يحتاج سيرفراً، وهذا كاف لغرفة تبريد واحدة وقراءة كل ثانيتين، وسوف ننتقل إلى InfluxDB في [مقال لوحات المتابعة](https://arabroot.io/articles/%D9%84%D9%88%D8%AD%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AA%D8%A7%D8%A8%D8%B9%D8%A9-%D9%84%D8%A7%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D8%A7%D8%B4%D9%8A%D8%A7%D8%A1-node-red-%D9%85%D8%B9-grafana/) من السلسلة.

وبين الوسيط وقاعدة البيانات توجد خدمة صغيرة اسمها خدمة الاستقبال Ingest، تشترك في المواضيع وتتحقق من كل رسالة ثم تكتبها. وهذه الخدمة هي المكان الصحيح لثلاثة أشياء: رفض الرسائل التالفة بدل أن تدخل قاعدة البيانات، واكتشاف الفقد من الرقم التسلسلي، وحفظ وقت الاستقبال بجانب وقت الجهاز. ولاحظ أنها أيضاً نقطة ضعف، فإذا توقفت فلا أحد يحفظ شيئاً، وسوف نرى في التجربة أن غيابها دقيقتين كان أخطر من توقف الوسيط نفسه.

## لوحة المتابعة Dashboard مع التنبيه Alerting

لوحة المتابعة هي الجزء الذي يراه الجميع، ولذلك يبدأ منه الكثيرون، وهذا ترتيب خاطئ، لأن اللوحة لا تستطيع أن تعرض إلا ما حفظ بشكل صحيح. وفي المختبر كتبنا لوحة صغيرة جداً بـ Python دون أي مكتبة، فيها رسم بياني لآخر 300 قراءة مع خط أحمر عند 8 درجات، وأشرطة صفراء حيث كان الباب مفتوحاً، وحالة كل جهاز، وآخر التنبيهات، وهدفها أن ترى المسار كاملاً وليس أن تكون لوحة إنتاج، فاللوحة الحقيقية مكانها Grafana، وقد شرحناها مع Prometheus في [مقال المقاييس ولوحات Grafana](https://arabroot.io/articles/%D9%85%D9%82%D8%A7%D9%8A%D9%8A%D8%B3-%D8%A7%D9%84%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D8%A7%D8%AA-metrics-prometheus-%D9%85%D8%B9-%D9%84%D9%88%D8%AD%D8%A7%D8%AA-grafana/).

أما التنبيه فقاعدته في المختبر بسيطة: إذا كانت الحرارة أعلى من 8 درجات في ثلاث قراءات متتالية فسجل تنبيهاً. وشرط القراءات المتتالية مهم، لأن فتح الباب ثوان قليلة يرفع الحرارة عند الحساس ثم تعود، ولا تريد أن يستيقظ المدير على كل فتحة باب، وقد شرحنا هذه الفكرة وتعب التنبيهات Alert Fatigue في [مقال التنبيهات](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D9%86%D8%A8%D9%8A%D9%87%D8%A7%D8%AA-alerting-%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D9%86%D8%A8%D9%87-%D8%B9%D9%84%D9%8A%D9%87-%D9%88%D9%85%D8%AA%D9%89-%D8%AA%D9%88%D9%82%D8%B8-%D8%A7%D8%AD%D8%AF%D8%A7/). ولكن هناك تنبيه أهم من الحرارة العالية لا ينتبه له الكثيرون، وهو غياب القراءات نفسها: إذا توقف الجهاز فلن تصل حرارة عالية، ولن يصل أي تنبيه، وسوف تبقى اللوحة تعرض آخر رقم جيد، ولذلك أول قاعدة تكتبها هي «لم تصل قراءة من هذا الجهاز منذ خمس دقائق»، وثاني قاعدة هي الحالة `offline` التي يرسلها الوسيط بالوصية.

## الأمر في الاتجاه المعاكس Command and Control

إلى الآن تحدثنا عن الرقم الذي يصعد من الحساس، ولكن كثيراً من الأنظمة تحتاج أن ترسل أمراً إلى الجهاز: شغل الضاغط الاحتياطي، غير فترة القراءة، حدث البرنامج. ومع MQTT يكون هذا بموضوع يشترك فيه الجهاز، مثل `coldstore/store1/room1-temp/cmd`، فينشر السيرفر الأمر ويستقبله الجهاز على الاتصال المفتوح نفسه. والمشكلة أن الجهاز قد يكون غير متصل لحظة الأمر، فماذا يحدث؟ والحل الذي تستخدمه المنصات الكبيرة هو فصل الحالة المطلوبة Desired State عن الحالة المبلغ عنها Reported State، كما في [خدمة Device Shadow في AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html?ref=arabroot.io): السيرفر يكتب ما يريده، والجهاز يقرأ هذه القيمة كلما اتصل وينفذها ثم يبلغ بحالته، والفرق بين الاثنين يعني أمراً لم ينفذ بعد. وتستطيع أن تبني الفكرة نفسها على أي وسيط برسالة محفوظة Retained على موضوع الحالة المطلوبة، فيجدها الجهاز فور اتصاله.

وتذكر أن كل أمر يصل إلى جهاز هو باب يستطيع المخترق أن يدخل منه، فالأمر الذي يطفئ الضاغط إذا وصل من شخص غير مصرح له يتلف البضاعة كلها، ولذلك الصلاحيات على مواضيع الأوامر أشد من الصلاحيات على مواضيع القراءات، وهذا ما سوف نطبقه في [مقال الأمن](https://arabroot.io/articles/%D8%A7%D9%85%D9%86-%D8%A7%D9%86%D8%AA%D8%B1%D9%86%D8%AA-%D8%A7%D9%84%D8%A7%D8%B4%D9%8A%D8%A7%D8%A1-iot-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9-%D8%A7%D9%84%D8%AA%D9%8A-%D9%8A%D9%86%D8%B3%D8%A7%D9%87%D8%A7-%D8%A7%D9%84%D8%AC%D9%85%D9%8A%D8%B9/) من السلسلة.

## المختبر Lab: المسار كاملاً على جهازك

الآن سوف نقوم ببناء المسار كاملاً على جهاز واحد في Docker، والصورة التالية تبين ما سوف نشغله:

![داخل إطار متقطع اسمه iot-net خمس بطاقات: iot-device فيه لوحة متحكم room1-temp يرسل MQTT QoS 1 إلى iot-broker، وiot-door حساس باب يرسل UDP إلى iot-gateway الذي يرسل MQTT إلى iot-broker، وiot-broker فيه Mosquitto 2.1.2 على المنفذ 1883 داخل الشبكة فقط، وiot-ingest فيه قاعدة SQLite ولوحة على المنفذ 8080 وقاعدة تنبيه، وتحته المنفذ 127.0.0.1:18080، وتحت الكل ملاحظة أن المنفذ الوحيد على جهازك هو لوحة المتابعة](https://arabroot.io/content/images/2026/11/iot-architecture-06-lab-1.webp)

خمس Containers على شبكة واحدة، والمنفذ الوحيد المفتوح على جهازك هو اللوحة على 127.0.0.1

ولتشغيل المختبر تحتاج Docker فقط، وإذا لم يكن مثبتاً فقد شرحنا تثبيته في [دليل تثبيت Docker](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-docker-%D8%B9%D9%84%D9%89-ubuntu/). والملفات كلها في مجلد واحد، ونبدأ بالـ Image المشترك لخدمات Python، وفيه مكتبة [paho-mqtt 2.2.0](https://pypi.org/project/paho-mqtt/2.2.0/?ref=arabroot.io) فقط:

```dockerfile
# Small Python image with the MQTT client library, shared by the lab services (device, gateway, ingest)
FROM python:3.13.18-slim
RUN pip install --no-cache-dir paho-mqtt==2.2.0
WORKDIR /app
COPY *.py /app/
```

ثم إعداد الوسيط `mosquitto.conf`:

```ini
# Lab broker: plain MQTT on 1883 inside the Docker network only (no port published to the host).
# Anonymous access is for this first lab only; the security post closes it with passwords, ACL and TLS.
listener 1883
allow_anonymous true
persistence true
persistence_location /mosquitto/data/
log_dest stdout
log_type error
log_type warning
log_type notice
log_type information
connection_messages true
```

في الإعداد أعلاه لاحظ التالي:

- `allow_anonymous true` يسمح لأي أحد بالاتصال دون اسم أو كلمة مرور، وهذا مقبول هنا فقط لأن المنفذ 1883 غير منشور على جهازك، ولا يصل إليه إلا من في شبكة Docker. ولا تقم بذلك في أي وسيط يصل إليه جهاز حقيقي، وسوف نغلقه في مقال الأمن.
- `persistence true` يجعل Mosquitto يحفظ الرسائل المحفوظة والجلسات الدائمة في ملف عند التوقف ويقرؤها عند العودة، وسوف نرى أثره في التجربة. والخيارات كلها موثقة في [صفحة mosquitto.conf](https://mosquitto.org/man/mosquitto-conf-5.html?ref=arabroot.io).
- `connection_messages true` يكتب سطراً في السجل لكل اتصال وانقطاع، وهو أول ما تقرؤه عندما يختفي جهاز.

### الجهاز المحاكى Emulated Device

الملف `device.py` يقوم بما يقوم به برنامج متحكم حقيقي مع حساس حرارة: يحسب حرارة الغرفة من نموذج بسيط، فالضاغط يسحب الحرارة نحو 3.5 درجة، والباب المفتوح يدخل هواء حرارته 30 درجة، ثم يرسل كل ثانيتين رسالة JSON، ويحتفظ بالقراءات في ذاكرته إذا انقطع الاتصال:

```python
"""Emulated cold-room sensor node (what an ESP32 with a temperature/humidity sensor would do).
Reads a simple thermal model of the room every PERIOD seconds and publishes JSON over MQTT.
Keeps readings in a local buffer while the broker is unreachable (store and forward)."""
import json, os, random, time, collections
import paho.mqtt.client as mqtt

SITE, DEV = os.environ.get("SITE", "store1"), os.environ.get("DEVICE", "room1-temp")
PERIOD = float(os.environ.get("PERIOD", "2"))
BUFFER = os.environ.get("BUFFER", "1") == "1"          # store and forward on/off
CLOCK_SKEW = float(os.environ.get("CLOCK_SKEW", "0"))  # seconds, to emulate a device without NTP
BASE = f"coldstore/{SITE}/{DEV}"

state = {"temp": 4.0, "door": False, "door_left": 0, "seq": 0}
pending = collections.deque(maxlen=5000)               # what a device keeps in RAM/flash while offline
connected = False

def step():
    """One reading of the room: the compressor pulls the air to 3.5 C, an open door lets in 30 C air."""
    if not state["door"] and random.random() < 0.02:
        state["door"], state["door_left"] = True, random.randint(5, 15)
    if state["door"]:
        state["temp"] += (30 - state["temp"]) * 0.03
        state["door_left"] -= 1
        if state["door_left"] <= 0:
            state["door"] = False
    else:
        state["temp"] += (3.5 - state["temp"]) * 0.08
    state["seq"] += 1
    return {
        "seq": state["seq"],
        "ts": int((time.time() + CLOCK_SKEW) * 1000),  # device clock, milliseconds
        "temp_c": round(state["temp"] + random.gauss(0, 0.05), 2),
        "hum_pct": round(80 + random.gauss(0, 1.5), 1),
        "door": "open" if state["door"] else "closed",
    }

def on_connect(c, userdata, flags, reason_code, properties):
    global connected
    connected = reason_code == 0
    print(f"connected: {reason_code}", flush=True)
    c.publish(f"{BASE}/status", "online", qos=1, retain=True)

def on_disconnect(c, userdata, flags, reason_code, properties):
    global connected
    connected = False
    print(f"disconnected: {reason_code}", flush=True)

c = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id=DEV)
c.will_set(f"{BASE}/status", "offline", qos=1, retain=True)   # the broker publishes this if we vanish
c.on_connect, c.on_disconnect = on_connect, on_disconnect
c.reconnect_delay_set(min_delay=1, max_delay=8)
c.connect_async(os.environ.get("BROKER", "iot-broker"), 1883, keepalive=10)
c.loop_start()

while True:
    r = step()
    if BUFFER:
        pending.append(r)
        if connected:
            n = len(pending)
            while pending and connected:
                c.publish(f"{BASE}/telemetry", json.dumps(pending[0]), qos=1)
                pending.popleft()
            if n > 1:
                print(f"flushed {n} buffered readings", flush=True)
    elif connected:
        c.publish(f"{BASE}/telemetry", json.dumps(r), qos=0)
    if r["seq"] % 30 == 0:
        print(f"seq={r['seq']} temp={r['temp_c']} door={r['door']} buffered={len(pending)}", flush=True)
    time.sleep(PERIOD)
```

في الكود أعلاه لاحظ التالي:

- `will_set` يسجل الوصية عند الاتصال: إذا انقطع الجهاز دون أن يودع، ينشر الوسيط `offline` على موضوع الحالة، ولأنها `retain=True` يجدها كل من يشترك بعد ذلك.
- `keepalive=10` يعني أن الجهاز يرسل إشارة حياة إذا لم يرسل شيئاً خلال 10 ثوان، والوسيط يعتبره مختفياً إذا مرت مرة ونصف هذه المدة دون أي رسالة منه، فيرسل الوصية.
- `reconnect_delay_set(min_delay=1, max_delay=8)` يجعل الانتظار بين محاولات العودة يتضاعف من ثانية حتى 8 ثوان على الأكثر، والقيمة الافتراضية للحد الأعلى في [توثيق المكتبة](https://eclipse.dev/paho/files/paho.mqtt.python/html/client.html?ref=arabroot.io) هي 120 ثانية، وهذا الرقم سوف يكلفنا قراءات كثيرة في التجربة.
- المتغيران `BUFFER` و`CLOCK_SKEW` للتجارب: الأول يلغي التخزين المؤقت ويرسل بـ QoS 0، والثاني يجعل ساعة الجهاز خاطئة.

### حساس الباب Door Sensor مع البوابة Gateway

حساس الباب في `door_sensor.py` لا يعرف MQTT، وإنما يرسل عند كل تغيير إطاراً نصياً قصيراً عبر UDP إلى البوابة، فيه رقم الراديو والعداد وحالة التماس وجهد البطارية بالملي فولت، كما يفعل حساس راديو صغير مع جهاز الاستقبال الخاص به:

```python
"""Emulated door contact on a cheap radio link: it cannot speak IP or MQTT.
It sends one short text frame per change over UDP to the gateway, like a sub-GHz or BLE sensor would to its hub."""
import os, random, socket, time
GW = (os.environ.get("GATEWAY", "iot-gateway"), 5005)
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
open_ = False
n = 0
while True:
    time.sleep(random.uniform(8, 25) if not open_ else random.uniform(3, 10))
    open_ = not open_
    n += 1
    frame = f"D1,{n},{1 if open_ else 0},{random.randint(2900, 3000)}"   # id, counter, contact, battery mV
    s.sendto(frame.encode(), GW)
    print("sent", frame, flush=True)
```

والبوابة في `gateway.py` تستقبل الإطار وتترجمه وتضيف إليه الاسم والوقت ثم تنشره:

```python
"""Gateway: receives raw frames from devices that cannot speak MQTT, adds identity and time, publishes MQTT."""
import json, os, socket, time
import paho.mqtt.client as mqtt

c = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="gw-store1")
c.will_set("coldstore/store1/gw-store1/status", "offline", qos=1, retain=True)
c.on_connect = lambda cl, u, f, rc, p: cl.publish("coldstore/store1/gw-store1/status", "online", qos=1, retain=True)
c.connect_async(os.environ.get("BROKER", "iot-broker"), 1883, keepalive=10)
c.loop_start()
MAP = {"D1": "room1-door"}            # radio id -> device name, kept on the gateway
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
s.bind(("0.0.0.0", 5005))
while True:
    data, addr = s.recvfrom(256)
    try:
        rid, cnt, contact, mv = data.decode().strip().split(",")
        msg = {"seq": int(cnt), "ts": int(time.time() * 1000), "door": "open" if contact == "1" else "closed",
               "bat_v": int(mv) / 1000, "via": "gw-store1"}
    except ValueError:
        print("bad frame", data, flush=True)
        continue
    dev = MAP.get(rid, f"unknown-{rid}")
    c.publish(f"coldstore/store1/{dev}/telemetry", json.dumps(msg), qos=1)
    print(f"{data.decode()} -> coldstore/store1/{dev}/telemetry {json.dumps(msg)}", flush=True)
```

ولاحظ أن الجدول `MAP` الذي يربط رقم الراديو باسم الجهاز يعيش في البوابة، وأن الإطار التالف يرفض في البوابة نفسها ولا يصل إلى الوسيط.

### خدمة الاستقبال والتخزين Ingest

الخدمة الأخيرة `ingest.py` تشترك في `coldstore/#` وتحفظ كل رسالة في SQLite، وتكتشف الفقد من الرقم التسلسلي، وتطبق قاعدة التنبيه، ثم تعرض اللوحة على المنفذ 8080\. وهذا الجزء الذي يستقبل ويخزن منها، أما جزء اللوحة فهو صفحة HTML بسيطة فيها رسم SVG:

```python
DB = sqlite3.connect("/data/coldstore.db", check_same_thread=False)
# WAL: readers (the dashboard, a report, an analyst) no longer block the writer, so a slow query cannot stall ingest
DB.execute("PRAGMA journal_mode=WAL")
LOCK = threading.Lock()
DB.executescript("""
CREATE TABLE IF NOT EXISTS reading(device TEXT, seq INT, ts_device INT, ts_ingest INT, temp_c REAL, hum_pct REAL, door TEXT, raw TEXT);
CREATE INDEX IF NOT EXISTS reading_dev_ts ON reading(device, ts_device);
CREATE TABLE IF NOT EXISTS status(device TEXT PRIMARY KEY, state TEXT, ts INT);
CREATE TABLE IF NOT EXISTS alert(device TEXT, ts INT, text TEXT);
""")
last_seq, high = {}, {}

def on_message(c, u, m):
    now = int(time.time() * 1000)
    parts = m.topic.split("/")            # coldstore/<site>/<device>/<kind>
    if len(parts) != 4:
        return
    dev, kind = parts[2], parts[3]
    with LOCK:
        if kind == "status":
            DB.execute("INSERT OR REPLACE INTO status VALUES(?,?,?)", (dev, m.payload.decode(), now))
            print(f"status {dev} = {m.payload.decode()} (retained={m.retain})", flush=True)
        elif kind == "telemetry":
            r = json.loads(m.payload)
            seq = r.get("seq")
            if dev in last_seq and seq is not None and seq != last_seq[dev] + 1:
                print(f"gap {dev}: expected seq {last_seq[dev] + 1}, got {seq}", flush=True)
            last_seq[dev] = seq
            DB.execute("INSERT INTO reading VALUES(?,?,?,?,?,?,?,?)",
                       (dev, seq, r.get("ts"), now, r.get("temp_c"), r.get("hum_pct"), r.get("door"), m.payload.decode()))
            if r.get("temp_c") is not None:
                high[dev] = high.get(dev, 0) + 1 if r["temp_c"] > 8.0 else 0
                if high[dev] == 3:
                    text = f"{dev}: temperature {r['temp_c']} C above 8 C for 3 readings"
                    DB.execute("INSERT INTO alert VALUES(?,?,?)", (dev, now, text))
                    print("ALERT", text, flush=True)
        DB.commit()

# PERSIST=1: a persistent session (clean_session=False) so the broker queues QoS 1 readings while ingest is away,
# and a short reconnect backoff (the library default grows to 120 s). PERSIST=0 is the first version of the lab.
PERSIST = os.environ.get("PERSIST", "1") == "1"
c = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="ingest-1", clean_session=not PERSIST)
if PERSIST:
    c.reconnect_delay_set(min_delay=1, max_delay=8)
c.on_connect = lambda cl, u, f, rc, p: (print("ingest connected", rc, flush=True), cl.subscribe("coldstore/#", qos=1))
c.on_message = on_message
c.connect_async(os.environ.get("BROKER", "iot-broker"), 1883, keepalive=30)
c.loop_start()
```

ولاحظ أن الخدمة تحفظ الرسالة الخام كاملة في العمود `raw` بجانب الحقول، والسبب القاعدة التي ذكرناها مع الحساس: إذا اكتشفت خطأ في التحليل لاحقاً فتستطيع أن تعيد قراءة الأصل. أما السطران عن WAL والجلسة الدائمة `PERSIST` فلم يكونا في النسخة الأولى، وكل منهما جاء من مشكلة حقيقية سوف نشرحها بعد قليل.

وأخيراً ملف `compose.yaml` الذي يجمع الخدمات الخمس:

```yaml
# The whole path on one machine: sensor node, a radio door contact behind a gateway, the broker, ingest/storage/dashboard.
name: iot-arch
services:
  iot-broker:
    image: eclipse-mosquitto:2.1.2-alpine
    container_name: iot-broker
    volumes:
      - ./mosquitto.conf:/mosquitto/config/mosquitto.conf:ro
      - iot-broker-data:/mosquitto/data
  iot-device:
    build: .
    image: iot-py:1
    container_name: iot-device
    command: python -u device.py
    environment: { DEVICE: room1-temp, PERIOD: "2" }
  iot-gateway:
    image: iot-py:1
    container_name: iot-gateway
    command: python -u gateway.py
  iot-door:
    image: iot-py:1
    container_name: iot-door
    command: python -u door_sensor.py
  iot-ingest:
    image: iot-py:1
    container_name: iot-ingest
    command: python -u ingest.py
    volumes: [ "iot-ingest-data:/data" ]
    ports: [ "127.0.0.1:18080:8080" ]
volumes:
  iot-broker-data: {}
  iot-ingest-data: {}
networks:
  default: { name: iot-net }
```

ولاحظ أن المنفذ الوحيد المنشور هو `127.0.0.1:18080` للوحة، أي أنها تفتح من جهازك فقط وليس من الشبكة المحلية، وقد شرحنا لماذا تكتب `127.0.0.1` قبل المنفذ في [دليل Docker](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-docker-%D8%B9%D9%84%D9%89-ubuntu/).

### تشغيل المختبر وقراءة السجلات Logs

الآن نقوم بالتشغيل ثم نقرأ سجلات الخدمات:

```bash
docker compose up -d --build
docker compose logs --no-color
```

والمخرج سوف يكون كما يلي، مختصراً إلى الأسطر المهمة:

```text
iot-broker   | 1793920734: mosquitto version 2.1.2 starting
iot-broker   | 1793920734: Config loaded from /mosquitto/config/mosquitto.conf.
iot-broker   | 1793920734: Opening ipv4 listen socket on port 1883.
iot-broker   | 1793920734: mosquitto version 2.1.2 running
iot-broker   | 1793920735: New client connected from 172.18.0.3:46597 as room1-temp (p4, c1, k10).
iot-broker   | 1793920736: New client connected from 172.18.0.4:33963 as gw-store1 (p4, c1, k10).
iot-broker   | 1793920739: New client connected from 172.18.0.6:42541 as ingest-1 (p4, c1, k30).
iot-device   | connected: Success
iot-device   | flushed 2 buffered readings
iot-gateway  | D1,1,1,2964 -> coldstore/store1/room1-door/telemetry {"seq": 1, "ts": 1793920749666, "door": "open", "bat_v": 2.964, "via": "gw-store1"}
iot-ingest   | ingest connected Success
iot-ingest   | status room1-temp = online (retained=True)
iot-ingest   | status gw-store1 = online (retained=True)
```

وعند قراءة السجل لاحظ التالي:

- الرقم في بداية كل سطر من Mosquitto هو الوقت بالثواني منذ 1970 Unix Time، وهنا 1793920734 يساوي 23:18:54 بتوقيت UTC.
- القوسان `(p4, c1, k10)` فيهما ثلاث معلومات عن كل اتصال: `p4` رقم إصدار البروتوكول، و4 هو الرقم الذي تستخدمه المواصفة لـ MQTT 3.1.1، وهو الإصدار الافتراضي في paho، و`c1` يعني جلسة نظيفة Clean Session، أي أن الوسيط ينسى كل شيء عن هذا الكلاينت عند انقطاعه، و`k10` مدة keepalive بالثواني.
- الجهاز بدأ قبل أن يتصل، فخزن قراءتين ثم أرسلهما فور الاتصال، وهذا ما تقوله `flushed 2 buffered readings`.
- خدمة الاستقبال اتصلت بعد الجهاز بأربع ثوان، فوجدت حالتي الجهاز والبوابة جاهزتين بـ `retained=True`، وهذا عمل الرسالة المحفوظة: لم تكن الخدمة موجودة عندما نشرت الحالة، ومع ذلك وصلتها.
- أما القراءات التي أرسلها الجهاز في هذه الثواني الأربع فلم تصل إلى الخدمة، وأول قراءة في قاعدة البيانات كانت رقم 3 وليس 1، والسبب أن الوسيط لا يحتفظ برسالة عادية لمشترك غير موجود. وهذه أول إشارة لما سوف نراه بشكل أكبر في التجربة.

ولترى الرسائل كما يراها أي مشترك، اشترك في كل شيء من داخل Container الوسيط بالأداة `mosquitto_sub`:

```bash
docker exec iot-broker mosquitto_sub -v -t 'coldstore/#' -C 9
```

والمخرج:

```text
coldstore/store1/room1-temp/status online
coldstore/store1/gw-store1/status online
coldstore/store1/room2-temp/status online
coldstore/store1/room3-temp/status online
coldstore/store1/room1-temp/telemetry {"seq": 618, "ts": 1793922157585, "temp_c": 12.42, "hum_pct": 77.6, "door": "open"}
coldstore/store1/room2-temp/telemetry {"seq": 578, "ts": 1793922158060, "temp_c": 3.95, "hum_pct": 80.4, "door": "closed"}
coldstore/store1/room3-temp/telemetry {"seq": 577, "ts": 1793921858124, "temp_c": 8.05, "hum_pct": 80.6, "door": "closed"}
coldstore/store1/room1-door/telemetry {"seq": 105, "ts": 1793922158490, "door": "open", "bat_v": 2.921, "via": "gw-store1"}
coldstore/store1/room1-temp/telemetry {"seq": 619, "ts": 1793922159586, "temp_c": 12.93, "hum_pct": 79.9, "door": "closed"}
```

الخيار `-v` يطبع اسم الموضوع قبل المحتوى، و`-C 9` يتوقف بعد تسع رسائل. ولاحظ أن الأسطر الأربعة الأولى وصلت فوراً لأنها محفوظة، وهذا المخرج من وقت متأخر من التجربة بعد أن أضفنا جهازين آخرين للغرفتين الثانية والثالثة كما سيأتي، ولاحظ أيضاً أن وقت `room3-temp` أقل من الباقي بثلاثمئة ثانية تقريباً، وهو الجهاز ذو الساعة الخاطئة. أما الحرارة 12.42 مع `door` مفتوح فهي فتحة باب في النموذج، وبعد ثانيتين أغلق الباب وما زالت الحرارة ترتفع قليلاً قبل أن يسحبها الضاغط.

وبعد بضع دقائق افتح `http://127.0.0.1:18080` في المتصفح، فسوف تجد اللوحة كما في الصورة التالية من المختبر:

![لوحة ويب بعنوان Cold room 1 (store1): سطر علوي فيه الحرارة الحالية 6.69 والباب مفتوح وعدد القراءات 450 ومتوسط التأخير 13773 ms، ثم رسم بياني لآخر 300 قراءة بخط أزرق يبقى قرب 4 درجات ويرتفع مع كل شريط أصفر للباب المفتوح حتى 13 درجة مع خط أحمر متقطع عند 8، ثم قائمة الأجهزة الأربعة online، ثم قائمة التنبيهات بخمسة أسطر منها اثنان لـ room1-temp في الثانية نفسها 23:40:39](https://arabroot.io/content/images/2026/11/iot-architecture-07-dashboard-1.webp)

لوحة المختبر بعد التجربتين: كل ارتفاع يبدأ مع فتح الباب، والتنبيهان في الثانية نفسها جاءا من قراءات وصلت متأخرة

وفي اللوحة رقمان يحتاجان شرحاً، وسوف نصل إليهما في التجربة: متوسط التأخير 13773 ملي ثانية رغم أن التأخير العادي ملي ثانية واحدة، وتنبيهان لـ `room1-temp` في الثانية نفسها.

### مشكلة واجهتنا: تأخير 19 ثانية مع database is locked

في النسخة الأولى من خدمة الاستقبال لم يكن سطر WAL موجوداً، وبعد دقيقة من التشغيل أردنا أن نرى أرقام التأخير، فقرأنا قاعدة البيانات من أمر `docker exec` منفصل، فظهر الخطأ التالي:

```text
sqlite3.OperationalError: database is locked
```

وهذا الخطأ وحده متوقع، ولكن الأغرب ظهر عندما نظرنا إلى التأخير لكل قراءة بعد ذلك، فهو ملي ثانية واحدة ثم يقفز فجأة إلى آلاف الملي ثواني ثم يعود:

```text
[(4, 53), (5, 34), (6, 1), (7, 1), (8, 1), (9, 0), (10, 29), (11, 1), (12, 1), (13, 11), (14, 2132), (15, 5635),
 (16, 10530), (17, 19305), (18, 18508), (19, 17557), (20, 16022), (21, 14118), (22, 12220), (23, 10260), (24, 9266),
 (25, 7352), (26, 5371), (27, 3507), (28, 1550), (29, 1), (30, 0), (31, 2084), (32, 3374), (33, 5468), (34, 3906), ...]
```

كل زوج هو الرقم التسلسلي والتأخير بالملي ثانية، ولاحظ الشكل: التأخير يصعد حتى 19305 ملي ثانية عند القراءة 17، ثم ينزل بمقدار ثانيتين تقريباً مع كل قراءة. وهذا الشكل يقول بوضوح ماذا حدث: الخدمة توقفت عن الكتابة قرابة 20 ثانية، والقراءات تراكمت في الطابور، ثم عادت الخدمة فكتبت المتراكم بسرعة، وكل قراءة متراكمة أحدث من التي قبلها بثانيتين. والتوقف حدث بالضبط في الوقت الذي كنا نقرأ فيه من الأمر المنفصل.

والسبب في طريقة القفل في SQLite: في الوضع الافتراضي، وهو سجل التراجع Rollback Journal، القارئ يحتاج قفلاً مشتركاً على الملف، والكاتب يحتاج قفلاً حصرياً عند الحفظ، فإذا كان هناك قارئ فالكاتب ينتظر، وأثناء انتظاره تتوقف دالة `on_message`، وتتوقف معها مكتبة MQTT عن معالجة الرسائل لأن الدالة تعمل في خيط Thread المكتبة نفسه. والحل الذي يوثقه [موقع SQLite](https://www.sqlite.org/wal.html?ref=arabroot.io) هو وضع السجل المسبق Write-Ahead Logging واختصاراً WAL، وفيه يكتب الكاتب في ملف منفصل، فالقراء لا يوقفون الكاتب والكاتب لا يوقف القراء. وبعد إضافة السطر أعدنا التجربة بقارئ أسوأ من الأول، يفتح معاملة Transaction ويبقيها أربع ثوان، اثنتي عشرة مرة متتالية:

```bash
docker exec iot-ingest python -c "
import sqlite3,time
for i in range(12):
  d=sqlite3.connect('/data/coldstore.db',timeout=30,isolation_level=None)
  d.execute('BEGIN'); n=d.execute('select count(*) from reading').fetchone()[0]; time.sleep(4); d.execute('COMMIT'); d.close()
print('reader done, last count',n)"
```

ثم نظرنا إلى وضع السجل والتأخير في الفترة نفسها:

```text
reader done, last count 34
('wal',)
(30, 0, 1.6333333333333333, 17)
```

أي أن الوضع أصبح `wal`، وخلال 48 ثانية من القراءة المستمرة كان أكبر تأخير 17 ملي ثانية والمتوسط 1.6\. والدرس هنا أوسع من SQLite: خدمة الاستقبال يجب ألا تتوقف بسبب من يقرأ البيانات، فإذا كانت قاعدة البيانات بطيئة لأي سبب فاجعل الاستقبال يضع الرسائل في طابور في الذاكرة ويكتبها خيط منفصل على دفعات، وراقب طول الطابور، لأن التأخير الذي رأيناه لم يظهر في أي خطأ، وإنما فقط في الفرق بين الوقتين، ولهذا قلنا احفظ الوقتين دائماً.

## ماذا يحدث إذا توقف الوسيط Broker؟ تجربة What If

الآن نصل إلى التجربة الأهم، وهي السؤال الذي يجب أن تسأله عن أي نظام إنترنت أشياء قبل أن تعتمد عليه: ماذا يحدث للقراءات عندما يتوقف شيء في المنتصف؟ ولنجعل المقارنة واضحة، أضفنا جهازين للغرفتين الثانية والثالثة على الشبكة نفسها، الثاني دون تخزين مؤقت ويرسل بـ QoS 0، كما تفعل أجهزة رخيصة كثيرة، والثالث مع التخزين المؤقت وساعته متأخرة كما رأينا:

```bash
docker run -d --name iot-device2 --network iot-net -e DEVICE=room2-temp -e BUFFER=0 iot-py:1 python -u device.py
docker run -d --name iot-device3 --network iot-net -e DEVICE=room3-temp -e CLOCK_SKEW=-300 iot-py:1 python -u device.py
```

### التجربة الأولى: الإعدادات الافتراضية Defaults

في التجربة الأولى كانت خدمة الاستقبال بنسختها الأولى، أي بجلسة نظيفة وبالانتظار الافتراضي بين محاولات العودة، فأوقفنا الوسيط ثم شغلناه بعد 153 ثانية:

```bash
docker stop iot-broker
# ... 153 seconds ...
docker start iot-broker
```

وسجل الوسيط عند التوقف والعودة كان كما يلي:

```text
1793921071: mosquitto version 2.1.2 terminating
1793921071: Saving in-memory database to /mosquitto/data//mosquitto.db.
1793921224: Restored 4 base messages
1793921224: Restored 4 retained messages
1793921224: Restored 0 clients
1793921224: Restored 0 subscriptions
1793921224: Restored 0 client messages
1793921224: mosquitto version 2.1.2 running
1793921230: New client connected from 172.18.0.5:48333 as room1-temp (p4, c1, k10).
1793921230: New client connected from 172.18.0.8:35109 as room3-temp (p4, c1, k10).
1793921230: New client connected from 172.18.0.7:44955 as room2-temp (p4, c1, k10).
1793921346: New client connected from 172.18.0.3:54459 as ingest-1 (p4, c1, k30).
1793921346: New client connected from 172.18.0.6:39369 as gw-store1 (p4, c1, k10).
```

وسجل الجهاز الأول:

```text
disconnected: Unspecified error
seq=90 temp=5.1 door=open buffered=15
seq=120 temp=8.01 door=closed buffered=45
seq=150 temp=3.83 door=closed buffered=75
connected: Success
flushed 80 buffered readings
```

ثم سجل خدمة الاستقبال بعد عودتها:

```text
ingest connected Success
gap room2-temp: expected seq 35, got 173
gap room1-temp: expected seq 76, got 213
gap room3-temp: expected seq 34, got 172
```

ولنقرأ القصة من هذه الأسطر بالترتيب:

- عند التوقف حفظ Mosquitto الرسائل المحفوظة في ملف، وعند العودة استعادها: أربع رسائل حالة، و`0 clients` لأن كل الجلسات كانت نظيفة فلا يوجد ما يحفظ.
- الأجهزة الثلاثة عادت بعد 6 ثوان من عودة الوسيط، لأن انتظارها محدود بـ 8 ثوان، والجهاز الأول كان قد خزن 80 قراءة فأرسلها كلها فوراً.
- أما خدمة الاستقبال والبوابة فعادتا بعد 122 ثانية من عودة الوسيط، والسبب أنهما بالإعداد الافتراضي في paho حيث يتضاعف الانتظار من ثانية حتى 120 ثانية، فكانت المحاولة التالية بعيدة.
- والنتيجة في قاعدة البيانات: الجهاز الأول فقد 137 قراءة، من 76 إلى 212، رغم أنه خزنها وأرسلها، لأنه أرسلها إلى وسيط لا يوجد فيه مشترك واحد، والجلسة النظيفة تعني أن الوسيط لا يحتفظ بشيء لمشترك غائب. والجهاز الثاني الذي لا يخزن فقد 138 قراءة، والثالث 138.

أي أن التخزين المؤقت في الجهاز لم ينفع إطلاقاً في هذه التجربة، والفرق بين جهاز يخزن وجهاز لا يخزن كان قراءة واحدة. وهذا هو الدرس الذي يفوت الكثيرين: البيانات لا تكون في أمان لأن طرفاً واحداً في السلسلة يخزن، وإنما عندما يتحمل كل طرف مسؤولية الطرف الذي بعده.

### التجربة الثانية: جلسة دائمة Persistent Session مع انتظار أقصر

عدلنا خدمة الاستقبال بالسطرين اللذين رأيتهما في الكود: `clean_session=False` مع اسم كلاينت ثابت `ingest-1`، فيحتفظ الوسيط باشتراكها ويجمع لها رسائل QoS 1 وهي غائبة، و`reconnect_delay_set(min_delay=1, max_delay=8)`. وعند إعادة التشغيل أصبح سطر الاتصال في سجل الوسيط `c0` بدل `c1`:

```text
1793921881: New client connected from 172.18.0.3:49505 as ingest-1 (p4, c0, k30).
```

ثم أوقفنا الوسيط مرة ثانية 140 ثانية، فكان سجل العودة:

```text
1793921891: mosquitto version 2.1.2 terminating
1793921891: Saving in-memory database to /mosquitto/data//mosquitto.db.
1793922031: Restored 4 base messages
1793922031: Restored 4 retained messages
1793922031: Restored 1 clients
1793922031: Restored 1 subscriptions
1793922031: Restored 4 client messages
1793922038: New client connected from 172.18.0.7:51717 as room2-temp (p4, c1, k10).
1793922038: New client connected from 172.18.0.3:60425 as ingest-1 (p4, c0, k30).
1793922038: New client connected from 172.18.0.8:52047 as room3-temp (p4, c1, k10).
1793922038: New client connected from 172.18.0.5:52291 as room1-temp (p4, c1, k10).
1793922042: New client connected from 172.18.0.6:38797 as gw-store1 (p4, c1, k10).
```

ثم فحصنا الفقد لكل جهاز منذ إعادة تشغيل الخدمة:

```text
room1-temp 102 first 481 last 582 gaps [] max latency 146072
room2-temp 29 first 440 last 542 gaps [(444, 519)] max latency 1
room3-temp 103 first 439 last 541 gaps [] max latency 448020
room1-door 16 first 83 last 98 gaps [] max latency 147752
```

وفي المخرج أعلاه لاحظ التالي:

- السطر `Restored 1 clients` مع `Restored 1 subscriptions` هو جلسة خدمة الاستقبال، فالوسيط حفظها في الملف عند التوقف، وعاد وهو يعرف أن `ingest-1` مشترك في `coldstore/#` حتى قبل أن تتصل.
- الكل عاد بعد 7 ثوان، فلم تعد هناك فترة يعمل فيها الوسيط دون مستقبل، وحتى لو تأخرت الخدمة فالوسيط كان سيجمع لها رسائل QoS 1، والحد الافتراضي لهذا الطابور في Mosquitto 1000 رسالة لكل كلاينت بحسب الخيار `max_queued_messages`.
- الجهاز الأول لم يفقد شيئاً، وأرسل 74 قراءة مخزنة بأوقاتها الأصلية، فوصلت أقدمها متأخرة 146 ثانية، وهذا هو الرقم الذي رفع متوسط التأخير في اللوحة إلى 13773 ملي ثانية. والجهاز الثالث لم يفقد شيئاً، وأكبر تأخير عنده 448 ثانية، وهي 148 ثانية انقطاع مع 300 ثانية من ساعته الخاطئة.
- الجهاز الثاني فقد 74 قراءة، من 445 إلى 518، لأنه لا يخزن ويرسل بـ QoS 0، فما يقيسه وقت الانقطاع يضيع في مكانه، ولا يوجد إعداد في الوسيط يعيده.
- والمفاجأة الجميلة حساس الباب: لم يفقد شيئاً رغم أن البوابة لا تخزن، والسبب أن مكتبة paho نفسها تحتفظ في الذاكرة برسائل QoS 1 التي تنشر وقت الانقطاع وترسلها بعد العودة، وهذا موثق في وصف الدالة `max_queued_messages_set` التي تحدد حجم هذا الطابور. ولكن هذا الطابور في الذاكرة فقط، فإذا أعيد تشغيل البوابة نفسها ضاع.

والصورة التالية تضع التجربتين بجانب بعض:

![قسمان: في الأعلى التجربة الأولى بجلسة نظيفة وانتظار حتى 120 ثانية، شريط أحمر الوسيط متوقف 153 ثانية ثم شريط أصفر الأجهزة عادت والقراءات بلا مستقبل 122 ثانية ثم أخضر Ingest عاد، وثلاث بطاقات: 137 قراءة مفقودة من room1-temp مع التخزين المؤقت و138 من room2-temp و275 ثانية من توقف الوسيط إلى عودة Ingest، وفي الأسفل التجربة الثانية بجلسة دائمة وانتظار أقصاه 8 ثوان، شريط أحمر 140 ثانية ثم الكل عاد بعد 7 ثوان، وبطاقات: 0 مفقودة من room1-temp والباب، و74 مفقودة من room2-temp، وسطر Restored 1 clients من سجل Mosquitto](https://arabroot.io/content/images/2026/11/iot-architecture-08-outage-1.webp)

التجربتان بأرقام المختبر: الفرق كله في إعدادين على جهة المستقبل

وهناك أثر جانبي ظهر في اللوحة يستحق الانتباه: التنبيهان في الثانية نفسها 23:40:39\. فالغرفة كانت دافئة أثناء الانقطاع، والقراءات التي تثبت ذلك وصلت دفعة واحدة بعد العودة، فطبقت الخدمة القاعدة عليها في لحظة الوصول، وسجلت التنبيه بوقت الوصول وليس بوقت الحدث. وهذا يعني أن مدير المستودع كان سيعرف أن الحرارة تجاوزت 8 درجات بعد أكثر من دقيقتين من حدوثه، وفي الحالة الأولى ما كان سيعرف أبداً. ولذلك قاعدة غياب القراءات التي ذكرناها ليست رفاهية: هي الشيء الوحيد الذي كان سيرسل تنبيهاً أثناء الانقطاع نفسه، وإذا كان التنبيه حرجاً فيجب أن يكون هناك قرار محلي في البوابة أو الجهاز، صفارة أو رسالة عبر شبكة أخرى، لا ينتظر السيرفر.

## على سيرفرك أم منصة سحابية؟ Self-hosted or Cloud

كل ما بنيناه في المختبر يعمل على سيرفر واحد صغير، وهذا خيار حقيقي لشركة لديها مستودع أو اثنان: Mosquitto وقاعدة بيانات ولوحة على سيرفر داخل الشركة، والبيانات تبقى داخل المملكة وتحت يدك، ولا توجد رسوم على كل رسالة. والخيار الآخر منصة سحابية مخصصة، مثل AWS IoT Core أو [Azure IoT Hub](https://learn.microsoft.com/en-us/azure/iot-hub/iot-concepts-and-iot-hub?ref=arabroot.io)، التي تعطيك وسيطاً مداراً وتسجيلاً للأجهزة وشهادة لكل جهاز وخدمات مثل Device Shadow، مقابل رسوم ترتبط بعدد الرسائل والأجهزة، وارتباط بطريقة عمل المزود.

والقرار يعتمد على ثلاثة أسئلة: كم جهازاً سوف يكون لديك بعد سنتين، فعشرات الأجهزة يخدمها سيرفر صغير بسهولة، وعشرات الآلاف تحتاج فريقاً أو منصة. ومن سوف يدير الوسيط ويحدثه ويراقبه في منتصف الليل، فالوسيط المتوقف رأينا أثره. وأين يجب أن تبقى البيانات، وهل هناك متطلبات نظامية لمكانها. والجيد في الأمر أنك إذا بنيت أجهزتك على MQTT المعياري، وفصلت أسماء المواضيع عن أي منصة، فالانتقال من سيرفرك إلى منصة أو العكس يكون في الغالب تغيير عنوان الوسيط والشهادات، وليس إعادة كتابة البرنامج الثابت، وهذا بالضبط سبب اختيارنا لبروتوكول معياري من البداية. وإذا أردت أن تجرب هذه الأدوات على جهاز في البيت قبل الشركة، فقد شرحنا فكرة بيئة التجارب المنزلية في [مقال الهوم لاب Homelab](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-%D8%A7%D9%84%D9%87%D9%88%D9%85-%D9%84%D8%A7%D8%A8-homelab-%D9%88%D9%84%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D8%A8%D9%86%D9%8A%D9%87/).

## الأمن Security من اليوم الأول

المختبر فيه ثلاثة أخطاء أمنية متعمدة: الوسيط يقبل أي أحد دون كلمة مرور، والرسائل تمر دون تشفير، وكل كلاينت يستطيع أن ينشر على أي موضوع، بما في ذلك موضوع الأوامر. وهذه الأخطاء الثلاثة هي بالضبط ما تجده في كثير من الأنظمة الحقيقية، والأجهزة نفسها مشهورة بكلمات المرور الافتراضية، وفي أكتوبر 2016 نشرت CISA الأمريكية [تنبيهاً عن شبكة Mirai](https://www.cisa.gov/news-events/alerts/2016/10/14/heightened-ddos-threat-posed-mirai-and-other-botnets?ref=arabroot.io) التي جمعت كاميرات وأجهزة تسجيل وراوترات منزلية بتجربة قائمة من 62 اسم مستخدم وكلمة مرور افتراضية، واستخدمتها في هجمات حجب خدمة تجاوز أحدها 620 جيجابت في الثانية.

ولن نكرر هنا أساسيات الأمن التي شرحناها في [مقال الأمن السيبراني](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%88-%D8%A7%D9%84%D8%A7%D9%85%D9%86-%D8%A7%D9%84%D8%B3%D9%8A%D8%A8%D8%B1%D8%A7%D9%86%D9%8A-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%A9-%D9%88%D8%A7%D9%84%D8%B3%D9%84%D8%A7%D9%85%D8%A9-%D9%88%D8%A7%D9%84%D8%AA%D9%88%D8%A7%D9%81%D8%B1/)، ولكن هناك ثلاث قواعد يجب أن تبدأ بها في أي مشروع إنترنت أشياء: ضع الأجهزة في شبكة منفصلة لا تصل إلا إلى الوسيط، كما شرحنا في [مقال تقسيم الشبكة](https://arabroot.io/articles/%D8%AA%D9%82%D8%B3%D9%8A%D9%85-%D8%A7%D9%84%D8%B4%D8%A8%D9%83%D8%A9-network-segmentation-vlan-%D9%88-vpc/) وطبقناه على الكاميرات في [مقال تأمين كاميرات المراقبة](https://arabroot.io/articles/%D8%AA%D8%A3%D9%85%D9%8A%D9%86-%D9%83%D8%A7%D9%85%D9%8A%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B1%D8%A7%D9%82%D8%A8%D8%A9-%D9%88%D8%B9%D8%B2%D9%84%D9%87%D8%A7-%D9%81%D9%8A-vlan/)، ثم اجعل لكل جهاز اسماً وكلمة مرور أو شهادة خاصة به، ثم اجعل صلاحيات كل جهاز على مواضيعه فقط. وسوف نهاجم المختبر نفسه ثم نغلقه بالتشفير والصلاحيات في مقال أمن إنترنت الأشياء من السلسلة.

## أخطاء شائعة Common Mistakes

- **البدء من لوحة المتابعة:** لوحة جميلة فوق بيانات بلا رقم تسلسلي ولا وقت جهاز لا تستطيع أن تقول لك ماذا ضاع ومتى.
- **الاعتماد على التخزين في طرف واحد:** رأينا جهازاً خزن 80 قراءة وأرسلها كلها إلى وسيط لا يستمع له أحد، فضاعت كما ضاعت قراءات الجهاز الذي لا يخزن.
- **ترك الإعدادات الافتراضية لإعادة الاتصال:** الحد الأعلى 120 ثانية في المكتبة جعل خدمة الاستقبال تغيب دقيقتين بعد عودة الوسيط.
- **التنبيه على القيم فقط:** الجهاز المتوقف لا يرسل قيمة عالية، فاجعل غياب القراءات تنبيهاً بحد ذاته.
- **الوثوق بساعة الجهاز دون فحص:** جهاز لم يأخذ الوقت من NTP يرسم الأحداث في غير مكانها، فاحفظ الوقتين وراقب الفرق.
- **أسماء مواضيع فيها عناوين IP أو بيانات متغيرة:** اسم الموضوع جزء من عقد طويل مع الأجهزة، فاجعله ثابتاً ومفهوماً.
- **حفظ القيمة المصححة فقط:** احفظ الخام دائماً، والتصحيح منفصلاً.
- **وسيط مفتوح دون كلمة مرور على الشبكة:** مقبول في مختبر لا يصل إليه أحد، وغير مناسب إطلاقاً في أي مكان آخر.

## قائمة تحقق Checklist قبل أول حساس

| السؤال                                        | الإجابة التي تبحث عنها                                         |
| --------------------------------------------- | -------------------------------------------------------------- |
| هل لكل قراءة رقم تسلسلي ووقت جهاز بتوقيت UTC؟ | نعم، ويحفظهما السيرفر مع وقت الاستقبال                         |
| هل يأخذ الجهاز الوقت من NTP قبل أن يرسل؟      | نعم، أو يضع على القراءة علامة أن وقتها غير موثوق               |
| ماذا يحدث عند انقطاع الشبكة دقيقتين؟          | الجهاز أو البوابة يخزن، والمستقبل بجلسة دائمة و QoS 1، ولا فقد |
| ماذا يحدث عند انقطاع ساعات؟                   | تعرف حجم التخزين، وماذا يحذف عندما يمتلئ                       |
| ما أقصى انتظار لإعادة الاتصال في كل طرف؟      | قيمة اخترتها أنت، بالثواني وليس بالدقائق                       |
| هل هناك تنبيه على غياب القراءات؟              | نعم، لكل جهاز، مع حالة offline من الوصية                       |
| هل التنبيه الحرج يعمل دون السيرفر؟            | قرار محلي في البوابة أو الجهاز                                 |
| هل خدمة الاستقبال تتأثر بمن يقرأ البيانات؟    | لا، وطول طابورها مراقب                                         |
| هل لكل جهاز هوية وصلاحيات على مواضيعه فقط؟    | نعم، والأوامر أشد من القراءات                                  |
| هل الأجهزة في شبكة منفصلة؟                    | نعم، ولا تصل إلا إلى الوسيط وسيرفر الوقت والتحديث              |

## تدريب عملي Practice

1. أضف إلى `ingest.py` قاعدة تنبيه على غياب القراءات: إذا مرت 30 ثانية دون قراءة من جهاز، سجل تنبيهاً، ثم أوقف `iot-device` بالأمر `docker stop iot-device` وانظر متى يظهر التنبيه، ومتى تصل حالة `offline` من الوصية.
2. شغل `iot-device2` مرة ثانية مع `BUFFER=1`، وكرر تجربة إيقاف الوسيط، وتأكد أن الفقد أصبح صفراً للأجهزة الثلاثة.
3. أوقف البوابة نفسها `docker restart iot-gateway` أثناء انقطاع الوسيط، ولاحظ ما يحدث لطابور الرسائل الذي كان في ذاكرتها.

## حذف المختبر Cleanup

```bash
docker rm -f iot-device2 iot-device3
docker compose down -v
docker image rm iot-py:1
```

الأمر الأول يحذف الجهازين اللذين أضفناهما خارج ملف compose، والثاني يحذف الخدمات الخمس والشبكة والـ Volumes مع قاعدة البيانات، والثالث يحذف الـ Image الذي بنيناه، ويبقى Image الوسيط `eclipse-mosquitto:2.1.2-alpine` وحجمه قرابة 13 ميجابايت لأننا سوف نستخدمه في المقال التالي.

## الخلاصة Summary

- نظام إنترنت الأشياء ست طبقات: الحساس والجهاز والبوابة في الحافة، والوسيط والتخزين والمتابعة على السيرفر، والشبكة بينهما تنقطع كحالة عادية.
- كل قراءة تحتاج رقماً تسلسلياً ووقت جهاز بتوقيت UTC وهوية ثابتة، والسيرفر يحفظ معها وقت الاستقبال والرسالة الخام.
- MQTT انتشر لأنه يبقي اتصالاً واحداً يبدؤه الجهاز، ويعرف أن الشبكة غير موثوقة: مستويات تسليم ووصية ورسائل محفوظة وجلسات دائمة.
- في التجربة لم ينفع التخزين في الجهاز وحده، وفقدنا 137 قراءة، وبعد جلسة دائمة للمستقبل وانتظار أقصر أصبح الفقد صفراً.
- التنبيه على غياب القراءات أهم من التنبيه على القيم، والتنبيه الحرج يحتاج قراراً محلياً لا ينتظر السيرفر.

[![](https://arabroot.io/content/images/2026/11/mqtt-mosquitto-cover-cover.webp)دليلبروتوكول MQTT مع Mosquitto: كيف تتكلم الأجهزةنفهم الوسيط من الداخل برسائل حقيقية: مستويات التسليم والرسائل المحفوظة والوصية والجلسات الدائمة، ثم نغلقه بالتشفير وكلمات المرور والصلاحيات.](https://arabroot.io/articles/%D8%A8%D8%B1%D9%88%D8%AA%D9%88%D9%83%D9%88%D9%84-mqtt-%D9%85%D8%B9-mosquitto-%D9%83%D9%8A%D9%81-%D8%AA%D8%AA%D9%83%D9%84%D9%85-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9/)[![](https://arabroot.io/content/images/2026/10/timeseries-db-cover-cover.webp)دليلTimescaleDB وInfluxDB لبيانات السلاسل الزمنية Time-Seriesكيف تحفظ قراءات الأجهزة والمقاييس سنوات دون أن يكبر القرص بلا حد، ومتى يناسبك TimescaleDB أو InfluxDB.](https://arabroot.io/articles/%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%B3%D9%84%D8%A7%D8%B3%D9%84-%D8%A7%D9%84%D8%B2%D9%85%D9%86%D9%8A%D8%A9-timescaledb-%D9%88-influxdb/)[![](https://arabroot.io/content/images/2026/11/prometheus-grafana-cover-cover.webp)دليلمقاييس السيرفرات Metrics: Prometheus مع لوحات Grafanaنجمع مقاييس المعالج والذاكرة والقرص والـ Containers مع Prometheus، ونتنبأ بموعد امتلاء القرص قبل أن يحدث، ونبني لوحة Grafana محفوظة ككود في Git.](https://arabroot.io/articles/%D9%85%D9%82%D8%A7%D9%8A%D9%8A%D8%B3-%D8%A7%D9%84%D8%B3%D9%8A%D8%B1%D9%81%D8%B1%D8%A7%D8%AA-metrics-prometheus-%D9%85%D8%B9-%D9%84%D9%88%D8%AD%D8%A7%D8%AA-grafana/)[![](https://arabroot.io/content/images/2026/10/network-segmentation-cover-cover.webp)دليلتقسيم الشبكة Network Segmentation بال VLAN وال VPCلماذا تصل كاميرا مخترقة إلى قاعدة بياناتك، وكيف تمنع ذلك بتقسيم الشبكة إلى مناطق لا يمر بينها إلا ما تسمح به.](https://arabroot.io/articles/%D8%AA%D9%82%D8%B3%D9%8A%D9%85-%D8%A7%D9%84%D8%B4%D8%A8%D9%83%D8%A9-network-segmentation-vlan-%D9%88-vpc/)

وفي [المقال القادم](https://arabroot.io/articles/%D8%A8%D8%B1%D9%88%D8%AA%D9%88%D9%83%D9%88%D9%84-mqtt-%D9%85%D8%B9-mosquitto-%D9%83%D9%8A%D9%81-%D8%AA%D8%AA%D9%83%D9%84%D9%85-%D8%A7%D9%84%D8%A7%D8%AC%D9%87%D8%B2%D8%A9/) من السلسلة بإذن الله سوف نأخذ الوسيط وحده ونتعمق في Mosquitto: المواضيع ومستويات التسليم الثلاثة والرسائل المحفوظة والوصية، ثم الصلاحيات والتشفير.

## سجل التحديثات Changelog

- نوفمبر 2026: كتابة المقال، والتجربة على Mosquitto 2.1.2 (eclipse-mosquitto:2.1.2-alpine) ومكتبة paho-mqtt 2.2.0 على Python 3.13.18 في Docker Engine 29.8.0، والمعلومات من مواقع MQTT وOASIS وMosquitto وpaho وSQLite وThread Group وLoRa Alliance كما قرأناها في 6 نوفمبر 2026.