खास ऐप्लिकेशन कोड के लिए, अपने हिसाब से मॉनिटरिंग की सुविधा चालू करें

iOS+ Android वेब Flutter

Performance Monitoring, ट्रेस इकट्ठा करता है. इससे आपको अपने ऐप्लिकेशन की परफ़ॉर्मेंस को मॉनिटर करने में मदद मिलती है. ट्रेस, आपके ऐप्लिकेशन में किसी समयावधि के दौरान कैप्चर किए गए परफ़ॉर्मेंस डेटा की रिपोर्ट होती है.

अपने ऐप्लिकेशन में किसी खास कोड से जुड़े परफ़ॉर्मेंस डेटा को मॉनिटर करने के लिए, अपने खुद के ट्रेस बनाए जा सकते हैं. कस्टम कोड ट्रेस की मदद से, यह मेज़र किया जा सकता है कि आपके ऐप्लिकेशन को कोई खास टास्क या टास्क का सेट पूरा करने में कितना समय लगता है. उदाहरण के लिए, इमेज का सेट लोड करना या अपने डेटाबेस को क्वेरी करना.

कस्टम कोड ट्रेस के लिए डिफ़ॉल्ट मेट्रिक, "अवधि" होती है. यह ट्रेस के शुरू और खत्म होने के बीच का समय होता है. हालांकि, कस्टम मेट्रिक भी जोड़ी जा सकती हैं.

अपने कोड में, Performance Monitoring SDK टूल से मिले एपीआई का इस्तेमाल करके, कस्टम कोड ट्रेस की शुरुआत और खत्म होने का समय तय करें. Android ऐप्लिकेशन के लिए, @AddTrace एनोटेशन का इस्तेमाल करके, खास तरीकों की निगरानी भी की जा सकती है. कस्टम कोड ट्रेस को बनाने के बाद, कभी भी शुरू किया जा सकता है. साथ ही, ये थ्रेड सेफ़ होते हैं.

इन ट्रेस के लिए, डिफ़ॉल्ट मेट्रिक "अवधि" होती है. इसलिए, इन्हें कभी-कभी "अवधि के ट्रेस" भी कहा जाता है.

इन ट्रेस का डेटा, ट्रेस टेबल के कस्टम ट्रेस सबटैब में देखा जा सकता है. यह टेबल, परफ़ॉर्मेंस डैशबोर्ड में सबसे नीचे होती है. कंसोल इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, इस पेज पर बाद में पढ़ें.

ध्यान दें: बहुत तेज़ी से ट्रेस शुरू और बंद करने से, सिस्टम के संसाधनों पर काफ़ी असर पड़ सकता है. इसलिए, आपको ज़्यादा फ़्रीक्वेंसी पर कस्टम कोड ट्रेस नहीं बनाने चाहिए. उदाहरण के लिए, गेम में हर फ़्रेम में एक बार.

डिफ़ॉल्ट एट्रिब्यूट, कस्टम एट्रिब्यूट, और कस्टम मेट्रिक

कस्टम कोड ट्रेस के लिए, Performance Monitoring डिफ़ॉल्ट एट्रिब्यूट (जैसे कि ऐप्लिकेशन का वर्शन, देश, डिवाइस वगैरह) अपने-आप लॉग हो जाते हैं, ताकि Firebase कंसोल में ट्रेस के लिए डेटा को फ़िल्टर किया जा सके. कस्टम एट्रिब्यूट (जैसे कि गेम लेवल या उपयोगकर्ता प्रॉपर्टी) भी जोड़े और मॉनिटर किए जा सकते हैं.

परफ़ॉर्मेंस से जुड़े इवेंट के लिए, कस्टम कोड ट्रेस को और भी कॉन्फ़िगर किया जा सकता है. इससे, ट्रेस के स्कोप में होने वाले इवेंट के लिए कस्टम मेट्रिक रिकॉर्ड की जा सकती हैं. उदाहरण के लिए, कैश हिट और मिस की संख्या या यूज़र इंटरफ़ेस (यूआई) के कुछ समय के लिए काम न करने की संख्या के लिए, कस्टम मेट्रिक बनाई जा सकती है.

कस्टम एट्रिब्यूट और कस्टम मेट्रिक, Firebase कंसोल में दिखती हैं. ये ट्रेस के डिफ़ॉल्ट एट्रिब्यूट और डिफ़ॉल्ट मेट्रिक के साथ दिखती हैं.

एट्रिब्यूट एक स्ट्रिंग वैल्यू होती है. इससे आपको कंसोल में डेटा को फ़िल्टर और सेगमेंट करने में मदद मिलती है. मेट्रिक, एक संख्यात्मक वैल्यू होती है. इसे चार्ट में दिखाया जा सकता है और समय के साथ मेज़र किया जा सकता है.

कस्टम कोड ट्रेस जोड़ना

किसी ऐप्लिकेशन कोड को मॉनिटर करने के लिए, Performance Monitoring Trace API का इस्तेमाल करके, कस्टम कोड ट्रेस जोड़ें.

निम्न पर ध्यान दें:

• किसी ऐप्लिकेशन में, कस्टम कोड के कई ट्रेस हो सकते हैं.
• एक ही समय पर, एक से ज़्यादा कस्टम कोड ट्रेस चलाए जा सकते हैं.
• कस्टम कोड ट्रेस के नाम इन ज़रूरी शर्तों को पूरा करते हों: नाम की शुरुआत या आखिर में खाली सफ़ेद जगह न हो, नाम की शुरुआत में अंडरस्कोर (_) वर्ण न हो, और नाम की ज़्यादा से ज़्यादा लंबाई 100 वर्ण हो.
• कस्टम कोड ट्रेस में, कस्टम मेट्रिक और कस्टम एट्रिब्यूट जोड़ने की सुविधा मिलती है.

कस्टम कोड ट्रेस को शुरू और बंद करने के लिए, उस कोड को रैप करें जिसे आपको ट्रेस करना है. इसके लिए, यहां दिए गए कोड की तरह ही कोड की लाइनों का इस्तेमाल करें. इस उदाहरण में, कस्टम ट्रेस के नाम के तौर पर test_trace का इस्तेमाल किया गया है:

Kotlin

// 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()
MainActivity.kt

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();
MainActivity.java

(ज़रूरी नहीं) @AddTrace का इस्तेमाल करके, कुछ खास तरीकों को मॉनिटर करना

Android ऐप्लिकेशन में, कस्टम कोड ट्रेस को इंस्ट्रुमेंट करने के लिए @AddTrace एनोटेशन का इस्तेमाल किया जा सकता है. इस सुविधा का इस्तेमाल करके, ट्रेसिंग को तय किए गए तरीके की शुरुआत में शुरू किया जाता है. साथ ही, जब यह तरीका पूरा हो जाता है, तब इसे बंद कर दिया जाता है. इसमें तरीके से जुड़ी हर चीज़ शामिल होती है.

ध्यान दें: @AddTrace एनोटेशन का इस्तेमाल करके इंस्ट्रुमेंट किए गए कस्टम कोड ट्रेस के लिए, कस्टम मेट्रिक या कस्टम एट्रिब्यूट नहीं जोड़े जा सकते.

उदाहरण के लिए, onCreateTrace नाम का कस्टम कोड ट्रेस बनाया जा सकता है. यह कोड, onCreate() तरीके को कॉल किए जाने पर चलता है.

Kotlin

// 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)
}
MainActivity.kt

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);
}
MainActivity.java

कस्टम कोड ट्रेस में कस्टम मेट्रिक जोड़ना

कस्टम कोड ट्रेस में कस्टम मेट्रिक जोड़ने के लिए, Performance Monitoring Trace API का इस्तेमाल करें.

निम्न पर ध्यान दें:

• कस्टम मेट्रिक के नाम इन ज़रूरी शर्तों को पूरा करते हों: शुरुआत या आखिर में कोई खाली जगह न हो, शुरुआत में अंडरस्कोर (_) वर्ण न हो, और ज़्यादा से ज़्यादा 100 वर्ण हों.
• हर कस्टम कोड ट्रेस, ज़्यादा से ज़्यादा 32 मेट्रिक रिकॉर्ड कर सकता है. इनमें डिफ़ॉल्ट अवधि मेट्रिक भी शामिल है.

कस्टम मेट्रिक जोड़ने के लिए, इवेंट के हर बार होने पर, इस तरह का कोड जोड़ें. उदाहरण के लिए, यह कस्टम मेट्रिक आपके ऐप्लिकेशन में परफ़ॉर्मेंस से जुड़े इवेंट की गिनती करती है. जैसे, कैश हिट और मिस (item_cache_hit और item_cache_miss के उदाहरण इवेंट के नामों का इस्तेमाल करके और 1 की बढ़ोतरी).

Kotlin

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()
MainActivity.kt

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();
MainActivity.java

कस्टम कोड ट्रेस के लिए कस्टम एट्रिब्यूट बनाना

कस्टम कोड ट्रेस में कस्टम एट्रिब्यूट जोड़ने के लिए, Performance Monitoring Trace API का इस्तेमाल करें.

कस्टम एट्रिब्यूट का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन में ऐसा कोड जोड़ें जो एट्रिब्यूट को तय करता हो और उसे किसी कस्टम कोड ट्रेस से जोड़ता हो. ट्रेस शुरू होने और ट्रेस बंद होने के बीच, कस्टम एट्रिब्यूट को किसी भी समय सेट किया जा सकता है.

निम्न पर ध्यान दें:

• कस्टम एट्रिब्यूट के नाम इन शर्तों के मुताबिक होने चाहिए:

  • शुरुआत या आखिर में खाली सफ़ेद जगह नहीं होनी चाहिए. साथ ही, शुरुआत में अंडरस्कोर (_) वर्ण नहीं होना चाहिए
  • कोई स्पेस नहीं
  • ज़्यादा से ज़्यादा 32 वर्ण इस्तेमाल किए जा सकते हैं
  • नाम के लिए, A-Z, a-z, और _ वर्णों का इस्तेमाल किया जा सकता है.

• हर कस्टम कोड ट्रेस, ज़्यादा से ज़्यादा पांच कस्टम एट्रिब्यूट रिकॉर्ड कर सकता है.

• कृपया पक्का करें कि कस्टम एट्रिब्यूट में ऐसी कोई जानकारी शामिल न हो जिससे Google को किसी व्यक्ति की पहचान का पता चले.

  इस दिशा-निर्देश के बारे में ज़्यादा जानें

  उपयोगकर्ता का डेटा इकट्ठा करना: Performance Monitoring खुद व्यक्तिगत पहचान से जुड़ी कोई भी जानकारी इकट्ठा नहीं करता. जैसे, नाम, ईमेल पते या फ़ोन नंबर. डेवलपर, Performance Monitoring का इस्तेमाल करके अतिरिक्त डेटा इकट्ठा कर सकते हैं. इसके लिए, उन्हें कस्टम कोड ट्रेस पर कस्टम एट्रिब्यूट बनाने होंगे. Performance Monitoring के ज़रिए इकट्ठा किए गए इस तरह के डेटा में ऐसी जानकारी शामिल नहीं होनी चाहिए जिससे Google को किसी व्यक्ति की पहचान का पता चले.

  यहां एक ऐसे लॉग मैसेज का उदाहरण दिया गया है जिसमें व्यक्तिगत पहचान से जुड़ी जानकारी शामिल नहीं है:

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

  यहां एक ऐसा उदाहरण दिया गया है जिसमें व्यक्तिगत पहचान ज़ाहिर करने वाली जानकारी शामिल है. अपने ऐप्लिकेशन में इस तरह के कस्टम एट्रिब्यूट का इस्तेमाल न करें:

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

  अगर किसी डेटा से व्यक्तिगत पहचान से जुड़ी कोई भी जानकारी ज़ाहिर होती है, तो उसे बिना सूचना दिए मिटाया जा सकता है.

Kotlin

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
}
MainActivity.kt

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();
MainActivity.java

परफ़ॉर्मेंस डेटा को ट्रैक करना, देखना, और फ़िल्टर करना

अपने डैशबोर्ड में खास मेट्रिक ट्रैक करना

अपनी अहम मेट्रिक के रुझान के बारे में जानने के लिए, उन्हें परफ़ॉर्मेंस डैशबोर्ड में सबसे ऊपर मौजूद मेट्रिक बोर्ड में जोड़ें. हफ़्ते-दर-हफ़्ते होने वाले बदलावों को देखकर, रिग्रेशन की तुरंत पहचान की जा सकती है. इसके अलावा, यह पुष्टि की जा सकती है कि आपके कोड में हाल ही में किए गए बदलावों से परफ़ॉर्मेंस बेहतर हो रही है.

Firebase Performance Monitoring डैशबोर्ड" />

मेट्रिक बोर्ड में कोई मेट्रिक जोड़ने के लिए, यह तरीका अपनाएं:

1. Firebase कंसोल में, परफ़ॉर्मेंस डैशबोर्ड पर जाएं.
2. खाली मेट्रिक कार्ड पर क्लिक करें. इसके बाद, अपने बोर्ड में जोड़ने के लिए कोई मौजूदा मेट्रिक चुनें.
3. ज़्यादा विकल्पों के लिए, डेटा से भरे हुए मेट्रिक कार्ड पर पर क्लिक करें. उदाहरण के लिए, किसी मेट्रिक को बदलने या हटाने के लिए.

मेट्रिक बोर्ड में, समय के साथ इकट्ठा किया गया मेट्रिक डेटा दिखता है. यह डेटा, ग्राफ़ के साथ-साथ संख्यात्मक प्रतिशत बदलाव के तौर पर भी दिखता है.

डैशबोर्ड का इस्तेमाल करने के बारे में ज़्यादा जानें.

ट्रेस और उनका डेटा देखना

अपने ट्रेस देखने के लिए, Firebase कंसोल में परफ़ॉर्मेंस डैशबोर्ड पर जाएं. इसके बाद, नीचे की ओर स्क्रोल करके ट्रेस टेबल पर जाएं. फिर, सही सबटैब पर क्लिक करें. टेबल में, हर ट्रेस के लिए कुछ टॉप मेट्रिक दिखाई जाती हैं. साथ ही, किसी खास मेट्रिक के लिए, बदलाव के प्रतिशत के हिसाब से सूची को क्रम से लगाया जा सकता है.

Performance Monitoring कंसोल में, Firebase एक समस्या हल करने वाला पेज उपलब्ध कराता है. इस पेज पर मेट्रिक में हुए बदलावों को हाइलाइट किया जाता है. इससे, परफ़ॉर्मेंस से जुड़ी समस्याओं को तुरंत ठीक करना और आपके ऐप्लिकेशन और उपयोगकर्ताओं पर पड़ने वाले उनके असर को कम करना आसान हो जाता है. परफ़ॉर्मेंस से जुड़ी संभावित समस्याओं के बारे में जानने पर, समस्या हल करने वाले पेज का इस्तेमाल किया जा सकता है. उदाहरण के लिए, इन स्थितियों में:

• आपने डैशबोर्ड पर काम की मेट्रिक चुनी हैं और आपको उनमें बड़ा अंतर दिखता है.
• ट्रेस टेबल में, सबसे बड़े डेल्टा को सबसे ऊपर दिखाने के लिए क्रम से लगाएं. इसके बाद, आपको प्रतिशत में काफ़ी बदलाव दिखेगा.
• आपको परफ़ॉर्मेंस से जुड़ी समस्या की सूचना देने वाला ईमेल मिलता है.

समस्या हल करने वाले पेज को इन तरीकों से ऐक्सेस किया जा सकता है:

• मेट्रिक डैशबोर्ड पर, मेट्रिक की जानकारी देखें बटन पर क्लिक करें.
• किसी भी मेट्रिक कार्ड पर, => ब्यौरा देखें को चुनें. समस्या हल करने वाले पेज पर, चुनी गई मेट्रिक के बारे में जानकारी दिखती है.
• ट्रेस टेबल में, ट्रेस के नाम या उस ट्रेस से जुड़ी लाइन में मौजूद किसी भी मेट्रिक वैल्यू पर क्लिक करें.
• ईमेल से मिली सूचना में, अभी जांच करें पर क्लिक करें.

ट्रेस टेबल में किसी ट्रेस के नाम पर क्लिक करने पर, आपको अपनी पसंद की मेट्रिक के बारे में ज़्यादा जानकारी मिल सकती है. एट्रिब्यूट के हिसाब से डेटा फ़िल्टर करने के लिए, फ़िल्टर बटन पर क्लिक करें. उदाहरण के लिए:

Firebase Performance Monitoring के डेटा को एट्रिब्यूट के हिसाब से फ़िल्टर किया जा रहा है" />

• पिछली रिलीज़ या नई रिलीज़ के बारे में डेटा देखने के लिए, ऐप्लिकेशन वर्शन के हिसाब से फ़िल्टर करें
• डिवाइस के हिसाब से फ़िल्टर करके जानें कि पुराने डिवाइसों पर आपका ऐप्लिकेशन कैसे काम करता है
• देश के हिसाब से फ़िल्टर करें, ताकि यह पक्का किया जा सके कि आपके डेटाबेस की जगह की वजह से किसी खास क्षेत्र पर असर न पड़े

अपने ट्रेस के लिए डेटा देखने के बारे में ज़्यादा जानें.

अगले चरण

• परफ़ॉर्मेंस डेटा की जांच करने के लिए, एट्रिब्यूट इस्तेमाल करने के बारे में ज़्यादा जानें.

• Firebase कंसोल में परफ़ॉर्मेंस से जुड़ी समस्याओं को ट्रैक करने के तरीके के बारे में ज़्यादा जानें.

• सूचनाएं सेट अप करें, ताकि आपको कोड में होने वाले उन बदलावों के बारे में पता चल सके जिनसे आपके ऐप्लिकेशन की परफ़ॉर्मेंस खराब हो रही है. उदाहरण के लिए, अगर कस्टम कोड ट्रेस की अवधि, आपके सेट किए गए थ्रेशोल्ड से ज़्यादा हो जाती है, तो अपनी टीम के लिए ईमेल सूचना कॉन्फ़िगर की जा सकती है.

• उपयोगकर्ता सेशन की ज़्यादा जानकारी वाली रिपोर्ट देखें. इनमें आपको एक ही सेशन के दौरान इकट्ठा किए गए अन्य ट्रेस के टाइमलाइन कॉन्टेक्स्ट में कोई खास ट्रेस दिखेगा.