أداة Fleet Debugger (https://googlemaps.github.io/fleet-debugger/) هي أداة ويب مفتوحة المصدر تتيح لك عرض سجلّات Fleet Engine من Cloud Logging. وتوفّر خريطة تفاعلية ومخططًا زمنيًا لتحليل بيانات المركبات والمهام أو الرحلات، وتعمل بالكامل في متصفّحك.
الميزات الأساسية
تساعدك أداة Fleet Debugger في فهم سلوكيات الرحلات والمركبات المعقّدة من خلال توفير ما يلي:
- خريطة تفاعلية وإعادة تشغيل المخطط الزمني للاطّلاع على الأحداث بالتسلسل
- المزامنة بين الخريطة وجدول البيانات والمخطط الزمني
- فحص تفصيلي لإدخالات السجلّات للتعمّق في طلبات واجهة برمجة التطبيقات واستجاباتها
- عرض الطرق المخطط لها وحركة المرور (يتطلّب ذلك سجلّات الاستخدام المقيّد)
- مقارنة مواقع التوقف المطلوبة بمواقع التوقف الفعلية (يتطلّب ذلك سجلّات الاستخدام المقيّد)
تحميل البيانات من Cloud Logging
الطريقة الأساسية لاستخدام أداة Fleet Debugger هي ربطها مباشرةً بخدمة Cloud Logging في مشروع Google Cloud. لإجراء ذلك، اتّبِع الخطوات التالية:
- افتح الأداة: انتقِل إلى أداة Fleet Debugger.
- اختَر مجموعة البيانات: انقر على أحد أزرار "اختيار مجموعة البيانات".
- أدخِل المَعلمات: أدخِل رقم تعريف مشروعك أو أرقام تعريف مركباتك أو أرقام تعريف رحلاتك أو مهامك والنطاق الزمني الذي اخترته.
- استرداد السجلّات: انقر على "تسجيل الدخول واسترداد السجلّات".
- تسجيل الدخول: عليك إثبات هويتك باستخدام حساب 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 Debugger**
- مستودع GitHub: في هذا المستودع، يمكنك العثور على رمز المصدر والإبلاغ عن المشاكل.
الدعم
يتم توفير أداة Fleet Debugger بموجب ترخيص مفتوح المصدر. ولا تخضع لإرشادات خدمات الدعم الفني في "منصة خرائط Google" أو اتفاقية مستوى الخدمةأو سياسة الإيقاف النهائي. تظلّ خدمات "منصة خرائط Google" الأساسية التي تستخدمها الأداة خاضعة لبنود خدمة "منصة خرائط Google".
- للإبلاغ عن الأخطاء أو طلب الميزات، يمكنك ملء مشكلة على GitHub.
- للحصول على إجابات عن الأسئلة الفنية والمشاركة في المناقشات، استخدِم قنوات منتدى المطوّرين في "منصة خرائط Google".
- للمساهمة في المشروع، اطّلِع على أدلة المساهمة في الـ مستودع.