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

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

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

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

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

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

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

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

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

  • Cloud Datastore के मालिक
  • Cloud Datastore Key Visualizer व्यूअर
  • संपादक
  • मालिक

इन भूमिकाओं में, 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. नेविगेशन मेन्यू में, की विज़ुअलाइज़र पर क्लिक करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

दस्तावेज़ की कुंजियों को स्कैन करना

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

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

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

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

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