كيف تربط Sentry بفريقي لتصبح أخطاء تطبيقك مهام

ما الذي يفعله هذا الربط؟

يصل كل خطأ جديد يلتقطه Sentry في تطبيقك إلى فريقي كمهمة، فيُتابَع في المكان نفسه الذي يخطط فيه فريقك وينجز عمله، بدل أن يبقى في أداة لا يفتحها إلا المطوّرون.

• خطأ واحد يصبح مهمة واحدة مهما تكرّر، فلا تمتلئ القائمة بنسخ من الخطأ نفسه.
• تنزل المهام في قائمة مهام لكل أسبوع داخل المشروع الذي تختاره، باسم مدّتها، والأسبوع يبدأ السبت.
• إذا أُغلق الخطأ في Sentry، تكتمل المهمة في فريقي، مع تعليق يذكر من أغلقه.
• إذا أكملت المهمة في فريقي، يُغلق الخطأ في Sentry. أما إعادة فتح المهمة فلا تعيد فتح الخطأ هناك.
• يظهر في صفحة الخطأ داخل Sentry رابط يفتح مهمته في فريقي.
• إذا عاد الخطأ بعد إغلاقه، تُفتح المهمة نفسها من جديد مع تعليق يوضح ذلك، بدل إنشاء مهمة مكرّرة.
• إذا أُسند الخطأ في Sentry، يُسند إلى عضو المشروع الذي يحمل البريد نفسه في فريقي.
• إذا حذفت مهمة، لا يعيد فريقي إنشاءها إن تكرّر الخطأ.

قبل أن تبدأ

• يربط التكاملات مالك الشركة، أو عضو منحه دوره صلاحية «إدارة التكاملات».
• تحتاج في Sentry إلى صلاحية تثبيت التكاملات في منظمتك (Owner أو Manager عادةً).
• لكل خطة عدد من التكاملات، والخطة المجانية تتيح تكاملاً واحداً.
• تُربط منظمة Sentry بفريقي مرة واحدة. إن كانت مربوطة، تعرض بطاقة Sentry «إلغاء التكامل» بدل «ابدأ التكامل».

ما الذي يطلبه فريقي داخل Sentry؟

• Issue & Event (قراءة وكتابة): ليقرأ الخطأ ويحوّله إلى مهمة، وليغلقه حين تكتمل مهمته، وليضع في صفحته رابط المهمة.
• Organization (قراءة وكتابة): لشيء واحد فقط، أن يزيل فريقي تطبيقه من Sentry حين تفصل الربط من فريقي.

خطوات الربط

1. افتح «إعدادات الشركة»، ثم «التكاملات».
2. في بطاقة Sentry اضغط «ابدأ التكامل»، فتفتح صفحة Sentry.
3. اختر منظمتك في Sentry إن كان لديك أكثر من واحدة، ثم اضغط Accept & Install.
4. تعود إلى فريقي في صفحة «أين تنزل أخطاء Sentry؟».
5. اختر «مشروع جديد» لينشئ فريقي مشروع «أخطاء الإنتاج · Sentry»، أو «مشروع موجود» واختره من القائمة.
6. اختياري: حدّد «المسؤول الافتراضي»، ويُسند إليه الخطأ الذي ليس له مسؤول في Sentry من أعضاء المشروع.
7. اضغط «أنهِ الربط». يظهر أول خطأ جديد يصل كمهمة في المشروع.

نصيحة: تستطيع أن تبدأ من Sentry أيضاً: من Settings ثم Integrations ابحث عن Fareeqy واضغط Install. بعد الموافقة تنتقل إلى فريقي، فتسجّل الدخول وتختار المشروع بالطريقة نفسها.

ملاحظة: لا يوجد رابط أو مفتاح تنسخه. الربط كله موافقة داخل Sentry، واختيار للمشروع داخل فريقي.

نصيحة: يرسل Sentry كل خطأ جديد من كل البيئات، ومنها staging. لتصل أخطاء الإنتاج وحدها، أنشئ في Sentry قاعدة تنبيه (Alert Rule) تختار فيها البيئة production، واجعل فريقي وجهتها.

ربطته ولم يصل شيء؟

في صفحة «التكاملات» اضغط «سجل الوصول» بجانب التكامل. يعرض كل ما وصل من Sentry وماذا فعل فريقي به: أُنشئت مهمة، أو حُدّثت مهمة قائمة، أو لم يتغيّر شيء ولماذا. وما يظهر «قيد المعالجة» يكتمل خلال ثوانٍ. واختر «المتجاهَل والمرفوض» لترى ما لم يصبح مهمة وحده.

• «يحتاج إلى وجهة»: المشروع أو قائمة المهام حُذفت أو أُرشف المشروع. افتح «إدارة» واختر مشروعاً آخر.
• بقيت المهمة بلا مسؤول: بريد المطوّر في Sentry لا يطابق بريد أي عضو في المشروع. السجل يذكر البريد.
• «وصلت إلى عدد التكاملات المتاح في خطتك»: افصل تكاملاً آخر، أو رقِّ خطتك.
• «لم يكتمل الربط مع Sentry»: ابدأ من «ابدأ التكامل» من جديد، وإن تكرّر راسلنا على support@fareeqy.com.

تعديل الربط أو فصله

• من «إدارة» غيّر المشروع أو المسؤول الافتراضي في أي وقت.
• اضغط «افصل» بجانب التكامل، أو «إلغاء التكامل» في بطاقة Sentry، فيتوقف وصول الأخطاء الجديدة ويُزال تطبيق فريقي من Sentry. المهام التي أُنشئت تبقى كما هي.
• إن تعذّر على فريقي إزالة التطبيق من Sentry، تخبرك الرسالة بذلك. أزِله بنفسك من Settings ثم Integrations في Sentry.
• إلغاء تثبيت Fareeqy من داخل Sentry يفصل الربط في فريقي أيضاً.
• التكامل المفصول يبقى في الصفحة مع سجله. اضغط «أعد الربط» ليعود للعمل ما دام التطبيق مثبّتاً في Sentry، أو «حذف التكامل» لتحذفه مع سجله. المهام التي أنشأها تبقى في مشاريعها.
• لا يُحذف المشروع الذي يصل إليه التكامل ما دام موصولاً. افصله أو وجّهه إلى مشروع آخر أولاً.

سجل التغييرات

• 30 سبتمبر 2026: إكمال المهمة في فريقي يُغلق الخطأ في Sentry، وصفحة الخطأ في Sentry تعرض رابط مهمته. الفصل من فريقي يزيل التطبيق من Sentry، والتكامل المفصول يمكن حذفه مع سجله.
• 28 سبتمبر 2026: الإصدار الأول. الأخطاء الجديدة تصبح مهام، مع مزامنة الإغلاق وإعادة الفتح والإسناد.

النتيجة؟ أخطاء تطبيقك تُتابَع كأي عمل آخر في فريقي: لها مسؤول، ولها حالة، وتُغلق حين تُحل.