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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Web

import { trace } from "firebase/performance";

const t = trace(perf, "CUSTOM_TRACE_NAME");
t.start();

// Code that you want to trace 
// ...

t.stop();

Web

const trace = perf.trace("CUSTOM_TRACE_NAME");
trace.start();

// Code that you want to trace 
// ...

trace.stop();

ইউজার টাইমিং API ব্যবহার করে কাস্টম কোড ট্রেস যোগ করুন

Performance Monitoring ট্রেস API ছাড়াও, আপনি ব্রাউজারের নেটিভ ইউজার টাইমিং API ব্যবহার করে কাস্টম কোড ট্রেস যোগ করতে পারেন। এই API ব্যবহার করে পরিমাপ করা একটি ট্রেসের সময়কাল স্বয়ংক্রিয়ভাবে Performance Monitoring SDK দ্বারা বাছাই করা হয়। ইউজার টাইমিং API ব্যবহার করা বিশেষভাবে সহায়ক যদি আপনি Performance Monitoring SDK অ্যাসিঙ্ক্রোনাসভাবে লোড করতে পছন্দ করেন। একবার SDK শুরু হয়ে গেলে, SDK তার লোডের আগে ঘটে যাওয়া পরিমাপগুলি রেকর্ড করবে৷

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

Web

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

Web

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

উল্লেখ্য যে উপরের উদাহরণে performance ব্রাউজারের window.performance অবজেক্টকে বোঝায়।

ইউজার টাইমিং এপিআই ব্যবহার করার সময়, কাস্টম কোড ট্রেসে কাস্টম মেট্রিক্স এবং অ্যাট্রিবিউট যোগ করা যাবে না। Performance Monitoring ট্রেস API ব্যবহার করুন যদি আপনি সেই কাস্টম উপাদানগুলিকে একটি কাস্টম কোড ট্রেসে যুক্ত করতে চান।

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

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

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

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

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

Web

import { trace } from "firebase/performance";

async function getInventory(inventoryIds) {
  const t = trace(perf, "inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  t.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  t.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  t.stop();

  return inventoryData;
}

Web

async function getInventory(inventoryIds) {
  const trace = perf.trace("inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  trace.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  trace.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  trace.stop();

  return inventoryData;
}

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

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

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

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

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

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

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

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

Web

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();

Web

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

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

// Read attributes
const traceAttributes = trace.getAttributes();

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

রিয়েল-টাইম কর্মক্ষমতা ডেটা দেখতে, নিশ্চিত করুন যে আপনার অ্যাপটি একটি পারফরম্যান্স মনিটরিং SDK সংস্করণ ব্যবহার করে যা রিয়েল-টাইম ডেটা প্রক্রিয়াকরণের সাথে সামঞ্জস্যপূর্ণ। রিয়েল-টাইম কর্মক্ষমতা ডেটা সম্পর্কে আরও জানুন

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

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

<span class= এ মেট্রিক্স বোর্ডের একটি চিত্র ফায়ারবেস পারফরম্যান্স মনিটরিং ড্যাশবোর্ড" />

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

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

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

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

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

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

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

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

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

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

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

<span class= এর একটি চিত্র ফায়ারবেস পারফরম্যান্স মনিটরিং ডেটা অ্যাট্রিবিউট দ্বারা ফিল্টার করা হচ্ছে" />
  • আপনার সাইটের একটি নির্দিষ্ট পৃষ্ঠার জন্য ডেটা দেখতে পৃষ্ঠা URL দ্বারা ফিল্টার করুন
  • 3g সংযোগ কীভাবে আপনার অ্যাপকে প্রভাবিত করে তা জানতে কার্যকর সংযোগের ধরন দ্বারা ফিল্টার করুন
  • আপনার ডাটাবেসের অবস্থান একটি নির্দিষ্ট অঞ্চলকে প্রভাবিত করছে না তা নিশ্চিত করতে দেশ অনুসারে ফিল্টার করুন

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

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