讀取及寫入應用程式記錄

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

總覽

當要求傳送至您的應用程式時，App Engine 會自動寫入要求記錄。在處理要求的期間，應用程式也可寫入應用程式記錄。本頁將說明如何從應用程式寫入應用程式記錄檔、如何在Google Cloud 主控台查看記錄，以及如何瞭解 App Engine 在要求期間寫入的要求記錄資料。

如要瞭解如何下載記錄資料，請參閱「記錄匯出總覽」。

要求記錄和應用程式記錄的比較

記錄資料有兩種，分別是要求記錄和應用程式記錄。要求記錄是由 App Engine 針對應用程式處理的各項要求自動寫入的，其中含有專案 ID、HTTP 版本等資訊。如需要求記錄可用屬性的完整清單，請參閱 RequestLog 一文。如需要求記錄欄位的說明，另請參閱要求記錄表。

每筆要求記錄都包含一份與該要求相關聯的應用程式記錄 (AppLog) 清單，該清單是透過 RequestLog.app_logs 屬性傳回。每筆應用程式記錄都包含寫入記錄的時間、記錄訊息與記錄層級。

寫入應用程式記錄檔

Python 記錄模組可讓開發人員記錄下列 5 種嚴重性等級：

• 偵錯
• 資訊
• 警告
• 錯誤
• 重要

以下範例說明如何使用不同的記錄等級：

import logging

import webapp2


class MainPage(webapp2.RequestHandler):
    def get(self):
        logging.debug('This is a debug message')
        logging.info('This is an info message')
        logging.warning('This is a warning message')
        logging.error('This is an error message')
        logging.critical('This is a critical message')

        try:
            raise ValueError('This is a sample value error.')
        except ValueError:
            logging.exception('A example exception log.')

        self.response.out.write('Logging example.')


app = webapp2.WSGIApplication([
    ('/', MainPage)
], debug=True)

Google Cloud 控制台中的記錄網址格式

以下範例網址是 Google Cloud 主控台中記錄網址格式的範例：

https://console.cloud.google.com/logs?filters=request_id:000000db00ff00ff827e493472570001737e73686966746361727331000168656164000100

在主控台讀取記錄

如要查看在標準環境中執行的應用程式所寫入的記錄，請使用記錄檔探索工具。

一般來說，App Engine 記錄包含採用 Apache 合併記錄格式的資料，以及一些特殊的 App Engine 欄位，如以下記錄範例所示：

192.0.2.0 - test [27/Jun/2014:09:11:47 -0700] "GET / HTTP/1.1" 200 414
"http://www.example.com/index.html"
Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.153 Safari/537.36"
"1-dot-calm-sylph-602.appspot.com" ms=195 cpu_ms=42 cpm_usd=0.000046
loading_request=1 instance=00c61b117cfeb66f973d7df1b7f4ae1f064d app_engine_release=

瞭解要求記錄欄位

下表按照顯示順序列出欄位，並提供說明：

配額與限制

應用程式會受到下列記錄相關配額影響：

• 透過 Logs API 擷取的記錄資料。
• 記錄內容擷取的配額與保留期。

擷取資料的配額

每天透過 Logs API 呼叫擷取的記錄資料中，前 100 MB 的資料為免費。超過 100 MB 的資料每 GB 會產生 $0.12 美元的費用。

記錄內容擷取配額

App Engine 應用程式的記錄功能是由 Google Cloud Observability 提供。如要進一步瞭解記錄費用與限制，請參閱 Google Cloud Observability 定價。如要長期儲存記錄，您可以從 Google Cloud Observability 將記錄匯出至 Cloud Storage、BigQuery 和 Pub/Sub。

開發伺服器與 Logs API

根據預設，記錄只會儲存在開發伺服器的記憶體中，且可在您想測試 Logs API 功能時存取。如果您想將開發伺服器中的記錄保留在您自選的磁碟位置，請在 --logs_path 指令列選項中提供所要的路徑和檔案名稱，如下所示：

   python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py --logs_path=your-path/your-logfile-name your-app-directory