設定自訂通知管道並傳送自訂快訊

Firebase 提供預設的 Crashlytics 快訊 (請參閱快訊總覽頁面)。不過，這些預設快訊和通知管道可能無法滿足您的需求。

在這種情況下，您可以使用 Cloud Monitoring，根據 Cloud Logging 中的 Crashlytics 資料，將自訂快訊傳送至自訂通知管道。這些資料會自動轉送至網頁應用程式的 firebase-telemetry bucket，或匯出至行動應用程式的 Cloud Logging (以及選用的 Firebase 工作階段資料)。

如要使用 Cloud Monitoring 接收自訂快訊，請設定警告政策，說明警告發送時機及通知方式。

舉例來說，如果未當機率低於特定門檻，或網頁應用程式錯誤率飆升，Cloud Monitoring 就能將自訂快訊訊息傳送至特定電子郵件地址，或發布至 Discord、Slack、PagerDuty 或 Jira 等第三方服務。您也可以完全自訂快訊中傳送的資訊，例如加入 Firebase 控制台的實用深層連結，或公司專屬的疑難排解資訊。

如要進一步瞭解 Cloud Monitoring 和警告 (包括定價)，請參閱 Google Cloud 說明文件。

必要條件

1. 確認 Firebase 專案採用即付即用 Blaze 定價方案。

2. 確認 Cloud Logging 中有 Crashlytics 記錄：

   • 行動應用程式： 設定將Crashlytics資料和 Firebase 工作階段資料 (選用) 匯出至 Cloud Logging。
   • 網頁應用程式：在網頁應用程式中設定 Crashlytics 後，記錄會自動傳送至 firebase-telemetry bucket (firebasetelemetry.googleapis.com/events)。

3. 設定通知管道。

設定警告政策

以下是概略操作說明。如需詳細操作說明，請參閱 Google Cloud 說明文件 (例如：建立指標門檻警告政策或使用 PromQL 建立警告政策)。

執行查詢時，您可以設定記錄檔型快訊或 SQL 型快訊：

• 設定記錄式警告：

  1. 在 Logs Explorer 中執行查詢。

  2. 按一下畫面上顯示的「新增快訊」按鈕。

  3. 按照畫面上的指示新增記錄式警告。

• 設定 SQL 警告：

  1. 在記錄檔分析中執行查詢。

  2. 按一下畫面上顯示的「新增快訊」按鈕。

  3. 按照畫面上的指示，新增以 SQL 為基礎的警告。

或者，您也可以使用 Google Cloud 控制台中的政策設定工具，為記錄指標設定快訊，並選擇下列其中一個選項：

• 建構工具：控制台 UI 提供引導式工作流程，可協助您建構警告政策。

  範例：網頁應用程式錯誤次數激增時發出警告

  如果是網頁應用程式，您可以在 firebase-telemetry Cloud Logging bucket 上建立記錄計數器指標，並使用 Builder 設定門檻警告：

  1. 在 Google Cloud 控制台中，依序前往「Logging」> 「Log-based Metrics」(記錄指標)， 然後按一下「Create Metric」(建立指標)。
  2. 選取「Counter」(計數器) 做為指標類型，並為指標命名 (例如 web_crashlytics_errors)。

  3. 在「Build filter」(建構篩選器) 方塊中，輸入下列 LQL 查詢，計算傳入的網路錯誤記錄：

     logName="projects/PROJECT_ID/logs/firebasetelemetry.googleapis.com%2Fevents"
     severity=ERROR
     

  4. 按一下 [建立指標]。

  5. 在新建立指標的「Actions」(動作) 選單 (三個垂直點) 中，選取「Create alert from metric」(運用指標建立警告)。

  6. 設定「滾動週期」(例如 5 min) 和「滾動週期函式」(rate 或 count)，選擇「高於門檻」做為條件類型，然後選取通知管道 (例如電子郵件、Slack、PagerDuty 或 Webhook)。

• PromQL：為警告政策提供 PromQL 查詢

  PromQL 查詢範例

  舉例來說，假設您為匯出的 Crashlytics 和 Firebase 工作階段資料建立了兩項記錄指標：

  • 一個名為 firebase/crashlytics_events 的指標，標籤為 errorType，定義如下：

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

  • 另一個指標名為 firebase/session_events，標籤為 eventType，定義如下：

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

  以下是使用這些記錄指標的 PromQL 查詢範例，可在無當機率低於 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