Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

प्लैटफ़ॉर्म चुनें:

iOS+ Android Flutter Unity

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

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

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

गड़बड़ियों की शिकायत करना

पहचानी और मैनेज नहीं की गई गड़बड़ियों की शिकायत करना

FlutterError.onError को FirebaseCrashlytics.instance.recordFlutterFatalError से बदलकर, Flutter फ़्रेमवर्क में होने वाली सभी "गंभीर" गड़बड़ियों को अपने-आप पकड़ा जा सकता है. वैकल्पिक रूप से, "नुकसान न पहुंचाने वाली गड़बड़ी" अपवादों को भी पकड़ने के लिए, FlutterError.onError को FirebaseCrashlytics.instance.recordFlutterError से बदलें:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Firebase.initializeApp();
  bool weWantFatalErrorRecording = true;
  FlutterError.onError = (errorDetails) {
    if(weWantFatalErrorRecording){
      FirebaseCrashlytics.instance.recordFlutterFatalError(errorDetails);
    } else {
      FirebaseCrashlytics.instance.recordFlutterError(errorDetails);
    }
  };

  runApp(MyApp());
}

एसिंक्रोनस गड़बड़ियां

एसिंक्रोनस गड़बड़ियों को Flutter फ़्रेमवर्क से नहीं पकड़ा जाता:

ElevatedButton(
  onPressed: () async {
    throw Error();
  }
  ...
)

इस तरह की गड़बड़ियों का पता लगाने के लिए, PlatformDispatcher.instance.onError हैंडलर का इस्तेमाल किया जा सकता है:

Future<void> main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp();
    FlutterError.onError = (errorDetails) {
      FirebaseCrashlytics.instance.recordFlutterFatalError(errorDetails);
    };
    // Pass all uncaught asynchronous errors that aren't handled by the Flutter framework to Crashlytics
    PlatformDispatcher.instance.onError = (error, stack) {
      FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
      return true;
    };
    runApp(MyApp());

}

Flutter के बाहर की गड़बड़ियां

Flutter कॉन्टेक्स्ट से बाहर होने वाली गड़बड़ियों का पता लगाने के लिए, मौजूदा Isolate पर गड़बड़ी सुनने वाला प्रोग्राम इंस्टॉल करें:

Isolate.current.addErrorListener(RawReceivePort((pair) async {
  final List<dynamic> errorAndStacktrace = pair;
  await FirebaseCrashlytics.instance.recordError(
    errorAndStacktrace.first,
    errorAndStacktrace.last,
    fatal: true,
  );
}).sendPort);

अपवादों की रिपोर्ट करें

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

अपने ऐप्लिकेशन के कैच ब्लॉक में, नुकसान न पहुंचाने वाली गड़बड़ी अपवादों को रिकॉर्ड करने के लिए, recordError तरीके का इस्तेमाल करें. उदाहरण के लिए:

await FirebaseCrashlytics.instance.recordError(
  error,
  stackTrace,
  reason: 'a non-fatal error'
);

// Or you can use:
await FirebaseCrashlytics.instance.recordFlutterError(errorDetails);

गड़बड़ी के बारे में ज़्यादा जानकारी लॉग करने के लिए, information प्रॉपर्टी का इस्तेमाल करें:

await FirebaseCrashlytics.instance.recordError(
  error,
  stackTrace,
  reason: 'a non-fatal error',
  information: ['further diagnostic information about the error', 'version 2.0'],
);

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

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

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

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

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

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

की-वैल्यू पेयर सेट करने के लिए, setCustomKey इंस्टेंस के तरीके का इस्तेमाल करें. यहाँ कुछ उदाहरण दिए गए हैं:

// Set a key to a string.
FirebaseCrashlytics.instance.setCustomKey('str_key', 'hello');

// Set a key to a boolean.
FirebaseCrashlytics.instance.setCustomKey("bool_key", true);

// Set a key to an int.
FirebaseCrashlytics.instance.setCustomKey("int_key", 1);

// Set a key to a long.
FirebaseCrashlytics.instance.setCustomKey("int_key", 1L);

// Set a key to a float.
FirebaseCrashlytics.instance.setCustomKey("float_key", 1.0f);

// Set a key to a double.
FirebaseCrashlytics.instance.setCustomKey("double_key", 1.0);

पसंद के मुताबिक लॉग मैसेज जोड़ना

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

समस्याओं का पता लगाने के लिए, log का इस्तेमाल करें. उदाहरण के लिए:

FirebaseCrashlytics.instance.log("Higgs-Boson detected! Bailing out");

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

किसी समस्या का पता लगाने के लिए, यह जानना ज़रूरी होता है कि आपके किन उपयोगकर्ताओं को क्रैश की समस्या का सामना करना पड़ा. Crashlytics में, क्रैश रिपोर्ट में उपयोगकर्ताओं की पहचान को छिपाने का एक तरीका शामिल है.

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

FirebaseCrashlytics.instance.setUserIdentifier("12345");

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

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

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

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

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

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

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

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

डेटा अपने-आप इकट्ठा होने की सुविधा को बंद करने के लिए:

Apple के प्लैटफ़ॉर्म

अपनी Info.plist फ़ाइल में नई कुंजी जोड़ें:
- बटन: FirebaseCrashlyticsCollectionEnabled
- वैल्यू: false
Android

अपनी AndroidManifest.xml फ़ाइल के application ब्लॉक में, अपने-आप डेटा इकट्ठा होने की सुविधा बंद करने के लिए, meta-data टैग जोड़ें:
```
<meta-data
    android:name="firebase_crashlytics_collection_enabled"
    android:value="false" />
```
रनटाइम के दौरान, Crashlytics data collection override को कॉल करके, चुने गए उपयोगकर्ताओं के लिए डेटा कलेक्शन की सुविधा चालू करें. बदली गई वैल्यू, आपके ऐप्लिकेशन के सभी लॉन्च के दौरान बनी रहती है. इससे Crashlytics उस उपयोगकर्ता के लिए रिपोर्ट अपने-आप इकट्ठा कर सकता है.
```
FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(true);
```
अगर उपयोगकर्ता बाद में डेटा कलेक्शन से ऑप्ट-आउट करता है, तो false को ओवरराइड वैल्यू के तौर पर पास किया जा सकता है. यह वैल्यू, उपयोगकर्ता के अगली बार ऐप्लिकेशन लॉन्च करने पर लागू होगी. साथ ही, उपयोगकर्ता के लिए ऐप्लिकेशन के सभी बाद के लॉन्च पर बनी रहेगी.

क्रैश की अहम जानकारी का डेटा मैनेज करना

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

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

अगले चरण

अपने डेटा को BigQuery या Cloud Logging में एक्सपोर्ट करें, ताकि आपको बेहतर विश्लेषण और सुविधाएं मिल सकें. जैसे, अपने डेटा के बारे में क्वेरी करना, कस्टम डैशबोर्ड बनाना, और कस्टम अलर्ट सेट अप करना.