راه‌اندازی یکپارچه‌سازی‌های اولیه هشدار با Slack، Jira و PagerDuty

فایربیس یکپارچه‌سازی‌های اولیه هشدار را برای ارسال هشدارهای Crashlytics به Slack، Jira و PagerDuty ارائه می‌دهد.

در سطح بالا، نحوه تنظیم و پیکربندی این ادغام‌ها در کنسول Firebase به شرح زیر است:

  1. گردش کار هدایت‌شده برای هر سرویس را در برگه «یکپارچه‌سازی‌ها» در سیستم خود دنبال کنید. تنظیمات پروژه .

  2. انتخاب کنید که کدام پیکربندی برای برنامه‌های جداگانه استفاده شود و مقصد سایر هشدارها را در کارت Crashlytics از برگه هشدارها در سیستم خود پیکربندی کنید. تنظیمات پروژه .


بقیه این صفحه به تفصیل نحوه تنظیم هر یکپارچه‌سازی هشدار اولیه را شرح می‌دهد.

اسلک جیرا پیجر دیوتی



یکپارچه‌سازی اولیه با Slack را راه‌اندازی کنید

نمونه‌ای از هشدار Crashlytics به کانال Slack

پس از راه‌اندازی یکپارچه‌سازی Firebase با Slack، پروژه شما می‌تواند در پاسخ به رویدادهای گزارش‌شده توسط Crashlytics ، مانند مشکلات جدید، پسرفت یا افزایش سرعت، به فضای کاری Slack شما ارسال شود.

مرحله ۱ : یک وب‌هوک Slack راه‌اندازی کنید

قبل از اینکه یکپارچه‌سازی را در Firebase راه‌اندازی کنید، باید یک وب‌هوک ورودی در Slack اضافه کنید تا ارتباطات از Firebase را مدیریت کند.

برای یادگیری نحوه انجام این کار، مستندات Slack در مورد ارسال پیام‌ها با استفاده از Incoming Webhooks را مطالعه کنید.

مرحله 2 : یکپارچه‌سازی Slack را در کنسول Firebase راه‌اندازی کنید

پس از تنظیم وب‌هوک مناسب، آماده‌ی راه‌اندازی یکپارچه‌سازی برای Crashlytics هستید:

  1. وارد کنسول Firebase شوید، سپس پروژه خود را انتخاب کنید.

  2. روی کلیک کنید، سپس تنظیمات پروژه را انتخاب کنید.

  3. برگه ادغام‌ها را انتخاب کنید.

  4. در کارت ادغام Slack ، روی نصب کلیک کنید.

  5. با تنظیم مقادیر در فیلدهای زیر، ادغام را تنظیم کنید:

    • آدرس وب‌هوک : آدرس وب‌هوک را از صفحه تنظیمات Slack خود وارد کنید.

    • کانال پیش‌فرض : نام کانال را وارد کنید. می‌توانید بعداً این پیش‌فرض را برای هر برنامه یا هر هشدار لغو کنید.

    • نام کاربر ارسال کننده : نامی را برای ارسال پیام‌ها وارد کنید.

  6. روی تأیید و ذخیره کلیک کنید.

پس از تأیید و ذخیره ادغام Slack، باید یک پیام تأیید در کانال پیش‌فرضی که انتخاب کرده‌اید، مشاهده کنید.

مرحله ۳ : تنظیمات هشدار را برای Slack پیکربندی کنید

شما می‌توانید هشدارها را بر اساس نوع برنامه و رویداد پیکربندی کنید. برای مثال، می‌توانید هشدارها را در برنامه آزمایشی خود خاموش کنید یا هشدارهای با اولویت بالا را در برنامه عملیاتی خود به یک کانال #urgent هدایت کنید.

انواع رویداد

ادغام Firebase با Slack به شما امکان می‌دهد در پاسخ به انواع رویدادهای زیر هشدار ارسال کنید:

  • مشکلات مهلک جدید : زمانی رخ می‌دهد که برنامه شما دچار خرابی یا ANR شود که Crashlytics قبلاً آن را ندیده است.

  • مشکلات جدید غیرمهلک : زمانی رخ می‌دهد که برنامه شما با یک مشکل غیرمهلک مواجه شود که Crashlytics قبلاً آن را ندیده است.

  • مشکلات پس‌رفته : زمانی رخ می‌دهد که برنامه شما با مشکلی مواجه می‌شود که قبلاً آن را بسته علامت‌گذاری کرده‌اید.

  • مسائل پرطرفدار : زمانی فعال می‌شود که یک مسئله در حال ظهور یا پرطرفدار شدن باشد.

  • مشکلات مربوط به افزایش سرعت : زمانی رخ می‌دهد که یک کرش یا نوع ANR، درصدی از کاربران را در یک دوره 30 دقیقه‌ای برای یک نسخه خاص از برنامه تحت تأثیر قرار دهد.

پیکربندی تنظیمات برای هر برنامه

در اینجا نحوه پیکربندی هشدارها برای هر برنامه در پروژه Firebase شما آورده شده است:

  1. وارد کنسول Firebase شوید، سپس پروژه خود را انتخاب کنید.

  2. روی کلیک کنید، سپس تنظیمات پروژه را انتخاب کنید.

  3. برگه هشدارها را انتخاب کنید.

  4. به کارت هشدارهای Crashlytics بروید. برنامه‌ای را که می‌خواهید پیکربندی کنید از منوی کشویی انتخاب کنید.

  5. کانال Slack را که می‌خواهید هشدارهای مربوط به این برنامه را در آن ارسال کنید، انتخاب کنید.

  6. برای هر نوع هشدار، از منوی کشویی انتخاب کنید که آیا می‌خواهید آن نوع هشدار را به Slack ارسال کنید یا خیر.

  7. این مراحل را برای هر برنامه‌ای که می‌خواهید پیکربندی کنید، تکرار کنید.

همین! اگر برنامه‌های شما مشکلات جدید، پسرفت یا افزایش سرعت داشته باشند، فایربیس هشدارهایی را به کانال‌های Slack مشخص شده شما ارسال می‌کند.



راه‌اندازی یکپارچه‌سازی اولیه با جیرا

پس از راه‌اندازی یکپارچه‌سازی Firebase با Jira، پروژه Firebase شما می‌تواند در پاسخ به رویدادهای گزارش‌شده توسط Crashlytics ، مانند مشکلات جدید، پسرفت یا افزایش سرعت، به یک پروژه Jira ارسال شود. همچنین می‌توانید مشکلات Crashlytics را به صورت جداگانه به مشکلات Jira پیوند دهید.

مرحله ۱ : آماده‌سازی جیرا برای ادغام با فایربیس

ایجاد یک توکن API (فقط در جیرا کلود)

قبل از اینکه ادغام را در Firebase راه‌اندازی کنید، باید یک توکن API در Jira Cloud ایجاد کنید.

  1. در کنسول جیرا، تنظیمات توکن‌های API را باز کنید.

  2. روی ایجاد توکن API کلیک کنید.

  3. این توکن API را در جایی امن ذخیره کنید، زیرا بعداً به آن نیاز خواهید داشت.

یک نوع مشکل "اشکال" ایجاد کنید

ادغام Firebase با Jira مشکلاتی را در رابطه با نوع Bug ایجاد می‌کند. شما باید این نوع مشکل را در پروژه Jira خود ایجاد کنید (اگر از قبل وجود ندارد).

  1. در کنسول جیرا، به تنظیمات پروژه (Project Settings) بروید.

  2. روی انواع مشکل کلیک کنید.

  3. روی افزودن نوع مشکل کلیک کنید.

  4. «اشکال» را انتخاب کنید، یا آن را به صورت دستی وارد کنید.

مرحله 2 : یکپارچه‌سازی Jira را در کنسول Firebase راه‌اندازی کنید

یکپارچه‌سازی جیرا را برای جیرا کلود یا جیرا سرور تنظیم کنید.

جیرا کلود

  1. وارد کنسول Firebase شوید، سپس پروژه خود را انتخاب کنید.

  2. روی کلیک کنید، سپس تنظیمات پروژه را انتخاب کنید.

  3. برگه ادغام‌ها را انتخاب کنید.

  4. در کارت یکپارچه‌سازی جیرا ، روی نصب کلیک کنید.

  5. روی راه‌اندازی یکپارچه‌سازی جیرا کلیک کنید.

  6. آدرس اینترنتی پروژه جیرا خود را با فرمت زیر وارد کنید: https:// WORKSPACE_NAME .atlassian.net/projects/ PROJECT_KEY

  7. ایمیل ورود به سیستم جیرا و توکن API خود را وارد کنید.

  8. روی تأیید و ذخیره کلیک کنید.

سرور جیرا

  1. وارد کنسول Firebase شوید، سپس پروژه خود را انتخاب کنید.

  2. روی کلیک کنید، سپس تنظیمات پروژه را انتخاب کنید.

  3. برگه ادغام‌ها را انتخاب کنید.

  4. در کارت یکپارچه‌سازی جیرا ، روی نصب کلیک کنید.

  5. روی راه‌اندازی یکپارچه‌سازی جیرا کلیک کنید.

  6. آدرس اینترنتی پروژه جیرا خود را با فرمت زیر وارد کنید: https:// SERVER_NAME.com /projects/ PROJECT_KEY

  7. ایمیل ورود به سیستم جیرا و توکن API خود را وارد کنید.

  8. روی تأیید و ذخیره کلیک کنید.

مرحله ۳ : پیکربندی تنظیمات هشدار برای جیرا

شما می‌توانید هشدارها را بر اساس نوع برنامه و رویداد پیکربندی کنید. برای مثال، می‌توانید هشدارها را در برنامه آزمایشی خود خاموش کنید یا هشدارهای مربوط به برنامه‌های مختلف را به پروژه‌های مختلف جیرا هدایت کنید.

انواع رویداد

ادغام Firebase با Jira به شما امکان می‌دهد در پاسخ به انواع رویدادهای زیر هشدار ارسال کنید:

  • مشکلات مهلک جدید : زمانی رخ می‌دهد که برنامه شما دچار خرابی یا ANR شود که Crashlytics قبلاً آن را ندیده است.

  • مشکلات جدید غیرمهلک : زمانی رخ می‌دهد که برنامه شما با یک مشکل غیرمهلک مواجه شود که Crashlytics قبلاً آن را ندیده است.

  • مشکلات پس‌رفته : زمانی رخ می‌دهد که برنامه شما با مشکلی مواجه می‌شود که قبلاً آن را بسته علامت‌گذاری کرده‌اید.

  • مسائل پرطرفدار : زمانی فعال می‌شود که یک مسئله در حال ظهور یا پرطرفدار شدن باشد.

  • مشکلات مربوط به افزایش سرعت : زمانی رخ می‌دهد که یک کرش یا نوع ANR، درصدی از کاربران را در یک دوره 30 دقیقه‌ای برای یک نسخه خاص از برنامه تحت تأثیر قرار دهد.

پیکربندی تنظیمات برای هر برنامه

در اینجا نحوه پیکربندی هشدارها برای هر برنامه در پروژه Firebase شما آورده شده است:

  1. وارد کنسول Firebase شوید، سپس پروژه خود را انتخاب کنید.

  2. روی کلیک کنید، سپس تنظیمات پروژه را انتخاب کنید.

  3. برگه هشدارها را انتخاب کنید.

  4. به کارت هشدارهای Crashlytics بروید. برنامه‌ای را که می‌خواهید پیکربندی کنید از منوی کشویی انتخاب کنید.

  5. پروژه جیرا را که می‌خواهید هشدارها را برای این برنامه ارسال کنید، انتخاب کنید.

  6. برای هر نوع هشدار، از منوی کشویی انتخاب کنید که آیا می‌خواهید آن نوع هشدار را به جیرا ارسال کنید یا خیر.

  7. این مراحل را برای هر برنامه‌ای که می‌خواهید پیکربندی کنید، تکرار کنید.

همین! اگر برنامه‌های شما مشکلات جدید، پسرفت یا افزایش سرعت داشته باشند، فایربیس به پروژه‌های مشخص شده جیرای شما هشدار ارسال می‌کند.

علاوه بر مسائل Jira که به طور خودکار توسط Firebase ایجاد می‌شوند، می‌توان مسائل Crashlytics خود را به مسائل موجود Jira پیوند داد. همچنین می‌توانید از کنسول Firebase یک مسئله Jira جدید ایجاد کنید. قبل از استفاده از این ویژگی، باید ادغام Jira را فعال کنید.

  1. به مسئله‌ی Crashlytics که می‌خواهید به یک مسئله‌ی Jira لینک دهید، بروید.

  2. روی پیوند به جیرا کلیک کنید.

  3. یا روی «ایجاد مسئله در پروژه» کلیک کنید، یا آدرس اینترنتی یا کلید مسئله جیرا خود را در فیلد ارائه شده جایگذاری کنید.

  1. به مسئله‌ی Crashlytics که می‌خواهید از Jira جدا کنید، بروید.

  2. روی مشکل مرتبط کلیک کنید.

  3. روی «بیشتر» کلیک کنید و «لغو پیوند» را انتخاب کنید.



راه‌اندازی یکپارچه‌سازی اولیه با PagerDuty

پس از راه‌اندازی یکپارچه‌سازی Firebase با PagerDuty، پروژه Firebase شما به PagerDuty اجازه می‌دهد تا پاسخگویان در حال آماده‌باش شما را در پاسخ به رویدادهای گزارش‌شده توسط Crashlytics ، مانند مشکلات جدید، پسرفت یا افزایش سرعت، صفحه‌بندی کند.

مرحله 1 : یکپارچه‌سازی PagerDuty را در کنسول Firebase راه‌اندازی کنید

  1. وارد کنسول Firebase شوید، سپس پروژه خود را انتخاب کنید.

  2. روی کلیک کنید، سپس تنظیمات پروژه را انتخاب کنید.

  3. برگه ادغام‌ها را انتخاب کنید.

  4. در کارت ادغام PagerDuty ، روی نصب کلیک کنید.

  5. برای تنظیم ادغام، دستورالعمل‌های روی صفحه را دنبال کنید.

  6. روی تأیید و ذخیره کلیک کنید.

مرحله ۲ : پیکربندی تنظیمات هشدار برای PagerDuty

شما می‌توانید هشدارها را بر اساس نوع برنامه و رویداد پیکربندی کنید. برای مثال، می‌توانید هشدارها را در برنامه آزمایشی خود خاموش کنید یا هشدارهای مربوط به برنامه‌های مختلف را به پروژه‌های مختلف PagerDuty هدایت کنید.

انواع رویداد

ادغام Firebase با PagerDuty به شما امکان می‌دهد در پاسخ به انواع رویدادهای زیر هشدار ارسال کنید:

  • مشکلات مهلک جدید : زمانی رخ می‌دهد که برنامه شما دچار خرابی یا ANR شود که Crashlytics قبلاً آن را ندیده است.

  • مشکلات جدید غیرمهلک : زمانی رخ می‌دهد که برنامه شما با یک مشکل غیرمهلک مواجه شود که Crashlytics قبلاً آن را ندیده است.

  • مشکلات پس‌رفته : زمانی رخ می‌دهد که برنامه شما با مشکلی مواجه می‌شود که قبلاً آن را بسته علامت‌گذاری کرده‌اید.

  • مسائل پرطرفدار : زمانی فعال می‌شود که یک مسئله در حال ظهور یا پرطرفدار شدن باشد.

  • مشکلات مربوط به افزایش سرعت : زمانی رخ می‌دهد که یک کرش یا نوع ANR، درصدی از کاربران را در یک دوره 30 دقیقه‌ای برای یک نسخه خاص از برنامه تحت تأثیر قرار دهد.

پیکربندی تنظیمات برای هر برنامه

در اینجا نحوه پیکربندی هشدارها برای هر برنامه در پروژه Firebase شما آورده شده است:

  1. وارد کنسول Firebase شوید، سپس پروژه خود را انتخاب کنید.

  2. روی کلیک کنید، سپس تنظیمات پروژه را انتخاب کنید.

  3. برگه هشدارها را انتخاب کنید.

  4. به کارت هشدارهای Crashlytics بروید. برنامه‌ای را که می‌خواهید پیکربندی کنید از منوی کشویی انتخاب کنید.

  5. سرویس PagerDuty را که می‌خواهید برای این برنامه هشدار ارسال کنید، انتخاب کنید.

  6. برای هر نوع هشدار، از منوی کشویی انتخاب کنید که آیا می‌خواهید آن نوع هشدار را به PagerDuty ارسال کنید یا خیر.

  7. این مراحل را برای هر برنامه‌ای که می‌خواهید پیکربندی کنید، تکرار کنید.

همین! اگر برنامه‌های شما مشکلات جدید، پسرفت یا افزایش سرعت داشته باشند، Firebase اشکالات را به سرویس PagerDuty مشخص شده شما ارسال خواهد کرد.