Catch up on highlights from Firebase at Google I/O 2023. Learn more

अपनी Firebase Crashlytics क्रैश रिपोर्ट कस्टमाइज़ करें

यह मार्गदर्शिका बताती है कि Firebase Crashlytics SDK का उपयोग करके अपनी क्रैश रिपोर्ट को कैसे अनुकूलित किया जाए। डिफ़ॉल्ट रूप से, Crashlytics आपके ऐप के सभी उपयोगकर्ताओं के लिए स्वचालित रूप से क्रैश रिपोर्ट एकत्र करता है (इसके बजाय आप स्वचालित क्रैश रिपोर्टिंग बंद कर सकते हैं और इसके बजाय अपने उपयोगकर्ताओं के लिए ऑप्ट-इन रिपोर्टिंग सक्षम कर सकते हैं )। Crashlytics बॉक्स से बाहर चार लॉगिंग तंत्र प्रदान करता है: कस्टम कुंजियाँ , कस्टम लॉग , उपयोगकर्ता पहचानकर्ता और पकड़े गए अपवाद

कस्टम कुंजियाँ जोड़ें

कस्टम कुंजियाँ आपको क्रैश होने तक आपके ऐप की विशिष्ट स्थिति प्राप्त करने में सहायता करती हैं। आप अपनी क्रैश रिपोर्ट के साथ मनमाना कुंजी/मान जोड़े जोड़ सकते हैं, फिर फायरबेस कंसोल में क्रैश रिपोर्ट खोजने और फ़िल्टर करने के लिए कस्टम कुंजियों का उपयोग करें।

  • Crashlytics डैशबोर्ड में, आप कस्टम कुंजी से मेल खाने वाली समस्याओं की खोज कर सकते हैं।
  • जब आप कंसोल में किसी विशिष्ट समस्या की समीक्षा कर रहे हों, तो आप प्रत्येक ईवेंट ( कुंजियाँ उपटैब) के लिए संबद्ध कस्टम कुंजियाँ देख सकते हैं और कस्टम कुंजियों द्वारा ईवेंट फ़िल्टर भी कर सकते हैं ( फ़िल्टर मेनू पृष्ठ के शीर्ष पर)।

कुंजी/मान जोड़े सेट करने के लिए setCustomValue विधि का उपयोग करें। उदाहरण के लिए:

तीव्र

// Set int_key to 100.
Crashlytics.crashlytics().setCustomValue(100, forKey: "int_key")

// Set str_key to "hello".
Crashlytics.crashlytics().setCustomValue("hello", forKey: "str_key")

उद्देश्य सी

पूर्णांक, बूलियन, या फ़्लोट्स सेट करते समय, मान को @( value ) के रूप में बॉक्स करें।

// Set int_key to 100.
[[FIRCrashlytics crashlytics] setCustomValue:@(100) forKey:@"int_key"];

// Set str_key to "hello".
[[FIRCrashlytics crashlytics] setCustomValue:@"hello" forKey:@"str_key"];

आप कुंजी को कॉल करके और इसे किसी भिन्न मान पर सेट करके किसी मौजूदा कुंजी के मान को संशोधित भी कर सकते हैं। उदाहरण के लिए:

तीव्र

Crashlytics.crashlytics().setCustomValue(100, forKey: "int_key")

// Set int_key to 50 from 100.
Crashlytics.crashlytics().setCustomValue(50, forKey: "int_key")

उद्देश्य सी

[[FIRCrashlytics crashlytics] setCustomValue:@(100) forKey:@"int_key"];

// Set int_key to 50 from 100.
[[FIRCrashlytics crashlytics] setCustomValue:@(50) forKey:@"int_key"];

केवल पैरामीटर के रूप में NSDictionary के साथ setCustomKeysAndValues ​​​​विधि का उपयोग कर थोक में कुंजी/मान जोड़े जोड़ें:

तीव्र

let keysAndValues = [
                 "string key" : "string value",
                 "string key 2" : "string value 2",
                 "boolean key" : true,
                 "boolean key 2" : false,
                 "float key" : 1.01,
                 "float key 2" : 2.02
                ] as [String : Any]

Crashlytics.crashlytics().setCustomKeysAndValues(keysAndValues)

उद्देश्य सी

NSDictionary *keysAndValues =
    @{@"string key" : @"string value",
      @"string key 2" : @"string value 2",
      @"boolean key" : @(YES),
      @"boolean key 2" : @(NO),
      @"float key" : @(1.01),
      @"float key 2" : @(2.02)};

[[FIRCrashlytics crashlytics] setCustomKeysAndValues: keysAndValues];

कस्टम लॉग संदेश जोड़ें

किसी क्रैश की ओर ले जाने वाली घटनाओं के लिए स्वयं को अधिक संदर्भ देने के लिए, आप अपने ऐप में कस्टम Crashlytics लॉग जोड़ सकते हैं। Crashlytics लॉग को आपके क्रैश डेटा के साथ संबद्ध करता है और उन्हें Firebase कंसोल के Crashlytics पृष्ठ में, Logs टैब के अंतर्गत प्रदर्शित करता है।

तीव्र

समस्याओं को इंगित करने में सहायता के लिए log() या log(format:, arguments:) उपयोग करें। यदि आप संदेशों के साथ एक उपयोगी लॉग आउटपुट प्राप्त करना चाहते हैं, तो आप जिस ऑब्जेक्ट को log() में पास करते हैं, वह CustomStringConvertible प्रॉपर्टी के अनुरूप होना चाहिए। log() आपके द्वारा ऑब्जेक्ट के लिए परिभाषित विवरण संपत्ति देता है। उदाहरण के लिए:

Crashlytics.crashlytics().log("Higgs-Boson detected! Bailing out…, \(attributesDict)")

.log(format:, arguments:) getVaList() कॉल करने से लौटाए गए मानों को स्वरूपित करता है। उदाहरण के लिए:

Crashlytics.crashlytics().log(format: "%@, %@", arguments: getVaList(["Higgs-Boson detected! Bailing out…", attributesDict]))

log() या log(format:, arguments:) उपयोग करने के तरीके के बारे में अधिक जानकारी के लिए, Crashlytics संदर्भ दस्तावेज़ देखें।

उद्देश्य सी

समस्याओं को इंगित करने में सहायता के लिए log या logWithFormat उपयोग करें। ध्यान दें कि यदि आप संदेशों के साथ एक उपयोगी लॉग आउटपुट प्राप्त करना चाहते हैं, तो आप जिस वस्तु को किसी भी विधि से पास करते हैं, उसे description उदाहरण गुण को ओवरराइड करना चाहिए। उदाहरण के लिए:

[[FIRCrashlytics crashlytics] log:@"Simple string message"];

[[FIRCrashlytics crashlytics] logWithFormat:@"Higgs-Boson detected! Bailing out... %@", attributesDict];

[[FIRCrashlytics crashlytics] logWithFormat:@"Logging a variable argument list %@" arguments:va_list_arg];

log और logWithFormat का उपयोग करने के तरीके के बारे में अधिक जानकारी के लिए Crashlytics संदर्भ दस्तावेज़ देखें।

उपयोगकर्ता पहचानकर्ता सेट करें

किसी समस्या का निदान करने के लिए, अक्सर यह जानना उपयोगी होता है कि आपके किन उपयोगकर्ताओं ने किसी दुर्घटना का अनुभव किया है. Crashlytics में आपकी क्रैश रिपोर्ट में गुमनाम रूप से उपयोगकर्ताओं की पहचान करने का एक तरीका शामिल है।

अपनी रिपोर्ट में उपयोगकर्ता आईडी जोड़ने के लिए, प्रत्येक उपयोगकर्ता को आईडी नंबर, टोकन या हैश मान के रूप में एक विशिष्ट पहचानकर्ता निर्दिष्ट करें:

तीव्र

Crashlytics.crashlytics().setUserID("123456789")

उद्देश्य सी

[[FIRCrashlytics crashlytics] setUserID:@"123456789"];

यदि आपको इसे सेट करने के बाद उपयोगकर्ता पहचानकर्ता को कभी भी साफ़ करने की आवश्यकता होती है, तो मान को रिक्त स्ट्रिंग पर रीसेट करें। उपयोगकर्ता पहचानकर्ता को साफ़ करने से मौजूदा Crashlytics रिकॉर्ड नहीं हटते हैं। यदि आप किसी उपयोगकर्ता आईडी से संबद्ध रिकॉर्ड हटाना चाहते हैं, तो Firebase समर्थन से संपर्क करें

ऑप्ट-इन रिपोर्टिंग सक्षम करें

डिफ़ॉल्ट रूप से, Crashlytics आपके ऐप के सभी उपयोगकर्ताओं के लिए स्वचालित रूप से क्रैश रिपोर्ट एकत्र करता है। उपयोगकर्ताओं को उनके द्वारा भेजे जाने वाले डेटा पर अधिक नियंत्रण देने के लिए, आप स्वचालित रिपोर्टिंग को अक्षम करके और केवल अपने कोड में चुनने पर Crashlytics को डेटा भेजकर ऑप्ट-इन रिपोर्टिंग को सक्षम कर सकते हैं:

  1. अपनी Info.plist फ़ाइल में एक नई कुंजी जोड़कर स्वचालित संग्रह बंद करें:

    • कुंजी: FirebaseCrashlyticsCollectionEnabled
    • मान: false
  2. रनटाइम पर Crashlytics डेटा संग्रह ओवरराइड को कॉल करके चुनिंदा उपयोगकर्ताओं के लिए संग्रह सक्षम करें। ओवरराइड वैल्यू आपके ऐप के लॉन्च के दौरान बनी रहती है, इसलिए Crashlytics स्वचालित रूप से रिपोर्ट एकत्र कर सकता है।

    स्वचालित क्रैश रिपोर्टिंग से ऑप्ट आउट करने के लिए, ओवरराइड मान के रूप में false पास करें। जब false पर सेट किया जाता है, तो नया मान ऐप के अगले रन तक लागू नहीं होता है।

    तीव्र

    Crashlytics.crashlytics().setCrashlyticsCollectionEnabled(true)

    उद्देश्य सी

    [[FIRCrashlytics crashlytics] setCrashlyticsCollectionEnabled:YES];

क्रैश इनसाइट्स डेटा प्रबंधित करें

क्रैश इनसाइट्स आपके अज्ञात स्टैक ट्रेस की तुलना अन्य फायरबेस ऐप के निशान से करके और आपको यह बताने में मदद करता है कि क्या आपकी समस्या एक बड़े रुझान का हिस्सा है। कई मुद्दों के लिए, क्रैश इनसाइट्स क्रैश को डीबग करने में आपकी सहायता के लिए संसाधन भी प्रदान करता है।

क्रैश इनसाइट्स सामान्य स्थिरता प्रवृत्तियों की पहचान करने के लिए समेकित क्रैश डेटा का उपयोग करता है। यदि आप अपने ऐप के डेटा को साझा नहीं करना चाहते हैं, तो आप Firebase कंसोल में अपनी Crashlytics समस्या सूची के शीर्ष पर Crash Insights मेनू से Crash Insights से ऑप्ट-आउट कर सकते हैं।