函數計算基于實例生命周期增加多種回調操作,有效解決傳統應用遷移至Serverless架構時遇到的指標數據延遲或丟失等痛點。本文介紹函數計算的運行時擴展功能原理、如何配置PreFreeze和PreStop回調函數及回調函數日志查詢。
背景信息
傳統應用遷移Serverless架構的痛點
傳統常駐的虛擬機或者托管容器類服務通常從實例啟動到結束作為計費區間,即使該時間段沒有業務請求仍納入計費。函數計算提供1 ms計費粒度,且只在有實際請求的區間內計費,在請求以外的時間段內實例會被冷凍。這樣基本消除了完全事件驅動的計費模型的閑置成本。然而冷凍機制也會打破一些傳統架構下long-running進程的假設,加大應用遷移的難度。由于函數計算擁有特殊的運行環境,面對沒有冷啟動的場景,例如常用的開源分布式鏈路追蹤Tracing Analysis庫和第三方APM解決方案等,將無法追蹤并正確上報其數據。
阻礙傳統應用平滑遷移至Serverless架構的痛點如下。
異步背景指標數據延遲或丟失:如果在請求期間沒有發送成功,則可能被延遲至下一次請求,或者數據點被丟棄。
同步發送指標增加延遲:如果在每個請求結束后都調用類似Flush接口,不僅增加了每個請求的延遲,對于后端服務也產生了不必要的壓力。
函數優雅下線受阻:實例關閉時應用有清理連接、關閉進程、上報狀態等需求。在函數計算中實例的下線時機開發者無法掌握,也缺少Webhook通知函數實例下線事件。
函數計算編程模型擴展
函數計算針對上述痛點發布了運行時擴展(Runtime Extensions)功能。該功能在現有的HTTP服務編程模型上擴展,在已有的HTTP服務器的模型中增加了PreFreeze和PreStop Webhooks,擴展開發者實現HTTP handler,監聽函數實例生命周期事件。
PreFreeze
在每次函數計算服務決定冷凍當前函數實例前,函數計算服務會調用HTTP GET /pre-freeze路徑,擴展開發者負責實現相應邏輯以確保完成實例冷凍前的必要操作,例如等待指標發送成功等。函數調用InvokeFunction的時間不包含PreFreeze hook的執行時間。
PreStop
在每次函數計算決定停止當前函數實例前,函數計算服務會調用HTTP GET /pre-stop路徑,擴展開發者負責實現相應邏輯以確保完成實例釋放前的必要操作,如關閉數據庫鏈接,以及上報、更新狀態等。
前提條件
已完成函數的創建,具體請參見創建函數。
使用限制
PreFreeze和PreStop回調函數輸入參數沒有event參數。
PreFreeze和PreStop回調函數無返回值,在函數末尾增加返回邏輯無效。
所有Runtime均支持配置PreStop回調函數;Python、PHP及C# Runtime不支持配置PreFreeze回調函數。
如果使用Java Runtime,您需要將fc-java-core更新至1.4.0及以上版本,否則無法使用PreFreeze和PreStop擴展回調函數。具體操作,請參見HTTP請求處理程序(HTTP Handler)。
如果您使用的是非Web Server模式的Custom Container Runtime,則配置的PreFreeze和PreStop回調無效。
當函數執行返回時,函數計算將凍結函數實例,用戶不可假設調用返回時所有異步進程、線程、協程等執行完成,也不可假設本次異步寫入的日志被刷新。
配置PreFreeze和PreStop回調
喚起PreFreeze或PreStop中產生的費用計費方式與InvokeFunction計費方式一致。具體信息,請參見計費說明。
通過控制臺配置回調
當您使用控制臺創建函數時,函數計算不支持您配置PreFreeze及PreStop回調,您需要在更新函數時配置該回調函數。
- 登錄函數計算控制臺,在左側導航欄,單擊服務及函數。
- 在頂部菜單欄,選擇地域,然后在服務列表頁面,單擊目標服務。
- 在函數管理頁面,單擊目標函數操作列的配置。
在編輯函數配置頁面的實例生命周期回調區域,設置回調程序與超時時間,然后單擊保存。
說明每一個擴展函數都需要配置單獨的回調程序和超時時間,其中回調程序格式為[文件名].[擴展函數名]。例如在Python Runtime中,創建函數時指定的PreStop回調為index.preStopHandler,那么文件名為index.py,PreStop函數名為preStopHandler。
配置擴展函數后,您需要在代碼執行中實現對應的函數。
單擊函數代碼頁簽,在代碼編輯區域,輸入擴展函數代碼。
例如,您配置的PreStop回調程序為
index.preStopHandler
,則需要實現preStopHandler函數。不同語言運行時實現函數實例生命周期回調的方法請參見函數實例生命周期回調方法。說明在線IDE支持PHP、Python、Node.js和Custom Runtime;但不支持Java、Go和.NET這類編譯性語言,以及Custom Container。
單擊代碼編輯器上方的部署代碼,然后單擊測試函數。
通過Serverless Devs配置回調
使用Serverless Devs配置PreFreeze、PreStop擴展函數時,s.yaml
配置文件示例代碼片段如下所示:
codeUri: './code.zip'
......
instanceLifecycleConfig:
preFreeze:
handler: index.PreFreeze
timeout: 60
preStop:
handler: index.PreStop
timeout: 60
如果您需要關閉某個擴展函數,需要將擴展函數的handler
參數顯示置空,否則后端默認不更新。例如關閉PreFreeze函數,您需要按照以下配置進行部署更新,此時PreFreeze函數的timeout
參數已無效。
codeUri: './code.zip'
......
instanceLifecycleConfig:
preFreeze:
handler: ""
timeout: 60
preStop:
handler: index.PreStop
timeout: 60
不同語言運行時實現函數實例生命周期回調的方法請參見函數實例生命周期回調方法。
通過SDK配置回調
您可以通過SDK部署和更新擴展函數。本文介紹如何獲取在創建函數時配置PreStop和PreFreeze函數的SDK示例代碼。
進入CreateFunction - 創建函數頁面,單擊調試,進入OpenAPI門戶。
在參數配置頁簽,根據需要創建函數的基本信息填寫輸入參數。
其中您可以在實例生命周期函數配置
instanceLifecycleConfig
字段配置PreStop和PreFreeze回調。參數配置完成后,單擊SDK示例頁簽,從而獲取對應語言的SDK示例代碼。
不同語言運行時實現函數實例生命周期回調的方法請參見函數實例生命周期回調方法。
函數實例生命周期回調方法
不同語言運行時實現函數實例生命周期回調的方法請參考以下內容。
運行時 | 描述 | 參考文檔 |
Node.js | 通過Node.js實現并應用函數實例生命周期回調方法。 | |
Python | 通過Python實現并應用函數實例生命周期回調方法。 | |
PHP | 通過PHP實現并應用函數實例生命周期回調方法。 | |
Java | 通過Java運行時實現函數實例生命周期回調的方法。 | |
C# | 通過C#運行時實現函數實例生命周期回調的方法。 | |
Go | 通過Go實現函數實例生命周期回調的方法。 | |
Custom Runtime | 通過Custom Runtime實現函數實例生命周期回調的方法。 | |
Custom Container | 通過Web Server模式的Custom Container Runtime實現函數實例生命周期回調的方法。 |
查詢回調函數相關日志
配置函數實例生命周期回調并執行代碼實現對應的回調函數后,您可以查詢實例生命周期回調函數的相關日志。
- 登錄函數計算控制臺,在左側導航欄,單擊服務及函數。
- 在頂部菜單欄,選擇地域,然后在服務列表頁面,單擊目標服務。
在函數管理頁面,單擊目標函數,然后單擊調用日志頁簽。
在調用請求列表頁簽,找到想要查詢的請求行,復制實例 ID,然后單擊高級日志。
您可以使用復制的實例ID,查詢所有生命周期回調函數的Start/End日志;還可以使用
實例ID+函數實例生命周期回調關鍵字
查詢指定回調函數的Start/End日志,例如,c-62833f38-20f1629801fa4bd***** and PreStop
。此外,您還可以根據Start/End日志中的RequestId查詢請求的日志信息。如果用戶日志中沒有RequestId,可以單擊該日志中的圖標獲取上下文日志。
計費說明
擴展HTTP hooks請求數不計費。擴展在單實例多并發的場景下依然適用,假設同時有多個Invoke請求在相同實例執行,在所有請求都結束后,即將冷凍實例之前,會調用一次PreFreeze hook。
以下圖為例,函數規格為1 GB,從t1 PreFreeze開始到t6請求2結束的時間段(假設為1秒),則實例執行時間為t6-t1,消耗1s * 1 GB=1 CU。關于計費方式的具體信息,請參見計費方式。