快訊：發布 Pub/Sub 主題的運作時間檢查

1. 簡介

上次更新時間：2023 年 6 月 21 日

運作時間檢查的可用性快訊

您可以透過正常運作時間檢查的快訊功能，快速找出並解決可能影響服務的問題。收到服務中斷警報後，您就能採取行動，盡量減少對使用者和客戶的影響。

正常運作時間檢查會以間隔執行，最短間隔為 60 秒。如果需要更精細的資料 (超過 60 秒)，建議您透過以記錄為準的快訊，監控錯誤代碼是否為動態事件，做為無法使用的額外指標。如果可接受 60 秒以上的間隔，運作時間檢查是測量服務的簡單方法，且不需要額外設定。

如果服務無法使用，即使沒有流量，正常運作時間檢查也會偵測到問題。另一方面，流量可能會受到維護、升級等因素影響，甚至系統外部因素 (例如惡劣天氣或體育賽事) 也可能導致使用量下降。

如要進一步瞭解何時該使用運作時間檢查，請參閱「確保 Google Cloud 資源的運作時間」。

將 Pub/Sub 主題設為快訊通知管道

Pub/Sub 主題可做為 Google Cloud Monitoring 通知管道，將快訊傳送至 Pub/Sub 訂閱項目。方便您將 Cloud Monitoring 快訊與其他系統 (包括第三方通知服務) 整合。

如要將 Pub/Sub 主題做為通知管道，請先建立 Pub/Sub 主題和 Pub/Sub 訂閱項目。接著，您需要建立 Cloud Monitoring 通知管道，並將 Pub/Sub 主題做為目的地。

觸發快訊時，Cloud Monitoring 會將訊息傳送至 Pub/Sub 主題。Pub/Sub 訂閱項目的訂閱者隨後即可處理訊息，並採取適當行動。

建構項目

在本程式碼研究室中，您將部署應用程式、建立 Pub/Sub 主題，並為應用程式建立正常運作時間檢查警報，該警報會使用 Pub/Sub 主題做為通知管道。

課程內容

如何建立 Pub/Sub 主題
如何建立運作時間檢查和快訊

本程式碼研究室著重於建立運作時間檢查的快訊。我們不會對與主題無關的概念和應用程式程式碼多做介紹，但會事先準備好這些程式碼區塊，屆時您只要複製及貼上即可。

軟硬體需求

具備下列權限的 Google Cloud 帳戶：
部署 Cloud Run 應用程式
建立 Pub/Sub 主題
建立運作時間檢查
建立快訊

2. 開始設定

選取或建立 Google Cloud 專案

如要選取現有專案，請使用下拉式選單：

如要在 Google Cloud 中建立新專案，請按照下列步驟操作：

前往 Google Cloud Platform Console。
按一下「建立專案」按鈕。
請輸入專案名稱。
選取專案的帳單帳戶。
按一下 [建立] 按鈕。

系統會建立專案，並將您帶往專案資訊主頁。然後即可開始使用 Google Cloud 服務。

以下是各步驟的詳細說明：

名稱：專案名稱在機構內不得重複。
帳單帳戶：你可以使用現有的帳單帳戶或建立新帳戶。
建立：輸入所有必要資訊後，按一下「建立」按鈕即可建立專案。

詳情請參閱 Google Cloud 專案建立說明文件。

3. 部署 API 應用程式

範例應用程式或 API 的用途為何？

我們的應用程式是簡單的 Inventory API 應用程式，會公開 REST API 端點，並提供幾項作業來列出商品目錄項目，以及取得特定項目的商品目錄數量。

部署 API 後 (假設託管於 https://<somehost>)，我們就能存取 API 端點，如下所示：

https://<somehost>/inventory

系統會列出所有產品項目，以及現有庫存量。

https://<somehost>/inventory/{productid}

系統會提供單一記錄，其中包含該產品的產品 ID 和現有庫存量。

傳回的回應資料為 JSON 格式。

注意：這個 API 應用程式僅供示範用途，不代表安全且穩固的 API 實作方式。目的是讓我們快速取得應用程式，探索實驗室的主要用途，也就是 Google Cloud Operations。

資料和 API 要求/回應範例

為簡化操作，應用程式並未在後端使用資料庫。內含 3 個範例產品 ID 和現有庫存量。

產品 ID	現有庫存量
I-1	10
I-2	20
I-3	30

API 要求和回應範例如下所示：

API 要求	API 回應
https://<somehost>/inventory	[ { "I-1": 10, "I-2": 20, "I-3": 30 }]
https://<somehost>/inventory/I-1	{ "productid": "I-1", "qty": 10}
https://<somehost>/inventory/I-2	{ "productid": "I-2", "qty": 20}
https://<somehost>/inventory/I-200	{ "productid": I-200, "qty": -1}

複製存放區

雖然可以透過筆電遠端操作 Google Cloud，但在本程式碼研究室中，您將使用 Google Cloud Shell，這是可在雲端執行的指令列環境。

在 GCP 主控台，按一下右上角工具列的 Cloud Shell 圖示：

佈建並連線至環境的作業需要一些時間才能完成。完成後，您應該會看到如下的內容：

這部虛擬機器搭載您需要的所有開發工具，並提供永久的 5GB 主目錄，而且可在 Google Cloud 運作，大幅提升網路效能並強化驗證功能。您只需要瀏覽器，就能完成本實驗室的所有工作。

設定 gcloud

在 Cloud Shell 中設定專案 ID，並儲存為 PROJECT_ID 變數。

PROJECT_ID=[YOUR-PROJECT-ID]

gcloud config set project $PROJECT_ID

現在，請執行下列指令：

$ git clone https://github.com/rominirani/cloud-code-sample-repository.git

這樣一來，這個資料夾中就會建立名為 cloud-code-sample-repository 的資料夾。

(選用) 在 Cloud Shell 上執行應用程式

如要在本機執行應用程式，請按照下列步驟操作：

在終端機中，使用下列指令前往 Python 版本的 API：

$ cd cloud-code-sample-repository

$ cd python-flask-api

在終端機中提供下列指令 (撰寫本文時，Cloud Shell 已安裝 Python 3.9.x，我們將使用預設版本。如果您打算在筆電上在本機執行，可以使用 Python 3.8 以上版本：

$ python app.py

您可以執行下列指令，在本機啟動 Python 伺服器。

按一下「透過以下通訊埠預覽：8080」。5. 系統會開啟瀏覽器視窗。您會看到 404 錯誤，這沒關係。修改網址，將主機名稱後的內容改為僅有「/inventory」。

舉例來說，在我的電腦上，看起來會像這樣：

https://8080-cs-557561579860-default.cs-asia-southeast1-yelo.cloudshell.dev/inventory

系統會顯示庫存商品清單，如先前所述：

現在前往終端機並按下 Ctrl-C，即可停止伺服器

部署應用程式

現在要將這個 API 應用程式部署至 Cloud Run。這個程序會使用 gcloud 指令列用戶端執行指令，將程式碼部署至 Cloud Run。

在終端機中輸入下列 gcloud 指令：

$ gcloud run deploy --source .

系統會詢問多個問題，以下列出部分問題：

服務名稱 (python-flask-api)：您可以沿用這個預設名稱，也可以選擇其他名稱，例如 my-inventory-api
專案 [613162942481] 未啟用 API [run.googleapis.com]。Would you like to enable and retry (this will take a few minutes)? (y/N)? 是
請指定區域：選擇 31 (us-west-1)
專案 [613162942481] 未啟用 API [artifactregistry.googleapis.com]。Would you like to enable and retry (this will take a few minutes)? (y/N)? 是
從來源部署時，需要 Artifact Registry Docker 存放區來儲存建構的容器。系統會在 [us-west1] 區域中建立名為 [cloud-run-source-deploy] 的存放區。
Do you want to continue (Y/n)? 是
Allow unauthenticated invocations to [my-inventory-api] (y/N)? 是

最終，這會啟動程序，將您的原始碼容器化、推送至 Artifact Registry，然後部署 Cloud Run 服務和修訂版本。請耐心等待這項程序完成 (可能需要 3 到 4 分鐘)，完成後您會看到服務網址。

以下是執行範例：

測試應用程式

應用程式部署至 Cloud Run 後，您就可以透過下列方式存取 API 應用程式：

請記下上一個步驟中的服務網址。舉例來說，在我的設定中，這項資訊會顯示為 https://my-inventory-api-bt2r5243dq-uw.a.run.app。我們將此稱為 <SERVICE_URL>。
開啟瀏覽器，存取下列 3 個 API 端點的網址：
<SERVICE_URL>/inventory
<SERVICE_URL>/inventory/I-1
<SERVICE_URL>/inventory/I-100

應與我們在先前章節中提供的規格相同，並附上 API 要求和回應範例。

從 Cloud Run 取得服務詳細資料

我們已將 API 服務部署至無伺服器運算環境 Cloud Run。我們隨時可以透過 Google Cloud 控制台前往 Cloud Run 服務。

在主選單中，前往 Cloud Run。畫面上會顯示您在 Cloud Run 中執行的服務清單。您應該會看到剛部署的服務。視您選取的名稱而定，畫面應會顯示類似下列的內容：

按一下服務名稱即可查看詳細資料。詳細資料範例如下：

請注意網址，這就是服務網址，您可以在瀏覽器中輸入這個網址，存取我們剛部署的 Inventory API。查看指標和其他詳細資料。

現在就開始使用 Google Cloud 作業套件。

4. 建立 Pub/Sub 主題來接收快訊通知

如要建立 Pub/Sub 主題，請在 Google Cloud 控制台中按照下列步驟操作：

在搜尋方塊中搜尋「Pub/Sub」，然後前往 Pub/Sub。
如果尚未進入「主題」分頁，請按一下這個分頁標籤。
按一下「建立主題」按鈕。
輸入主題名稱。

按一下「建立」按鈕。
使用複製圖示按鈕複製主題名稱。下一節會用到這項資訊。

5. 建立運作時間檢查

如要為 Google Cloud Run 應用程式建立運作時間檢查，請按照下列步驟操作：

前往 Google Cloud Platform Console。
按一下「監控」分頁標籤。
按一下「運作時間檢查」分頁標籤。
按一下頁面頂端的「建立正常運作時間檢查」按鈕。

請使用下列值：
通訊協定：HTTPS
資源類型：網址
主機名稱：輸入 Cloud Run 服務網址，但不要輸入 https。下方螢幕截圖顯示範例。如果不確定服務網址為何，請從 Google Cloud 主控台前往 Cloud Run，然後如先前所述，前往 Cloud Run 服務的詳細資料，取得服務網址。
路徑：healthy
檢查頻率：1 分鐘

按一下 [Continue] (繼續)。
開啟「已啟用內容比對功能」
在「Response Content」(回應內容) 下方輸入「All Izz Well」；應用程式傳送完整回應時，這個字串已在應用程式中。
Keep

將「可接受的 HTTP 回應代碼」設為「回應代碼類別」，並將「2xx」設為唯一的回應代碼類別。這樣一來，系統只會評估回應代碼為 2xx 的字串，其他代碼則會自動計為檢查失敗。
按一下 [Continue] (繼續)。
選取 Cloud Pub/Sub 主題做為通知管道，然後按一下「確定」

按一下 [Continue] (繼續)。
新增容易辨識的標題
按一下「測試」按鈕

檢查並按一下「建立」按鈕

系統會建立運作時間檢查，並開始監控 Cloud Run 應用程式。您可以在「運作時間檢查」分頁中查看運作時間檢查的狀態。

6. 恭喜

恭喜，您已成功設定運作時間檢查，可將快訊傳送至 Pub/Sub！