كل إشارة. قصة واحدة واضحة.
يربط LogBrew السجلات والتتبّعات والمشكلات والإصدارات لتفهم سبب كل عطل.
السجلات
ابحث في الرسالة، ثم افتح التتبّع عندما يفسّر سجلٌّ عطلًا ما.
POST /webhooks/payments
{ "title": "POST /webhooks/payments", "project": "Checkout API", "duration": "12 ms", "spans": 3, "trace_id": "webhook-8e91", "issue_id": "PAY-1043", "request_id": "req-webhook-8e91", "release": "checkout-api@1.24.0", "environment": "production", "http": { "method": "POST", "route": "/webhooks/payments", "status_code": 400 }, "operations": [ { "span_id": "webhook", "parent_span_id": null, "name": "POST /webhooks/payments", "start_offset_ms": 0, "duration_ms": 12, "status": "error" }, { "span_id": "secret", "parent_span_id": "webhook", "name": "signing_key.load", "start_offset_ms": 0, "duration_ms": 3, "status": "ok" }, { "span_id": "verify", "parent_span_id": "webhook", "name": "signature.verify", "start_offset_ms": 3, "duration_ms": 9, "status": "error", "attributes": { "key_version": "v7", "signature_match": false, "payload_logged": false } } ], "logs": [ { "offset_ms": 0, "severity": "info", "message": "Payment webhook received; provider event evt-9032" }, { "offset_ms": 3, "severity": "info", "message": "Loaded signing key version v7 from runtime configuration" }, { "offset_ms": 12, "severity": "error", "message": "Signature verification failed; returned 400 without updating order state" } ] }
اجعل الأدلة تعمل لصالحك.
اعثر على المشكلات المتكررة
راجع المشكلات المجمّعة وآخر حدوث لها قبل أن تختار ما تحقّق فيه.
قراءة دليل المشكلاتالمشكلات
ابحث في الأعطال وافتح سياق التتبّع.
| خطأ | Checkout API | 3 | ||
| حرج | Checkout API | 18 | ||
| تحذير | Checkout API | 6 | ||
| معلومات | Checkout API | 12 |
اعرف ما حدث قبل العطل
تابع السجلات وBreadcrumbs الملتقطة حول العطل، مع إبقاء سياق الطلب أمامك.
قراءة دليل التحقيقالتتبّعات
افتح طلبًا لترى مساره والإشارات المرتبطة به.
| Checkout API | خطأ | 12 ms | 3 | |
| Checkout API | سليم | 46 ms | 3 | |
| Checkout API | سليم | 8 ms | 2 | |
| Checkout API | خطأ | 2,548 ms | 4 |
حقّق بمساعدة وكيلك
أدخل السياق الملتقط إلى سير عمل البرمجة لديك. راجع الأدلة قبل أن تقرر ما تغيّره.
قراءة دليل الوكلاءPOST /webhooks/payments
{ "title": "POST /webhooks/payments", "project": "Checkout API", "duration": "12 ms", "spans": 3, "trace_id": "webhook-8e91", "issue_id": "PAY-1043", "request_id": "req-webhook-8e91", "release": "checkout-api@1.24.0", "environment": "production", "http": { "method": "POST", "route": "/webhooks/payments", "status_code": 400 }, "operations": [ { "span_id": "webhook", "parent_span_id": null, "name": "POST /webhooks/payments", "start_offset_ms": 0, "duration_ms": 12, "status": "error" }, { "span_id": "secret", "parent_span_id": "webhook", "name": "signing_key.load", "start_offset_ms": 0, "duration_ms": 3, "status": "ok" }, { "span_id": "verify", "parent_span_id": "webhook", "name": "signature.verify", "start_offset_ms": 3, "duration_ms": 9, "status": "error", "attributes": { "key_version": "v7", "signature_match": false, "payload_logged": false } } ], "logs": [ { "offset_ms": 0, "severity": "info", "message": "Payment webhook received; provider event evt-9032" }, { "offset_ms": 3, "severity": "info", "message": "Loaded signing key version v7 from runtime configuration" }, { "offset_ms": 12, "severity": "error", "message": "Signature verification failed; returned 400 without updating order state" } ] }
امنح كل إشارة طريقًا إلى إجابة.
افتح LogBrew وحوّل سؤال الإنتاج التالي إلى تحقيق مركّز.
اعثر على إجابات عن LogBrew في الأسئلة الشائعة
تعرّف على كيفية ربط تطبيقك، والتحقيق في الأخطاء، والعمل مع وكيل البرمجة الخاص بك.
يساعدك LogBrew على التحقيق في أعطال التطبيق عبر المشكلات المجمّعة والسجلات والتتبّعات. افتح مشكلة لتفحص السياق الملتقط لها، أو ابحث في السجلات عن حدث معيّن. تعتمد التفاصيل المتاحة على التكامل الذي تستخدمه وعلى ما يرسله تطبيقك.
تسجّل السجلات أحداثًا فردية، بما فيها النشاط العادي. أما تتبّع الأخطاء فيجمع الأعطال المترابطة في مشكلات، فتراجع مرات حدوثها المتكررة وآخر وقت حدثت فيه. استخدم المشكلة لتختار ما تعالجه، ثم افحص السجلات المرتبطة بها للحصول على السياق.
ابدأ بحدوث ملتقط وافحص بيئته وإصداره ورسالته وتتبّع المكدّس (stack trace) الخاص به. راجع السجلات المرتبطة وأدلة التتبّع عند توفرها. يمكن لهذه السجلات أن تضيّق نطاق التحقيق حتى عندما لا تستطيع إعادة إنتاج الخطأ محليًا، لكنها لا تضمن الوصول إلى السبب الجذري.
عندما يلتقط التكامل Breadcrumbs (الخطوات السابقة) أو سجلات مرتبطة، يمكن أن تعرض تفاصيل المشكلة الأحداث المحيطة بالعطل. ويمكن لتتبّع مرتبط أن يضيف توقيت العمليات. لا يستطيع LogBrew إعادة بناء نشاط لم يلتقطه تطبيقك.
يسجّل السجل حدثًا واحدًا. ويعرض تتبّع المكدّس (stack trace) استدعاءات الدوال المرتبطة بخطأ ما. ويتابع التتبّع الموزّع العمليات المترابطة داخل طلب أو مهمة، وقد يمتد عبر عدة خدمات. ويجيب كل منها عن سؤال مختلف أثناء تصحيح الأخطاء.
استخدم صفحة المشكلات لمراجعة الأعطال المجمّعة وأعداد مرات حدوثها وآخر حدوث لها. ضيّق النتائج حسب المشروع والنطاق الزمني، ثم افحص حدوثًا واحدًا. يساعدك التكرار على ملاحظة نمط ما، لكنه لا يقيس وحده الأثر على المستخدمين.
يمكن ربط الأحداث المترابطة عندما تلتقط التكاملات سياق تتبّع مطابقًا وتنقله. ولا يكفي تطابق الطابع الزمني أو تشابه الرسالة لإثبات أن حدثين ينتميان إلى الطلب نفسه. اتبع تعليمات التتبّع الخاصة بكل تكامل.
يمكن التقاط خطأ دون سياق تتبّع نشط. وقد يكون التتبّع أيضًا غير متاح عند فحصه. راجع حالة الأدلة في تفاصيل المشكلة وإعدادات التتبّع في التكامل. ولا يضيف إصدار أحدث من SDK سياق التتبّع إلى مرات الحدوث القديمة.
نعم. استخدم سياق التحقيق المتاح أو CLI أو أدوات MCP لتعطي وكيلك أدلة محددة النطاق. يشرح دليل الوكلاء سير العمل. تحقّق من البيانات التي تشاركها، وأبقِ بيانات الاعتماد خارج الموجّهات، وراجع التغييرات المقترحة قبل تطبيقها.
يمكنك التحقيق مباشرة في لوحة التحكم. أدوات الوكلاء اختيارية. وينبغي أن يعتمد كلا الأسلوبين على الأدلة الملتقطة وأن يُبقيا السياق الغائب أو المحدود ظاهرًا. لا يضمن LogBrew إصلاحًا تلقائيًا.
أنشئ مشروعًا، واختر التكامل الخاص بلغتك أو إطار العمل الذي تستخدمه، واتبع دليل إعداده. أرسل حدث اختبار آمنًا وتأكد من ظهوره في المشروع المقصود. تختلف الإشارات المدعومة والإعدادات من تكامل إلى آخر.
افحص أولًا المشروع المحدد والنطاق الزمني وعوامل التصفية الأخرى. ثم تحقّق من إعدادات المشروع ومن الإشارة التي يرسلها التكامل. السجلات والمشكلات والتتبّعات تدفقات منفصلة، لذلك لا يعني خلوّ صفحة السجلات أنه لم تصل أي مشكلات.
يمكنك تنظيم بيانات القياس في مشاريع، واستخدام العروض المدعومة لاختيار مشروع واحد أو عدة مشاريع أو كل المشاريع التي يمكنك الوصول إليها. وتحدد الخدمة المكوّن الذي يرسل البيانات داخل المشروع. أبقِ هذه النطاقات واضحة عند مقارنة نشاط الواجهة الأمامية والواجهة الخلفية والعمليات الخلفية.
يستهلك جمع بيانات القياس وإرسالها بعض الموارد. ويعتمد الأثر على SDK والإعدادات وحجم الأحداث. اختبر التكامل تحت حمل عمل يمثّل الواقع، واستخدم أدوات التحكم الموثّقة لذلك SDK. لا تفترض أن الحمل الإضافي معدوم.
لا تضمّن الأسرار أو البيانات الشخصية غير الضرورية في الرسائل أو السمات أو سياق الأخطاء. راجع خيارات الالتقاط والإخفاء في SDK، ثم افحص حدث اختبار آمنًا قبل تفعيل التكامل في بيئة الإنتاج. لا تفترض أن كل حقل يُحذف تلقائيًا.
استخدم صفحة الأسعار لمعرفة الخطط الحالية والحصص المضمّنة. وبعد تسجيل الدخول، راجع صفحتي الحساب والاستخدام لمعرفة المعلومات المعروضة لحسابك. اعتمد على تفاصيل الخطة الحالية بدلًا من افتراض أن الجمع غير محدود.