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 का व्यूअर
  • संपादक
  • मालिक

इन भूमिकाओं में, आईएएम की ये अनुमतियां शामिल होती हैं. ये अनुमतियां, 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 डिफ़ॉल्ट रूप से यह मेट्रिक दिखाता है.

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

इंडेक्स के पासकोड का स्कैन

किसी सेल में Index Write Ops/s मेट्रिक से, पासकोड की संबंधित 10 सेकंड की समयावधि और रेंज के दौरान, हर सेकंड में इंडेक्स में किए गए औसत बदलावों की संख्या का पता चलता है.

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