اختر إشارة
ابدأ التحقيق في الإخفاق بالمشكلات أو السجلات. استخدم تتبّعًا متاحًا لفحص تنفيذ
واحد. واستخدم اتجاه مقياس لفحص الفترة الأوسع. لمعرفة النشاط والاحتفاظ
بالمستخدمين، اقرأ تحليلات المنتج.
التقط الحقول التي يحتاجها التحقيق فقط. استخدم أسماء ثابتة للخدمات والعمليات
والمقاييس. لا ترسل بيانات الاعتماد أو بيانات الدفع أو نصوص الطلبات الخام. تشرح
إرشادات التحكم في البيانات الملتقطة أدوات التحكم في ذلك.
السجلات
السجل قيد يصدر عن التطبيق في لحظة زمنية واحدة. يحتوي السجل المفيد على:- وقت وقوع الحدث في المصدر.
- مستوى خطورة معياري.
- نطاق المشروع والخدمة.
- البيئة والإصدار.
- معرّفَي التتبّع والـ Span عندما يكون للسجل سياق تتبّع نشط.
- سمات صغيرة ومسمّاة تحمل سياق الحدث.
occurred_at وseverity وproject_id
وservice_name وenvironment وrelease وtrace_id وspan_id
وattributes. ضع السياق في سمات مسمّاة، لا في نص الرسالة.
السجلات الصادرة عن عدة خدمات في عرض واحد لا تجمعها علاقة تتبّع. سياق التتبّع
وحده ينشئ هذه العلاقة.
التتبّعات
يحتوي التتبّع على الـ Spans الخاصة بطلب واحد أو عملية واحدة. الـ Span الجذري ليس له أب. ويحدد الـ Span الفرعي الـ Span الأب الخاص به. تحمل كل Spans التتبّع معرّف التتبّع نفسه ومعرّفات Span مختلفة. راجع التتبّع الموزّع. يحصل كل سجل أو مشكلة أو إجراء أو مقياس يُرسَل دون سياق تتبّع نشط على تتبّع التقاط. لا يحتوي هذا التتبّع إلا على Spans التقاط، ولا يُظهر مسار طلب. راجع Spans الالتقاط.المقاييس
يسجّل المقياس قيمة مقيسة عبر الزمن. اقرأ كل مقياس مع اسمه ووحدته وأبعاده ومشروعه ونطاقه الزمني وفاصله الزمني. يختار LogBrew قيمةvalue لكل نقطة بناءً
على kind وtemporality للمقياس:
مثلًا، ثلاث عيّنات من عدّاد تغيّر (delta counter) بالقيم
2 و3 و5 في فاصل
زمني واحد تعطي نقطة قيمتها value تساوي 10 وقيمة sample_count تساوي 3.
أما ثلاث عيّنات gauge بالقيم نفسها وبالترتيب نفسه فتعطي نقطة قيمتها value
تساوي 5. قيمة p95 ليست متوسطًا. فنحو 95% من الملاحظات المسجّلة تساويها أو
تقل عنها.
عند status: "ready" يكون التجميع المشتق متاحًا. وعند status: "limited" اقرأ
aggregation.limitation واستخدم القيم الخام فقط. لا تجمع قيم gauge أو تدفقًا
تراكميًا. والفاصل الزمني الذي لا نقطة فيه ليس قياسًا بقيمة صفر. لمعرفة حقول
الاستعلام، اقرأ
عوامل تصفية الاستعلام.
تُرجع GET /api/telemetry/metrics/series هذه النقاط. وتتطلب project_id
وname وsince. لكل سلسلة identity واحدة تحمل kind وunit
وtemporality. وتبقى السلاسل ذات الهويات المختلفة منفصلة. ويمكن أن تحتوي كل
نقطة أيضًا على:
تكون
coverage.truncated بالقيمة true عندما يُسقط series_limit السلاسل
الأقل حجمًا. لمقارنة نافذة مقياس بالنافذة السابقة لها بالطول نفسه، شغّل:
المشكلات
تجمع المشكلة الإخفاقات المتكررة حسب بصمة ثابتة. ولها خطورة وحالة وعدد مرات حدوث ووقت أول ظهور ووقت آخر ظهور. ويمكن أن تضيف تفاصيل المشكلة سلاسل الاستثناءات وإطارات المكدّس والـ Breadcrumbs (أحداث قصيرة مسجَّلة قبل وقوع المشكلة) والسجلات المرتبطة وعلاقة تتبّع. تمثّلlast_seen_at أحدث حدوث في المجموعة. وقد يكون الحدوث الذي تختاره أقدم.
اقرأ الوقتين كليهما.
تكون قيمة status للمشكلة unresolved أو resolved أو archived. يعرض
الإصدار 1 من استجابة الـ API القيمة archived على أنها ignored. ويضيف
الإصداران 2 و3 الحقلين priority (high أو medium أو low)
وpriority_source. ويضيف الإصدار 3 أيضًا assignee. راجع
قيم الحالة
والأولوية.
الإجراءات
يسجّل الإجراء نشاط المنتج. ويصنّفه التصنيف المدعوم على أنه مشاهدة صفحة أو مشاهدة شاشة أو تفاعل. اسم الحدث وحده لا يحدد التصنيف. استخدم التقاط أحداث المنتج لإضافة هذا السياق. الجلسات ليست مستخدمين. والكيانات مجهولة الهوية ليست مستخدمين معروفي الهوية.قيم الخطورة
يقبل LogBrew الأسماء البديلة في الإدخال بأي حالة أحرف. ويستخدم الـ API والـ CLI
والأحداث المباشرة القيم المعيارية. ويرفض قيم الخطورة غير المعروفة. الخطورة هي
درجة الإلحاح المسجّلة، ولا تُظهر التأثير على العمل أو السبب الجذري.
يمكن للمستخدم تغيير الخطورة المعروضة لمشكلة أو سجل. عندها تحتوي الاستجابة على
كائن
triage فيه effective_severity. ويحتفظ الحقل severity بالقيمة
الملتقَطة.
القراءة المباشرة واللقطات
يُرجعlogbrew read لقطة للمشروع والنطاق الزمني وعوامل التصفية المحددة. شغّله
مرة أخرى لقراءة الأحداث الجديدة. ويبثّ logbrew watch السجلات والمشكلات
والإجراءات الجديدة ما دام الاتصال مفتوحًا. ولا يبثّ التتبّعات أو المقاييس. فشل
الاتصال لا يعني أن المشروع فارغ.
حالات الأدلة
تُبقي الاستجابات هذه الحالات منفصلة: ملتقَط، ومفقود، ومحجوب، ومقتطَع، وغير متاح. ولأدلة التتبّع أربع حالات:available وnot_linked وnot_found
وunavailable. راجع المقدمة
لمعرفة معناها، وحدود الأدلة
لمعرفة حقول التغطية. الإصدار الأحدث من الـ SDK لا يضيف حقولًا إلى الأحداث التي
أرسلها سابقًا.
التحقيق في مشروع واحد
1
اعثر على المشكلات غير المحلولة
2
اقرأ مشكلة واحدة
يقرأ هذا الأمر تاريخ المشكلة المحتفَظ به. ولا ينطبق عليه عامل التصفية
--since المستخدم في القائمة.3
افتح تتبّعًا متاحًا
استخدم معرّف التتبّع فقط عندما يُرجعه الحدوث المحدد.
4
اقرأ الأدلة المرتبطة
صفِّ السجلات والإجراءات والمقاييس حسب المشروع والخدمة والبيئة والإصدار
نفسها. لا تربط الإشارات بالوقت وحده.