কোয়েরি পারফর্ম্যান্স পরিসংখ্যান বিশ্লেষণ করা

কোয়েরি পারফর্ম্যান্স শনাক্ত ও বিশ্লেষণ করতে কীভাবে কোয়েরি ইনসাইট ড্যাশবোর্ড ব্যবহার করতে হয় তা এই পৃষ্ঠায় বর্ণনা করা হয়েছে।

কোয়েরি ইনসাইট ওভারভিউ

মেট্রিক-সম্পর্কিত কোয়েরি মনিটর করতে কোয়েরি ইনসাইট ড্যাশবোর্ড ব্যবহার করুন। মেট্রিকের উপর ভিত্তি করে, আপনি সবচেয়ে বেশি ব্যবহৃত কোয়েরি এবং উচ্চ লেটেন্সি সহ কোয়েরি শনাক্ত করতে পারেন যেগুলি অপ্টিমাইজ করার প্রয়োজন হতে পারে। কোয়েরি ইনসাইট ড্যাশবোর্ড ব্যবহার করে আপনি এইসব সুবিধা পাবেন:

  • কোয়েরি পারফর্ম্যান্স অপ্টিমাইজেশন: বেশি লেটেন্সি সহ কোয়েরি শনাক্ত করুন এবং যেগুলি অপ্টিমাইজ করার প্রয়োজন হতে পারে।
  • কোয়েরি সংক্রান্ত খরচ ম্যানেজ করা: বেশি খরচ হয় এমন কোয়েরি খুঁজে বের করুন এবং খরচ কমাতে সেগুলি অপ্টিমাইজ করুন।
  • কোয়েরি স্ট্যাটস মনিটর করা: সময়ের সাথে সাথে কোয়েরি স্ট্যাটস ট্র্যাক করা।
  • ইনডেক্স সাজেশন: বাদ পড়ে যাওয়া বা সাব-অপ্টিমাল কম্পোজিট ইনডেক্স শনাক্ত করুন এবং ড্যাশবোর্ড থেকে সরাসরি সাজেস্ট করা ইনডেক্স তৈরি করুন (Enterprise সংস্করণ)।

ইনসাইট ডেটা কোয়েরি করা

কোয়েরি ইনসাইটে নিম্নলিখিত API পদ্ধতি থেকে পাওয়া ডেটা অন্তর্ভুক্ত থাকে:

  • find
  • aggregate

আপনি কোনও নির্দিষ্ট প্রোজেক্ট, ডেটাবেস এবং ১০ মিনিট থেকে ৩০ দিন পর্যন্ত সময়সীমার মধ্যে এইসব পদ্ধতি ব্যবহার করে করা কোয়েরি সম্পর্কিত ডেটা দেখতে পারবেন। একই ধরনের স্ট্রাকচার সহ কোয়েরির ডেটা একটি নরমালাইজড কোয়েরির অধীনে ক্যাপচার করা হয়।

কোয়েরি ইনসাইট কোনও কোয়েরি সম্পর্কে নিম্নলিখিত তথ্য প্রদান করে:

নর্মালাইজ করা কোয়েরি টেক্সট টেক্সটে দেখানো কোয়েরি স্ট্রাকচার।
এক্সিকিউশনের সংখ্যা বেছে নেওয়া সময়সীমার মধ্যে কতবার এক্সিকিউট করা হয়েছে।
সমস্যার সংখ্যা বেছে নেওয়া সময়সীমার মধ্যে হওয়া সমস্যার সংখ্যা।
গড় এক্সিকিউশন সময়সীমা(মিলিসেকেন্ড) কোয়েরি প্রসেস করতে ডেটাবেসের মিলিসেকেন্ডে যে গড় সময় লেগেছে।
ফিরে আসা ফলাফলের গড় সংখ্যা কোয়েরি থেকে পাওয়া ফলাফলের সংখ্যা। ফলাফলে ডকুমেন্ট, সংগ্রহের আইডি ও অ্যাগ্রিগেট করা বাকেট অন্তর্ভুক্ত থাকে।
স্ক্যান করা ডকুমেন্টের গড় সংখ্যা একটি কোয়েরিতে স্ক্যান করা ডকুমেন্টের সংখ্যা।
স্ক্যান করা ইনডেক্স এন্ট্রির গড় সংখ্যা কোয়েরি কার্যকর করার জন্য পরীক্ষা করা ইনডেক্স এন্ট্রির সংখ্যা।
গড় সময় অনুযায়ী লোড করুন গড় লেটেন্সির উপর ভিত্তি করে সেরা কোয়েরি ফিল্টার করতে সাহায্য করার জন্য ডেটা।
মোট (বিলযোগ্য) রিড অপারেশন অনুযায়ী লোড করুন মোট বিলযোগ্য রিড অপারেশনের উপর ভিত্তি করে সেরা কোয়েরি ফিল্টার করতে সাহায্য করার জন্য ডেটা।
ইনডেক্স সংক্রান্ত সাজেশন Enterprise এডিশন ডেটাবেসে কোয়েরির জন্য সাজেস্ট করা কম্পোজিট ইনডেক্স, ব্যবহৃত ইনডেক্স এবং আনুমানিক ওয়ার্কলোড ইমপ্যাক্ট।

ডেটা গ্র্যানুলারিটি ও রিটেনশন

ডেটার গ্র্যানুলারিটি নির্ভর করে নির্দিষ্ট করা সময়সীমার উপর:

  • ৪ দিন আগে পর্যন্ত ইন্টারভ্যালের জন্য ১০ মিনিটের গ্রানুলারিটি
  • ৩০ দিন আগে পর্যন্ত সময়ের ব্যবধানের জন্য ১ ঘণ্টার গ্র্যানুলারিটি

কোয়েরি ইনসাইটের জন্য ডেটার রেকর্ড রাখার সর্বাধিক সময়সীমা হল ৩০ দিন। ১০-মিনিটের ডেটা ৪ দিনের জন্য এবং প্রতি ঘণ্টার ডেটা ৩০ দিনের জন্য স্টোর করা হয়।

কোয়েরি ইনসাইট দেখুন

Firebase কনসোল
  1. Cloud Firestore ডেটাবেসের জন্য কোয়েরি ইনসাইট দেখতে, Google Cloud কনসোলে ডেটাবেস কোয়েরি ইনসাইট প্যানেল খুলুন।
  2. Firebase কনসোলে, Firestore Database পৃষ্ঠায় যান।

    Firestore ডেটাবেসে যান

  3. ডেটাবেসের তালিকা থেকে একটি ডেটাবেস বেছে নিন।
  4. ট্যাবের তালিকা থেকে কোয়েরি ইনসাইট বিকল্পে ক্লিক করুন।

    লেটেন্সি বা রিড অপারেশনের সংখ্যার উপর ভিত্তি করে সেরা কোয়েরি খুঁজতে, লেটেন্সি বা রিড অপারেশন বিকল্পে ক্লিক করুন।

ইনডেক্স সংক্রান্ত সাজেশন

কোয়েরি ইনসাইটের জন্য ইন্ডেক্স সংক্রান্ত সাজেশন, Firestore Enterprise এডিশন ডেটাবেসে ঘন ঘন এক্সিকিউট করা কোয়েরি শেপের জন্য অনুপস্থিত বা সাবঅপ্টিমাল কম্পোজিট ইন্ডেক্স কনফিগারেশন অটোমেটিক শনাক্ত করে।

Firestore Enterprise এডিশনে, কম্পোজিট ইন্ডেক্স ম্যাচ না করলেও কোয়েরি রান করা যেতে পারে, যার ফলে সম্পূর্ণ কালেকশন স্ক্যান বা ইন-মেমরি সর্ট অপারেশন ধীর গতিতে হতে পারে। কোয়েরি ইনসাইট ড্যাশবোর্ড ঐতিহাসিক কোয়েরি এক্সিকিউশন পরিসংখ্যান বিশ্লেষণ করে এবং কোয়েরি লেটেন্সি অপ্টিমাইজ করতে এবং বিলযোগ্য স্ক্যান করা ডকুমেন্ট কমাতে টার্গেট করা কম্পোজিট ইনডেক্সের সাজেশন দেয়।

ইনডেক্স সাজেশন কীভাবে কাজ করে

অফলাইন ব্যাচ পাইপলাইন নির্দিষ্ট সময় অন্তর পুরনো সেরা কোয়েরি মূল্যায়ন করে:

  • কোয়েরি স্ট্রাকচার বিশ্লেষণ: প্রায়শই এক্সিকিউট করা কোয়েরি থেকে ইকুয়ালিটি, সর্ট ও রেঞ্জ প্রেডিকেট এক্সট্র্যাক্ট করে।
  • ক্যান্ডিডেট ইন্ডেক্স জেনারেশন: ইন্ডেক্স-অর্ডারিং হিউরিস্টিকস (Equality > Sort > Range) ব্যবহার করে সম্ভাব্য কম্পোজিট ইন্ডেক্স ডেফিনেশন জেনারেট করে।
  • অপ্টিমাইজার মূল্যায়ন: কাল্পনিক ইন্ডেক্স করা এক্সিকিউশন প্ল্যানের সাথে বেসলাইন কোয়েরি এক্সিকিউশন খরচের তুলনা করার জন্য কোয়েরি ইঞ্জিনের খরচ মডেলে ক্যান্ডিডেট ইন্ডেক্স ইনজেক্ট করে।
  • ওয়ার্কলোড ইমপ্যাক্ট র‍্যাঙ্কিং: মোট আনুমানিক ওয়ার্কলোড খরচ সাশ্রয়ের উপর ভিত্তি করে সাজেস্ট করা ইন্ডেক্সকে ইমপ্যাক্ট টিয়ারে র‍্যাঙ্ক করে:
    • HIGH: সম্পূর্ণ কালেকশন স্ক্যানকে বেছে নেওয়া ইন্ডেক্স সিকে কনভার্ট করে, ডকুমেন্ট রিড ও এক্সিকিউশন লেটেন্সি উল্লেখযোগ্যভাবে কমায়।
    • মাঝারি: আগে থেকে সাজানো ইন্ডেক্স ফলাফল প্রদান করে ইন-মেমরি সর্টিংয়ের মতো খরচসাপেক্ষ অপারেশন বাদ দেয়।
    • কম: সামান্য উন্নতি করে।
Firebase কনসোল থেকে ইন্ডেক্স সংক্রান্ত সাজেশন দেখতে এবং সাজেস্ট করা ইন্ডেক্স তৈরি করতে:

  1. Firebase কনসোলে, Firestore Database পৃষ্ঠায় যান।

    Firestore ডেটাবেসে যান

  2. ডেটাবেসের তালিকা থেকে, একটি Enterprise সংস্করণ ডেটাবেস বেছে নিন।

  3. কোয়েরি ইনসাইট ট্যাবে ক্লিক করুন।

  4. কোয়েরি টেবিলে, সাজেশন সহ কোয়েরি শেপ খুঁজে নিন এবং সারিতে বা পপওভারে সাজেশন পর্যালোচনা করুন বিকল্পে ক্লিক করুন।

  5. ইনডেক্স সাজেশন ডায়ালগে, কম্পোজিট ইনডেক্স সংজ্ঞা, ফিল্ড অর্ডারিং এবং আনুমানিক ওয়ার্কলোড ইমপ্যাক্ট টিয়ার (HIGH, MEDIUM, অথবা LOW) পর্যালোচনা করুন।

  6. সেভ করুন বিকল্পে ক্লিক করুন। ইনডেক্স বিল্ডের প্রগ্রেস ট্র্যাক করতে লং-রানিং অপারেশন (LRO) ড্রয়ার খুলে যায়।

  7. বিল্ড সম্পূর্ণ হয়ে গেলে, ইন্ডেক্সটি ইন্ডেক্স ট্যাবের অধীনে তালিকাভুক্ত করা হয় এবং কোয়েরি সারি থেকে সাজেশন ইন্ডিকেটরটি অদৃশ্য হয়ে যায়।

যেসব সংস্করণে কাজ করে

ইনডেক্স সংক্রান্ত সাজেশন শুধুমাত্র Firestore Enterprise এডিশন ডেটাবেসের জন্য কাজ করে। স্ট্যান্ডার্ড এডিশন ডেটাবেস কাজ করে না।

সীমাবদ্ধতা

  • কোয়েরি ইনসাইট ডেটা এক থেকে দুই ঘণ্টা দেরিতে দেখানো হয়।
  • ইনডেক্স সংক্রান্ত সাজেশন, ঐতিহাসিক কোয়েরি ডেটার ভিত্তিতে, নির্দিষ্ট সময় অন্তর জেনারেট করা হয়, রিয়েল টাইমে নয়।
  • ইনডেক্স সংক্রান্ত সাজেশন নতুন কম্পোজিট ইনডেক্স সাজেস্ট করে; এটি আগে থেকে থাকা ইনডেক্স পরিবর্তন বা মুছে ফেলার সাজেশন দেয় না।
  • অটোমেটিক ইন্ডেক্স তৈরি করার সুবিধা নেই; সাজেস্ট করা ইন্ডেক্স ম্যানুয়ালি তৈরি করতে হবে।
  • কোয়েরি নরমালাইজেশন আক্ষরিক মানকে প্লেসহোল্ডার দিয়ে প্রতিস্থাপন করে। ইনডেক্স সাজেশন নির্দিষ্ট রানটাইম ভ্যালুর পরিবর্তে নরমালাইজড কোয়েরি টেমপ্লেটের উপর ভিত্তি করে করা হয়।
  • খরচের মূল্যায়ন লাইভ ডেটা স্যাম্পলিংয়ের পরিবর্তে হিউরিস্টিক ব্যবহার করে। সাজেস্ট করা ইনডেক্স প্রতিটি পরিস্থিতিতে পারফর্ম্যান্স উন্নত নাও করতে পারে এবং একটি ইনডেক্স তৈরি করলে রাইট ও স্টোরেজ ওভারহেড যোগ হয়।

মূল্য

কোয়েরি ইনসাইট বা ইন্ডেক্স সংক্রান্ত সাজেশনের জন্য কোনও অতিরিক্ত খরচ নেই।

প্রয়োজনীয় ভূমিকা

কোয়েরি ইনসাইট ড্যাশবোর্ড দেখতে এবং সাজেস্ট করা ইন্ডেক্স তৈরি করতে আপনার যে অনুমতি প্রয়োজন তা পেতে, আপনার অ্যাডমিনিস্ট্রেটরকে আপনার প্রোজেক্টে নিম্নলিখিত IAM ভূমিকাগুলি আপনাকে প্রদান করতে বলুন:

  • কোয়েরি ইনসাইট দেখতে: Datastore Viewer (roles/datastore.viewer)
  • সাজেস্ট করা ইন্ডেক্স তৈরি করতে: Datastore Index Admin (roles/datastore.indexAdmin) অথবা Cloud Datastore Owner (roles/datastore.owner)

এইসব আগে থেকে নির্ধারিত ভূমিকায় datastore.insights.get এবং datastore.indexes.create অনুমতি থাকে।

এছাড়াও, আপনি কাস্টম ভূমিকা বা অন্যান্য পূর্বনির্ধারিত ভূমিকার মাধ্যমে এইসব অনুমতি পেতে পারেন।

এর পরে কী করতে হবে