পারফরম্যান্স মনিটরিং আপনার অ্যাপের পারফরম্যান্স নিরীক্ষণে সাহায্য করার জন্য ট্রেস সংগ্রহ করে। ট্রেস হল আপনার অ্যাপে দুটি সময়ের মধ্যে ক্যাপচার করা পারফরম্যান্স ডেটার একটি প্রতিবেদন।
আপনার অ্যাপের নির্দিষ্ট কোডের সাথে সম্পর্কিত পারফরম্যান্স ডেটা নিরীক্ষণের জন্য আপনি নিজস্ব ট্রেস তৈরি করতে পারেন। একটি কাস্টম কোড ট্রেস ব্যবহার করে, আপনি পরিমাপ করতে পারেন যে আপনার অ্যাপটি একটি নির্দিষ্ট কাজ বা কাজের একটি সেট সম্পূর্ণ করতে কত সময় নেয়, উদাহরণস্বরূপ ছবির একটি সেট লোড করা বা আপনার ডাটাবেস অনুসন্ধান করা।
একটি কাস্টম কোড ট্রেসের জন্য ডিফল্ট মেট্রিক হল এর "সময়কাল" (ট্রেসের শুরু এবং শেষ বিন্দুর মধ্যে সময়), তবে আপনি কাস্টম মেট্রিক্সও যোগ করতে পারেন।
আপনার কোডে, আপনি পারফরম্যান্স মনিটরিং SDK দ্বারা প্রদত্ত API ব্যবহার করে একটি কাস্টম কোড ট্রেসের শুরু এবং শেষ নির্ধারণ করেন।
কাস্টম কোড ট্রেস তৈরির পরে যেকোনো সময় শুরু করা যেতে পারে এবং সেগুলি থ্রেড-নিরাপদ।
যেহেতু এই ট্রেসগুলির জন্য সংগৃহীত ডিফল্ট মেট্রিক হল "সময়কাল", তাই কখনও কখনও এগুলিকে "সময়কাল ট্রেস" বলা হয়।
আপনি ট্রেস টেবিলের কাস্টম ট্রেস সাবট্যাবে এই ট্রেসগুলি থেকে ডেটা দেখতে পারেন, যা পারফরম্যান্স ড্যাশবোর্ডের নীচে রয়েছে (এই পৃষ্ঠায় পরে কনসোল ব্যবহার সম্পর্কে আরও জানুন)।
ডিফল্ট অ্যাট্রিবিউট, কাস্টম অ্যাট্রিবিউট এবং কাস্টম মেট্রিক্স
কাস্টম কোড ট্রেসের জন্য, পারফরম্যান্স মনিটরিং স্বয়ংক্রিয়ভাবে ডিফল্ট অ্যাট্রিবিউটগুলি (অ্যাপ সংস্করণ, দেশ, ডিভাইস ইত্যাদির মতো সাধারণ মেটাডেটা) লগ করে যাতে আপনি ফায়ারবেস কনসোলে ট্রেসের জন্য ডেটা ফিল্টার করতে পারেন। আপনি কাস্টম অ্যাট্রিবিউটগুলি (যেমন, গেম লেভেল বা ব্যবহারকারীর বৈশিষ্ট্য) যোগ এবং নিরীক্ষণ করতে পারেন।
আপনি ট্রেসের সুযোগের মধ্যে ঘটে যাওয়া পারফরম্যান্স-সম্পর্কিত ইভেন্টগুলির জন্য কাস্টম মেট্রিক্স রেকর্ড করার জন্য একটি কাস্টম কোড ট্রেস আরও কনফিগার করতে পারেন। উদাহরণস্বরূপ, আপনি ক্যাশে হিট এবং মিসের সংখ্যা বা UI একটি লক্ষণীয় সময়ের জন্য প্রতিক্রিয়াহীন হয়ে পড়ার সংখ্যার জন্য একটি কাস্টম মেট্রিক তৈরি করতে পারেন।
কাস্টম অ্যাট্রিবিউট এবং কাস্টম মেট্রিক্স ফায়ারবেস কনসোলে ট্রেসের জন্য ডিফল্ট অ্যাট্রিবিউট এবং ডিফল্ট মেট্রিকের পাশাপাশি প্রদর্শিত হয়।
কাস্টম কোড ট্রেস যোগ করুন
নির্দিষ্ট অ্যাপ্লিকেশন কোড নিরীক্ষণের জন্য কাস্টম কোড ট্রেস যোগ করতে পারফরম্যান্স মনিটরিং ট্রেস API ব্যবহার করুন।
নিম্নলিখিত বিষয়গুলি লক্ষ্য করুন:
- একটি অ্যাপে একাধিক কাস্টম কোড ট্রেস থাকতে পারে।
- একই সময়ে একাধিক কাস্টম কোড ট্রেস চালানো যেতে পারে।
- কাস্টম কোড ট্রেসের নামগুলিকে নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করতে হবে: কোনও লিডিং বা ট্রেলিং হোয়াইটস্পেস নেই, কোনও লিডিং আন্ডারস্কোর (
_) অক্ষর নেই এবং সর্বাধিক দৈর্ঘ্য ১০০ অক্ষর। - কাস্টম কোড ট্রেস কাস্টম মেট্রিক্স এবং কাস্টম বৈশিষ্ট্য যোগ করতে সহায়তা করে।
একটি কাস্টম কোড ট্রেস শুরু এবং বন্ধ করতে, আপনি যে কোডটি ট্রেস করতে চান সেটি নিম্নলিখিত কোডের মতো করে মুড়ে দিন:
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
কাস্টম কোড ট্রেসে কাস্টম মেট্রিক্স যোগ করুন
কাস্টম কোড ট্রেসে কাস্টম মেট্রিক্স যোগ করতে পারফরম্যান্স মনিটরিং ট্রেস 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();
কাস্টম কোড ট্রেসের জন্য কাস্টম অ্যাট্রিবিউট তৈরি করুন
কাস্টম অ্যাট্রিবিউট ব্যবহার করতে, আপনার অ্যাপে এমন কোড যোগ করুন যা অ্যাট্রিবিউটটিকে সংজ্ঞায়িত করে এবং এটিকে একটি নির্দিষ্ট কাস্টম কোড ট্রেসের সাথে সংযুক্ত করে। ট্রেস শুরু হওয়ার এবং ট্রেস বন্ধ হওয়ার মধ্যে যেকোনো সময় আপনি কাস্টম অ্যাট্রিবিউট সেট করতে পারেন।
নিম্নলিখিত বিষয়গুলি লক্ষ্য করুন:
কাস্টম অ্যাট্রিবিউটের নামগুলিকে নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করতে হবে: কোনও লিডিং বা ট্রেলিং হোয়াইটস্পেস নেই, কোনও লিডিং আন্ডারস্কোর (
_) অক্ষর নেই এবং সর্বাধিক দৈর্ঘ্য 32 অক্ষর।প্রতিটি কাস্টম কোড ট্রেস সর্বোচ্চ ৫টি কাস্টম বৈশিষ্ট্য রেকর্ড করতে পারে।
আপনার এমন কাস্টম অ্যাট্রিবিউট ব্যবহার করা উচিত নয় যাতে এমন তথ্য থাকে যা Google-এর কাছে কোনও ব্যক্তিকে ব্যক্তিগতভাবে শনাক্ত করে।
পারফরম্যান্স মনিটরিং নিজে থেকে কোনও ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য (PII) সংগ্রহ করে না, যেমন নাম, ইমেল ঠিকানা, বা ফোন নম্বর। ডেভেলপাররা কাস্টম কোড ট্রেসে কাস্টম অ্যাট্রিবিউট তৈরি করে পারফরম্যান্স মনিটরিং ব্যবহার করে অতিরিক্ত ডেটা সংগ্রহ করতে পারেন। পারফরম্যান্স মনিটরিংয়ের মাধ্যমে সংগৃহীত এই ধরনের ডেটাতে এমন তথ্য থাকা উচিত নয় যা Google-এর কাছে কোনও ব্যক্তিকে ব্যক্তিগতভাবে শনাক্ত করে।
এখানে এমন একটি লগ বার্তার উদাহরণ দেওয়া হল যেখানে ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য নেই:
customTrace.putAttribute("experiment", "A"); // OKএখানে এমন একটি উদাহরণ দেওয়া হল যেখানে ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য রয়েছে (আপনার অ্যাপে এই ধরণের কাস্টম অ্যাট্রিবিউট ব্যবহার করবেন না):
customTrace.putAttribute(("email", user.getEmailAddress()); // Don't do this!যে ডেটা ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য প্রকাশ করে তা কোনও নোটিশ ছাড়াই মুছে ফেলা হতে পারে।
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 কনসোলের পারফরম্যান্স ড্যাশবোর্ডে যান, ট্রেস টেবিলে স্ক্রোল করুন, তারপর উপযুক্ত সাবট্যাবে ক্লিক করুন। টেবিলটি প্রতিটি ট্রেসের জন্য কিছু শীর্ষ মেট্রিক্স প্রদর্শন করে এবং আপনি একটি নির্দিষ্ট মেট্রিকের শতাংশ পরিবর্তন অনুসারে তালিকাটি সাজাতে পারেন।
যদি আপনি ট্রেস টেবিলের একটি ট্রেস নামে ক্লিক করেন, তাহলে আপনি বিভিন্ন স্ক্রিনে ক্লিক করে ট্রেসটি অন্বেষণ করতে পারেন এবং আগ্রহের মেট্রিক্সগুলি খতিয়ে দেখতে পারেন। বেশিরভাগ পৃষ্ঠায়, আপনি বৈশিষ্ট্য অনুসারে ডেটা ফিল্টার করতে ফিল্টার বোতাম (স্ক্রিনের উপরে-বামে) ব্যবহার করতে পারেন, উদাহরণস্বরূপ:
- আপনার পূর্ববর্তী রিলিজ বা সর্বশেষ রিলিজ সম্পর্কে ডেটা দেখতে অ্যাপ ভার্সন অনুসারে ফিল্টার করুন
- পুরনো ডিভাইসগুলি আপনার অ্যাপ কীভাবে পরিচালনা করে তা জানতে ডিভাইস অনুসারে ফিল্টার করুন
- আপনার ডাটাবেসের অবস্থান কোনও নির্দিষ্ট অঞ্চলকে প্রভাবিত করছে না তা নিশ্চিত করতে দেশ অনুসারে ফিল্টার করুন।
আপনার ট্রেসের ডেটা দেখার বিষয়ে আরও জানুন।
পরবর্তী পদক্ষেপ
পারফর্ম্যান্স ডেটা পরীক্ষা করার জন্য অ্যাট্রিবিউট ব্যবহার সম্পর্কে আরও জানুন।
Firebase কনসোলে কর্মক্ষমতা সংক্রান্ত সমস্যাগুলি কীভাবে ট্র্যাক করবেন সে সম্পর্কে আরও জানুন।
আপনার অ্যাপের কর্মক্ষমতা হ্রাসকারী কোড পরিবর্তনের জন্য সতর্কতা সেট আপ করুন । উদাহরণস্বরূপ, যদি একটি নির্দিষ্ট কাস্টম কোড ট্রেসের সময়কাল আপনার সেট করা থ্রেশহোল্ড অতিক্রম করে তবে আপনি আপনার দলের জন্য একটি ইমেল সতর্কতা কনফিগার করতে পারেন।