Key Visualizer का इस्तेमाल शुरू करना

इस पेज पर, Key Visualizer का इस्तेमाल करके, Cloud Firestore के इस्तेमाल के पैटर्न से जुड़ी परफ़ॉर्मेंस की समस्याओं का पता लगाने का तरीका बताया गया है.

शुरू करने से पहले

Cloud Firestore के लिए Key Visualizer का इस्तेमाल करने के लिए, आपको Firestore Key Visualizer API को चालू करना होगा.

एपीआई चालू करने के लिए ज़रूरी भूमिकाएं

एपीआई चालू करने के लिए, आपके पास serviceusage.services.enable अनुमति होनी चाहिए. अगर आपने प्रोजेक्ट बनाया है, तो हो सकता है कि आपके पास मालिक की भूमिका (roles/owner) के ज़रिए यह अनुमति पहले से हो. इसके अलावा, सेवा के इस्तेमाल से जुड़ी एडमिन की भूमिका (roles/serviceusage.serviceUsageAdmin) के ज़रिए भी यह अनुमति मिल सकती है. भूमिकाएं देने का तरीका जानें.

एपीआई को चालू करना

ज़रूरी भूमिकाएं

पक्का करें कि आपके खाते को इनमें से कोई एक आईएएम भूमिका दी गई हो:

  • Cloud Datastore का मालिक
  • Cloud Datastore Key Visualizer Viewer
  • संपादक
  • मालिक

इन भूमिकाओं में, IAM की ये अनुमतियां शामिल हैं. Key Visualizer को ऐक्सेस करने के लिए, ये अनुमतियां ज़रूरी हैं:

  • datastore.keyVisualizerScans.get
  • datastore.keyVisualizerScans.list
  • datastore.databases.getMetadata
  • resourcemanager.projects.get

ज़रूरी अनुमतियों के साथ, कस्टम भूमिका भी तय की जा सकती है.

किसी समयावधि के लिए स्कैन देखना

Key Visualizer का हर स्कैन, दो घंटे की अवधि को कवर करता है. किसी तय अवधि के लिए स्कैन की सुविधा, उन डेटाबेस के लिए उपलब्ध है जिनमें उस अवधि के दौरान किसी भी मिनट में, दस्तावेज़ से जुड़े 3,000 से ज़्यादा ऑपरेशन किए गए हों.

Key Visualizer को लॉन्च करने के लिए:

  1. Google Cloud console में, डेटाबेस पेज पर जाएं.

    डेटाबेस पर जाएं

  2. डेटाबेस की सूची से वह डेटाबेस चुनें जिसकी आपको ज़रूरत है.

  3. नेविगेशन मेन्यू में, Key Visualizer पर क्लिक करें.

  4. उपलब्ध Key Visualizer स्कैन में से कोई समयावधि और मेट्रिक चुनें:

    1. सबसे ऊपर दाईं ओर मौजूद, पेंसिल आइकॉन पर क्लिक करें. कोई तारीख और समय चुनें.

      स्कैन करने की सुविधा, स्कैन करने की ज़रूरी शर्तें पूरी करने पर उपलब्ध होती है. आपके पास ऐसी समयावधि चुनने का विकल्प नहीं है जो स्कैन की ज़रूरी शर्तें पूरी नहीं करती या जो अब भी प्रोसेस हो रही है. दिन के दो सबसे हाल के स्कैन को प्रोसेस होने में कुछ समय लगेगा. इसके बाद ही, वे उपलब्ध होंगे.

    2. सोर्स के तौर पर, दस्तावेज़ का पूरा डेटा या इंडेक्स का पूरा डेटा चुनें.

    3. अपडेट करें पर क्लिक करें.

  5. विश्लेषण करने के लिए कोई मेट्रिक चुनें:

    सबसे ऊपर बाईं ओर मौजूद मेट्रिक ड्रॉपडाउन पर क्लिक करें और देखने के लिए कोई मेट्रिक चुनें. डिफ़ॉल्ट रूप से, Key Visualizer, दस्तावेज़ की कुंजियों के लिए Ops/s मेट्रिक और इंडेक्स कुंजियों के लिए Index Write Ops/s मेट्रिक में खुलता है.

मेट्रिक की तुलना करने या डेटा के बीच संबंध देखने के लिए, Key Visualizer की कई मेट्रिक को एक साथ दिखाया जा सकता है. अलग-अलग मेट्रिक के बीच कनेक्शन ढूंढना देखें.

गतिविधि की खास जानकारी देखना

चुनी गई दो घंटे की समयावधि के दौरान हुई गतिविधि की खास जानकारी पाने के लिए, डिफ़ॉल्ट मेट्रिक के लिए हीटमैप देखें.

यहां दिए गए उदाहरण में एक हीटमैप दिखाया गया है. इसमें अलग-अलग की रेंज के इस्तेमाल के पैटर्न में काफ़ी अंतर है:

  • गहरे रंगों में दिखाई गई रेंज में, गतिविधि कम या बिलकुल नहीं होती.
  • चमकीले रंगों वाली रेंज में, गतिविधि काफ़ी ज़्यादा होती है.
  • बीच में मौजूद सफ़ेद रंग की चमकती हुई रेंज में, बहुत ज़्यादा गतिविधि होती है.

Key Visualizer स्कैन का उदाहरण

दस्तावेज़ में मौजूद बटन स्कैन करना

Ops/s मेट्रिक, हर की रेंज के लिए हर सेकंड किए गए अनुरोधों की संख्या को मेज़र करती है. यह मेट्रिक, राइट, लुकअप, और क्वेरी के अनुरोधों का कुल योग है. हीटमैप खोलने पर, Key Visualizer डिफ़ॉल्ट रूप से यह मेट्रिक दिखाता है.

अपने डेटाबेस में होने वाली सभी गतिविधियों के बारे में जानने के बाद, अन्य मेट्रिक देखकर अपनी जांच जारी रखी जा सकती है. साथ ही, उन मुख्य रेंज पर फ़ोकस किया जा सकता है जिनकी वजह से समस्याएं हो सकती हैं. ज़्यादा जानें.

इंडेक्स कुंजियों को स्कैन करना

किसी सेल में इंडेक्स राइट ऑप्स/सेकंड मेट्रिक, 10 सेकंड के समयांतर और कुंजी की रेंज में, हर सेकंड होने वाले औसत इंडेक्स राइट को मेज़र करती है.

आगे क्या करना है