הכלי Fleet Debugger (https://googlemaps.github.io/fleet-debugger/) הוא כלי אינטרנטי בקוד פתוח שמאפשר לכם להציג באופן חזותי את היומנים של Fleet Engine מ-Cloud Logging. הוא כולל מפה אינטראקטיבית וציר זמן לניתוח נתונים של כלי רכב, משימות או נתוני הנסיעה, והוא פועל כולו בדפדפן.
תכונות עיקריות
הכלי Fleet Debugger עוזר לכם להבין התנהגויות מורכבות של נסיעות וכלי רכב באמצעות:
- הפעלה חוזרת של ציר הזמן ומפה אינטראקטיבית כדי לראות את האירועים ברצף.
- סנכרון בין המפה, טבלת נתונים וציר זמן.
- בדיקה מפורטת של רשומות ביומן כדי להתעמק בבקשות ובתגובות של API.
- הדמיה של מסלולים מתוכננים ותנועה (נדרשים יומני שימוש מוגבל).
- השוואה בין מיקומי העצירה המבוקשים לבין מיקומי העצירה בפועל (נדרש יומני שימוש מוגבל).

טעינת נתונים מ-Cloud Logging
הדרך העיקרית להשתמש ב-Fleet Debugger היא לחבר אותו ישירות ל-Cloud Logging של פרויקט Google Cloud. כדי לעשות את זה, פועלים לפי השלבים הבאים:
- פותחים את הכלי: עוברים אל Fleet debugger.
- בחירת קבוצת נתונים: לוחצים על הלחצן 'בחירת קבוצת נתונים'.
- הזנת פרמטרים: מזינים את מזהה הפרויקט, מזהי הרכבים או מזהי הנסיעות או המשימות, ואת טווח הזמן שנבחר.
- אחזור יומנים: לוחצים על 'כניסה ואחזור יומנים'.
- כניסה: מתבצע אימות באמצעות חשבון Google שיש לו את ההרשאות הנדרשות לגישה אל Cloud Logging (לדוגמה,
roles/logging.viewer).
שיטות אחרות לטעינת נתונים
לרוב, הכי קל להתחבר ישירות ל-Cloud Logging, אבל יכולות להיות כמה סיבות לשימוש בשיטות שמבוססות על קבצים:
- לנתח יומנים שסופקו על ידי חבר צוות.
- כדי לטעון מערך נתונים שיוצא בעבר לצורך ניתוח מחדש.
כדי לעבוד עם יומנים כשאין לכם גישה ישירה לפרויקט GCP.
- ייבוא קובץ: אפשר גם לטעון נתוני יומן מקובצי JSON או ZIP באמצעות הלחצן 'טעינת קובץ JSON או ZIP במקום זאת'. אלה יכולים להיות קבצים שייצאתם בעבר מ-Cloud Logging או מהכלי עצמו.
- ייצוא מהכלי: כדי לשתף מערך נתונים, משתמשים בתפריט הנפתח של מערך הנתונים ובוחרים באפשרות 'ייצוא'. קובץ JSON יורד למחשב, ואפשר לדחוס אותו. הכלי תומך בטעינה של קובצי ZIP דחוסים בפורמט JSON.
כל הנתונים נשארים מקומיים בדפדפן.
יומנים של שימוש מוגבל
הפעלת יומני שימוש מוגבל לא נדרשת כדי להשתמש בכלי Fleet Debugger, אבל מומלץ להפעיל אותם כדי לקבל את ההדמיה המלאה ביותר. היומנים האלה מספקים הקשר חשוב, כולל:
- מסלול הניווט המתוכנן של הנהג מ-Navigation SDK.
- נתוני תנועה לאורך המסלולים.
- מיקומי האיסוף וההורדה המקוריים שצוינו בבקשה, בנוסף למיקומים בפועל.
בלי יומנים מוגבלים, הפרטים הספציפיים האלה לא יהיו זמינים בכלי לניפוי באגים.
משאבים
- Fleet debugger
- מאגר GitHub: במאגר הזה אפשר למצוא קוד מקור ולדווח על בעיות.
תמיכה
כלי Fleet Debugger מוצע במסגרת רישיון קוד פתוח. הוא לא כפוף להנחיות לשירותי תמיכה טכנית, להסכם רמת השירות (SLA) או למדיניות הוצאה משימוש של Google Maps Platform. שירותי Google Maps Platform שמשמשים את הכלי עדיין כפופים לתנאים ולהגבלות של Google Maps Platform.
- כדי לדווח על באגים או לבקש תכונות, אפשר לפתוח בעיה ב-GitHub.
- לשאלות טכניות ולדיונים, אפשר להשתמש בערוצי הקהילה של מפתחים ב-Google Maps Platform.
- כדי לתרום לפרויקט, אפשר לעיין במדריכים לתורמים במאגר.