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


পারফরম্যান্স মনিটরিং আপনাকে আপনার অ্যাপের কর্মক্ষমতা নিরীক্ষণ করতে সাহায্য করার জন্য ট্রেস সংগ্রহ করে। একটি ট্রেস হল আপনার অ্যাপে সময়ের মধ্যে দুটি পয়েন্টের মধ্যে ক্যাপচার করা কর্মক্ষমতা ডেটার একটি প্রতিবেদন।

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

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

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

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

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

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

Default attributes, custom attributes, and custom metrics

কাস্টম কোড ট্রেসের জন্য, পারফরম্যান্স মনিটরিং স্বয়ংক্রিয়ভাবে ডিফল্ট বৈশিষ্ট্যগুলি (সাধারণ মেটাডেটা যেমন অ্যাপ সংস্করণ, দেশ, ডিভাইস ইত্যাদি) লগ করে যাতে আপনি Firebase কনসোলে ট্রেসের জন্য ডেটা ফিল্টার করতে পারেন। You can also add and monitor custom attributes (such as, game level or user properties).

You can further configure a custom code trace to record custom metrics for performance-related events that occur within the trace's scope. উদাহরণ স্বরূপ, আপনি ক্যাশে হিট এবং মিস হওয়ার সংখ্যার জন্য একটি কাস্টম মেট্রিক তৈরি করতে পারেন বা একটি লক্ষণীয় সময়ের জন্য UI কতবার প্রতিক্রিয়াহীন হয়ে পড়ে।

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

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

Use the Performance Monitoring Trace API to add custom code traces to monitor specific application code.

নিম্নলিখিত নোট করুন:

  • একটি অ্যাপে একাধিক কাস্টম কোড ট্রেস থাকতে পারে।
  • More than one custom code trace can run at the same time.
  • Names for custom code traces must meet the following requirements: no leading or trailing whitespace, no leading underscore ( _ ) character, and max length is 100 characters.
  • Custom code traces support adding custom metrics and custom attributes .

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

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

// Code you want to trace

await customTrace.stop();

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

কাস্টম কোড ট্রেসে কাস্টম মেট্রিক্স যোগ করতে পারফরম্যান্স মনিটরিং ট্রেস API ব্যবহার করুন।

নিম্নলিখিত নোট করুন:

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

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

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 টি অক্ষর নয়।

  • প্রতিটি কাস্টম কোড ট্রেস 5টি কাস্টম বৈশিষ্ট্য পর্যন্ত রেকর্ড করতে পারে।

  • আপনার এমন কাস্টম অ্যাট্রিবিউট ব্যবহার করা উচিত নয় যাতে এমন তথ্য থাকে যা ব্যক্তিগতভাবে 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 কনসোলের পারফরম্যান্স ড্যাশবোর্ডে যান, তারপর ড্যাশবোর্ড ট্যাবে ক্লিক করুন। Click an empty metric card, then select an existing metric to add to your board. Click the vertical ellipsis ( ⋮ ) on a populated metric card for more options, like to replace or remove a metric.

The metrics board shows collected metric data over time, both in graphical form and as a numerical percentage change.

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

ট্রেস এবং তাদের ডেটা দেখুন

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

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

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

আপনার ট্রেসের জন্য ডেটা দেখার বিষয়ে আরও জানুন।

পরবর্তী পদক্ষেপ