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

iOS+ অ্যান্ড্রয়েড ওয়েব ফ্লাটার

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

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

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

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

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

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

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

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

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

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

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

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

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

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

নির্দিষ্ট অ্যাপ্লিকেশন কোড নিরীক্ষণ করতে কাস্টম কোড ট্রেস যোগ করতে পারফরম্যান্স মনিটরিং ট্রেস API ব্যবহার করুন।

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

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

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

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-এ একজন ব্যক্তিকে শনাক্ত করে।

  ব্যবহারকারীর তথ্য সংগ্রহ করা হচ্ছে

  পারফরম্যান্স মনিটরিং নিজে কোনো ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য (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 কনসোলে পারফরম্যান্সের সমস্যাগুলি কীভাবে ট্র্যাক করতে হয় সে সম্পর্কে আরও জানুন।

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