探針（Python Agent）版本說明 - Application Real-Time Monitoring Service

本文主要介紹了ARMS應用監控Python探針的版本更新歷史。

查看探針版本

登入ARMS控制台。
在左側導覽列選擇應用監控 > > 探针管理，然後單擊探针版本发布说明頁簽。

探針版本

版本	發布時間	發布說明
3.2.1	2026年8月14日	新增特性新增Strands Agents架構支援：ARMS 應用監控支援的 Python 組件和架構。新增Google GenAI SDK架構支援：ARMS 應用監控支援的 Python 組件和架構。新增LiteStar架構支援：ARMS 應用監控支援的 Python 組件和架構。問題修複修複MAF架構的指標膨脹與上下文斷問題。修複v0.5.16版本以上的SGLang掛載探針後啟動失敗的問題。
3.1.4	2026年8月12日	新增特性業務鏈路觀測與業務參數提取：支援業務參數提取與業務鏈路追蹤：Python 業務參數提取自訂方法監控：新增使用者自訂方法監控插樁（監控方法自訂）：監控方法自訂。 Live-Debug：新增Live-Debug動態問題排查能力：通過 Live-Debug Agent Skill 診斷 Python 應用。支援 AgentScope v2 外掛程式支援：ARMS 應用監控支援的 Python 組件和架構。新增 LoongSuite AutoGen 外掛程式支援：ARMS 應用監控支援的 Python 組件和架構。新增 Microsoft Agent Framework (MAF) 外掛程式支援：ARMS 應用監控支援的 Python 組件和架構。新增 DeepAgents 外掛程式支援：ARMS 應用監控支援的 Python 組件和架構。 Skill 中繼資料採集：Agno、Google ADK、Claude Agent SDK（Skill 載入時採集 `gen_ai.skill.*`），並為工具指標增加 Skill 維度：LLM Trace欄位定義說明。問題修複修複 AgentScope 架構流式 LLM Span 時序錯誤的問題。修複 Agno 架構運行標識傳播、ReAct 步驟拆分及預設打包啟用問題。修複 Qwen-Agent、QwenPaw 架構 Token 統計、嵌套 Agent 追蹤及會話關聯異常問題。修複 Hermes Agent 架構入口 Span 會話關聯異常問題。修複 DashScope 架構多模態媒體輸出未採集的問題。修複 LangChain、Qwen-Agent、Claude Agent SDK 模型響應 ID 採集異常的問題。修複 LangGraph 和 DeepAgents 外掛程式覆蓋使用者圖遞迴限制配置的問題。最佳化 STS 臨時憑證重新整理機制。修複 Claude Agent SDK 將同一次模型響應中的 Reasoning 與最終 Text 錯誤拆分為兩個 LLM Span 的問題。修複 SGLang v0.5.16 及以上版本中 `ServerArgs.enable_trace` 唯讀變更導致的相容性問題。
2.11.3	2026年7月15日	新增特性支援vLLM和SGLang架構的模型思考過程採集。支援OpenAI Responses API的採集。支援gRPC外掛程式的TTFT統計。支援CloudMonitor2.0指標富化。支援指定baggage富化至Span Attributes中。問題修複修複Claude Agent SDK在某些情境調用報錯的問題。修複FastAPI架構在某些情境擷取路由失敗導致調用報錯的問題。修複LLM部分指標的耗時統計單位錯誤問題。修複ASGI外掛程式抑制異常拋出的問題。修複vLLM外掛程式多進程情境下指標統計被平均的問題。規範SGLang架構工具調用記錄格式。
2.10.5	2026年6月22日	新增特性支援anthropic-sdk-python，詳見：ARMS 應用監控支援的 Python 組件和架構。 LLM調用支援採集模型思考過程，詳見：LLM Trace欄位定義說明。 LLM調用支援採集request id，詳見：LLM Trace欄位定義說明。問題修複修複AgentScope架構在某些情境下吞異常的問題。修複持續剖析在pip未安裝情境下安裝上報失敗的問題。修複不符合預期的日誌列印。最佳化部分情境下因指標發散導致的記憶體佔用過高問題。
2.9.0	2026年6月12日	新增特性支援 Qwen-Agent/QwenPaw/Hermes架構，詳見：ARMS 應用監控支援的 Python 組件和架構。 LangChain 外掛程式支援 Rerank 調用觀測。增強 SGLang 推理引擎觀測能力，對於v0.5.9版本以上的SGLang引擎，支援細粒度的效能追蹤（包括分詞器，調度器，Prefill，Decode各組件與階段的耗時），詳見：對vLLM/SGLang推理引擎進行可觀測。問題修複修複 AgentScope ReAct 多輪調用、嵌套 Agent 和並發情境下 Span 狀態可能串擾的問題。修複 Google ADK 流式調用和同 Session 並發調用下 Span 結束時機不準確的問題。修複 CrewAI、Google ADK、LiteLLM 等 AI Agent 架構的 GenAI 語義採集能力。修複 ARMS 探活請求被採集進業務調用鏈的問題。
2.8.3	2026年6月4日	新增特性支援通過OpenTelemetry Python SDK自訂指標。問題修複修複系統指標統計在某些情境下列印錯誤堆棧到使用者標準輸出的問題。修複多進程情境下指標維度發散的問題。修複DashScope外掛程式部分情境下輸出內容未採集的問題。
2.7.0	2026年5月18日	新增特性支援在CloudMonitor2.0的AI Agent可觀測中以AI Agent維度進行觀測。對vLLM/SGLang推理引擎進行可觀測支援PD分離情境。問題修複修複OpenAI外掛程式在LLM調用錯誤時錯誤指標未統計的問題。修複部分情境下由於網路問題導致的探針啟動慢。
2.6.4	2026年4月21日	新增特性 vLLM外掛程式支援Token粒度分析：對vLLM/SGLang推理引擎進行可觀測。支援Python3.14版本，同時停止對Python3.8版本的後續支援。ARMS 應用監控支援的 Python 組件和架構問題修複修複AgentScope架構無首包延時指標上報的問題。相容採集LangGraph的session_id與user_id關聯。修複OpenAI外掛程式Embedding Span沒有記錄gen_ai.provider.name屬性的問題。修複GEVENT情境下伺服器請求崩潰的問題。
2.5.4	2026年4月2日	新增特性支援對Dify ReACT外掛程式的支援：ARMS 應用監控支援的 Python 組件和架構。 LangChain & AgentScope & Dify ReACT支援對ReACT的每一輪迭代進行觀測，詳見LLM Trace欄位定義說明。 vLLM外掛程式支援引擎並發分析與Token層級引擎細粒度觀測，詳見對vLLM/SGLang推理引擎進行可觀測。 vLLM引擎支援Embedding與Rerank操作的可觀測：對vLLM/SGLang推理引擎進行可觀測。問題修複修複公網情況下持續剖析無法開啟的問題。修複Dify Plugin增強失敗的問題。修複指標中上下遊關聯錯誤的問題。修複部分資料庫外掛程式控制台跳轉失敗的問題。修複部分情境下拉取控制台配置失敗的問題。修複Dify部分情境下請求重複計數的問題。修複部分情境下Python3.9應用接入失敗的問題。修複urllib3情境下請求重放的問題。修複FastAPI狀態代碼統計有誤的問題。修複LangChain架構user_id和session_id採集不到的問題。
2.4.3	2026年2月9日	新增特性 OpenAI SDK與Dashscope SDK支援多模態資料擷取，詳見Attributes 文檔LLM小節中`gen_ai.input.messages`，`gen_ai.output.messages`等欄位的樣本輸出。支援Claude Agent SDK架構：ARMS 應用監控支援的 Python 組件和架構。問題修複修複使用OpenTelemetry API部分情境下的null 指標問題。修複與阿里雲上其他SDK共存時的包路徑尋找衝突問題。修複使用低版本Protobuf時配置更新不生效的問題。修複非同步情境下OpenAI外掛程式與LangChain外掛程式的Token記錄重複的問題。修複LangChain架構Chain節點與其餘微服務調用節點串聯失敗的問題。修複部分情境下探活失敗導致上報返回405狀態代碼的問題。
2.3.5	2026年1月16日	新增特性支援PyMySQL以及psycopg2架構的資料庫調用指標統計：ARMS 應用監控支援的 Python 組件和架構。支援mem0架構：ARMS 應用監控支援的 Python 組件和架構。支援新版本MCP架構埋點（小於等於1.25.0）：ARMS 應用監控支援的 Python 組件和架構。支援openai-agents架構：ARMS 應用監控支援的 Python 組件和架構。問題修複修複gRPC架構流式調用指標統計為空白的問題。修複部分情境應用概覽分頁錯誤數指標統計錯誤的問題。修複探針接入導致Dify工作流程鏈路資料上報失敗的問題。修複HTTP架構可能的記錄指標發散導致效能下降的問題。修複Redis架構可能的記錄指標發散導致效能下降的問題。修複通過opentelemetry-api設定baggage失敗的問題。修複OpenAI架構調用無資料的問題。修複部分情境下http 400狀態代碼被統計為5xx的問題。
2.2.2	2025年12月22日	新增特性支援CrewAI架構：ARMS 應用監控支援的 Python 組件和架構。支援LiteLLM架構：ARMS 應用監控支援的 Python 組件和架構。支援AgentScope架構：ARMS 應用監控支援的 Python 組件和架構。支援壓縮重複Span：LLM 大語言模型應用/推理服務接入 ARMS 支援相容1.35.0版本以上的OpenTelemetry API：ARMS 應用監控支援的 Python 組件和架構。同步LoongSuite Python Agent開源最新代碼：變更詳情。問題修複修複LangChain外掛程式首包延時統計不到的問題。修複LangChain外掛程式Tool操作統計不到工具名的問題。修複OpenAI外掛程式首包延時統計不到的問題。修複Dashscope外掛程式流式情境輸入輸出和Token統計錯誤的問題。修複Dashscope外掛程式Rerank操作統計不到的問題。
2.1.3	2025年12月09日	問題修複修複Python3.9版本下LangChain等外掛程式不生效的問題。修複LangChain外掛程式流式調用情境下Token統計錯誤的問題。修複LangChain外掛程式部分情境下記憶體流失的問題。最佳化多Python解譯器情境下探針接入失敗的問題。最佳化大模型推理服務架構探測邏輯。修複探針執行個體數計算不準的問題。
2.1.2	2025年11月24日	新增特性支援Milvus向量資料庫，詳見：ARMS 應用監控支援的 Python 組件和架構。支援Dify Plugin進程的觀測資料擷取，詳見：ARMS 應用監控支援的 Python 組件和架構。支援BlackSheep架構，詳見：ARMS 應用監控支援的 Python 組件和架構。支援Falcon/Starlette/gRPC/MySQL架構的指標彙總，詳見：ARMS 應用監控支援的 Python 組件和架構。支援RagFlow架構，詳見：ARMS 應用監控支援的 Python 組件和架構。支援使用Loguru架構時的日誌關聯TraceID，詳見：ARMS 應用監控支援的 Python 組件和架構。問題修複修複在同時使用LangChain以及OpenAI/Dashscope架構時，Token重複計數的問題。修複控制台外掛程式開關不生效問題。修複Python3.8情境下部分外掛程式增強失敗的問題。修複執行個體監控GC統計次數為負的問題。
2.0.0	2025年10月13日	新增特性新增Google ADK、Tornado、vLLM v1等多個外掛程式的支援，詳見ARMS 應用監控支援的 Python 組件和架構。支援模型交談記錄在日誌中控制 LLM 應用對話歷史採集行為。 OpenAI外掛程式輸入輸出採集對齊最新語義規範，並支援配置大模型內容採集最大長度，詳情請參見 LLM 應用語義規範變更歷史。 Dify應用拆分 APP 的時按照 workspace 進行區分LLM 大語言模型應用/推理服務接入 ARMS 問題修複最佳化探針日誌列印，避免與使用者logger產生衝突。修複探針workspace的計算問題。
1.8.3	2025年9月19日	新增特性支援通過環境變數進行訊息內容欄位長度限制。問題修複統一 OpenAI 相關的日誌記錄器，提升日誌管理的一致性。修複 ARMS_WORKSPACE 為空白時的異常行為。
1.8.2	2025年9月12日	新增特性最佳化 Langchain 外掛程式對於 LLM Span 的輸入輸出展示格式：LLM Trace欄位定義說明。 OpenAI 外掛程式支援統計 LLM 請求數，錯誤數，耗時，token 消耗等指標：LLM指標說明。 OpenAI 外掛程式支援非 UTF-8 字元輸入。 Langchain 外掛程式新增輸入輸出內容採集開關能力：LLM 大語言模型應用/推理服務接入 ARMS。問題修複過濾外部調用中 ECS 元資訊相關請求產生的觀測資料，避免該資料幹擾使用者查詢。修複 Python Agent 在CloudMonitor2.0中執行個體監控跳轉失敗的問題。修複 Python Agent 與高版本 Langfuse SDK 一起使用時 Span 無法上報的問題。修複非雲上環境在標準輸出列印錯誤記錄檔的問題。修複無侵入接入情境下aliyun相關包衝突的問題。修複探針長時間運行情境下可能的資源流失問題。修複部分網路不通情境下啟動慢的問題。
1.8.0	2025年8月15日	新增特性相容高版本 opentelemetry-api（<=1.35.0），詳見支援的 OpenTelemetry API 版本。支援 K8s/ECS metadata 關聯，增強雲環境監控能力。支援 MCP 協議的分布式鏈路追蹤（ propagate 功能）。支援 MCP 1.12.4 版本，版本支援詳見支援的外掛程式版本。支援 SGLang 0.4.9.post6 版本，版本支援詳見支援的外掛程式版本。支援 LangChain 擷取 sessionid、userid 等使用者資訊。 OpenAI/LangChain 新增對 base64 編碼圖片資料的過濾功能，避免上報大量圖片資料。修複內容修複 Flask 外掛程式在多進程情境下的記憶體流失問題。修複 Dify 使用 gevent 時的報錯以及重複注入問題。修複 SGLang 在 0.4.6 版本上無法使用的問題。修複特定條件下接入時 None 值報錯的問題。修複對 OpenAI 外掛程式 Python3.11 以下版本的相容性問題。固定 cramjam 版本為 2.10.0，修複 python 3.8 下依賴庫衝突問題。修複 LangChain 單點模式下可能出現的鏈路斷鏈問題。統一探針載入異常的日誌等級，提升問題排查體驗。
1.6.1	2025年7月28日	修複內容修複探針上報自監控日誌時探活失敗非預期走公網上報的問題。
1.6.0	2025年7月22日	新增特性支援SGlang大語言模型推理架構，詳見對vLLM/SGLang推理引擎進行可觀測。支援MCP架構，詳見ARMS 應用監控支援的 Python 組件和架構。支援Dify 1.4.0版本，接入文檔見將Dify應用接入ARMS應用監控。支援使用者指定探針日誌路徑Python探針使用常見問題。支援使用者指定Python應用類型 LLM 大語言模型應用/推理服務接入 ARMS。修複內容修複Flask外掛程式耗時統計不符合預期的問題。修複Flask外掛程式異常統計次數不準的問題。修複大語言模型應用類型識別失敗的問題。修複openai外掛程式調用異常時，異常資訊展示有誤的問題。修複LangChain外掛程式偶發token計算錯誤。
1.5.1	2025年7月9日	新增特性 Dify外掛程式支援最新版本的 OTel規範詳見待合并的規範的PR。支援上報資料至CloudMonitor2.0。修複內容修複Dify外掛程式Chat/Completion應用調用鏈斷鏈問題。修複Dify外掛程式在使用gevent啟動服務時的不相容報錯。修複部分情境上下遊調用鏈串聯失敗問題。修複部分情境下與其他阿里雲三方依賴的包衝突問題。
1.4.0	2025年6月23日	新增特性 Dify外掛程式支援1.3.0版本，支援輸入/輸出內容採集開關。修複內容移除grpc-exporter相關依賴，減少依賴衝突的可能性。修複DashScope流式情境導致使用者調用失敗的問題。修複None導致的attributes warning，預設不在標準輸出列印nacos錯誤記錄檔。修複Dify工作流程spanKind任務丟失的問題。修複Dify外掛程式輸入輸出重複問題。修複OpenAI非同步呼叫時響應不符合預期的問題。
1.3.1	2025年05月23日	修複內容修複在部分情境下，探針上報資料時服務名等元資訊偶發擷取不到的問題。修複Python探針版本號碼展示錯誤的問題。
1.3.0	2025年04月23日	新增特性支援執行個體/應用層級標籤。支援區分LLM （大語言模型）應用與LLM （大語言模型）服務。修複內容限制Dify架構的支援範圍，防止使用者在使用探針不支援版本的Dify架構時調用報錯。
1.2.0	2025年03月13日	新增特性新增vLLM外掛程式。 Langchain外掛程式新增LLM指標。支援 Python 3.12。修複內容解決與 OpenTelemetry API 的相容性問題。修複 Langchain 外掛程式變更記錄檔層級的問題修複 Langchain 外掛程式 prompts 資訊未採集的問題。
1.1.0	2025年01月06日	支援Dify外掛程式。支援HTTPX外掛程式。支援應用業務日誌關聯調用鏈TraceId，更多資訊，請參見Python應用業務日誌關聯調用鏈TraceId。 OpenAI外掛程式支援LLM（大語言模型）應用指標。 LlamaIndex外掛程式支援LLM（大語言模型）應用指標。 LlamaIndex外掛程式支援首包耗時指標。修複Flask指標Label不對的問題。修複設定Random隨機運算元情境下TraceId、SpanId重複的問題。修複探針與OpenTelemetry包的相容性問題。
1.0.0	2024年9月24日	支援Python應用無侵入地接入ARMS應用監控，提供鏈路追蹤、效能監控、智能警示等能力。