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

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

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

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

আপনার কোডে, আপনি পারফরম্যান্স মনিটরিং SDK দ্বারা প্রদত্ত API ব্যবহার করে একটি কাস্টম কোড ট্রেসের শুরু এবং শেষ সংজ্ঞায়িত করেন।Android অ্যাপগুলির জন্য, আপনি @AddTrace টীকা ব্যবহার করে নির্দিষ্ট পদ্ধতিগুলি নিরীক্ষণ করতে পারেন।কাস্টম কোড ট্রেসগুলি তৈরি হওয়ার পরে যে কোনও সময় শুরু করা যেতে পারে এবং সেগুলি থ্রেড নিরাপদ৷

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

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

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

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

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

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

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

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

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

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

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

Kotlin+KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace

myTrace.stop()

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace

myTrace.stop();

(ঐচ্ছিক) @AddTrace ব্যবহার করে নির্দিষ্ট পদ্ধতি পর্যবেক্ষণ করুন

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

উদাহরণস্বরূপ, আপনি onCreateTrace নামে একটি কাস্টম কোড ট্রেস তৈরি করতে পারেন যা onCreate() পদ্ধতি কল করা হলে চলে।

Kotlin+KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
// the `enabled` argument is optional and defaults to true
@AddTrace(name = "onCreateTrace", enabled = true)
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
}

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
@Override
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
}

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

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

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

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

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

Kotlin+KTX

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace (and log custom metrics)
val item = cache.fetch("item")
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1)
} else {
    myTrace.incrementMetric("item_cache_miss", 1)
}

myTrace.stop()

Java

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace (and log custom metrics)
Item item = cache.fetch("item");
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1);
} else {
    myTrace.incrementMetric("item_cache_miss", 1);
}

myTrace.stop();

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

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

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

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

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

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

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

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

Kotlin+KTX

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}

Java

Trace trace = FirebasePerformance.getInstance().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();

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

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

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

ফায়ারবেস পারফরম্যান্স মনিটরিং ড্যাশবোর্ডে মেট্রিক্স বোর্ডের একটি ছবি

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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