結構化記錄

本文將討論結構化記錄的概念，以及為記錄項目酬載欄位新增結構的方法。如果記錄酬載的格式為 JSON 物件，且該物件儲存在 jsonPayload 欄位中，則該記錄項目稱為結構化記錄。對於這些記錄，您可以建構查詢來搜尋特定 JSON 路徑，也可以為記錄酬載中的特定欄位建立索引。反之，如果記錄檔酬載格式為字串，並儲存在 textPayload 欄位中，記錄項目就是非結構化。您可以搜尋文字欄位，但無法為其內容建立索引。

如要建立結構化記錄項目，請執行下列任一操作：

• 呼叫 entries.write API 方法，並提供格式完整的 LogEntry。
• 使用 gcloud logging write 指令。

如要進一步瞭解這些方法，請參閱下列章節。

使用 gcloud CLI 寫入記錄

您可以使用 gcloud CLI 寫入記錄資料。這個介面支援非結構化記錄和結構化記錄。如要寫入結構化記錄，請提供序列化 JSON 物件給指令。

如需快速入門，請參閱「使用 Google Cloud CLI 寫入及查詢記錄項目」。

如需程式碼範例，請參閱 gcloud logging write 參考資料。

後續步驟

• 如要查詢及查看記錄項目，請參閱「使用 Logs Explorer 查看記錄檔」。

• 如要使用 Google Cloud CLI 讀取記錄項目，請參閱讀取記錄項目一文。

• 如要使用 Logging API 讀取記錄項目，請參閱 entries.list 方法。