Skip to main content
غالبًا ما يكون السؤال الأول عند حدوث ارتفاع مفاجئ في زمن الاستجابة أو الأخطاء هو: هل نُشرت تغييرات جديدة؟ يمكن للمخططات الزمنية في لوحة المعلومات الإجابة عن ذلك فورًا: فعِّل وسوم الإصدار، فيرسم كل بلاطة خطًا عموديًا متقطعًا عند اللحظة التي يظهر فيها إصدار خدمة لأول مرة في بيانات القياس عن بُعد الخاصة بها. تأتي الإصدارات من بيانات القياس عن بُعد التي ترسلها بالفعل، وتُقرأ عبر تعبير في مصدر البلاطة. لا حاجة إلى إعداد تكامل CI أو إرسال أي شيء عند النشر.

تفعيل الوسوم

تكون وسوم الإصدار معطّلة افتراضيًا. افتح قائمة الخيارات الإضافية للوحة المعلومات واختر إظهار وسوم الإصدار. يضيف مفتاح التبديل releaseMarkers=true إلى URL لوحة المعلومات، لذا يُفتح الرابط الذي تشاركه مع تفعيل الوسوم مسبقًا. هذه حالة عرض وليست إعدادًا للوحة المعلومات: لا تُحفظ مع لوحة المعلومات، ويؤدي تعطيلها إلى إزالة المعلَمة مجددًا. تُرسم الوسوم على بلاطات السلاسل الزمنية التي يكون مصدرها مصدر سجل أو مصدر تتبّع. تأتي التعليقات التوضيحية للتنبيهات من القائمة نفسها، ويمكن إظهارها في الوقت نفسه — تُرسم مجموعتا الوسوم معًا، وتحتفظ كل منهما بتسمياتها الخاصة.

تهيئة مصدر الإصدار

يقرأ ClickStack افتراضيًا سمة المورد ResourceAttributes['service.version'] في OpenTelemetry. إذا كانت خدماتك تتبع الاتفاقيات الدلالية لمورد الخدمة، فستعمل الوسوم دون أي تهيئة. لقراءة الإصدار من مصدر آخر، عيّن تعبير إصدار الخدمة في مصدر السجل أو التتبع. حرّر المصدر من إعدادات الفريق → المصادر. في مصدر السجل، يوجد الحقل ضمن تهيئة الحقول الاختيارية؛ أما في مصدر التتبع، فيظهر مباشرةً في النموذج أسفل تعبير اسم الخدمة. القيمة تعبير SQL وليست اسم سمة، وهذا يغطي حالتين شائعتين:
  • معرّف الإصدار موجود في سمة أخرى. في GitOps، يكون ما يعرّف الإصدار عادةً هو وسم صورة الحاوية، ويصل باسم container.image.tag. توجيه المصدر إلى ResourceAttributes['container.image.tag'] أقل كلفة بكثير من تغيير instrumentation في جميع الخدمات.
  • تختلف الخدمات ضمن جدول واحد. استخدم coalesce للرجوع إلى سمات بديلة:
يتوفر الحقل أيضًا باسم serviceVersionExpression في مصادر السجلات والتتبعات ضمن واجهة برمجة تطبيقات المصادر، لذا يمكنك ضبطه عند إعداد المصادر برمجيًا. راجع القائمة الكاملة لإعدادات المصدر الخاصة بـالسجلات والتتبعات.

معنى الوسم

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

الإصدارات التي يعرضها البلاطة

يُنفَّذ استعلام الإصدارات على المصدر الخاص بالبلاطة، باستخدام المسندات الخاصة به: عبارة WHERE وعامل تصفية كل سلسلة وأي عوامل تصفية للوحة المعلومات. يعتمد ما يعرضه البلاطة على ما يرسمه في المخطط: في الحالة الثالثة، لا يوجد خط في المخطط يطابق خدمة الوسم، لذا تُحذف الوسوم. أما إذا كانت جميع الإصدارات في النافذة من خدمة واحدة، فتُرسم باللون الافتراضي للوسوم.

قراءة الوسوم على مخطط مزدحم

مرّر المؤشر فوق تسمية وسم لعرض جميع الإصدارات عند تلك النقطة، مع الخدمة التي أصدرتها وإصدار كلٍّ منها ووقته. يربط اللون الوسم بسلسلتها، لكن وسيلة إيضاح المخطط تعرض أربعة إدخالات كحد أقصى قبل طيّ البقية خلف “+N المزيد”، وعندها لا يعود هناك ما على الشاشة يمكن مقارنة اللون به. يذكر التلميح اسم الخدمة صراحةً، لذا يظل مفيدًا بغض النظر عن عدد السلاسل التي يعرضها البلاطة. تُجمع الوسوم المتقاربة جدًا بحيث لا يمكن تسميتها فرديًا في نقطة ارتكاز واحدة تحمل التسمية N إصدارات؛ ويؤدي تمرير المؤشر فوقها إلى عرض أسمائها جميعًا. يُرسم التجمع الذي يمتد عبر عدة خدمات بلون محايد بدلًا من لون إحدى هذه الخدمات، ليظل العدد دقيقًا من دون الإيحاء بوجود مالك. يستمر السحب أفقيًا عبر الرسم في التكبير حتى عند عرض الوسوم.

القيود

  • لبلاطات السلاسل الزمنية فقط. لا تعرض الجداول والأرقام والخرائط الحرارية وسومًا.
  • لمصادر السجل والتتبع فقط. يحدّد مصدر المقاييس جدوله وفقًا لنوع المقياس، لذا لا يوجد جدول واحد لإعادة التجميع، ولا يمكن تطبيق عوامل تصفية البلاطة عليه بشكل ذي معنى. لإضافة تعليقات توضيحية إلى بيانات المقاييس، ضع بلاطة سجل أو تتبع بجانبها في لوحة المعلومات نفسها.
  • تُتخطى قيم الإصدار الفارغة. لا تُنتج الخدمة التي لا تصدر إصدارًا أي وسوم. إذا لم تعثر البلاطة على أي تغييرات في الإصدار، يعرض ClickStack No releases found بدلًا من أن تتساءل عما إذا كانت الميزة معطّلة.
  • تُقرأ حتى 500 إصدار مميز لكل نافذة.
آخر تعديل في ٢٦ أغسطس ٢٠٢٦