تمثيل السجلات بصريًا باستخدام Fleet Debugger

‫Fleet Debugger (https://googlemaps.github.io/fleet-debugger/) هي أداة ويب مفتوحة المصدر تتيح لك عرض سجلات Fleet Engine من Cloud Logging. توفّر هذه الأداة خريطة ومخططًا زمنيًا تفاعليًا لتحليل بيانات المركبات والمهام أو الرحلات، وتعمل بالكامل في المتصفّح.

الميزات الرئيسية

تساعدك أداة Fleet Debugger في فهم سلوكيات الرحلات والمركبات المعقّدة من خلال توفير ما يلي:

  • خريطة تفاعلية وإعادة تشغيل المخطط الزمني للاطّلاع على الأحداث بالتسلسل
  • المزامنة بين الخريطة وجدول البيانات والمخطط الزمني
  • فحص إدخالات السجلّ المفصّلة للتعمّق في طلبات واجهة برمجة التطبيقات واستجاباتها
  • تصوّر الطرق المخطّط لها وحركة المرور (يتطلّب سجلات الاستخدام المحظور)
  • مقارنة بين المواقع الجغرافية المطلوبة والمواقع الجغرافية الفعلية للتوقف (يتطلّب ذلك سجلات الاستخدام المحظور)

واجهة Fleet Debugger تعرض خريطة وإدخالات سجلّ

تحميل البيانات من Cloud Logging

الطريقة الأساسية لاستخدام Fleet Debugger هي ربطها مباشرةً بخدمة Cloud Logging في مشروعك على Google Cloud. لإجراء ذلك، اتّبِع الخطوات التالية:

  1. فتح الأداة: انتقِل إلى أداة تصحيح أخطاء الأسطول.
  2. اختيار مجموعة البيانات: انقر على زر "اختيار مجموعة البيانات".
  3. إدخال المَعلمات: أدخِل رقم تعريف مشروعك أو معرّفات المركبات أو معرّفات الرحلات أو المهام، بالإضافة إلى النطاق الزمني المحدّد.
  4. استرداد السجلّات: انقر على "تسجيل الدخول واسترداد السجلّات".
  5. تسجيل الدخول: عليك إثبات ملكية حسابك على Google الذي لديه الأذونات المطلوبة للوصول إلى Cloud Logging (مثل roles/logging.viewer).

ملاحظة: تتوافق ميزة الاستيراد المباشر من Cloud Logging بشكل كامل مع On-demand trips. التوافق مع Scheduled tasks محدود (مشكلة في التتبُّع).

طُرق أخرى لتحميل البيانات

على الرغم من أنّ الربط المباشر بخدمة Cloud Logging هو غالبًا الأسهل، يمكنك استخدام طرق مستندة إلى الملفات لعدة أسباب:

  • لتحليل السجلات التي يقدّمها أحد أعضاء الفريق
  • لتحميل مجموعة بيانات تم تصديرها سابقًا لإعادة تحليلها

  • للعمل مع السجلات عندما لا يكون لديك إذن وصول مباشر إلى مشروع Google Cloud Platform

    • استيراد الملفات: يمكنك أيضًا تحميل بيانات السجلّ من ملفات JSON أو ZIP باستخدام الزر "تحميل ملف JSON أو ZIP بدلاً من ذلك". يمكن أن تكون هذه الملفات هي الملفات التي سبق لك تصديرها من Cloud Logging أو من الأداة نفسها.
    • التصدير من الأداة: لمشاركة مجموعة بيانات، استخدِم القائمة المنسدلة لمجموعة البيانات واختَر "تصدير". سيؤدي ذلك إلى تنزيل ملف JSON يمكن ضغطه. تتيح الأداة تحميل ملفات ZIP مضغوطة بتنسيق JSON.

تبقى جميع البيانات محلية في متصفّحك.

سجلات الاستخدام المحدود

لا يلزم تفعيل سجلات الاستخدام المحدود لكي تعمل أداة Fleet Debugger، ولكن يُنصح بتفعيلها للحصول على التمثيل البصري الأكثر اكتمالاً. توفّر هذه السجلات سياقًا مفيدًا، بما في ذلك:

  • مسار التنقّل المخطّط له من قِبل السائق من خلال حزمة Navigation SDK
  • بيانات حركة المرور على طول الطرق
  • المواقع الجغرافية الأصلية المطلوبة لاستلام الطلب وتسليمه، بالإضافة إلى المواقع الجغرافية الفعلية

وبدون السجلّات المقيدة، لن تتوفّر هذه التفاصيل المحدّدة في أداة تصحيح الأخطاء.

الموارد

الدعم

يتم توفير أداة Fleet Debugger بموجب ترخيص مفتوح المصدر. ولا تخضع هذه الخدمات لإرشادات خدمات الدعم الفني الخاصة بـ "منصة خرائط Google" أو اتفاقية مستوى الخدمة أو سياسة الإيقاف النهائي. تظل خدمات "منصة خرائط Google" الأساسية التي تستخدمها الأداة خاضعة لبنود خدمة "منصة خرائط Google".