| প্ল্যাটফর্ম বেছে নিন: | iOS+ Android ওয়েব Flutter Unity |
আপনি কোনও সমস্যার উপর ক্লিক করে Firebase কনসোলের DevOps ও এনগেজমেন্ট > Crashlytics ড্যাশবোর্ড থেকে ইভেন্টের বিস্তারিত রিপোর্ট পেতে পারেন। আপনার অ্যাপে কী ঘটছে এবং Crashlytics-এ রিপোর্ট করা ইভেন্টের আশেপাশের পরিস্থিতি আরও ভালোভাবে বুঝতে আপনাকে সাহায্য করার জন্য আপনি সেইসব রিপোর্ট কাস্টমাইজ করতে পারেন।
Crashlytics-এ ধরা পড়া ব্যতিক্রম এবং ধরা না পড়া ব্যতিক্রম সম্পর্কে রিপোর্ট করুন।
মেমরি করাপশন সংক্রান্ত সমস্যা ডিবাগ করতে GWP-ASan রিপোর্ট অন্তর্ভুক্ত করুন।
কাস্টম কী, কাস্টম লগ মেসেজ এবং ইউজার আইডেন্টিফায়ার লগ করার জন্য আপনার অ্যাপকে ইনস্ট্রুমেন্ট করুন।
আপনার অ্যাপ Google Analytics-এর জন্য Firebase SDK ব্যবহার করলে, অটোমেটিক ব্রেডক্রাম্ব লগ পান। এইসব লগ আপনাকে ব্যবহারকারীর অ্যাক্টিভিটি সম্পর্কে তথ্য দেয় যার ফলে আপনার অ্যাপে 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-কে সেগুলি
মারাত্মক ইভেন্ট হিসেবে রিপোর্ট করতে বলতে পারেন। এর জন্য আপনাকে
Crashlytics.ReportUncaughtExceptionsAsFatal প্রপার্টি true-এ সেট করতে হবে, যেখানে আপনি
আপনার Unity প্রোজেক্টে Crashlytics ইনিশিয়ালাইজ করেন
।
এইসব ইভেন্ট রিয়েল-টাইমে 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 সেট-আপ পরীক্ষা করতে পারবেন।
কাস্টম 'কী' যোগ করুন
কাস্টম কী আপনাকে ক্র্যাশ হওয়ার আগে আপনার অ্যাপের নির্দিষ্ট অবস্থা জানতে সাহায্য করে। আপনি ক্র্যাশ রিপোর্টের সাথে ইচ্ছামতো কী-ভ্যালু পেয়ার যোগ করতে পারবেন, তারপর Firebase কনসোলের DevOps ও এনগেজমেন্ট > Crashlytics ড্যাশবোর্ড থেকে ক্র্যাশ রিপোর্ট সার্চ ও ফিল্টার করতে কাস্টম কী ব্যবহার করতে পারবেন।
আপনি কাস্টম 'কী'-এর সাথে ম্যাচ করে এমন সমস্যা সার্চ করতে পারবেন।
কনসোলে কোনও নির্দিষ্ট সমস্যা পর্যালোচনা করার সময়, আপনি প্রতিটি ইভেন্টের জন্য সংশ্লিষ্ট কাস্টম 'কী' (কী সাবট্যাব) দেখতে এবং এমনকি কাস্টম 'কী' (পৃষ্ঠার সবচেয়ে উপরে ফিল্টার মেনু) অনুসারে ইভেন্ট ফিল্টার করতে পারবেন।
একাধিকবার কল করা হলে, আগে থেকে থাকা 'কী'-এর নতুন ভ্যালু, ভ্যালু আপডেট করবে, এবং ক্র্যাশ রেকর্ড করা হলে শুধুমাত্র সবচেয়ে সাম্প্রতিক ভ্যালু ক্যাপচার করা হয়।
Crashlytics.SetCustomKey(string key, string value);
কাস্টম লগ মেসেজ যোগ করুন
ক্র্যাশ হওয়ার আগে কী কী ঘটনা ঘটেছে সেই সম্পর্কে আরও তথ্য পেতে, আপনি অ্যাপে কাস্টম Crashlytics লগ যোগ করতে পারেন। Crashlytics আপনার ক্র্যাশ ডেটার সাথে লগ অ্যাসোসিয়েট করে এবং আপনি কোনও সমস্যার বিবরণ দেখার সময় লগ ট্যাবে সেগুলি দেখায় (Firebase কনসোলের DevOps ও এনগেজমেন্ট > Crashlytics ড্যাশবোর্ড থেকে আপনার সব সমস্যা দেখুন)।
Crashlytics.Log(string message);
ইউজার আইডেন্টিফায়ার সেট করা
আপনি কোনও আইডি নম্বর, টোকেন বা হ্যাশ ভ্যালু ব্যবহার করে আপনার অ্যাপ্লিকেশনের ব্যবহারকারীকে অনন্যভাবে শনাক্ত করতে পারেন, এতে তাদের কোনও ব্যক্তিগত তথ্য প্রকাশ বা ট্রান্সমিট করতে হয় না। এছাড়াও, আপনি ভ্যালু ফাঁকা স্ট্রিংয়ে সেট করে তা মুছে দিতে পারেন। Firebase কনসোলের DevOps ও এনগেজমেন্ট > Crashlytics ড্যাশবোর্ডে কোনও নির্দিষ্ট ক্র্যাশ দেখার সময় এই ভ্যালু দেখানো হয়।
Crashlytics.SetUserId(string identifier);
ব্রেডক্রাম্ব লগ পান
ব্রেডক্রাম্ব লগ আপনাকে ক্র্যাশ, মারাত্মক নয় এমন বা ANR ইভেন্টের আগে আপনার অ্যাপের সাথে ব্যবহারকারীর ইন্টার্যাকশন সম্পর্কে আরও ভালভাবে বুঝতে সাহায্য করে। কোনও সমস্যা ডিবাগ ও সমাধান করার সময় এই লগগুলি সহায়ক হতে পারে।
ব্রেডক্রাম্ব লগ Google Analytics দ্বারা পরিচালিত হয়, তাই ব্রেডক্রাম্ব লগ পেতে, আপনাকে Firebase প্রোজেক্টের জন্য Google Analytics চালু করতে হবে এবং আপনার অ্যাপে Google Analytics-এর জন্য Firebase SDK যোগ করতে হবে। এইসব প্রয়োজনীয়তা পূরণ হয়ে গেলে, আপনি কোনও সমস্যার বিবরণ দেখার সময় (Firebase কনসোলের DevOps ও এনগেজমেন্ট > Crashlytics ড্যাশবোর্ডে আপনার সব সমস্যা দেখুন) লগ ট্যাবের মধ্যে ইভেন্টের ডেটার সাথে ব্রেডক্রাম্ব লগ অটোমেটিক অন্তর্ভুক্ত হয়ে যায়।
Analytics SDK
অটোমেটিক screen_view ইভেন্ট লগ করে
যা ক্র্যাশ, নন-ফেটাল বা ANR ইভেন্টের আগে দেখা স্ক্রিনের তালিকা দেখানোর জন্য ব্রেডক্রাম্ব লগ চালু করে। screen_view ব্রেডক্রাম্ব লগে
firebase_screen_class প্যারামিটার থাকে।
ব্রেডক্রাম্ব লগে যেকোনও কাস্টম ইভেন্টও থাকে যা আপনি ব্যবহারকারীর সেশনে ম্যানুয়ালি লগ করেন, এর মধ্যে ইভেন্টের প্যারামিটার ডেটাও থাকে। এই ডেটা ক্র্যাশ, মারাত্মক নয় এমন বা ANR ইভেন্ট পর্যন্ত ব্যবহারকারীর অ্যাকশনের সিরিজ দেখাতে সাহায্য করতে পারে।
মনে রাখবেন যে আপনি Google Analytics ডেটার সংগ্রহ ও ব্যবহার নিয়ন্ত্রণ করতে পারবেন, যার মধ্যে ব্রেডক্রাম্ব লগ পপুলেট করা ডেটাও অন্তর্ভুক্ত।
অপ্ট-ইন রিপোর্টিং চালু করুন
সাধারণত, Crashlytics আপনার অ্যাপের সব ব্যবহারকারীর জন্য ক্র্যাশ রিপোর্ট অটোমেটিক সংগ্রহ করে। ব্যবহারকারীদের ক্র্যাশ সংক্রান্ত রিপোর্ট পাঠানোর বিকল্প চালু করার অনুমতি দিয়ে, তাদের পাঠানো ডেটার উপর আরও বেশি নিয়ন্ত্রণ দিতে পারেন।
শুধুমাত্র বেছে নেওয়া ব্যবহারকারীদের জন্য অটোমেটিক সংগ্রহ বন্ধ করতে, রানটাইমে Crashlytics ডেটা সংগ্রহ ওভাররাইড কল করুন। আপনার অ্যাপের পরবর্তী সব লঞ্চ জুড়ে ওভাররাইড ভ্যালু বজায় থাকে যাতে Crashlytics অটোমেটিক সেই ব্যবহারকারীর জন্য রিপোর্ট সংগ্রহ করতে পারে।
Crashlytics.IsCrashlyticsCollectionEnabled = true
ব্যবহারকারী পরে ডেটা সংগ্রহ থেকে বেরিয়ে আসলে, আপনি ওভাররাইড ভ্যালু হিসেবে false পাস করতে পারেন, যা ব্যবহারকারী পরের বার অ্যাপ লঞ্চ করলে প্রযোজ্য হবে এবং সেই ব্যবহারকারীর জন্য পরবর্তী সব লঞ্চ জুড়ে বজায় থাকবে।
ক্র্যাশ ইনসাইট ডেটা ম্যানেজ করুন
ক্র্যাশ ইনসাইট আপনার পরিচয় গোপন রাখা স্ট্যাক ট্রেসকে অন্যান্য Firebase অ্যাপের ট্রেসের সাথে তুলনা করে সমস্যা সমাধান করতে সাহায্য করে এবং আপনার সমস্যাটি কোনও বৃহত্তর ট্রেন্ডের অংশ কিনা তা আপনাকে জানায়। অনেক সমস্যার ক্ষেত্রে, ক্র্যাশ ইনসাইট এমনকি ক্র্যাশ ডিবাগ করতে আপনাকে সাহায্য করার জন্য রিসোর্স প্রদান করে।
ক্র্যাশ ইনসাইট, সাধারণ স্টেবিলিটি ট্রেন্ড শনাক্ত করতে, এগ্রিগেট করা ক্র্যাশ ডেটা ব্যবহার করে। আপনি যদি অ্যাপের ডেটা শেয়ার করতে না চান, তাহলে Firebase কনসোলের DevOps ও এনগেজমেন্ট > Crashlytics ড্যাশবোর্ড-এ সমস্যার তালিকার উপরে ক্র্যাশ ইনসাইট মেনু থেকে ক্র্যাশ ইনসাইট অপ্ট-আউট করতে পারবেন।
পরবর্তী ধাপ
- উন্নত বিশ্লেষণ ও ফিচারের জন্য আপনার ডেটা BigQuery বা Cloud Logging-এ এক্সপোর্ট করুন যেমন, আপনার ডেটা কোয়েরি করা, কাস্টম ড্যাশবোর্ড তৈরি করা এবং কাস্টম সতর্কতা সেট-আপ করা।