設定及管理通知

電子郵件

如要新增電子郵件通知管道，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的 notifications「Alerting」(警告) 頁面：

   前往「Alerting」(快訊)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主機專案或啟用應用程式的資料夾管理專案。
3. 按一下「編輯通知管道」。
4. 在「Email」部分中，按一下「Add new」。
5. 輸入一個電子郵件地址和說明。
6. 按一下 [儲存]。

如果您使用群組電子郵件地址做為警告政策的通知管道，請將群組設為接受來自 ErrorReportingNotifications-noreply@google.com 的郵件。

行動應用程式

使用 Google Cloud 主控台行動應用程式，即可隨時隨地監控 Google Cloud 主控台資源和監控資訊。 Google Cloud 主控台行動應用程式通知會傳送至特定裝置或特定使用者：

• 「裝置」表示通知只會傳送至建立通知管道的特定裝置。如果是裝置層級的通知管道，則「顯示名稱」欄位會包含裝置資訊。
• 使用者：表示通知會傳送至所有已安裝 Google Cloud 控制台行動應用程式的裝置。

Cloud Monitoring 會在建立管道時決定通知範圍。您無法選取或變更範圍。

如要為特定 Google Cloud 專案設定 Google Cloud 主控台行動應用程式通知管道，請按照下列步驟操作：

1. 從行動裝置的應用程式商店安裝 Google Cloud 主控台行動應用程式。

2. 在 Google Cloud 控制台行動應用程式中選取要查看的專案。

   選取專案後，應用程式與所選 Google Cloud 專案之間就會進行資料交換。如果系統偵測到沒有通知管道，就會建立一個。幾分鐘後，這個管道就會列在「通知管道」頁面的「行動裝置」部分。

如要將行動裝置新增為快訊政策的通知管道，請在「Notifications」(通知) 區段中選取「Google Cloud console (行動版)」，然後從清單中選擇行動裝置。

Slack

如要設定 Slack 通知，請按照下列步驟操作：

1. 在 Slack 中：前往 Slack 網站建立 Slack 工作區和管道。記下頻道網址。

2. 前往 Google Cloud 控制台的 notifications「Alerting」(警告) 頁面：

   前往「Alerting」(快訊)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

3. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主機專案或啟用應用程式的資料夾管理專案。

4. 按一下「編輯通知管道」。

5. 在「Slack」部分，按一下「新增」，開啟 Slack 登入頁面：

   1. 選取 Slack 工作區。
   2. 點選「允許」，啟用 Cloud Monitoring 存取 Slack 工作區的權限。這項操作會將您帶回通知管道監控設定頁面。
   3. 在「Slack 頻道名稱」欄位中，輸入要用於通知的 Slack 頻道名稱。
   4. 在「Cloud Alerting Display Name」欄位中，輸入簡短的說明性陳述。監控會在「通知管道」頁面上顯示這個欄位的值。
   5. (選用) 如要測試 Cloud Monitoring 與 Slack 工作區之間的連線，請按一下「Send test notification」。如果連線成功，您會在指定的 Slack 通知管道中看到訊息 This is a test alert notification...。請查看通知管道來確認接收情況。

6. 如果您要用於通知的 Slack 頻道是私人頻道，則必須手動邀請 Monitoring 應用程式加入頻道：

   1. 開啟 Slack。

   2. 前往您指定的監控通知管道。

   3. 在頻道中輸入並傳送下列訊息，邀請 Monitoring 應用程式加入頻道：

      /invite @Google Cloud Monitoring

      請務必在 Monitoring 中建立通知管道時，將 Monitoring 應用程式邀請至您指定的私人管道。邀請 Monitoring 應用程式加入公開頻道是可選步驟。

Webhook

設定 Webhook 通知管道前，請考量下列事項：

• Webhook 僅支援公開端點。公開端點可透過公開網際網路存取，例如 HTTP (port:80) 或 HTTPS (port:443)。通知服務必須能夠建立與端點的連線，並在 HTTPS 的情況下驗證伺服器的安全憑證。
• 如果 Cloud Run 函式已設定為通知管道的 webhook 端點，請確認叫用函式的使用者具有必要的驗證權限。詳情請參閱「為叫用程序進行驗證」和「啟用函式存取權」。
• Webhook 通知管道與 Microsoft Teams 不相容。 如要將通知資料從 Monitoring 傳送至 Microsoft Teams，請建立整合層來接收 Monitoring Webhook，然後將其重新導向至 Microsoft Teams。

設定 Webhook 通知管道

如要設定 Webhook 通知，請按照下列步驟操作：

1. Webhook 處理常式：識別要接收 Monitoring Webhook 資料的公開端點網址。

2. 前往 Google Cloud 控制台的 notifications「Alerting」(警告) 頁面：

   前往「Alerting」(快訊)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

3. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如要設定 App Hub，請選取 App Hub 主機專案或啟用應用程式的資料夾管理專案。
4. 按一下「編輯通知管道」。
5. 在「Webhook」部分中，按一下「新增」。
6. 完成對話方塊。
7. 按一下「Test Connection」，將測試酬載傳送至 Webhook 端點。您可以前往接收端點，確認是否已送達。
8. 按一下 [儲存]。

Webhook 結構定義

基本驗證

除了 Cloud Monitoring 傳送的 webhook 要求外，基本驗證機制還會使用 HTTP 規格來處理使用者名稱和密碼。Cloud Monitoring 要求您的伺服器傳回 401 回應，並附上適當的 WWW-Authenticate 標頭。如要進一步瞭解基本驗證功能，請參閱下列資源：

• RFC 規格
• 基本驗證

權杖驗證

權杖驗證功能需要端點網址中的查詢字串參數，以及伺服器希望在自身和監控服務之間保密的金鑰。以下是含有符記的網址範例：

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

如果監控功能將事件發布至端點網址，您的伺服器就能驗證附加的權杖。這種驗證方法最有效的做法是搭配 SSL/TLS 使用，以便加密 HTTP 要求，防止窺探者瞭解權杖。

如需 Python 中的伺服器範例，請參閱這個伺服器範例。