Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

Crashlytics को, ऐसे अपवादों की रिपोर्ट करें जिन्हें हैंडल नहीं किया गया है और ऐसे अपवादों की रिपोर्ट करें जिन्हें हैंडल किया गया है .
अपने ऐप्लिकेशन को इंस्ट्रूमेंट करें, ताकि कस्टम कुंजियां, कस्टम लॉग मैसेज, और यूज़र आइडेंटिफ़ायर लॉग किए जा सकें.
अगर आपका ऐप्लिकेशन, Firebase SDK टूल का इस्तेमाल करता है, तो ब्रेडक्रंब लॉग अपने-आप मिल जाते हैं.Google Analytics इन लॉग से आपको यह पता चलता है कि आपके ऐप्लिकेशन में, 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, आपके ऐप्लिकेशन के क्रैश होने की रिपोर्ट अपने-आप जनरेट करता है. इसके अलावा, Crashlytics lets यह क्रैश न होने से जुड़े अपवादों को भी रिकॉर्ड करता है और उन्हें अगली बार क्रैश की रिपोर्ट जनरेट होने पर या ऐप्लिकेशन रीस्टार्ट होने पर भेजता है.

अपने ऐप्लिकेशन के कैच ब्लॉक में, क्रैश न होने से जुड़े अपवादों को रिकॉर्ड करने के लिए, 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 आपके ऐप्लिकेशन में गड़बड़ियों की रिपोर्टिंग को सीमित कर सकता है.

ये अपवाद, DevOps & Engagement > Crashlytics डैशबोर्ड में, क्रैश न होने से जुड़ी समस्याओं के तौर पर दिखते हैं.Firebase समस्या की खास जानकारी में, आपको आम तौर पर क्रैश से मिलने वाली सभी स्टेट की जानकारी मिलती है. इसके अलावा, वर्शन और हार्डवेयर डिवाइस के हिसाब से भी जानकारी मिलती है.

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

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

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

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

की-वैल्यू पेयर सेट करने के लिए, 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 कंसोल के DevOps & Engagement > Crashlytics डैशबोर्ड पर जाएं.

Crashlytics

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

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

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

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

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

FirebaseCrashlytics.instance.setUserIdentifier("12345");

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

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

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

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

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

ध्यान दें कि आप डेटा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 डेटा कलेक्शन को बदलने की सुविधा का इस्तेमाल करके, चुनिंदा उपयोगकर्ताओं के लिए डेटा कलेक्शन की सुविधा चालू करें. बदली गई वैल्यू, आपके ऐप्लिकेशन के सभी लॉन्च के दौरान बनी रहती है. इसलिए, Crashlytics उस उपयोगकर्ता के लिए, रिपोर्ट अपने-आप इकट्ठा कर सकता है.
```
FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(true);
```
अगर उपयोगकर्ता बाद में डेटा कलेक्शन से ऑप्ट-आउट करता है, तो बदली गई वैल्यू के तौर पर false पास किया जा सकता है. यह वैल्यू, उपयोगकर्ता के अगली बार ऐप्लिकेशन लॉन्च करने पर लागू होगी. साथ ही, उस उपयोगकर्ता के लिए, सभी लॉन्च के दौरान बनी रहेगी.

Crash Insights के डेटा को मैनेज करना

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

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

अगले चरण

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