結構化記錄

在 Cloud Logging 中，LogEntry 物件可以將記錄酬載儲存為結構化資料或非結構化文字。「結構化」記錄項目會將酬載儲存為 jsonPayload 欄位中的 JSON 物件，而「非結構化」記錄項目則會將酬載儲存為 textPayload 欄位中的字串。

將記錄酬載格式化為 JSON 物件，即可在 Logs Explorer 中，依 JSON 路徑搜尋及查詢。使用非結構化記錄時，您可以搜尋文字字串，但無法查詢個別索引鍵。

結構化記錄的寫入方式

結構化記錄項目寫入 Logging 的方式，取決於您的環境和記錄收集方式：

• Logging 用戶端程式庫：當您傳遞 JSON 物件或對應做為酬載，或將單行 JSON 輸出至 stdout 或 stderr 時，這些程式庫會寫入結構化記錄。

• Google Cloud CLI 或 Logging API：您可以使用 --payload-type=json 旗標執行 gcloud logging write (範例)，或使用 jsonPayload 物件呼叫 entries.write API 方法。

後續步驟

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

• 如要使用 gcloud CLI 讀取記錄項目，請參閱「讀取記錄項目」。

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