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

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

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

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

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

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

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

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

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

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

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

Performance Monitoring का इस्तेमाल करना Trace API का उपयोग करें.

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

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

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

// 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

// 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 एनोटेशन की सुविधा भी काम करती है. इस सुविधा का इस्तेमाल करने पर, ट्रेस की शुरुआत बताए गए तरीके की शुरुआत और विधि के पूरा होने पर रुक जाता है. इसमें ये शामिल हैं कुछ भी शुरू किया गया हो.

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

// 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

// 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 की बढ़ोतरी).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अगले चरण

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

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

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

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