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


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

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

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

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

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

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

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

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

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

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

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

Performance Monitoring का इस्तेमाल करना Trace 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 का इस्तेमाल करके, खास तरीकों पर नज़र रखना

Android ऐप्लिकेशन @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);
}

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

Performance Monitoring का इस्तेमाल करना Trace 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();

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

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है Performance Monitoring का इस्तेमाल करें ट्रेस एपीआई का इस्तेमाल करें.

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

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

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

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

  • कृपया पक्का करें कि कस्टम एट्रिब्यूट में ऐसी कोई जानकारी न हो जो 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();

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अगले चरण

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