Thiết lập tính năng cảnh báo nâng cao cho các kênh thông báo tuỳ chỉnh

Firebase cung cấp hai lựa chọn để định cấu hình cảnh báo và gửi cảnh báo đến các kênh thông báo tuỳ chỉnh.

• (Nên dùng) Thiết lập và gửi cảnh báo tùy chỉnh đến các kênh thông báo tùy chỉnh

  Bạn có thể sử dụng Cloud Monitoring để gửi cảnh báo tùy chỉnh hoàn toàn đến các kênh thông báo tuỳ chỉnh dựa trên dữ liệu Crashlytics và (không bắt buộc) dữ liệu phiên Firebase mà bạn đã xuất sang Cloud Logging.

• Gửi cảnh báo Crashlytics mặc định đến các kênh thông báo tuỳ chỉnh

  Bạn có thể sử dụng Cloud Functions để gửi Crashlytics cảnh báo mặc định đến các kênh thông báo tuỳ chỉnh.

---

(Nên dùng) Thiết lập và gửi cảnh báo tùy chỉnh đến các kênh thông báo tùy chỉnh

Firebase cung cấp các cảnh báo Crashlytics mặc định (xem trang tổng quan về cảnh báo). Tuy nhiên, những cảnh báo mặc định này và các kênh thông báo của chúng có thể không đủ cho nhu cầu của bạn.

Trong những trường hợp này, bạn có thể sử dụng Cloud Monitoring để gửi cảnh báo tùy chỉnh đến các kênh thông báo tùy chỉnh dựa trên dữ liệu Crashlytics (và dữ liệu phiên Firebase không bắt buộc) mà bạn đã xuất sang Cloud Logging.

Để sử dụng Cloud Monitoring cho cảnh báo tùy chỉnh, bạn cần thiết lập một chính sách cảnh báo, trong đó mô tả những trường hợp bạn muốn nhận cảnh báo và cách bạn muốn nhận thông báo.

Ví dụ: nếu tỷ lệ không gặp sự cố của bạn giảm xuống dưới một ngưỡng cụ thể, Cloud Monitoring có thể gửi cảnh báo tùy chỉnh đến một địa chỉ email cụ thể hoặc đăng cảnh báo đó lên một dịch vụ bên thứ ba, chẳng hạn như Discord, Slack hoặc Jira. Bạn cũng có thể tuỳ chỉnh hoàn toàn thông tin được gửi trong cảnh báo, chẳng hạn như thêm các đường liên kết sâu hữu ích vào bảng điều khiển Firebase hoặc thông tin khắc phục sự cố dành riêng cho công ty.

Trong tài liệu về Google Cloud, hãy tìm hiểu thêm về Cloud Monitoring và cảnh báo, bao gồm cả giá.

Điều kiện tiên quyết

1. Đảm bảo dự án Firebase của bạn sử dụng gói giá Blaze (trả tiền theo mức dùng).

2. Thiết lập tính năng xuất dữ liệu sang Cloud Logging cho dữ liệu của Crashlytics và dữ liệu phiên Firebase (không bắt buộc).

3. Thiết lập kênh thông báo.

Thiết lập chính sách cảnh báo

Sau đây là hướng dẫn tổng quan; để biết hướng dẫn chi tiết, hãy xem tài liệu về Google Cloud (ví dụ: Tạo chính sách cảnh báo về ngưỡng chỉ số hoặc Sử dụng PromQL để tạo chính sách cảnh báo).

Trong quá trình chạy truy vấn, bạn có thể thiết lập cảnh báo dựa trên nhật ký hoặc cảnh báo dựa trên SQL:

• Thiết lập cảnh báo dựa trên nhật ký:

  1. Chạy truy vấn trong Logs Explorer.

  2. Nhấp vào nút Thêm cảnh báo xuất hiện.

  3. Làm theo hướng dẫn trên màn hình để thêm cảnh báo dựa trên nhật ký.

• Thiết lập cảnh báo dựa trên SQL:

  1. Chạy một truy vấn trong Logs Analytics.

  2. Nhấp vào nút Thêm cảnh báo xuất hiện.

  3. Làm theo hướng dẫn trên màn hình để thêm cảnh báo dựa trên SQL.

Ngoài ra, bạn có thể thiết lập cảnh báo cho chỉ số dựa trên nhật ký bằng cách sử dụng công cụ cấu hình chính sách trong bảng điều khiển Google Cloud, nơi bạn có thể chọn một trong các lựa chọn sau:

• Trình tạo: Giao diện người dùng của bảng điều khiển cung cấp quy trình làm việc có hướng dẫn để xây dựng chính sách cảnh báo.

• PromQL: Bạn cung cấp một truy vấn PromQL cho chính sách cảnh báo của mình

  Ví dụ về truy vấn PromQL

  Ví dụ: giả sử bạn đã tạo hai chỉ số dựa trên nhật ký cho dữ liệu phiên Crashlytics và Firebase đã xuất:

  • Một chỉ số có tên là firebase/crashlytics_events với nhãn là errorType, và được định nghĩa là:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • Một chỉ số khác có tên là firebase/session_events với nhãn là eventType, và được định nghĩa là:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

  Dưới đây là ví dụ về truy vấn PromQL sử dụng các chỉ số dựa trên nhật ký này để cảnh báo khi tỷ lệ không gặp sự cố giảm xuống dưới 70%:

  1 - (sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/crashlytics_events", errorType="FATAL"}[5m])) /
  sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/session_events", eventType="SESSION_START"}[5m]))
  ) < 0.7

---

Gửi cảnh báo mặc định của Crashlytics đến các kênh thông báo tuỳ chỉnh

Firebase cung cấp các cảnh báo Crashlytics mặc định (xem danh sách trên trang tổng quan về các lựa chọn cảnh báo). Tuy nhiên, thông tin trong các cảnh báo mặc định này và kênh thông báo của chúng có thể không đủ cho nhu cầu của bạn.

Trong những trường hợp này, bạn có thể sử dụng Cloud Functions for Firebase để gửi các cảnh báo Crashlytics mặc định này đến các kênh thông báo tuỳ chỉnh. Ví dụ: bạn có thể viết một hàm ghi lại sự kiện cảnh báo cho cảnh báo về tốc độ và đăng thông tin cảnh báo lên một dịch vụ bên thứ ba, chẳng hạn như Discord, Slack hoặc Jira.

Với cơ chế cảnh báo nâng cao này, bạn cũng có thể tuỳ chỉnh thông tin được gửi đến dịch vụ bên thứ ba. Ví dụ: ngoài thông tin mặc định do Firebase cung cấp, bạn cũng có thể thêm các đường liên kết sâu hữu ích vào bảng điều khiển Firebase hoặc thông tin khắc phục sự cố dành riêng cho công ty.

Để thiết lập các tính năng cảnh báo nâng cao bằng Cloud Functions for Firebase, hãy làm theo các bước sau:

1. Thiết lập Cloud Functions cho Firebase, bao gồm các nhiệm vụ sau:

   1. Thiết lập môi trường phát triển cho Node.js hoặc Python.
   2. Cài đặt và đăng nhập vào CLI Firebase.
   3. Khởi động Cloud Functions for Firebase bằng CLI Firebase.

2. Viết và triển khai một hàm ghi lại sự kiện cảnh báo từ Crashlytics và xử lý tải trọng sự kiện (ví dụ: đăng thông tin cảnh báo trong một tin nhắn trên Discord).

Để tìm hiểu về tất cả các sự kiện cảnh báo Crashlytics mà bạn có thể ghi lại, hãy xem tài liệu tham khảo về cảnh báo Crashlytics.

Tìm hiểu thêm về cách xử lý cảnh báo Crashlytics bằng Cloud Functions for Firebase