本文說明如何探索合成監控項的執行記錄,以及如何查看收集到的指標和記錄。
這項功能僅支援 Google Cloud 專案。 如要進行 App Hub 設定,請選取 App Hub 主專案或啟用應用程式的資料夾管理專案。
事前準備
在儲存合成監控項目的 Google Cloud 專案中完成下列步驟:
-
如要取得必要權限,以便使用 Google Cloud 控制台查看合成監控項目的執行結果,請要求管理員為您授予專案的下列 IAM 角色:
-
監控檢視器 (
roles/monitoring.viewer
) -
Cloud Functions 開發人員 (
roles/cloudfunctions.developer
) -
記錄檢視器 (
roles/logging.viewer
)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
-
監控檢視器 (
查看綜合監控作業的執行記錄
如要瞭解通過和失敗的執行作業記錄,請查看綜合監控的「綜合監控詳細資料」頁面:
-
前往 Google Cloud 控制台的
「Synthetic monitoring」(綜合監控) 頁面:
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果。
- 在 Google Cloud 控制台的工具列中,選取您的 Google Cloud 專案。如為「App Hub」設定,請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
- 如要開啟「綜合監控詳細資料」頁面,請找出要查看的綜合監控,然後按一下其名稱。
「綜合監控詳細資料」頁面會列出摘要資訊,例如成功率、持續時間和最近狀態。這個頁面也會繪製執行作業的記錄時間長度圖表,並顯示表格,每個執行作業各佔一行。
資料表中的每一列都會列出狀態、日期、時間長度,並連結至顯示目前程式碼和與該執行作業相關記錄的頁面。
查看執行的記錄和追蹤記錄
如要查看執行的記錄、追蹤記錄和摘要資訊,請在「綜合監控詳細資料」頁面上,按一下執行的連結。您可以在這個頁面執行下列操作:
- 查看記錄資料。
- 查看追蹤資料。
查看目前的程式碼。
存取 Cloud Run 函式。
如果是 Mocha 測試,請查看每項測試的結果。舉例來說,如果合成監控器包含四項 Mocha 測試,測試結果窗格就會包含四個項目。清單中的每個項目都會標示為通過或失敗。
如果選取標示為失敗的項目,系統會顯示並醒目顯示失敗的程式碼。
查看記錄檔資料
Cloud Monitoring 會自動收集記錄。這些記錄檔包含測試資訊和失敗詳細資料。可用的記錄取決於 Cloud Run 函式。舉例來說,如果您使用 Mocha,記錄會包含測試是否通過、測試時間長度,以及失敗時的完整堆疊追蹤。堆疊追蹤包含失敗的程式碼行、錯誤類型和錯誤訊息。
如要查看相關記錄的詳細資料,請在「執行記錄」窗格中展開記錄項目。
記錄項目會以 JSON 格式顯示。如要使用記錄檔探索工具查看記錄,請按一下「在記錄檔探索工具中開啟」。 系統會開啟 Logs Explorer,並預先設定查詢。
查看追蹤記錄資料
Cloud Run 函式執行時,系統會收集追蹤記錄資料。如要查看追蹤資料,請使用 Google Cloud 控制台或 Cloud Trace API。
主控台
如要查看追蹤記錄資料,請執行下列其中一項操作:
如要查看追蹤記錄的摘要資訊,請在執行作業詳細資料頁面的工具列中,按一下「查看追蹤記錄詳細資料」。
「詳細資料」面板隨即開啟,並顯示甘特圖,其中包含追蹤記錄中每個作業記錄的時距資訊。如要查看追蹤記錄及其時距的完整資訊,請按一下「在 Cloud Trace 中查看」,開啟「Trace 探索工具」頁面。
在 Cloud Trace 中查看追蹤記錄:
追蹤記錄和範圍可以在時間軸中包含圓圈,代表執行期間發生的記錄項目或事件。按一下圓圈,即可顯示記錄項目或事件的相關資訊。如要在記錄項目中識別 Cloud Run 函式,請查看 resource.labels.service_name
欄位。
如要進一步瞭解如何探索追蹤記錄資料,請參閱「尋找及探索追蹤記錄」。
API
建議您使用 Google Cloud 控制台查看追蹤資料。
不過,如要使用 Cloud Trace API,請使用 traces.list
方法列出可用的追蹤記錄,然後使用 traces.get
方法取得追蹤記錄的詳細資料。
查看 Cloud Run 函式的記錄和指標
記錄和指標會提供 Cloud Run 函式執行的動作相關資訊。舉例來說,如果記錄包含名為 userAgent
的欄位,且值為 GoogleStackdriverMonitoring-UptimeChecks
,表示您的服務收到運作時間檢查服務的要求。
本節的其餘部分說明如何查看 Cloud Run 函式收集的記錄和指標。
查看函式記錄檔
主控台
如要查看 Cloud Run 函式記錄,請按照下列步驟操作:
- 在綜合監控項目名稱所在的窗格中,按一下 Cloud Run 函式名稱。
- 在「Function details」(函式詳細資料) 頁面中,選取「Logs」(記錄檔) 分頁標籤。
如要進一步探索圖表中的記錄資料,請展開記錄項目,然後選取「在記錄檔探索工具中開啟」。 在 Logs Explorer 中,您可以執行修正查詢、建立記錄指標或建立記錄警告等動作。
API
如要瞭解如何以程式輔助方式讀取及寫入 Cloud Run 函式記錄,請參閱「寫入、查看及回應記錄檔」。
查看函式指標
如果是綜合監控項目,指標會由 Cloud Monitoring 和 Cloud Run 函式收集:
Cloud Monitoring 會收集每個合成監控項執行作業的指標。這些指標包括程式碼執行延遲時間和成功記錄。如要瞭解如何查看這些指標,請參閱查看綜合監控項目的執行記錄。
Cloud Run functions 會收集每個 Cloud Run 函式的指標。這些指標會記錄每個區段的執行時間、記憶體使用率、執行個體計數和叫用次數。本節的其餘部分將說明如何查看這些指標。
主控台
如要查看 Cloud Run 函式指標,請按照下列步驟操作:
- 在綜合監控項目名稱所在的窗格中,按一下 Cloud Run 函式名稱。
- 在「Function details」(函式詳細資料) 頁面中,選取「Metrics」(指標) 分頁標籤。
如要放大特定時間範圍,請按照下列步驟操作:
- 在圖表上,將指標放在時間範圍的一端,然後按一下指標左鍵。
- 將指標水平拖曳至時間範圍的另一端,然後放開指標按鈕。
如要進一步探索圖表中顯示的資料,請在圖表工具列中選取「更多圖表選項」more_vert,然後進行選取。相關選項包括:
- 將圖表下載為 PNG 或 CSV 檔案
- 將圖表儲存至自訂資訊主頁
- 開啟 Metrics Explorer
- 展開或收合圖表圖例
- 重設縮放比例