यह मार्गदर्शिका बताती है कि फायरबेस क्रैशलाइटिक्स एसडीके का उपयोग करके अपनी क्रैश रिपोर्ट को कैसे अनुकूलित करें। डिफ़ॉल्ट रूप से, क्रैशलाइटिक्स स्वचालित रूप से आपके ऐप के सभी उपयोगकर्ताओं के लिए क्रैश रिपोर्ट एकत्र करता है (आप स्वचालित क्रैश रिपोर्टिंग को बंद कर सकते हैं और इसके बजाय अपने उपयोगकर्ताओं के लिए ऑप्ट-इन रिपोर्टिंग सक्षम कर सकते हैं )। क्रैशलिटिक्स बॉक्स से बाहर चार लॉगिंग तंत्र प्रदान करता है: कस्टम कुंजी , कस्टम लॉग , उपयोगकर्ता पहचानकर्ता , और पकड़े गए अपवाद ।
कस्टम कुंजियाँ जोड़ें
कस्टम कुंजियाँ आपके ऐप की क्रैश होने तक की विशिष्ट स्थिति जानने में आपकी सहायता करती हैं। आप अपनी क्रैश रिपोर्ट के साथ मनमाने ढंग से कुंजी/मान जोड़े को जोड़ सकते हैं, फिर फायरबेस कंसोल में क्रैश रिपोर्ट को खोजने और फ़िल्टर करने के लिए कस्टम कुंजियों का उपयोग कर सकते हैं।
- क्रैशलिटिक्स डैशबोर्ड में, आप कस्टम कुंजी से मेल खाने वाले मुद्दों की खोज कर सकते हैं।
- जब आप कंसोल में किसी विशिष्ट मुद्दे की समीक्षा कर रहे होते हैं, तो आप प्रत्येक ईवेंट के लिए संबंधित कस्टम कुंजियाँ ( कुंजियाँ उपटैब) देख सकते हैं और यहां तक कि कस्टम कुंजियों द्वारा ईवेंट को फ़िल्टर भी कर सकते हैं (पृष्ठ के शीर्ष पर फ़िल्टर मेनू)।
कुंजी/मूल्य जोड़े सेट करने के लिए 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];
कस्टम लॉग संदेश जोड़ें
दुर्घटना की ओर ले जाने वाली घटनाओं के बारे में स्वयं को अधिक संदर्भ देने के लिए, आप अपने ऐप में कस्टम क्रैशलिटिक्स लॉग जोड़ सकते हैं। क्रैशलाईटिक्स लॉग को आपके क्रैश डेटा के साथ जोड़ता है और उन्हें लॉग टैब के अंतर्गत फायरबेस कंसोल के क्रैशलाईटिक्स पृष्ठ में प्रदर्शित करता है।
तीव्र
समस्याओं का पता लगाने में सहायता के लिए 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:)
उपयोग करने के तरीके के बारे में अधिक जानकारी के लिए, क्रैशलाईटिक्स संदर्भ दस्तावेज़ देखें।
उद्देश्य सी
समस्याओं का पता लगाने में सहायता के लिए 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().setUserID("123456789")
उद्देश्य सी
[[FIRCrashlytics crashlytics] setUserID:@"123456789"];
यदि आपको किसी उपयोगकर्ता पहचानकर्ता को सेट करने के बाद उसे साफ़ करने की आवश्यकता हो, तो मान को एक रिक्त स्ट्रिंग पर रीसेट करें। उपयोगकर्ता पहचानकर्ता को साफ़ करने से मौजूदा क्रैशलिटिक्स रिकॉर्ड नहीं हटते। यदि आपको उपयोगकर्ता आईडी से जुड़े रिकॉर्ड हटाने की आवश्यकता है, तो फायरबेस समर्थन से संपर्क करें ।
ऑप्ट-इन रिपोर्टिंग सक्षम करें
डिफ़ॉल्ट रूप से, Crashlytics स्वचालित रूप से आपके ऐप के सभी उपयोगकर्ताओं के लिए क्रैश रिपोर्ट एकत्र करता है। उपयोगकर्ताओं को उनके द्वारा भेजे गए डेटा पर अधिक नियंत्रण देने के लिए, आप स्वचालित रिपोर्टिंग को अक्षम करके ऑप्ट-इन रिपोर्टिंग सक्षम कर सकते हैं और केवल तभी क्रैशलाईटिक्स को डेटा भेज सकते हैं जब आप अपने कोड में चुनते हैं:
अपनी
Info.plist
फ़ाइल में एक नई कुंजी जोड़कर स्वचालित संग्रह बंद करें:- कुंजी:
FirebaseCrashlyticsCollectionEnabled
- मान:
false
- कुंजी:
रनटाइम पर क्रैशलिटिक्स डेटा संग्रह ओवरराइड को कॉल करके चुनिंदा उपयोगकर्ताओं के लिए संग्रह सक्षम करें। ओवरराइड मान आपके ऐप के लॉन्च के दौरान बना रहता है इसलिए क्रैशलिटिक्स स्वचालित रूप से रिपोर्ट एकत्र कर सकता है।
स्वचालित क्रैश रिपोर्टिंग से बाहर निकलने के लिए, ओवरराइड मान के रूप में
false
पास करें। जबfalse
पर सेट किया जाता है, तो नया मान ऐप के अगले रन तक लागू नहीं होता है।तीव्र
Crashlytics.crashlytics().setCrashlyticsCollectionEnabled(true)
उद्देश्य सी
[[FIRCrashlytics crashlytics] setCrashlyticsCollectionEnabled:YES];
क्रैश इनसाइट डेटा प्रबंधित करें
क्रैश इनसाइट्स आपके अज्ञात स्टैक ट्रेस की तुलना अन्य फायरबेस ऐप्स के ट्रेस से करके आपको समस्याओं को हल करने में मदद करता है और आपको बताता है कि क्या आपकी समस्या एक बड़े रुझान का हिस्सा है। कई मुद्दों के लिए, क्रैश इनसाइट्स आपको क्रैश को डीबग करने में मदद करने के लिए संसाधन भी प्रदान करता है।
क्रैश इनसाइट्स सामान्य स्थिरता रुझानों की पहचान करने के लिए एकत्रित क्रैश डेटा का उपयोग करता है। यदि आप अपने ऐप का डेटा साझा नहीं करना चाहते हैं, तो आप फायरबेस कंसोल में अपनी क्रैशलिटिक्स समस्या सूची के शीर्ष पर क्रैश इनसाइट्स मेनू से क्रैश इनसाइट्स से ऑप्ट-आउट कर सकते हैं।