找出記錄項目的關聯性

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

建立記錄項目關聯後，您可以在記錄檔探索工具中，查看含有多個子項記錄項目的父項記錄項目。

設定相關聯的記錄項目

如要設定相關聯的記錄項目，您可以手動填入 trace 欄位，也可以使用 Google 用戶端程式庫，將追蹤記錄提交至 Cloud Trace，藉此檢測應用程式。系統會自動擷取追蹤資料，並套用下列設定：

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

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

LogEntry 物件中的 trace 欄位會設為下列格式的字串：
```
   projects/PROJECT_ID/traces/TRACE_ID
```
其中 PROJECT_ID 是專案 ID， Google Cloud 是專案 ID，TRACE_ID 則是追蹤 ID。
記錄項目中的 trace 欄位相同。
每個記錄項目都屬於不重複的記錄。也就是說，logName 欄位的值不得相同。

如要查看與您在記錄檔探索工具中檢視的上層記錄項目相關聯的子項記錄項目，請展開該記錄項目。

舉例來說，如要顯示 App Engine 要求的記錄項目和應用程式記錄項目，請按照下列步驟操作：

前往 Google Cloud 控制台的「Logs Explorer」頁面：
前往「Logs Explorer」(記錄檔探索工具)

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Logging」的結果。
在「Resource」(資源) 下拉式選單中，選取「GAE Application」(GAE 應用程式)。
在「記錄檔名稱」下拉式選單中，選取 request_log。
在「查詢結果」窗格中，按一下「展開」，即可展開記錄項目。

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

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

您可以使用查詢，同時搜尋父項和子項記錄項目。搜尋結果會列出符合查詢條件的父項記錄項目，無論查詢條件是否位於父項或子項記錄項目中。舉例來說，如要在子項和父項記錄項目中搜尋字串「app log message」，請執行下列操作：

前往 Google Cloud 控制台的「Logs Explorer」頁面：
前往「Logs Explorer」(記錄檔探索工具)

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Logging」的結果。
在搜尋欄位中輸入 "app log message"，然後按一下「執行查詢」。「Query results」(查詢結果) 窗格會列出包含「app log message」的子項記錄項目。
在「查詢結果」窗格中，按一下「依據關聯性」，然後選取父項記錄。如要查看 App Engine 要求記錄，請選取 request_log，然後按一下「套用」。
「查詢結果」窗格會列出所有包含 "app log message" 字串的父項記錄項目，或是包含該字串的子項記錄項目。

如要查看巢狀子項記錄項目，請展開父項記錄項目，然後點選「展開」。

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

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