剖析 Python 應用程式

gcloud CLI

1. 如果您尚未在工作站上安裝 Google Cloud CLI，請參閱 Google Cloud CLI 說明文件。

2. 執行下列指令：

   gcloud services enable cloudprofiler.googleapis.com
   

詳情請參閱 gcloud services。

Google Cloud 控制台

1. Enable the required API.

   Enable the API

2. 如果畫面顯示「API enabled」，代表 API 已啟用。如果未顯示，請按一下「啟用」按鈕。

Compute Engine

如果是 Compute Engine，請執行下列操作：

1. 安裝 C/C++ 編譯器和開發工具：

   sudo apt-get install -y build-essential
   

2. 安裝 pip：

   sudo apt-get install -y python3-pip
   

3. 安裝 Profiler 套件：

   pip3 install google-cloud-profiler
   

4. 匯入 googlecloudprofiler 模組，並盡早在初始化程式碼中呼叫 googlecloudprofiler.start 函式：

   import googlecloudprofiler
   
   
   def main():
       # Profiler initialization. It starts a daemon thread which continuously
       # collects and uploads profiles. Best done as early as possible.
       try:
           googlecloudprofiler.start(
               service="hello-profiler",
               service_version="1.0.1",
               # verbose is the logging level. 0-error, 1-warning, 2-info,
               # 3-debug. It defaults to 0 (error) if not set.
               verbose=3,
               # project_id must be set if not running on GCP.
               # project_id='my-project-id',
           )
       except (ValueError, NotImplementedError) as exc:
           print(exc)  # Handle errors here

   您必須在 start 函式中指定 service 參數。如要在 Profiler 介面中依應用程式版本進行篩選，請指定 service_version 參數。如需疑難排解和例外狀況的相關資訊，請參閱「疑難排解」一節。

GKE

如果是 GKE，請執行下列操作：

1. 修改 Dockerfile 來安裝 Profiler 套件：

   FROM python:3
   ...
   RUN apt-get update && apt-get install -y build-essential python3-pip
   RUN pip3 install google-cloud-profiler
   

2. 匯入 googlecloudprofiler 模組，並盡早在初始化程式碼中呼叫 googlecloudprofiler.start 函式：

   import googlecloudprofiler
   
   
   def main():
       # Profiler initialization. It starts a daemon thread which continuously
       # collects and uploads profiles. Best done as early as possible.
       try:
           googlecloudprofiler.start(
               service="hello-profiler",
               service_version="1.0.1",
               # verbose is the logging level. 0-error, 1-warning, 2-info,
               # 3-debug. It defaults to 0 (error) if not set.
               verbose=3,
               # project_id must be set if not running on GCP.
               # project_id='my-project-id',
           )
       except (ValueError, NotImplementedError) as exc:
           print(exc)  # Handle errors here

   您必須在 start 函式中指定 service 參數。如要在 Profiler 介面中依應用程式版本進行篩選，請指定 service_version 參數。如需疑難排解和例外狀況的相關資訊，請參閱「疑難排解」一節。

彈性環境

如果是 App Engine 彈性環境，請按照下列步驟操作：

1. 將 google-cloud-profiler 新增至 requirements.txt 檔案。

2. 匯入 googlecloudprofiler 模組，並盡早在初始化程式碼中呼叫 googlecloudprofiler.start 函式。

在 App Engine 中，service 和 service_version 是衍生自您的作業環境。如需疑難排解和例外狀況的相關資訊，請參閱疑難排解一節。

標準環境

如果是 App Engine 標準環境 (您必須使用 Python 3 執行階段環境)，請按照下列步驟操作：

1. 將 google-cloud-profiler 新增至 requirements.txt 檔案。

2. 匯入 googlecloudprofiler 模組，並盡早在初始化程式碼中呼叫 googlecloudprofiler.start 函式。

在 App Engine 中，service 和 service_version 是衍生自您的作業環境。如需疑難排解和例外狀況的相關資訊，請參閱「疑難排解」一節。