הכלי 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 נתמכת באופן מלא ב-On-demand trips. התמיכה ב-Scheduled tasks מוגבלת
(בעיה במעקב).
שיטות אחרות לטעינת נתונים
לרוב, הכי קל להתחבר ישירות ל-Cloud Logging, אבל יכולות להיות כמה סיבות לשימוש בשיטות שמבוססות על קבצים:
- לנתח יומנים שסופקו על ידי חבר צוות.
- כדי לטעון מערך נתונים שיוצא בעבר לצורך ניתוח מחדש.
כדי לעבוד עם יומנים כשאין לכם גישה ישירה לפרויקט GCP.
- ייבוא קובץ: אפשר גם לטעון נתוני יומן מקובצי JSON או ZIP באמצעות הלחצן 'טעינת קובץ JSON או ZIP במקום זאת'. אלה יכולים להיות קבצים שייצאתם בעבר מ-Cloud Logging או מהכלי עצמו.
- ייצוא מהכלי: כדי לשתף מערך נתונים, משתמשים בתפריט הנפתח של מערך הנתונים ובוחרים באפשרות 'ייצוא'. קובץ JSON יורד למחשב, ואפשר לדחוס אותו. הכלי תומך בטעינה של קובצי ZIP דחוסים בפורמט JSON.
כל הנתונים נשארים מקומיים בדפדפן.
יומנים של שימוש מוגבל
הפעלת יומני שימוש מוגבל לא נדרשת כדי שהכלי Fleet Debugger יפעל, אבל מומלץ להפעיל אותם כדי לקבל את ההדמיה המלאה ביותר. היומנים האלה מספקים הקשר חשוב, כולל:
- מסלול הניווט המתוכנן של הנהג מ-Navigation SDK.
- נתוני תנועה לאורך המסלולים.
- מיקומי האיסוף וההחזרה המקוריים שצוינו בבקשה, בנוסף למיקומים בפועל.
בלי יומנים מוגבלים, הפרטים הספציפיים האלה לא יהיו זמינים בכלי לניפוי באגים.
משאבים
- Fleet debugger
- מאגר GitHub: במאגר הזה אפשר למצוא קוד מקור ולדווח על בעיות.
תמיכה
כלי Fleet Debugger מוצע במסגרת רישיון קוד פתוח. הוא לא כפוף להנחיות לשירותי תמיכה טכנית של פלטפורמת מפות Google, להסכם רמת השירות (SLA) או למדיניות הוצאה משימוש. שירותי הפלטפורמה של מפות Google שמשמשים את הכלי עדיין כפופים לתנאים ולהגבלות של הפלטפורמה של מפות Google.
- כדי לדווח על באגים או לבקש תכונות, אפשר לפתוח פנייה ב-GitHub.
- לשאלות טכניות ולדיונים, אפשר להשתמש בערוצי הקהילה של מפתחים בפלטפורמה של מפות Google.
- כדי לתרום לפרויקט, אפשר לעיין במדריכים לתורמים במאגר.