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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

নিম্নলিখিত বিষয়গুলি লক্ষ্য করুন:

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

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

সুইফট

দ্রষ্টব্য: এই Firebase পণ্যটি macOS, Mac Catalyst, 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()

অবজেক্টিভ-সি

দ্রষ্টব্য: এই Firebase পণ্যটি macOS, Mac Catalyst, 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 ) ব্যবহার করুন।

নিম্নলিখিত বিষয়গুলি লক্ষ্য করুন:

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

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

সুইফট

দ্রষ্টব্য: এই Firebase পণ্যটি macOS, Mac Catalyst, watchOS টার্গেটগুলিতে উপলব্ধ নয়।

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

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

trace.stop()

অবজেক্টিভ-সি

দ্রষ্টব্য: এই Firebase পণ্যটি macOS, Mac Catalyst, 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 ) ব্যবহার করুন।

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

নিম্নলিখিত বিষয়গুলি লক্ষ্য করুন:

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

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

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

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

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

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

  এখানে এমন একটি লগ বার্তার উদাহরণ দেওয়া হল যেখানে ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য নেই :

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

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

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

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

সুইফট

দ্রষ্টব্য: এই Firebase পণ্যটি macOS, Mac Catalyst, 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;

অবজেক্টিভ-সি

দ্রষ্টব্য: এই Firebase পণ্যটি macOS, Mac Catalyst, 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 কনসোলের পারফরম্যান্স ড্যাশবোর্ডে যান, ট্রেস টেবিলে স্ক্রোল করুন, তারপর উপযুক্ত সাবট্যাবে ক্লিক করুন। টেবিলটি প্রতিটি ট্রেসের জন্য কিছু শীর্ষ মেট্রিক্স প্রদর্শন করে এবং আপনি একটি নির্দিষ্ট মেট্রিকের শতাংশ পরিবর্তন অনুসারে তালিকাটি সাজাতে পারেন।

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

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

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

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

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

"Firebase Performance Monitoring ডেটা অ্যাট্রিবিউট" /> দ্বারা ফিল্টার করা হচ্ছে

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

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

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

• পারফর্ম্যান্স ডেটা পরীক্ষা করার জন্য অ্যাট্রিবিউট ব্যবহার সম্পর্কে আরও জানুন।

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

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

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