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 2 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.

(Đề xuất) Thiết lập và gửi cảnh báo tuỳ chỉnh đến các kênh thông báo tuỳ chỉnh

Bạn có thể sử dụng Cloud Monitoring để gửi cảnh báo được tuỳ 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ể dùng Cloud Functions để gửi cảnh báo Crashlyticsmặc định đến các kênh thông báo tuỳ chỉnh.

(Đề xuất) Thiết lập và gửi cảnh báo tuỳ chỉnh đế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 trang tổng quan về cảnh báo). Tuy nhiên, 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 đáp ứng đủ 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 tuỳ chỉnh đến các kênh thông báo tuỳ 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 tuỳ chỉnh, bạn cần thiết lập một chính sách cảnh báo. Chính sách này mô tả những trường hợp mà 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 xuống dưới một ngưỡng cụ thể, Cloud Monitoring có thể gửi thông báo cảnh báo tuỳ chỉnh đến một địa chỉ email cụ thể hoặc đăng thông 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 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

Đảm bảo dự án Firebase của bạn sử dụng Gói giá linh hoạt (trả tiền theo mức dùng).
Thiết lập chế độ xuất dữ liệu Cloud Logging của Crashlytics và (không bắt buộc) dữ liệu phiên Firebase.
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 chung; để biết hướng dẫn chi tiết, hãy xem tài liệu Google Cloud (ví dụ: Tạo chính sách cảnh báo dựa trên 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 một 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 một 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 Phân tích nhật ký.
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 một 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 các chỉ số dựa trên nhật ký bằng cách sử dụng công cụ định cấu hình chính sách trong bảng điều khiển Google Cloud. Tại đây, 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 một quy trình có hướng dẫn để tạo 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
Ví dụ về truy vấn PromQL

Ví dụ: giả sử bạn đã tạo 2 chỉ số dựa trên nhật ký cho dữ liệu phiên Crashlytics đã xuất và Firebase:
- Một chỉ số có tên là firebase/crashlytics_events với nhãn errorType và được xác định 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 eventType và được xác định là:
  
  logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"
Sau đây là một 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 Crashlytics mặc định đế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 đáp ứng đủ nhu cầu của bạn.

Trong những trường hợp này, bạn có thể dùng Cloud Functions for Firebase để gửi những 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 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 chức 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:

Thiết lập Cloud Functions cho Firebase, bao gồm các việc 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 Firebase CLI.
3. Khởi động Cloud Functions for Firebase bằng CLI Firebase.
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 thông báo 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 truy cập vào 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