Fleet Debugger (https://googlemaps.github.io/fleet-debugger/) هي أداة ويب مفتوحة المصدر تتيح لك عرض سجلات Fleet Engine من Cloud Logging. توفّر هذه الأداة خريطة ومخططًا زمنيًا تفاعليًا لتحليل بيانات المركبات والمهام أو الرحلات، وتعمل بالكامل في المتصفّح.
الميزات الرئيسية
تساعدك أداة Fleet Debugger في فهم سلوكيات الرحلات والمركبات المعقّدة من خلال توفير ما يلي:
- خريطة تفاعلية وإعادة تشغيل المخطط الزمني للاطّلاع على الأحداث بالتسلسل
- المزامنة بين الخريطة وجدول البيانات والمخطط الزمني
- فحص إدخالات السجلّ المفصّلة للتعمّق في طلبات واجهة برمجة التطبيقات واستجاباتها
- تصوّر الطرق المخطّط لها وحركة المرور (يتطلّب سجلات الاستخدام المحظور)
- مقارنة بين المواقع الجغرافية المطلوبة والمواقع الجغرافية الفعلية للتوقف (يتطلّب ذلك سجلات الاستخدام المحظور)
تحميل البيانات من Cloud Logging
الطريقة الأساسية لاستخدام Fleet Debugger هي ربطها مباشرةً بخدمة Cloud Logging في مشروعك على Google Cloud. لإجراء ذلك، اتّبِع الخطوات التالية:
- فتح الأداة: انتقِل إلى أداة تصحيح أخطاء الأجهزة.
- اختيار مجموعة البيانات: انقر على زر "اختيار مجموعة البيانات".
- إدخال المَعلمات: أدخِل رقم تعريف مشروعك أو معرّفات المركبات أو معرّفات الرحلات أو المهام، بالإضافة إلى النطاق الزمني المحدّد.
- استرداد السجلات: انقر على "تسجيل الدخول واسترداد السجلات".
- تسجيل الدخول: عليك المصادقة باستخدام حسابك على Google الذي يتضمّن الأذونات المطلوبة للوصول إلى Cloud Logging (مثل
roles/logging.viewer).
طُرق تحميل البيانات الأخرى
على الرغم من أنّ الربط المباشر بخدمة Cloud Logging هو غالبًا الأسهل، يمكنك استخدام طرق مستندة إلى الملفات لعدة أسباب:
- لتحليل السجلات التي قدّمها أحد أعضاء الفريق
- لتحميل مجموعة بيانات تم تصديرها سابقًا لإعادة تحليلها
للعمل مع السجلات عندما لا يكون لديك إذن وصول مباشر إلى مشروع Google Cloud Platform
- استيراد الملفات: يمكنك أيضًا تحميل بيانات السجلّ من ملفات JSON أو ZIP باستخدام الزر "تحميل ملف JSON أو ZIP بدلاً من ذلك". يمكن أن تكون هذه الملفات هي الملفات التي سبق لك تصديرها من Cloud Logging أو من الأداة نفسها.
- التصدير من الأداة: لمشاركة مجموعة بيانات، استخدِم القائمة المنسدلة لمجموعة البيانات واختَر "تصدير". سيؤدي ذلك إلى تنزيل ملف JSON يمكن ضغطه. تتيح الأداة تحميل ملفات ZIP مضغوطة بتنسيق JSON.
وتبقى جميع البيانات محلية في المتصفّح.
سجلات الاستخدام المحدود
لا يلزم تفعيل سجلّات الاستخدام المحظور لكي تعمل أداة Fleet Debugger، ولكن يُنصح بتفعيلها للحصول على التمثيل المرئي الأكثر اكتمالاً. توفّر هذه السجلات سياقًا مفيدًا، بما في ذلك:
- مسار التنقّل المخطّط له من قِبل السائق من خلال حزمة Navigation SDK
- بيانات حركة المرور على طول الطرق
- المواقع الجغرافية الأصلية المحدّدة لاستلام الطلب وتسليمه، بالإضافة إلى المواقع الجغرافية الفعلية
وبدون السجلّات المحظورة، لن تتوفّر هذه التفاصيل المحدّدة في أداة تصحيح الأخطاء.
الموارد
- أداة تصحيح الأخطاء في Fleet
- مستودع GitHub: يمكنك العثور في هذا المستودع على الرمز المصدر والإبلاغ عن المشاكل.
الدعم
يتم تقديم أداة Fleet Debugger بموجب ترخيص مفتوح المصدر. ولا تخضع لإرشادات خدمات الدعم الفني الخاصة بفريق دعم "منصة خرائط Google" أو اتفاقية مستوى الخدمة أو سياسة الإيقاف النهائي. ستبقى خدمات "منصة خرائط Google" الأساسية التي تستخدمها الأداة خاضعة لبنود خدمة "منصة خرائط Google".
- للإبلاغ عن أخطاء أو طلب ميزات، يُرجى الإبلاغ عن مشكلة في GitHub.
- للحصول على إجابات عن الأسئلة الفنية والمشاركة في المناقشات، يمكنك استخدام قنوات منتدى المطوّرين في "منصة خرائط Google".
- للمساهمة في المشروع، يُرجى الاطّلاع على أدلة المساهمة في المستودع.