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


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

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

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

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

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

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

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

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

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

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

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

Performance Monitoring ट्रेस एपीआई का इस्तेमाल करना (स्विफ़्ट | ओबीजे-सी) का उपयोग करें.

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

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

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

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

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

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

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

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

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];

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

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

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

मेट्रिक बोर्ड की एक इमेज <span class=Firebase परफ़ॉर्मेंस मॉनिटर करने वाला डैशबोर्ड" />

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

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

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

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

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

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

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

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

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

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

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

<span class=Firebase की परफ़ॉर्मेंस मॉनिटर करने से जुड़ा डेटा, एट्रिब्यूट के हिसाब से फ़िल्टर किया जा रहा है />
  • किसी पिछली रिलीज़ या अपनी सबसे नई रिलीज़ का डेटा देखने के लिए, ऐप्लिकेशन के वर्शन के हिसाब से फ़िल्टर करें
  • डिवाइस के हिसाब से फ़िल्टर करके, यह जानें कि पुराने डिवाइस आपके ऐप्लिकेशन को कैसे हैंडल करते हैं
  • देश के हिसाब से फ़िल्टर करके, पक्का करें कि आपके डेटाबेस की जगह के किसी खास हिस्से पर असर न पड़ रहा हो प्रांत

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

अगले चरण

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