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

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

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

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

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

আপনার কোডে, আপনি Performance Monitoring SDK দ্বারা প্রদত্ত API ব্যবহার করে একটি কাস্টম কোড ট্রেসের শুরু এবং শেষ সংজ্ঞায়িত করেন।কাস্টম কোড ট্রেসগুলি তৈরি হওয়ার পরে যে কোনও সময় শুরু করা যেতে পারে এবং সেগুলি থ্রেড নিরাপদ৷

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

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

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

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

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

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

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

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

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

নির্দিষ্ট অ্যাপ্লিকেশন কোড নিরীক্ষণ করতে কাস্টম কোড ট্রেস যোগ করতে Performance Monitoring ট্রেস API ( Swift | Obj-C ) ব্যবহার করুন।

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

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

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

সুইফট

দ্রষ্টব্য: এই ফায়ারবেস পণ্যটি macOS, Mac ক্যাটালিস্ট, watchOS লক্ষ্যে উপলব্ধ নয়।

// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

উদ্দেশ্য-C

দ্রষ্টব্য: এই ফায়ারবেস পণ্যটি macOS, Mac ক্যাটালিস্ট, watchOS লক্ষ্যে উপলব্ধ নয়।

// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

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

কাস্টম কোড ট্রেসে কাস্টম মেট্রিক্স যোগ করতে Performance Monitoring ট্রেস API ( Swift | Obj-C ) ব্যবহার করুন।

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

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

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

সুইফট

দ্রষ্টব্য: এই ফায়ারবেস পণ্যটি macOS, Mac ক্যাটালিস্ট, watchOS লক্ষ্যে উপলব্ধ নয়।

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

উদ্দেশ্য-C

দ্রষ্টব্য: এই ফায়ারবেস পণ্যটি macOS, Mac ক্যাটালিস্ট, watchOS লক্ষ্যে উপলব্ধ নয়।

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

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

কাস্টম কোড ট্রেসে কাস্টম বৈশিষ্ট্য যোগ করতে Performance Monitoring ট্রেস API ( Swift | Obj-C ) ব্যবহার করুন।

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

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

• কাস্টম বৈশিষ্ট্যগুলির জন্য নামগুলি অবশ্যই নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করতে হবে:

  • কোন লিডিং বা ট্রেইলিং হোয়াইটস্পেস নেই, কোন লিডিং আন্ডারস্কোর ( _ ) অক্ষর নেই
  • কোনো স্পেস নেই
  • সর্বাধিক দৈর্ঘ্য 32 অক্ষর
  • নামের জন্য অনুমোদিত অক্ষর হল AZ , az , এবং _ ।

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

• অনুগ্রহ করে নিশ্চিত করুন যে কাস্টম বৈশিষ্ট্যগুলিতে এমন কোনও তথ্য নেই যা ব্যক্তিগতভাবে Google-এর কাছে একজন ব্যক্তিকে সনাক্ত করে।

  এই নির্দেশিকা সম্পর্কে আরও জানুন

  ব্যবহারকারীর তথ্য সংগ্রহ করা: Performance Monitoring নিজে থেকে কোনো ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য (PII), যেমন নাম, ইমেল ঠিকানা বা ফোন নম্বর সংগ্রহ করে না। বিকাশকারীরা কাস্টম কোড ট্রেসে কাস্টম বৈশিষ্ট্য তৈরি করে Performance Monitoring ব্যবহার করে অতিরিক্ত ডেটা সংগ্রহ করতে পারে। Performance Monitoring মাধ্যমে সংগ্রহ করা এই ধরনের ডেটাতে এমন তথ্য থাকা উচিত নয় যা Google-এর কাছে ব্যক্তিগতভাবে একজন ব্যক্তিকে শনাক্ত করে।

  এখানে একটি লগ বার্তার একটি উদাহরণ যা ব্যক্তিগতভাবে সনাক্তযোগ্য তথ্য ধারণ করে না :

  trace.putAttribute("experiment", "A");

  এখানে একটি উদাহরণ যা ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য ধারণ করে (আপনার অ্যাপে এই ধরনের কাস্টম বৈশিষ্ট্য ব্যবহার করবেন না ):

  trace.putAttribute("email", user.getEmailAddress());

  কোনো ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য প্রকাশ করে এমন ডেটা কোনো বিজ্ঞপ্তি ছাড়াই মুছে ফেলার বিষয়।

সুইফট

দ্রষ্টব্য: এই ফায়ারবেস পণ্যটি macOS, Mac ক্যাটালিস্ট, watchOS লক্ষ্যে উপলব্ধ নয়।

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

উদ্দেশ্য-C

দ্রষ্টব্য: এই ফায়ারবেস পণ্যটি macOS, Mac ক্যাটালিস্ট, watchOS লক্ষ্যে উপলব্ধ নয়।

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

ট্র্যাক, দেখুন, এবং ফিল্টার কর্মক্ষমতা ডেটা

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

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

ফায়ারবেস পারফরম্যান্স মনিটরিং ড্যাশবোর্ড" />

আপনার মেট্রিক্স বোর্ডে একটি মেট্রিক যোগ করতে, এই ধাপগুলি অনুসরণ করুন:

1. Firebase কনসোলে পারফরম্যান্স ড্যাশবোর্ডে যান।
2. একটি খালি মেট্রিক কার্ডে ক্লিক করুন, তারপর আপনার বোর্ডে যোগ করতে একটি বিদ্যমান মেট্রিক নির্বাচন করুন।
3. আরও বিকল্পের জন্য একটি জনবহুল মেট্রিক কার্ডে ক্লিক করুন, উদাহরণস্বরূপ একটি মেট্রিক প্রতিস্থাপন বা সরানোর জন্য।

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

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

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

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

Performance Monitoring Firebase কনসোলে একটি সমস্যা সমাধানের পৃষ্ঠা সরবরাহ করে যা মেট্রিক পরিবর্তনগুলিকে হাইলাইট করে, এটি আপনার অ্যাপ এবং ব্যবহারকারীদের উপর কার্যক্ষমতা সংক্রান্ত সমস্যাগুলির প্রভাব দ্রুত সমাধান এবং কমিয়ে আনা সহজ করে তোলে। আপনি সম্ভাব্য কর্মক্ষমতা সমস্যা সম্পর্কে জানলে আপনি সমস্যা সমাধানের পৃষ্ঠাটি ব্যবহার করতে পারেন, উদাহরণস্বরূপ, নিম্নলিখিত পরিস্থিতিতে:

• আপনি ড্যাশবোর্ডে প্রাসঙ্গিক মেট্রিক্স নির্বাচন করেন এবং আপনি একটি বড় ডেল্টা লক্ষ্য করেন।
• ট্রেস টেবিলে আপনি শীর্ষে সবচেয়ে বড় ডেল্টা প্রদর্শনের জন্য সাজান, এবং আপনি একটি উল্লেখযোগ্য শতাংশ পরিবর্তন দেখতে পান।
• আপনি একটি ইমেল সতর্কতা পাবেন যা আপনাকে একটি কর্মক্ষমতা সমস্যা সম্পর্কে অবহিত করে।

আপনি নিম্নলিখিত উপায়ে সমস্যা সমাধান পৃষ্ঠা অ্যাক্সেস করতে পারেন:

• মেট্রিক ড্যাশবোর্ডে, মেট্রিকের বিবরণ দেখুন বোতামে ক্লিক করুন।
• যেকোনো মেট্রিক কার্ডে নির্বাচন করুন => বিস্তারিত দেখুন । সমস্যা সমাধানের পৃষ্ঠাটি আপনার নির্বাচিত মেট্রিক সম্পর্কে তথ্য প্রদর্শন করে।
• ট্রেস টেবিলে, সেই ট্রেসের সাথে যুক্ত সারিতে একটি ট্রেস নাম বা যেকোনো মেট্রিক মান ক্লিক করুন।
• একটি ইমেল সতর্কতায়, এখন তদন্ত করুন ক্লিক করুন।

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

ফায়ারবেস পারফরম্যান্স মনিটরিং ডেটা অ্যাট্রিবিউট দ্বারা ফিল্টার করা হচ্ছে" />

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

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

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

• পারফরম্যান্স ডেটা পরীক্ষা করার জন্য বৈশিষ্ট্যগুলি ব্যবহার করার বিষয়ে আরও জানুন।

• Firebase কনসোলে পারফরম্যান্সের সমস্যাগুলি কীভাবে ট্র্যাক করতে হয় সে সম্পর্কে আরও জানুন।

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

• ব্যবহারকারী সেশনের বিশদ প্রতিবেদন দেখুন যেখানে আপনি একই সেশনের সময় সংগৃহীত অন্যান্য ট্রেসগুলির একটি সময়রেখা প্রসঙ্গে একটি নির্দিষ্ট ট্রেস দেখতে পারেন৷