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 يمكن ضغطه. تتيح الأداة تحميل ملفات JSON zip المضغوطة.
تبقى جميع البيانات محلية في متصفّحك.
سجلات الاستخدام المحدود
لا يلزم تفعيل سجلّات الاستخدام المقيّد لكي تعمل أداة Fleet Debugger، ولكن يُنصح بتفعيلها للحصول على عرض مرئي أكثر اكتمالاً. توفّر هذه السجلات سياقًا مفيدًا، بما في ذلك:
- مسار التنقّل المخطّط له من قِبل السائق من خلال حزمة Navigation SDK
- بيانات حركة المرور على طول الطرق
- المواقع الجغرافية الأصلية المطلوبة للاستلام والتسليم، بالإضافة إلى المواقع الجغرافية الفعلية
بدون السجلّات المحظورة، لن تكون هذه التفاصيل المحدّدة متاحة في أداة تصحيح الأخطاء.
الموارد
- أداة تصحيح الأخطاء في الأجهزة الافتراضية
- مستودع GitHub: يمكنك العثور في هذا المستودع على الرمز المصدر والإبلاغ عن المشاكل.
الدعم
يتم تقديم أداة Fleet Debugger هذه بموجب ترخيص البرامج المفتوحة المصدر. ولا تخضع هذه الخدمات لإرشادات خدمات الدعم الفني الخاصة بفريق دعم "منصة خرائط Google" أو اتفاقية مستوى الخدمة أو سياسة الإيقاف النهائي. ستبقى خدمات "منصة خرائط Google" الأساسية التي تستخدمها الأداة خاضعة لبنود خدمة "منصة خرائط Google".
- للإبلاغ عن أخطاء أو طلب ميزات، يمكنك الإبلاغ عن مشكلة على GitHub.
- للحصول على إجابات عن الأسئلة الفنية والمشاركة في المناقشات، يمكنك استخدام قنوات منتدى المطوّرين في "منصة خرائط Google".
- للمساهمة في المشروع، راجِع أدلة المساهمة في المستودع.