القراءات

ما يحدث للقراءة¶

القراءة قيمة واحدة لقياس في وقت واحد. يرسل المستشعر القراءات عبر HTTPS، حتى 500 في الطلب (نقطة استقبال المستشعر)، ولكل قراءة بالترتيب:

1. وقتها وقت المستشعر. at هو ما تُحفظ به القراءة وتُرسم ويُحكم عليها، ويُحفظ بجانبه وقت وصولها. والقراءة المؤرخة بأكثر من عشر دقائق في المستقبل تُرفض — فساعة المستشعر خاطئة — وكذلك التي هي أقدم مما تحفظه المؤسسة من القراءات.
2. تُستلم كل قراءة مرة واحدة. المستشعر نفسه وat نفسه مرة أخرى مستلمة من قبل ولا تغيّر شيئًا، فيستطيع المستشعر إعادة إرسال دفعة بأمان.
3. القراءة المتأخرة مقبولة. الدفعة المتراكمة منذ ساعة تقع في ساعتها ويومها من السجل، ولا تعيد أحدث قيم الأصل إلى الوراء أبدًا.
4. تحكم القواعد عليها حين تُحفظ — يُفحص الحد في الطلب نفسه (القواعد). والقاعدة تحكم إلى الأمام فقط: القراءة الأقدم من آخر ما حكمت عليه لذلك المستشعر تُحفظ، لكنها لا تفتح شيئًا ولا تمدّه ولا تغلقه.
5. تأخذ الطبقة الحيّة أحدث قيمة لكل قياس لكل أصل، في كتابة واحدة لا تتكرر أسرع من مرة كل 30 ثانية في Haiyz Cloud — حدّ التحديث الأدنى — فتظهر في لوحة المعلومات بعد نحو دقيقة من إرسالها.

حالة التنبيه¶

ما تقوله قراءات الأصل الآن، تضبطه المنصة ولا يضبطه شخص أبدًا — عمود alert_state في الطبقة الحيّة:

القيمة	تظهر باسم	متى
normal	طبيعي	أرسل مستشعر مشغَّل للأصل قراءة
alerting	تنبيه	حدث مفتوح لقاعدة على قراءاته — حد أو منطقة
stale	منقطع	لمستشعر مشغَّل قراءات، أحدثها أقدم مما تنتظره الفئة
none	لا يوجد	لا شيء يرسل عنه: لا مستشعر، أو لا مستشعر مشغَّل، أو لم يرسل أي منها شيئًا

إذا انطبقت حالتان فالترتيب stale ثم alerting ثم normal ثم none: المستشعر الصامت يغلب الحد المتجاوز، الذي يبقى مفتوحًا ومحسوبًا في open_events، ويعود الأصل إلى حالة التنبيه بقيمة alerting حين يرسل مستشعره. أما حالة الخدمة التي يضبطها شخص فعمود آخر في طبقة أخرى.

الانقطاع¶

يكون المستشعر منقطعًا حين يكون مشغَّلًا، وأرسل قراءات، وأحدثها — بوقتها هي — أقدم من القراءات متوقعة كل في فئته. تنظر المنصة كل خمس دقائق. والأصل منقطع ما دام أي من مستشعراته المشغَّلة منقطعًا؛ والمستشعر الذي يعود فيرسل يُرفع عنه الانقطاع مع تلك القراءة، لا بعد خمس دقائق. والمستشعر الذي لم يرسل شيئًا قط ليس منقطعًا: أصله يقرأ لا يوجد.

ولا يُبلَّغ أحد بانقطاع مستشعر إلا عبر قاعدة على ينقطع مستشعر. وبدونها يظهر منقطعًا في صفحته وصفحة أصله والطبقة الحيّة ولوحات المعلومات، ولا تُرسل رسالة لأحد.

السجل والرسوم¶

صفحة الأصل › القراءات: أحدث القيم، ورسم لكل قياس بخط لكل مستشعر، على فترة — آخر 24 ساعة، أو 7 أو 30 أو 90 أو 365 يومًا. الفترة القصيرة ترسم كل قراءة، والأطول متوسط كل ساعة ثم كل يوم، والملاحظة تحت الفترة تقول أيهما. والقياس نعم/لا يرسم آخر قيمة في كل ساعة أو يوم.

• الساعات والأيام بتوقيت الرياض (UTC+3، بلا توقيت صيفي) — الأيام نفسها التي تستعملها رسوم لوحات المعلومات. وتظهر القراءة المفردة بتوقيتك أنت.
• تُعلَّم الأحداث على الرسوم: شريط من بداية الحدث إلى انتهائه — وإلى نهاية الرسم ما دام مفتوحًا — مع القاعدة وأسوأ قيمة حين تشير داخله.
• لصفحة المستشعر الرسوم نفسها لذلك المستشعر وحده؛ وعنصر سلسلة القراءات في لوحة المعلومات يرسم مستشعرًا واحدًا، أو كل مستشعرات فئة، بإحصاء لكل ساعة أو يوم — الأخيرة أو المتوسط أو الأدنى أو الأعلى أو المجموع أو العدد أو الوسيط. والوسيط يحتاج كل قراءة، فلا يصل إلا إلى حيث تُحفظ القراءات مفردة. والفئة التي تزيد مستشعراتها على 20 تُرسم ثلاثة خطوط بدل خط لكل مستشعر: الأدنى والمتوسط والأعلى لكل مستشعراتها، ساعة بساعة أو يومًا بيوم.

مدة حفظ القراءات¶

ما يُحفظ	مدته
كل قراءة	مدة احتفاظ المؤسسة — في Haiyz Cloud مدة فئتها (Pro ثلاثون يومًا، وMax تسعون)؛ وفي النسخة المستضافة ذاتيًا إعدادها الخاص (365 يومًا ما لم يُغيَّر)
عدد كل ساعة وأدناها وأعلاها ومجموعها وآخرها	90 يومًا
مثلها لكل يوم	حتى يُحذف المستشعر أو فئته أو المؤسسة
القراءات التي يحفظها حدث	ما دام الحدث محفوظًا — انظر الأحداث

والقراءة التي تحمل موقعًا قد تكون بيانات شخصية؛ وتذهب بانتهاء مدة الحفظ، ومع مستشعرها، ومع المؤسسة.