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

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

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

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

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

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

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

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

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

  • 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 ऑपरेशन/सेकंड मेट्रिक में खुलता है. साथ ही, इंडेक्स कुंजियों के लिए, इंडेक्स राइट ऑपरेशन/सेकंड मेट्रिक में खुलता है.

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

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

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

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

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

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

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

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

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

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

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

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