寫入應用程式記錄

將要求傳送到在 App Engine 上執行的應用程式時,系統會自動記錄要求和回應的詳細資料,您可以在 Google Cloud Platform 主控台的 Stackdriver 記錄檢視器中查看這些資料。

Stackdriver Logging 代理程式也會收集應用程式的要求和應用程式記錄。請參閱配額政策,瞭解記錄保留政策和記錄項目的大小上限。如要將記錄保留較長時間,您可以將記錄匯出至 Cloud Storage。您也可以將記錄匯出至 BigQuery 和 Pub/Sub 進行後續處理。

如需檢視您可使用的記錄清單,請參閱 App Engine 彈性環境記錄

寫入應用程式記錄

應用程式在處理要求時,會在 stdoutstderr 中寫入本身的記錄訊息。使用 stdout 來寫入應用程式記錄以用於輸出,使用 stderr 以用於錯誤訊息。系統會自動收集這些檔案,您也可以在記錄檢視器中查看這些檔案。請注意,這樣做並不會提供在記錄檢視器中用於篩選的記錄層級,然而,記錄檢視器仍可提供其他篩選,如文字、時間戳記等。記錄檢視器中只有最新的項目會被保留下來,藉此限制項目的大小。

查看應用程式記錄

您可使用記錄檢視器來查看應用程式記錄。

  1. 前往 GCP 主控台的「Stackdriver」>「記錄」頁面:

    前往記錄檢視器頁面

  2. 在頁面頂端選取現有的 GCP 專案。

  3. 從下拉式選單中選取 [GAE Application] (GAE 應用程式) 做為資源類型,以查看 App Engine 記錄。

您可以使用記錄檢視器的下拉式選單和其他元件,來篩選或搜尋相關項目的記錄。詳情請參閱記錄檢視器的篩選器介面

篩選應用程式記錄

如要在記錄檢視器中透過標籤或文字搜尋功能來篩選記錄項目,請參閱基本記錄篩選器

如要寫入進階記錄篩選器以進一步指定一組記錄項目,請參閱進階記錄篩選器

如要檢視特定執行個體、服務或版本的記錄,請按照記錄篩選器中的資源 ID 進行篩選。如要尋找服務和版本 ID,請查看 App Engine 資訊主頁

在記錄檢視器中,可使用「上/下層」格式查看與相同的 trace 相關聯的記錄項目。

關聯記錄項目的操作說明如下:

  1. 決定您要與 request 記錄建立關聯性的應用程式記錄。請注意,如要讓此關聯生效,您必須選擇類型與 request 記錄類型不同的應用程式記錄。

  2. 在您的應用程式程式碼中,尋找傳入要求的 X-Cloud-Trace-Context HTTP 標頭。從標頭中擷取追蹤記錄 ID。詳情請參閱 Stackdriver Trace 支援

  3. 在應用程式記錄項目的 LogEntry trace 欄位中設定 trace ID。格式應為 projects/[PROJECT_ID]/traces/[TRACE_ID]

將記錄項目建立關聯後,請依照下列操作說明,查看相關聯的記錄項目:

  1. 在記錄檢視器中開啟 App Engine 記錄,詳情請參閱查看應用程式記錄

  2. 按一下記錄項目左側的黑色小三角形以展開 request 記錄。您會看到 request 和應用程式記錄以巢狀格式顯示。

此外:

  • 來自「下層」記錄項目的最高層級 severity 不會自動套用到頂層項目。如有上述需求,請在頂層項目中手動設定最高層級的 severity
  • 設定頂層記錄的 httpRequest.requestUrl 欄位。

透過 API 讀取記錄

彈性環境中沒有建立用於讀取 App Engine 記錄的 API。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
App Engine flexible environment for Python docs