關聯記錄項目

本文說明如何使用記錄檢視器，以「父子」格式分組及查看記錄項目。通常將記錄項目寫入 Cloud Logging 時，每個記錄項目都會單獨顯示，且不相關。不過，您可以使用 LogEntry 物件中的 trace 欄位，將記錄項目分組或建立關聯。

建立記錄項目關聯後，您就能在 Logs Explorer 中查看含有多個子項記錄項目的父項記錄項目。

設定相關聯的記錄項目

如要設定相關記錄項目，您可以手動填入 trace 欄位，也可以使用 Google 用戶端程式，為應用程式進行檢測，以便將追蹤記錄提交至 Cloud Trace。以下設定會自動擷取追蹤記錄資料：

• App Engine 標準環境

• Cloud Run 函式和 Cloud Run

如要瞭解如何檢測應用程式以收集追蹤記錄資料，請參閱「檢測 Cloud Trace 的總覽」。

如要讓記錄檔探索工具將一系列記錄項目建立關聯，這些記錄項目必須符合下列規定：

• LogEntry 物件中的 trace 欄位會設為格式如下的字串：

     projects/PROJECT_ID/traces/TRACE_ID
  

  其中 PROJECT_ID 是您的 Google Cloud 專案 ID，TRACE_ID 則是追蹤識別碼。

• 記錄項目中的 trace 欄位相同。

• 每個記錄項目都屬於一個專屬記錄。也就是說，logName 欄位的值必須不同。

在 Logs Explorer 中查看相關聯的記錄項目

如要查看與您在 Logs Explorer 中查看的父項記錄項目相關聯的子項記錄項目，請展開記錄項目。

舉例來說，如要顯示 App Engine 要求記錄項目和應用程式記錄項目，請執行下列操作：

1. 前往 Google Cloud 控制台的「Logs Explorer」頁面：

   前往「Logs Explorer」(記錄檔探索工具)

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

2. 在「Resource」下拉式選單中，選取「GAE Application」。

3. 在「Log Name」下拉式選單中，選取 request_log。

4. 如要展開記錄項目，請在「查詢結果」窗格中按一下 chevron_right「展開」。

   與要求記錄項目相關聯的應用程式記錄項目會嵌套在要求記錄項目中：

   

   在上一個螢幕截圖中，父項記錄項目有 10 個子項記錄項目。您可以展開這些子項記錄，查看詳細資料。

搜尋相關聯的記錄項目

相關搜尋可讓您透過查詢搜尋父項和子項記錄項目。搜尋結果會列出父項或子項記錄項目中，與查詢相符的父項記錄項目清單。舉例來說，如要在子項目和父項記錄中搜尋「app log message」字串，請執行下列操作：

1. 前往 Google Cloud 控制台的「Logs Explorer」頁面：

   前往「Logs Explorer」(記錄檔探索工具)

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

2. 在搜尋欄位中輸入 "app log message，然後按一下「執行查詢」。包含「應用程式記錄訊息」的子項記錄項目會列在「查詢結果」窗格中。

3. 在「查詢結果」窗格中，按一下「依據以下項目進行關聯」，然後選取父項記錄。如要查看 App Engine 要求記錄，請選取 request_log，然後按一下「Apply」(套用)。

4. 在「查詢結果」窗格中，系統會列出所有包含字串 "app log message" 的父項記錄項目，或是包含包含該字串的子項記錄項目。

   如要查看巢狀子項記錄項目，請展開父項記錄項目，然後按一下 chevron_right「展開」。

   

   在上一個螢幕截圖中，父項記錄包含 10 個子項記錄，其中包含「app log message」字串。您可以展開這些子日誌項目，查看詳細資料。

   如果您選取父項記錄，但「Query results」窗格中沒有任何記錄項目，表示沒有與查詢相符的相關聯父項和子項。

後續步驟

• 如要瞭解如何檢測應用程式以用於 Cloud Trace，請參閱「檢測 Cloud Trace 的簡介」。

• 如要瞭解 App Engine 要求記錄和應用程式記錄，請參閱「讀取及寫入應用程式記錄」。