本文說明如何探索合成監控項的執行記錄,以及如何查看收集到的指標和記錄。
這項功能僅支援 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 中查看追蹤記錄:
-
前往 Google Cloud 控制台的「Trace Explorer」頁面:
您也可以透過搜尋列找到這個頁面。
- 在 Google Cloud 控制台的工具列中,選取您的 Google Cloud 專案。如要進行 App Hub 設定,請選取 App Hub 主專案或管理專案。
- 在熱度圖或表格中選取追蹤記錄。
-
追蹤記錄和範圍可以包含時間軸中的圓圈,代表執行期間發生的記錄項目或事件。按一下圓圈,即可顯示記錄項目或事件的相關資訊。如要在記錄項目中識別 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
- 展開或收合圖表圖例
- 重設縮放比例