Fleet Debugger की मदद से लॉग विज़ुअलाइज़ करना

फ़्लीट डिबगर (https://googlemaps.github.io/fleet-debugger/) एक ओपन-सोर्स वेब टूल है. इसकी मदद से, Cloud Logging से Fleet Engine के लॉग देखे जा सकते हैं. यह एक इंटरैक्टिव मैप और टाइमलाइन उपलब्ध कराता है. इससे वाहन, टास्क या यात्रा के डेटा का विश्लेषण किया जा सकता है. यह पूरी तरह से आपके ब्राउज़र में चलता है.

मुख्य सुविधाएं

फ़्लीट डिबगर की मदद से, यात्रा और वाहन के व्यवहार को बेहतर तरीके से समझा जा सकता है. इसके लिए, यह टूल ये सुविधाएं देता है:

  • इवेंट को क्रम से देखने के लिए, इंटरैक्टिव मैप और टाइमलाइन रीप्ले की सुविधा.
  • मैप, डेटा टेबल, और टाइमलाइन के बीच सिंक करने की सुविधा.
  • एपीआई अनुरोधों और जवाबों के बारे में ज़्यादा जानने के लिए, लॉग एंट्री की बारीकी से जांच करने की सुविधा.
  • प्लान किए गए रास्तों और ट्रैफ़िक का विज़ुअलाइज़ेशन (इसके लिए, इस्तेमाल पर पाबंदी वाले लॉग की ज़रूरत होती है).
  • अनुरोध की गई स्टॉप लोकेशन की तुलना, असल स्टॉप लोकेशन से करना. इसके लिए, डेटा के इस्तेमाल पर पाबंदी से जुड़े लॉग ज़रूरी हैं.

मैप और लॉग एंट्री दिखाने वाला Fleet Debugger इंटरफ़ेस

Cloud Logging से डेटा लोड करना

Fleet Debugger का इस्तेमाल करने का मुख्य तरीका यह है कि इसे सीधे तौर पर अपने Google Cloud प्रोजेक्ट की Cloud Logging से कनेक्ट करें. इसके लिए, यह तरीका अपनाएं:

  1. टूल खोलें: फ़्लीट डिबगर पर जाएं.
  2. डेटासेट चुनें: "डेटासेट चुनें" बटन पर क्लिक करें.
  3. पैरामीटर डालें: अपना प्रोजेक्ट आईडी, वाहन का आईडी या आईडी, और चुनी गई समयावधि डालें.
  4. लॉग फ़ेच करें: "साइन इन करें और लॉग फ़ेच करें" पर क्लिक करें.
  5. साइन इन करें: उस Google खाते से पुष्टि करें जिसके पास Cloud Logging को ऐक्सेस करने के लिए ज़रूरी अनुमतियां हैं. उदाहरण के लिए, roles/logging.viewer.

डेटा लोड करने के अन्य तरीके

Cloud Logging से सीधे कनेक्ट करना अक्सर सबसे आसान होता है. हालांकि, फ़ाइल पर आधारित तरीकों का इस्तेमाल कई वजहों से किया जा सकता है:

  • टीम के किसी सदस्य से मिले लॉग का विश्लेषण करने के लिए.
  • पहले एक्सपोर्ट किए गए डेटासेट को फिर से विश्लेषण करने के लिए लोड करें.
  • जब आपके पास GCP प्रोजेक्ट का सीधे तौर पर ऐक्सेस न हो, तब लॉग के साथ काम करने के लिए.

    • फ़ाइल इंपोर्ट करना: "इसके बजाय JSON या ZIP फ़ाइल लोड करें" बटन का इस्तेमाल करके, JSON या ZIP फ़ाइलों से भी लॉग डेटा लोड किया जा सकता है. ये फ़ाइलें, Cloud Logging या टूल से पहले एक्सपोर्ट की गई फ़ाइलें हो सकती हैं.
    • टूल से एक्सपोर्ट करना: किसी डेटासेट को शेयर करने के लिए, डेटासेट ड्रॉप-डाउन मेन्यू का इस्तेमाल करें. इसके बाद, "एक्सपोर्ट करें" को चुनें. इससे एक JSON फ़ाइल डाउनलोड होती है, जिसे कंप्रेस किया जा सकता है. यह टूल, कंप्रेस की गई JSON ज़िप फ़ाइलों को लोड करने की सुविधा देता है.

सारा डेटा, आपके ब्राउज़र में ही सेव रहता है.

इस्तेमाल पर पाबंदी वाले लॉग

फ़्लीट डिबगर के काम करने के लिए, डेटा के सीमित इस्तेमाल के लॉग चालू करना ज़रूरी नहीं है. हालांकि, सबसे ज़्यादा विज़ुअलाइज़ेशन के लिए, ऐसा करने का सुझाव दिया जाता है. इन लॉग से आपको अहम जानकारी मिलती है. जैसे:

  • Navigation SDK से ड्राइवर के लिए प्लान किया गया नेविगेशन रूट.
  • रास्तों पर ट्रैफ़िक की जानकारी.
  • पिकअप और ड्रॉपऑफ़ की उन जगहों की जानकारी जिनके लिए अनुरोध किया गया था. साथ ही, पिकअप और ड्रॉपऑफ़ की मौजूदा जगहों की जानकारी.

पाबंदी वाले लॉग के बिना, ये खास जानकारी डीबगर में उपलब्ध नहीं होगी.

संसाधन

  • Fleet debugger
  • GitHub रिपॉज़िटरी: इस रिपॉज़िटरी में आपको सोर्स कोड मिलेगा. साथ ही, यहां समस्याओं की शिकायत की जा सकती है.

सहायता

यह फ्लीट डिबगर टूल, ओपन सोर्स लाइसेंस के तहत उपलब्ध कराया जाता है. यह Google Maps Platform की सहायता टीम के तकनीकी सहायता सेवाओं के दिशा-निर्देशों, एसएलए या बंद होने की नीति के तहत नहीं आता. इस टूल में इस्तेमाल की गई Google Maps Platform की सेवाएं, Google Maps Platform की सेवा की शर्तों के मुताबिक काम करती हैं.

  • गड़बड़ियों की शिकायत करने या सुविधाओं का अनुरोध करने के लिए, GitHub पर कोई समस्या दर्ज करें.
  • तकनीकी सवालों और चर्चाओं के लिए, Google Maps Platform डेवलपर कम्यूनिटी चैनलों का इस्तेमाल करें.
  • प्रोजेक्ट में योगदान देने के लिए, रिपॉज़िटरी में योगदान देने से जुड़ी गाइड देखें.