記錄資料庫總覽

許多程式設計語言都有標準記錄寫入介面，您可以重新設定這些介面，以便使用 Logging。

注意： 請檢測應用程式，收集特定資訊，協助您瞭解應用程式效能及排解故障。多個開放原始碼檢測架構會收集記錄、指標和追蹤記錄資料，並可將這些資料傳送至任何供應商，包括 Google Cloud。對於代理應用程式，部分架構可以收集提示和回覆，或傳遞情境資訊，以便追蹤某些遠端 Google Cloud MCP 伺服器呼叫。

如要檢測應用程式，建議您使用開放原始碼、不限供應商的檢測架構，例如 OpenTelemetry，而非供應商和產品專屬的 API 或用戶端程式庫。如要瞭解這些架構，請參閱「 應用程式開發人員觀測能力」和「選擇檢測方法」。

寫入記錄

如要將記錄寫入 Cloud Logging，可以採取下列任一做法：

• 將記錄寫入 Compute Engine VM 執行個體上的現有記錄檔 (例如 syslog)，並使用 Ops Agent 將記錄傳送至 Cloud Logging。詳情請參閱「Google Cloud Observability 代理程式」。
• 設定標準記錄套件，將您寫入的記錄傳送至 Logging。詳情請參閱下列詳細資料頁面：
  • 任何語言：fluentd
  • C#：使用 ASP.NET 或呼叫 API
  • Java：使用 Logback 和 java.util.logging
  • Go：使用標準記錄
  • Node.js：使用 Winston 和 Bunyan
  • PHP：使用 PSR-3 記錄器
  • Python：使用標準記錄功能
  • Ruby：使用 Google Cloud Observability gem
• 使用 Logging 的用戶端程式庫，以您的程式設計語言呼叫 Logging API。
• 直接呼叫 Logging API REST 端點。 請參閱 Logging API 參考文件。
• 使用 gcloud CLI。詳情請參閱 gcloud logging 指令列介面。

注意： 如果傳入記錄項目的時間戳記早於記錄保留期限，或晚於 24 小時後，系統會捨棄該項目。

將追蹤記錄資料與記錄項目建立關聯

記錄項目可能包含追蹤記錄的相關資訊。在記錄項目中加入追蹤資料，即可建立記錄和追蹤記錄之間的關聯，進而更有效地排解分散式問題。如要瞭解如何手動和自動擷取記錄項目中的追蹤記錄資訊，請參閱「與 Cloud Logging 整合」。

讀取記錄

如要在 Logging 中讀取記錄項目，您可以執行下列任一操作：

• 前往 Google Cloud 控制台的 segment「Logs Explorer」頁面：

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

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

  詳情請參閱「Logs Explorer 總覽」。

• 透過程式設計語言的用戶端程式庫呼叫 Logging API。

• 直接呼叫 Logging API REST 端點。請參閱 Logging API 參考文件。

• 使用 gcloud CLI。詳情請參閱 gcloud logging 指令列介面。