Thiết lập các công cụ tích hợp cảnh báo cơ bản với Slack, Jira và PagerDuty

Firebase có thể gửi nhiều cảnh báo Crashlytics mặc định (xem trang tổng quan về cảnh báo). Firebase cung cấp các tính năng tích hợp cảnh báo cơ bản để gửi cảnh báo Crashlytics mặc định đến Slack, Jira, và PagerDuty.

Ở cấp độ cao, sau đây là cách thiết lập và định cấu hình các tính năng tích hợp này trong Firebase bảng điều khiển:

  1. Làm theo quy trình công việc có hướng dẫn cho từng dịch vụ cảnh báo trong trang Settings > Integrations của Firebase bảng điều khiển.

  2. Chọn cấu hình được dùng cho từng ứng dụng và định cấu hình đích của các cảnh báo khác trong thẻ Crashlytics của trang Settings > Alerts của bảng điều khiển Firebase.


Phần còn lại của trang này mô tả chi tiết cách thiết lập từng tính năng tích hợp cảnh báo cơ bản.

Slack Jira PagerDuty



Slack: Thiết lập tính năng tích hợp với Slack

Ví dụ về cảnh báo Crashlytics gửi đến một kênh Slack

Sau khi thiết lập tính năng tích hợp Firebase với Slack, dự án của bạn có thể đăng lên không gian làm việc Slack để phản hồi các sự kiện do Crashlyticsbáo cáo, chẳng hạn như các vấn đề mới, tái phát hoặc tăng tốc.

Bước 1: Thiết lập webhook Slack

Trước khi thiết lập tính năng tích hợp trong Firebase, bạn cần thêm một webhook đến trong Slack để xử lý thông tin liên lạc từ Firebase.

Để tìm hiểu cách thực hiện việc này, hãy đọc tài liệu của Slack về cách Gửi tin nhắn bằng Webhook đến.

Bước 2: Thiết lập tính năng tích hợp Slack trong bảng điều khiển Firebase

Sau khi thiết lập webhook thích hợp, bạn đã sẵn sàng thiết lập tính năng tích hợp cho Crashlytics:

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang Settings > Integrations.

  2. Trên thẻ tích hợp Slack, hãy nhấp vào Install (Cài đặt).

  3. Thiết lập tính năng tích hợp bằng cách đặt các giá trị trong các trường sau:

    • Webhook URL (URL webhook): Dán URL webhook từ trang cài đặt Slack.

    • Default channel (Kênh mặc định): Nhập tên kênh. Bạn có thể ghi đè giá trị mặc định này sau này dựa trên từng ứng dụng hoặc từng cảnh báo.

    • Name of posting user (Tên người dùng đăng): Nhập tên để gửi tin nhắn.

  4. Nhấp vào Verify &save (Xác minh và lưu).

Sau khi xác minh và lưu tính năng tích hợp Slack, bạn sẽ thấy một thông báo xác nhận trong kênh mặc định mà bạn đã chọn.

Bước 3: Định cấu hình chế độ cài đặt cảnh báo cho Slack

Bạn có thể định cấu hình cảnh báo theo ứng dụng và loại sự kiện. Ví dụ: bạn có thể tắt cảnh báo trong ứng dụng thử nghiệm hoặc chuyển các cảnh báo có mức độ ưu tiên cao trong ứng dụng chính thức đến kênh #urgent.

Loại sự kiện

Tính năng tích hợp Firebase với Slack cho phép bạn gửi cảnh báo để phản hồi các loại sự kiện sau:

  • New fatal issues (Vấn đề nghiêm trọng mới): được kích hoạt khi ứng dụng của bạn gặp phải sự cố hoặc lỗi ANR mà Crashlytics chưa từng thấy trước đây.

  • New non-fatal issues (Vấn đề không nghiêm trọng mới): được kích hoạt khi ứng dụng của bạn gặp phải vấn đề không nghiêm trọng mà Crashlytics chưa từng thấy trước đây.

  • Vấn đề tái phát: được kích hoạt khi ứng dụng của bạn gặp phải sự cố mà bạn đã đánh dấu là đã đóng trước đó.

  • Trending issues (Vấn đề đang thịnh hành): được kích hoạt khi một vấn đề đang nổi lên hoặc thịnh hành.

  • Vấn đề tăng tốc: được kích hoạt khi một loại sự cố hoặc lỗi ANR duy nhất ảnh hưởng đến một tỷ lệ phần trăm người dùng trong khoảng thời gian 30 phút cho một phiên bản ứng dụng nhất định.

Định cấu hình chế độ cài đặt cho từng ứng dụng

Sau đây là cách định cấu hình cảnh báo cho từng ứng dụng trong dự án Firebase:

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang Settings > Alerts.

  2. Chuyển đến thẻ cảnh báo Crashlytics. Chọn ứng dụng bạn muốn định cấu hình trong trình đơn thả xuống.

  3. Chọn kênh Slack mà bạn muốn gửi cảnh báo cho ứng dụng này.

  4. Đối với từng loại cảnh báo, hãy chọn trong trình đơn thả xuống xem bạn muốn gửi loại cảnh báo đó đến Slack hay không.

  5. Lặp lại các bước này cho từng ứng dụng mà bạn muốn định cấu hình.

Tất cả chỉ có thế! Firebase sẽ gửi cảnh báo đến các kênh Slack mà bạn đã chỉ định nếu ứng dụng của bạn gặp phải các vấn đề mới, tái phát hoặc tăng tốc.



Jira: Thiết lập tính năng tích hợp với Jira

Sau khi thiết lập tính năng tích hợp Firebase với Jira, dự án Firebase của bạn có thể đăng lên một dự án Jira để phản hồi các sự kiện do Crashlytics báo cáo, chẳng hạn như các vấn đề mới, tái phát hoặc tăng tốc. Bạn cũng có thể liên kết từng vấn đề Crashlytics với các vấn đề trong Jira.

Bước 1: Chuẩn bị Jira để tích hợp với Firebase

Tạo mã thông báo API (chỉ dành cho Jira Cloud)

Trước khi thiết lập tính năng tích hợp trong Firebase, bạn cần tạo mã thông báo API trong Jira Cloud.

  1. Trong bảng điều khiển Jira, hãy mở phần cài đặt mã thông báo API.

  2. Nhấp vào Create API token (Tạo mã thông báo API).

  3. Lưu mã thông báo API này ở một nơi an toàn vì bạn sẽ cần đến mã này sau này.

Tạo loại vấn đề "Lỗi"

Tính năng tích hợp Firebase với Jira tạo ra các vấn đề có loại Bug. Bạn cần tạo loại vấn đề này trong dự án Jira (nếu chưa có).

  1. Trong bảng điều khiển Jira, hãy chuyển đến phần Project Settings (Cài đặt dự án).

  2. Nhấp vào Issue types (Loại vấn đề).

  3. Nhấp vào Add issue type (Thêm loại vấn đề).

  4. Chọn "Bug" (Lỗi) hoặc nhập theo cách thủ công.

Bước 2: Thiết lập tính năng tích hợp Jira trong bảng điều khiển Firebase

Thiết lập tính năng tích hợp Jira cho Jira Cloud hoặc cho Jira Server.

Jira Cloud

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang Settings > Integrations.

  2. Trên thẻ tích hợp Jira, hãy nhấp vào Install (Cài đặt).

  3. Nhấp vào Set up Jira integration (Thiết lập tính năng tích hợp Jira).

  4. Nhập URL dự án Jira theo định dạng sau: https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEY

  5. Nhập email đăng nhập Jira và mã thông báo API.

  6. Nhấp vào Verify &save (Xác minh và lưu).

Jira Server

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang Settings > Integrations.

  2. Trên thẻ tích hợp Jira, hãy nhấp vào Install (Cài đặt).

  3. Nhấp vào Set up Jira integration (Thiết lập tính năng tích hợp Jira).

  4. Nhập URL dự án Jira theo định dạng sau: https://SERVER_NAME.com/projects/PROJECT_KEY

  5. Nhập email đăng nhập Jira và mã thông báo API.

  6. Nhấp vào Verify &save (Xác minh và lưu).

Bước 3: Định cấu hình chế độ cài đặt cảnh báo cho Jira

Bạn có thể định cấu hình cảnh báo theo ứng dụng và loại sự kiện. Ví dụ: bạn có thể tắt cảnh báo trong ứng dụng thử nghiệm hoặc chuyển cảnh báo về các ứng dụng khác nhau đến các dự án Jira khác nhau.

Loại sự kiện

Tính năng tích hợp Firebase với Jira cho phép bạn gửi cảnh báo để phản hồi các loại sự kiện sau:

  • New fatal issues (Vấn đề nghiêm trọng mới): được kích hoạt khi ứng dụng của bạn gặp phải sự cố hoặc lỗi ANR mà Crashlytics chưa từng thấy trước đây.

  • New non-fatal issues (Vấn đề không nghiêm trọng mới): được kích hoạt khi ứng dụng của bạn gặp phải vấn đề không nghiêm trọng mà Crashlytics chưa từng thấy trước đây.

  • Vấn đề tái phát: được kích hoạt khi ứng dụng của bạn gặp phải sự cố mà bạn đã đánh dấu là đã đóng trước đó.

  • Trending issues (Vấn đề đang thịnh hành): được kích hoạt khi một vấn đề đang nổi lên hoặc thịnh hành.

  • Vấn đề tăng tốc: được kích hoạt khi một loại sự cố hoặc lỗi ANR duy nhất ảnh hưởng đến một tỷ lệ phần trăm người dùng trong khoảng thời gian 30 phút cho một phiên bản ứng dụng nhất định.

Định cấu hình chế độ cài đặt cho từng ứng dụng

Sau đây là cách định cấu hình cảnh báo cho từng ứng dụng trong dự án Firebase:

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang Settings > Alerts.

  2. Chuyển đến thẻ cảnh báo Crashlytics. Chọn ứng dụng bạn muốn định cấu hình trong trình đơn thả xuống.

  3. Chọn dự án Jira mà bạn muốn gửi cảnh báo cho ứng dụng này.

  4. Đối với từng loại cảnh báo, hãy chọn trong trình đơn thả xuống xem bạn muốn gửi loại cảnh báo đó đến Jira hay không.

  5. Lặp lại các bước này cho từng ứng dụng mà bạn muốn định cấu hình.

Tất cả chỉ có thế! Firebase sẽ gửi cảnh báo đến các dự án Jira mà bạn đã chỉ định nếu ứng dụng của bạn gặp phải các vấn đề mới, tái phát hoặc tăng tốc.

Ngoài các vấn đề trong Jira được Firebase tự động tạo, bạn có thể liên kết các vấn đề Crashlytics hiện có trong Jira. Bạn cũng có thể tạo một vấn đề mới trong Jira từ bảng điều khiển Firebase. Bạn cần bật tính năng tích hợp Jira trước khi sử dụng tính năng này.

  1. Chuyển đến vấn đề Crashlytics mà bạn muốn liên kết với một vấn đề trong Jira.

  2. Nhấp vào Link to Jira (Liên kết với Jira).

  3. Nhấp vào Create issue in Project (Tạo vấn đề trong Dự án) hoặc dán URL vấn đề hoặc khoá vấn đề trong Jira vào trường được cung cấp.

  1. Chuyển đến vấn đề Crashlytics mà bạn muốn huỷ liên kết với Jira.

  2. Nhấp vào Linked Issue (Vấn đề được liên kết).

  3. Nhấp vào More (Tuỳ chọn khác) rồi chọn Unlink (Huỷ liên kết).



PagerDuty: Thiết lập tính năng tích hợp với PagerDuty

Sau khi thiết lập tính năng tích hợp Firebase với PagerDuty, dự án Firebase của bạn cho phép PagerDuty thông báo cho người phản hồi đang trực để phản hồi các sự kiện do Crashlytics báo cáo, chẳng hạn như các vấn đề mới, tái phát hoặc tăng tốc.

Bước 1: Thiết lập tính năng tích hợp PagerDuty trong bảng điều khiển Firebase

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang Settings > Integrations.

  2. Trên thẻ tích hợp PagerDuty, hãy nhấp vào Install (Cài đặt).

  3. Làm theo hướng dẫn trên màn hình để thiết lập tính năng tích hợp.

  4. Nhấp vào Verify &save (Xác minh và lưu).

Bước 2: Định cấu hình chế độ cài đặt cảnh báo cho PagerDuty

Bạn có thể định cấu hình cảnh báo theo ứng dụng và loại sự kiện. Ví dụ: bạn có thể tắt cảnh báo trong ứng dụng thử nghiệm hoặc chuyển cảnh báo về các ứng dụng khác nhau đến các dự án PagerDuty khác nhau.

Loại sự kiện

Tính năng tích hợp Firebase với PagerDuty cho phép bạn gửi cảnh báo để phản hồi các loại sự kiện sau:

  • New fatal issues (Vấn đề nghiêm trọng mới): được kích hoạt khi ứng dụng của bạn gặp phải sự cố hoặc lỗi ANR mà Crashlytics chưa từng thấy trước đây.

  • New non-fatal issues (Vấn đề không nghiêm trọng mới): được kích hoạt khi ứng dụng của bạn gặp phải vấn đề không nghiêm trọng mà Crashlytics chưa từng thấy trước đây.

  • Vấn đề tái phát: được kích hoạt khi ứng dụng của bạn gặp phải sự cố mà bạn đã đánh dấu là đã đóng trước đó.

  • Trending issues (Vấn đề đang thịnh hành): được kích hoạt khi một vấn đề đang nổi lên hoặc thịnh hành.

  • Vấn đề tăng tốc: được kích hoạt khi một loại sự cố hoặc lỗi ANR duy nhất ảnh hưởng đến một tỷ lệ phần trăm người dùng trong khoảng thời gian 30 phút cho một phiên bản ứng dụng nhất định.

Định cấu hình chế độ cài đặt cho từng ứng dụng

Sau đây là cách định cấu hình cảnh báo cho từng ứng dụng trong dự án Firebase:

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang Settings > Alerts.

  2. Chuyển đến thẻ cảnh báo Crashlytics. Chọn ứng dụng bạn muốn định cấu hình trong trình đơn thả xuống.

  3. Chọn dịch vụ PagerDuty mà bạn muốn gửi cảnh báo cho ứng dụng này.

  4. Đối với từng loại cảnh báo, hãy chọn trong trình đơn thả xuống xem bạn muốn gửi loại cảnh báo đó đến PagerDuty hay không.

  5. Lặp lại các bước này cho từng ứng dụng mà bạn muốn định cấu hình.

Tất cả chỉ có thế! Firebase sẽ đăng lỗi lên dịch vụ PagerDuty mà bạn đã chỉ định nếu ứng dụng của bạn gặp phải các vấn đề mới, tái phát hoặc tăng tốc.