Unity के लिए क्रैश रिपोर्ट को पसंद के मुताबिक बनाना

किसी समस्या के बारे में ज़्यादा जानकारी पाने के लिए, DevOps और ऑडियंस की दिलचस्पी > Crashlytics डैशबोर्ड में जाकर, उस समस्या पर क्लिक करें. इससे आपको इवेंट की ज़्यादा जानकारी वाली रिपोर्ट मिलेगी.Firebase इन रिपोर्ट को अपनी ज़रूरत के हिसाब से बनाया जा सकता है. इससे आपको यह बेहतर ढंग से समझने में मदद मिलती है कि आपके ऐप्लिकेशन में क्या हो रहा है और इवेंट किन वजहों से हुए जिनकी रिपोर्ट Crashlytics को दी गई है.

• Crashlytics को, पकड़ी गई गड़बड़ियों और न पकड़ी गई गड़बड़ियों की रिपोर्ट करें.

• मेमोरी में गड़बड़ी की समस्याओं को डीबग करने के लिए, GWP-ASan की रिपोर्ट शामिल करें.

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

• अगर आपका ऐप्लिकेशन, Firebase SDK टूल का इस्तेमाल करता है, तो आपको ब्रेडक्रंब लॉग अपने-आप मिल जाएंगे Google Analytics. इन लॉग से आपको यह पता चलता है कि आपके ऐप्लिकेशन में, Crashlytics से इकट्ठा किए गए इवेंट से पहले, उपयोगकर्ता ने कौनसी कार्रवाइयां की थीं.

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

गड़बड़ियों की रिपोर्ट करना

पकड़ी गई गड़बड़ियों की रिपोर्ट करना

अगर आपको पता है कि गड़बड़ियां हो सकती हैं, तो Crashlytics SDK टूल को नॉन-फ़ेटल इवेंट के तौर पर उनकी रिपोर्ट करने के लिए सेट किया जा सकता है. इन इवेंट को डिवाइस पर लॉग किया जाता है. इसके बाद, इन्हें अगले फ़ेटल इवेंट की रिपोर्ट के साथ भेजा जाता है. इसके अलावा, इन्हें तब भी भेजा जाता है, जब एंड-यूज़र गेम को रीस्टार्ट करता है.

C# में गड़बड़ियों को लॉग करने के लिए, इस तरीके का इस्तेमाल करें:

Crashlytics.LogException(Exception ex);

अपने गेम के try/catch ब्लॉक में, संभावित गड़बड़ियों को लॉग किया जा सकता है:

try {
    myMethodThatThrows();
} catch (Exception e) {
   Crashlytics.LogException(e);
   // handle your exception here!
}

न पकड़ी गई गड़बड़ियों की रिपोर्ट करना

न पकड़ी गई गड़बड़ियों की वजह से, अगर आपका गेम क्रैश नहीं होता है (उदाहरण के लिए, गेम लॉजिक में C# की न पकड़ी गई गड़बड़ियां), तो Crashlytics SDK टूल को फ़ेटल इवेंट के तौर पर उनकी रिपोर्ट करने के लिए सेट किया जा सकता है. इसके लिए, आपको अपने Unity प्रोजेक्ट में Crashlytics को शुरू करते समय, Crashlytics.ReportUncaughtExceptionsAsFatal प्रॉपर्टी को true पर सेट करना होगा. इन इवेंट की रिपोर्ट, Crashlytics को रीयल टाइम में की जाती है. इसके लिए, एंड-यूज़र को गेम रीस्टार्ट करने की ज़रूरत नहीं होती.

न पकड़ी गई इन गड़बड़ियों को फ़ेटल इवेंट के तौर पर रिपोर्ट करने का मतलब है कि इन्हें, क्रैश न होने वाले उपयोगकर्ताओं के आंकड़ों और वेलोसिटी अलर्ट में गिना जाएगा.

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

void Start() {
    // Since there is no try-block surrounding this call, if an exception is thrown,
    // it is considered unexpected.
    // Setting `Crashlytics.ReportUncaughtExceptionsAsFatal = true`
    // will ensure that such cases are reported as fatals.
    thirdPartyMethodThatMayThrow();
}

मेमोरी में गड़बड़ी की समस्याओं को डीबग करने के लिए, GWP-ASan की रिपोर्ट शामिल करना

IL2CPP का इस्तेमाल करने वाले Android ऐप्लिकेशन के लिए, Crashlytics नेटिव मेमोरी में होने वाली गड़बड़ियों की वजह से होने वाले क्रैश को डीबग करने में आपकी मदद कर सकता है. इसके लिए, वह GWP-ASan की रिपोर्ट इकट्ठा करता है. मेमोरी से जुड़ी इन गड़बड़ियों की वजह से, आपके ऐप्लिकेशन में मेमोरी करप्ट हो सकती है. यह ऐप्लिकेशन की सुरक्षा से जुड़े जोखिमों की मुख्य वजह है.

Firebase कंसोल के DevOps और ऑडियंस की दिलचस्पी > Crashlytics डैशबोर्ड में, इस डेटा के साथ ये काम किए जा सकते हैं:

• किसी समस्या की ज़्यादा जानकारी पर क्लिक करने पर, इस डेटा को "मेमोरी स्टैक ट्रेस" नाम के नए टैब में देखा जा सकता है.

• इस डेटा से जुड़ी सभी समस्याओं को तुरंत देखने के लिए, "GWP-ASan की रिपोर्ट" नाम के नए सिग्नल और फ़िल्टर का इस्तेमाल किया जा सकता है.

अगर आपका ऐप्लिकेशन, Unity के लिए Crashlytics SDK टूल के नए वर्शन (v10.7.0+) का इस्तेमाल करता है और उसमें GWP-ASan की सुविधा साफ़ तौर पर चालू है, तो आपको GWP-ASan की मेमोरी रिपोर्ट मिल सकती हैं. इसके लिए, आपको अपने Android ऐप्लिकेशन के मेनिफ़ेस्ट में बदलाव करना होगा. अगर आपके ऐप्लिकेशन में C++ का कोई कोड है, तो Android के दस्तावेज़ में दिए गए नेटिव कोड के उदाहरण का इस्तेमाल करके, GWP-ASan के सेटअप की जांच की जा सकती है.

कस्टम बटन जोड़ना

कस्टम बटन की मदद से, क्रैश होने से पहले आपके ऐप्लिकेशन की खास स्थिति के बारे में पता चलता है. क्रैश होने की रिपोर्ट के साथ, अपनी पसंद के मुताबिक की-वैल्यू पेयर जोड़े जा सकते हैं. इसके बाद, क्रैश होने की रिपोर्ट को खोजने और फ़िल्टर करने के लिए, कस्टम बटन का इस्तेमाल किया जा सकता है. DevOps और ऑडियंस की दिलचस्पी > Crashlytics डैशबोर्ड में, Firebase कंसोल.

• कस्टम बटन से मेल खाने वाली समस्याओं को खोजा जा सकता है.

• कंसोल में किसी समस्या की समीक्षा करते समय, हर इवेंट के लिए उससे जुड़े कस्टम बटन (बटन सबटैब) देखे जा सकते हैं. साथ ही, पेज में सबसे ऊपर मौजूद फ़िल्टर मेन्यू में जाकर, इवेंट को कस्टम बटन के हिसाब से फ़िल्टर भी किया जा सकता है.

मौजूदा बटन के लिए नई वैल्यू, कई बार कॉल करने पर अपडेट हो जाएंगी. साथ ही, क्रैश रिकॉर्ड होने पर, सिर्फ़ सबसे नई वैल्यू कैप्चर की जाएगी.

Crashlytics.SetCustomKey(string key, string value);

कस्टम लॉग मैसेज जोड़ना

क्रैश होने से पहले के इवेंट के बारे में ज़्यादा जानकारी पाने के लिए, अपने ऐप्लिकेशन में कस्टम Crashlytics लॉग जोड़े जा सकते हैं. Crashlytics लॉग को क्रैश के डेटा से जोड़ता है और किसी समस्या की ज़्यादा जानकारी देखते समय, उन्हें लॉग टैब में दिखाता है. Firebase कंसोल के DevOps और ऑडियंस की दिलचस्पी > Crashlytics डैशबोर्ड में, अपनी सभी समस्याएं देखी जा सकती हैं.

Crashlytics.Log(string message);

यूज़र आइडेंटिफ़ायर सेट करना

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

Crashlytics.SetUserId(string identifier);

ब्रेडक्रंब लॉग पाना

ब्रेडक्रंब लॉग से आपको यह बेहतर ढंग से समझने में मदद मिलती है कि क्रैश, नुकसान न पहुंचाने वाली गड़बड़ी या एएनआर इवेंट से पहले, उपयोगकर्ता ने आपके ऐप्लिकेशन के साथ कौनसे इंटरैक्शन किए थे. किसी समस्या को रीक्रिएट और डीबग करने की कोशिश करते समय, ये लॉग काम आ सकते हैं.

ब्रेडक्रंब लॉग, Google Analytics की मदद से जनरेट होते हैं. इसलिए, ब्रेडक्रंब लॉग पाने के लिए, आपको अपने Firebase प्रोजेक्ट के लिए Google Analytics चालू करना होगा. साथ ही, अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल जोड़ना होगा. इन ज़रूरी शर्तों को पूरा करने के बाद, किसी समस्या की ज़्यादा जानकारी देखते समय, ब्रेडक्रंब लॉग अपने-आप **लॉग** टैब में शामिल हो जाते हैं. Firebase कंसोल के **DevOps और ऑडियंस की दिलचस्पी** > **Crashlytics** डैशबोर्ड में, अपनी सभी समस्याएं देखी जा सकती हैं.Google AnalyticsCrashlyticsFirebase

Analytics SDK टूल, screen_view इवेंट को अपने-आप लॉग करता है. इससे ब्रेडक्रंब लॉग में, क्रैश, नुकसान न पहुंचाने वाली गड़बड़ी या एएनआर इवेंट से पहले देखी गई स्क्रीन की सूची दिखती है. screen_view ब्रेडक्रंब लॉग में, firebase_screen_class पैरामीटर होता है.

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

ध्यान दें कि डेटाGoogle Analytics को इकट्ठा करने और इस्तेमाल करने की प्रोसेस को कंट्रोल किया जा सकता है, इसमें, ब्रेडक्रंब लॉग में शामिल डेटा भी शामिल है.

ऑप्ट-इन रिपोर्टिंग की सुविधा चालू करना

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

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

Crashlytics.IsCrashlyticsCollectionEnabled = true

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

क्रैश इनसाइट के डेटा को मैनेज करना

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

क्रैश इनसाइट, स्थिरता से जुड़े सामान्य ट्रेंड की पहचान करने के लिए, क्रैश के एग्रीगेट किए गए डेटा का इस्तेमाल करता है. अगर आपको अपने ऐप्लिकेशन का डेटा शेयर नहीं करना है, तो Firebase कंसोल के DevOps और जुड़ाव > Crashlytics डैशबोर्ड में, समस्याओं की सूची में सबसे ऊपर मौजूद क्रैश अहम जानकारी मेन्यू में जाकर, क्रैश अहम जानकारी से बाहर हुआ जा सकता है.

अगले चरण

• अपने डेटा को BigQuery या Cloud Logging में एक्सपोर्ट करें, ताकि उसे गहराई से समझा जा सके और डेटा को क्वेरी करने, कस्टम डैशबोर्ड बनाने, और कस्टम अलर्ट सेट अप करने जैसी सुविधाओं का इस्तेमाल किया जा सके.