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

iOS+ Android वेब फ़्लटर

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

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

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

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

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

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

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

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

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

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

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

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

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

किसी खास ऐप्लिकेशन कोड को मॉनिटर करने के लिए, Performance Monitoring Trace API (Swift | Obj-C) का इस्तेमाल करके, कस्टम कोड ट्रेस जोड़ें.

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

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

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

Swift

ध्यान दें: 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()

Objective-C

ध्यान दें: 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 ट्रेस एपीआई का इस्तेमाल करना (स्विफ़्ट | ओबीजे-सी) का इस्तेमाल करें.

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

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

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

Swift

ध्यान दें: Firebase का यह प्रॉडक्ट, macOS, Mac Catalyst, और 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()

Objective-C

ध्यान दें: 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 Trace API (Swift | Obj-C) का इस्तेमाल करें.

कस्टम एट्रिब्यूट का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन में ऐसा कोड जोड़ें जो एट्रिब्यूट के बारे में बताता हो और इसे एक खास कस्टम कोड ट्रेस से जोड़ता है. आप एट्रिब्यूट का इस्तेमाल करें.

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

• कस्टम एट्रिब्यूट के नाम नीचे दी गई ज़रूरी शर्तों के मुताबिक होने चाहिए:

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

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

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

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

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

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

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

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

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

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

Swift

ध्यान दें: 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;

Objective-C

ध्यान दें: 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];

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

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

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

Firebase परफ़ॉर्मेंस मॉनिटरिंग डैशबोर्ड" />

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

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

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

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

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

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

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

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

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

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

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

Firebase की परफ़ॉर्मेंस मॉनिटर करने से जुड़ा डेटा, एट्रिब्यूट के हिसाब से फ़िल्टर किया जा रहा है />

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

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

अगले चरण

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

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

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

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