নির্দিষ্ট অ্যাপ কোডের জন্য কাস্টম মনিটরিং যোগ করুন


আপনার অ্যাপের পারফর্ম্যান্স মনিটর করতে সাহায্য করার জন্য Performance Monitoring ট্রেস সংগ্রহ করে। ট্রেস হল আপনার অ্যাপে দুটি সময়ের মধ্যে ক্যাপচার করা পারফর্ম্যান্স ডেটার রিপোর্ট।

আপনার অ্যাপের নির্দিষ্ট কোডের সাথে সম্পর্কিত পারফর্ম্যান্স ডেটা মনিটর করার জন্য আপনি নিজের ট্রেস তৈরি করতে পারবেন। কাস্টম কোড ট্রেস-এর মাধ্যমে, আপনার অ্যাপের কোনও নির্দিষ্ট টাস্ক বা টাস্কের সেট সম্পূর্ণ করতে কত সময় লাগে তা আপনি পরিমাপ করতে পারবেন, যেমন, ছবির সেট লোড করা বা আপনার ডেটাবেস কোয়েরি করা।

কাস্টম কোড ট্রেসের ডিফল্ট মেট্রিক হল এর "সময়সীমা" (ট্রেসের শুরু ও শেষ হওয়ার পয়েন্টের মধ্যবর্তী সময়), তবে আপনি কাস্টম মেট্রিকও যোগ করতে পারবেন।

আপনার কোডে, আপনি পারফর্ম্যান্স মনিটরিং SDK-এর মাধ্যমে প্রদান করা API ব্যবহার করে কাস্টম কোড ট্রেসের শুরু এবং শেষ নির্ধারণ করেন।

কাস্টম কোড ট্রেস তৈরি করার পরে যেকোনও সময় শুরু করা যেতে পারে এবং সেগুলি থ্রেড-সেফ।

এইসব ট্রেসের জন্য সংগৃহীত ডিফল্ট মেট্রিক "সময়সীমা" হওয়ার কারণে, এগুলিকে কখনও কখনও "সময়সীমা ট্রেস" বলা হয়।

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

ডিফল্ট অ্যাট্রিবিউট, কাস্টম অ্যাট্রিবিউট ও কাস্টম মেট্রিক

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

ট্রেসের স্কোপের মধ্যে ঘটে যাওয়া পারফর্ম্যান্স-সম্পর্কিত ইভেন্টের জন্য কাস্টম মেট্রিক রেকর্ড করতে আপনি কাস্টম কোড ট্রেস আরও কনফিগার করতে পারবেন। যেমন, আপনি ক্যাশে হিট ও মিসের সংখ্যা বা UI কতবার উল্লেখযোগ্য সময়ের জন্য কাজ করা বন্ধ করে দেয় তার জন্য কাস্টম মেট্রিক তৈরি করতে পারেন।

ট্রেসের জন্য ডিফল্ট অ্যাট্রিবিউট এবং ডিফল্ট মেট্রিকের পাশাপাশি Firebase কনসোলে কাস্টম অ্যাট্রিবিউট এবং কাস্টম মেট্রিক ডিসপ্লে।

কাস্টম কোড ট্রেস যোগ করুন

নির্দিষ্ট অ্যাপ্লিকেশন কোড মনিটর করার জন্য কাস্টম কোড ট্রেস যোগ করতে Performance Monitoring Trace API ব্যবহার করুন।

নিম্নলিখিত বিষয় মনে রাখতে হবে:

  • একটি অ্যাপে একাধিক কাস্টম কোড ট্রেস থাকতে পারে।
  • একই সময়ে একাধিক কাস্টম কোড ট্রেস রান করতে পারে।
  • কাস্টম কোড ট্রেসের নামের ক্ষেত্রে নিম্নলিখিত শর্ত পূরণ করতে হবে: প্রথমে বা শেষে কোনও হোয়াইটস্পেস থাকা চলবে না, প্রথমে আন্ডারস্কোর (_) অক্ষর থাকা চলবে না, এবং সর্বাধিক দৈর্ঘ্য ১০০ অক্ষর হতে হবে।
  • কাস্টম কোড ট্রেস কাস্টম মেট্রিক এবং কাস্টম অ্যাট্রিবিউট যোগ করার সুবিধা দেয়।

কাস্টম কোড ট্রেস শুরু ও বন্ধ করতে, আপনি যে কোড ট্রেস করতে চান সেটি নিম্নলিখিত কোডের মতো কোড দিয়ে র‍্যাপ করুন:

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

কাস্টম কোড ট্রেসে কাস্টম মেট্রিক যোগ করুন

কাস্টম কোড ট্রেসে কাস্টম মেট্রিক যোগ করতে Performance Monitoring Trace API ব্যবহার করুন।

নিম্নলিখিত বিষয় মনে রাখতে হবে:

  • কাস্টম মেট্রিকের নাম অবশ্যই নিম্নলিখিত প্রয়োজনীয়তা পূরণ করতে হবে: শুরুতে বা শেষে কোনও হোয়াইটস্পেস নেই, শুরুতে কোনও আন্ডারস্কোর (_) অক্ষর নেই, এবং সর্বাধিক দৈর্ঘ্য ১০০ অক্ষর।
  • প্রতিটি কাস্টম কোড ট্রেস সর্বাধিক ৩২টি মেট্রিক রেকর্ড করতে পারে (ডিফল্ট সময়কাল মেট্রিক সহ)।

কাস্টম মেট্রিক যোগ করতে, প্রতিবার ইভেন্ট ঘটার সময় নিম্নলিখিত কোডের মতো একটি লাইন যোগ করুন। যেমন, এই কাস্টম মেট্রিক আপনার অ্যাপে ঘটা পারফর্ম্যান্স-সম্পর্কিত ইভেন্ট গণনা করে, যেমন ক্যাশে হিট বা আবার চেষ্টা করা।

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

কাস্টম কোড ট্রেসের জন্য কাস্টম অ্যাট্রিবিউট তৈরি করুন

কাস্টম অ্যাট্রিবিউট ব্যবহার করতে, আপনার অ্যাপে কোড যোগ করুন যা অ্যাট্রিবিউটকে সংজ্ঞায়িত করে এবং এটি একটি নির্দিষ্ট কাস্টম কোড ট্রেসের সাথে যুক্ত করে। ট্রেস শুরু ও বন্ধ হওয়ার মধ্যে যেকোনও সময় আপনি কাস্টম অ্যাট্রিবিউট সেট করতে পারবেন।

নিম্নলিখিত বিষয় মনে রাখতে হবে:

  • কাস্টম অ্যাট্রিবিউটের নাম অবশ্যই নিম্নলিখিত প্রয়োজনীয়তা পূরণ করতে হবে: প্রথমে বা শেষে কোনও হোয়াইটস্পেস নেই, প্রথমে কোনও আন্ডারস্কোর (_) অক্ষর নেই, এবং সর্বোচ্চ দৈর্ঘ্য হল ৩২টি অক্ষর।

  • প্রতিটি কাস্টম কোড ট্রেস সর্বাধিক ৫টি কাস্টম অ্যাট্রিবিউট রেকর্ড করতে পারে।

  • আপনি এমন কাস্টম অ্যাট্রিবিউট ব্যবহার করবেন না যাতে এমন তথ্য থাকে যা থেকে Google-এর কাছে কোনও ব্যক্তির ব্যক্তিগত পরিচয় প্রকাশ পায়।

Trace trace = FirebasePerformance.instance.newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

পারফর্ম্যান্স ডেটা ট্র্যাক, ভিউ ও ফিল্টার করা

আপনার ড্যাশবোর্ডে নির্দিষ্ট মেট্রিক ট্র্যাক করুন

আপনার মূল মেট্রিক কীভাবে ট্রেন্ডিং হচ্ছে তা জানতে, পারফর্ম্যান্স ড্যাশবোর্ডের উপরে আপনার মেট্রিক বোর্ডে সেগুলি যোগ করুন। আপনি সপ্তাহ-প্রতি-সপ্তাহ পরিবর্তন দেখে দ্রুত রিগ্রেশন শনাক্ত করতে পারেন অথবা আপনার কোডে সাম্প্রতিক পরিবর্তনগুলি পারফর্ম্যান্স উন্নত করছে কিনা তা যাচাই করতে পারেন।

আপনার মেট্রিক বোর্ডে মেট্রিক যোগ করতে, Firebase কনসোলে পারফর্ম্যান্স ড্যাশবোর্ড-এ যান, তারপর ড্যাশবোর্ড ট্যাবে ক্লিক করুন। একটি খালি মেট্রিক কার্ডে ক্লিক করুন, তারপর আপনার বোর্ডে যোগ করার জন্য একটি বিদ্যমান মেট্রিক বেছে নিন। মেট্রিক পরিবর্তন বা সরানোর মতো আরও বিকল্পের জন্য, মেট্রিক কার্ডে উল্লম্ব উপবৃত্তাকার (⋮) আইকনে ক্লিক করুন।

মেট্রিক্স বোর্ডে সময়ের সাথে সাথে সংগ্রহ করা মেট্রিক ডেটা গ্রাফিক্যাল ফর্ম এবং সংখ্যাগত শতাংশের পরিবর্তন হিসেবে দেখানো হয়।

ড্যাশবোর্ড ব্যবহার করা সম্পর্কে আরও জানুন।

ট্রেস ও তার ডেটা দেখুন

আপনার ট্রেস দেখতে, Firebase কনসোলে পারফর্ম্যান্স ড্যাশবোর্ড-এ যান, ট্রেস টেবিল পর্যন্ত স্ক্রল করে নিচে নামুন, তারপর উপযুক্ত সাবট্যাবে ক্লিক করুন। টেবিলে প্রতিটি ট্রেসের জন্য কিছু সেরা মেট্রিক দেখানো হয় এবং আপনি এমনকি নির্দিষ্ট মেট্রিকের জন্য শতাংশের পরিবর্তন অনুযায়ী তালিকাটি সাজাতে পারেন।

ট্রেস টেবিলে কোনও ট্রেসের নামে ক্লিক করলে, আপনি বিভিন্ন স্ক্রিনে ক্লিক করে ট্রেস এক্সপ্লোর করতে এবং আপনার আগ্রহের মেট্রিক আরও ভালভাবে বুঝতে পারবেন। বেশিরভাগ পৃষ্ঠায়, আপনি ফিল্টার বোতাম (স্ক্রিনের উপরে-বাঁদিকে) ব্যবহার করে অ্যাট্রিবিউট অনুযায়ী ডেটা ফিল্টার করতে পারবেন, যেমন:

  • আপনার লেটেস্ট রিলিজ বা আগের রিলিজ সম্পর্কে ডেটা দেখতে অ্যাপ ভার্সন অনুযায়ী ফিল্টার করুন রিলিজ
  • পুরনো ডিভাইস কীভাবে আপনার অ্যাপ ম্যানেজ করে তা জানতে ডিভাইস অনুযায়ী ফিল্টার করুন
  • আপনার ডেটাবেস লোকেশন যাতে কোনও নির্দিষ্ট অঞ্চলকে প্রভাবিত না করে তা নিশ্চিত করতে দেশ অনুযায়ী ফিল্টার করুন

আপনার ট্রেসের ডেটা দেখা সম্পর্কে আরও জানুন।

পরবর্তী ধাপ