可觀測性云原生運維【免費下載鏈接】hyperdxResolve production issues, fast. An open source observability platform unifying session replays, logs, metrics, traces and errors powered by ClickHouse and OpenTelemetry.項目地址https://gitcode.com/gh_mirrors/hy/hyperdx點擊查看免費下載本文以 HyperDX 倉庫根目錄 CHANGELOG.md 為骨架系統(tǒng)梳理 v2.29.0 至 v2.39.1 十個版本的演進脈絡(luò)告警與 Webhook、圖表與查詢引擎、儀表盤變量與過濾器、LLM 可觀測性、MCP 服務(wù)器、采集器與存儲運維、安全加固等主線能力逐一對應(yīng)真實源碼與配置文件給出實現(xiàn)依據(jù)并整理全部破壞性變更與升級前必讀的配置項幫助自托管用戶與集成開發(fā)者安全升級、充分使用新特性。版本概覽發(fā)布節(jié)奏與文檔組織方式HyperDX 的根級 CHANGELOG.md 記錄所有包hyperdx/api、hyperdx/app、hyperdx/cli、hyperdx/common-utils、hyperdx/hdx-eval、hyperdx/otel-collector的跨包發(fā)布級要點。每條記錄由 AI 在發(fā)版時生成并在 Release HyperDX PR 中人工復(fù)核編輯時需保留hyperdx-release-notes注釋標記否則改動會在重新生成時丟失。每個包的詳細變更分別記錄在各自的packages/*/CHANGELOG.md中packages/api/CHANGELOG.md — 后端 API、告警任務(wù)、MCP 服務(wù)端packages/app/CHANGELOG.md — 前端應(yīng)用與頁面packages/cli/CHANGELOG.md — 終端 CLIhdxpackages/common-utils/CHANGELOG.md — 前后端共享工具庫packages/hdx-eval/CHANGELOG.md — 評測框架packages/otel-collector/CHANGELOG.md — Go 采集器近十次發(fā)版節(jié)奏約為每周一次v2.30.1、v2.31.0、v2.32.0 密集于 2026 年 7 月到 v2.39.12026-09-19為止主線穩(wěn)定。從源碼結(jié)構(gòu)看根 CHANGELOG 還會被前端 Whats new 功能在構(gòu)建期解析渲染見 packages/app/CHANGELOG.md 中對應(yīng)條目即發(fā)布說明本身就是產(chǎn)品內(nèi)可讀的內(nèi)容資產(chǎn)。告警體系從單 Webhook 到完整告警生命周期告警是近十個版本中迭代最密集的模塊能力演進幾乎貫穿每一條發(fā)布主線。模板變量驅(qū)動的 Webhook 負載v2.38.0 起Generic 與 incident.io 兩種 Webhook 正文是 Handlebars 模板可用的模板變量從最初的 7 個擴充到完整集合。以倉庫內(nèi) docs/alert-webhook-template-variables.md 為準完整變量表如下變量類型說明{{title}}/{{body}}/{{link}}string標題、渲染后的消息體markdown、回鏈{{state}}/{{eventId}}string內(nèi)部告警狀態(tài)、本次 firing 的唯一 id{{startTime}}/{{endTime}}number評估窗口Unix 毫秒{{startTimeISO}}/{{endTimeISO}}string同一窗口的 ISO-8601 形式{{alertId}}string告警本身的穩(wěn)定 id是去重的關(guān)鍵{{status}}stringfiring、resolved、no_data、pending、error{{alertType}}stringsearch、dashboard_chart、inline_query{{comparator}}string、、、、、!、between、outside{{threshold}}/{{thresholdMax}}number閾值between/outside時前者為下界、后者為上界{{value}}number觸發(fā)或恢復(fù)告警的值{{groupKey}}string分組告警中的違約分組{{sourceQuery}}string告警實際評估的條件搜索表達式或 SQL{{teamId}}/{{note}}string所屬團隊、自由文本備注常放 runbook 鏈接所有字符串變量 JSON 轉(zhuǎn)義數(shù)字變量原樣輸出富化變量均為可選告警不攜帶時渲染為空串。文檔還給出了一段可直接使用的示例模板按嚴重程度路由、按alertId去重{ alert_id: {{alertId}}, dedup_key: {{alertId}}-{{groupKey}}, status: {{status}}, summary: {{title}}, urgency: {{#if (eq alertType \dashboard_chart\)}}low{{else}}high{{/if}}, value: {{value}}, threshold: {{threshold}}, window: { start: {{startTimeISO}}, end: {{endTimeISO}} }, runbook: {{note}}, link: {{link}} }配套的實操要點均來自 docs/alert-webhook-template-variables.md可選數(shù)字必須防缺失用{{#unless (eq thresholdMax undefined)}}而非{{#if thresholdMax}}守衛(wèi)否則合法的0下界會被當作不存在v2.39.0 修正。{{/unless}}與閉合}之間需保留空格或換行否則}}}會被 Handlebars 解析為三花括號而編譯失敗。Send test 會填充所有變量但樣例是between告警thresholdMax一定存在所以它無法暴露可選數(shù)字缺失這類模板錯誤——這正是上述守衛(wèi)的用途。incident.io 只接受firing/resolved默認負載把 HyperDX 狀態(tài)映射到二者并攜帶deduplication_key {{eventId}}按告警分組渠道穩(wěn)定保證 incident.io 關(guān)閉它自己打開的告警。v2.39.0 進一步修復(fù){{sourceQuery}}此前只讀取圖表的頂層where對按序列aggCondition定義的告警渲染為空現(xiàn)在會拼接圖表where 序列aggCondition或保存搜索的where 固定過濾器截斷至 2000 字符并刻意排除圖表的 pinned filters因為 tile/內(nèi)聯(lián)告警并不應(yīng)用它們。多渠道、連續(xù)窗口與評估歷史單告警最多 10 個 Webhookv2.36.0新增channels字段貫穿 v2 外部 API、內(nèi)部 API 與 MCPclickstack_save_alert舊的單一channel字段繼續(xù)兼容。注意 API 更新是整體替換而非合并——只帶channel的更新會把多通道告警縮減到單個 Webhook客戶端應(yīng) fetch 后回傳完整channels數(shù)組。連續(xù)窗口條件與 PENDING 狀態(tài)v2.30.0要求條件連續(xù) N 個窗口成立才觸發(fā)削減單窗口噪聲頁趨勢若延續(xù)即將觸發(fā)時上報PENDING狀態(tài)且可通過外部 API 配置。評估歷史 APIv2.35.0新增GET /alerts/:id/evaluations按時間范圍返回逐窗口評估歷史分組告警帶 per-group 明細、評估分析字段與去重后的錯誤信息游標分頁保證有空洞的歷史也能翻頁終止。對應(yīng)路由實現(xiàn)在 packages/api/src/routers/api/alerts.ts。失敗評估被保留而非覆蓋v2.35.0查詢錯誤、超時、Webhook 失敗按窗口逐一記錄超時單獨標注并附帶可操作消息同一窗口的重試合并為單行窗口恢復(fù)后錯誤條目清除。分組告警不再卡死在 ALERT 態(tài)v2.31.0閾值不再超限后歷史狀態(tài)重置為 OK。通知時長只統(tǒng)計投遞本身v2.39.0此前評估列表里的時長把構(gòu)建標題、查詢示例日志、渲染模板都算進去現(xiàn)在按目標分別計時并按目標聚合展示v2.37.0 引入可展開查看每個 Webhook 的累計時長、投遞次數(shù)與失敗數(shù)。分組告警示例日志每窗口只查一次v2.39.0按服務(wù)分組的告警此前對每個違約服務(wù)重復(fù)查詢同一批示例行現(xiàn)改為每窗口一次、所有通知共享追趕補發(fā)的窗口因數(shù)據(jù)不同仍各自查詢。同時示例日志行現(xiàn)在應(yīng)用保存搜索的 pinned filtersv2.39.0保證通知中的行確實來自被計數(shù)的行集。內(nèi)聯(lián)告警與圖表直連告警inline告警源v2.37.0 后端落地v2.38.0 貫通外部 API 與 MCP告警自身攜帶圖表配置無需先保存搜索或建 tilebuilder 配置支持 log/trace/metric 源原始 SQL 支持 Line/Stacked Bar/Number 展示PromQL 被拒絕評估走與 tile 告警相同的路徑含 group-by 與多窗口行為通知鏈接回圖表探索器。從圖表探索器直接建告警v2.39.0在/chart上構(gòu)建好日志/追蹤/指標查詢builder 或原始 SQL即可命名并創(chuàng)建告警無需經(jīng)過保存搜索或儀表盤 tile告警持久化自己的圖表配置告警列表以圖表圖標展示并可回鏈探索器。儀表盤 tile 告警可導(dǎo)出 Terraformv2.39.0clickhouse_clickstack_alert新增source tile與dashboard_id/tile_idprovider 3.28.0tile 名稱為空或重復(fù)時provider 的tile_idsmap 按鍵名索引以及被 provisioning 重寫的儀表盤會 withheld。告警相關(guān)的其他改進告警自帶 displayName 與 tagsv2.38.0v2.39.0 起 API 在啟動時為存量告警從所監(jiān)控的保存搜索/儀表盤回填命名與標簽。告警列表服務(wù)端分頁v2.39.0GET /alerts接受分頁與過濾參數(shù)并在數(shù)據(jù)庫中應(yīng)用列表虛擬化v2.37.0保證數(shù)百條告警下滾動不卡。Terraform 導(dǎo)出v2.34.0儀表盤、保存搜索、保存搜索告警均有 Export to Terraform 按鈕Team Settings 可下載整團隊 import 文件地址由資源 id 而非名稱推導(dǎo)避免重命名引發(fā) destroy-and-recreate。Webhook 投遞加固v2.31.0封禁已知壞 IP 段、投遞時不跟隨重定向v2.30.0 起失敗投遞按指數(shù)退避重試而非丟棄。圖表與查詢引擎公式、指標發(fā)現(xiàn)與性能修復(fù)公式Formulasv2.36.0 的核心特性任何 metric/log/trace 圖表都能攜帶派生序列寫作字母引用算術(shù)表達式A / (A B) * 100時間序列、表格、數(shù)字圖表新增 Add Formula 行內(nèi)聯(lián)校驗非法表達式與未知引用每公式可設(shè)別名與數(shù)字格式帶序列字母徽章Show input series 開關(guān)決定單獨渲染公式還是連同操作數(shù)。公式與 As Ratio 開關(guān)互斥缺失操作數(shù)按 0 計零或缺失分母渲染為缺口數(shù)字 tile 永遠顯示公式而非原始操作數(shù)。事件源公式內(nèi)聯(lián)編譯進圖表的單次掃描 SELECT沒有每序列查詢扇出。公式貫通外部 API v2、MCPsave_dashboard/patch_dashboard與 CLI寫入時校驗未知引用、非法語法、與asRatio混用、數(shù)字 tile 多公式等tile 告警在公式圖上評估公式本身v2.36.0 修復(fù)此前閾值對著原始操作數(shù)比較的問題。Convert to SQL 支持多序列/比率/公式圖表v2.36.0輸出基于宏的原始 SQL 模板每序列分支一個$__sourceTable(metricType)宏。指標探索器與指標名稱選擇Metrics explorerv2.37.0圖表編輯器的瀏覽控件把指標命名空間渲染為前綴層級樹system→cpu→utilization跨名稱與描述搜索行內(nèi)展示 kind 與描述詳情面板給出單位、上報服務(wù)、可下鉆的標簽鍵按.或_分詞嵌套瀏覽標簽時可把過濾器與 group-by 暫存為可移除 chips應(yīng)用時按 kind 自動選擇聚合gauge→avg、counter→sum、histogram→p95。指標名稱選擇器性能v2.39.0名稱改從表的稀疏主索引流式讀取約 4,900 個 gauge 指標時首選項約 30ms 而非 770ms瀏覽時按有數(shù)據(jù)的指標加權(quán)鍵入時切到全量相關(guān)性排序搜索服務(wù)器低于 24.2、Distributed 或非 MergeTree 表、主鍵不含MetricName時自動回退全量列舉。名稱完整可選v2.38.0指標下拉不再抽樣超過 3000 個名稱也可按名搜索精確匹配排最前列表不完整時明確提示尊重所選時間范圍而非固定看最近 24 小時。目錄之外的指標如近三天停止上報的也能按名選圖。時間圖表的行為與邊界高基數(shù)序列默認封頂v2.34.0破壞性按高基數(shù)字段分組的 tile 不再試圖畫出每條線默認物化并渲染有界數(shù)量的序列內(nèi)置 N more 懸停/釘住提示與 load all series 逃生口。外部儀表盤 API 上為三態(tài)省略默認上限0不限正整數(shù)top N依賴省略字段獲取全量序列的客戶端應(yīng)改傳0。頂層 HAVING/ORDER BY/LIMIT 作用于整體v2.36.0此前泄漏進每個序列分支現(xiàn)引用圖表的輸出列操作數(shù)別名、公式名、比率列、group-by 列、時間桶HAVING err rate 0.5正確過濾連接后的行?；旌?float/integer 聚合v2.36.0所有序列值歸一化為 Float64解決NO_COMMON_TYPE/Variant 報錯原始 SQL 圖表的全數(shù)字Variant(...)列也歸類為數(shù)值。多序列指標圖表單查詢執(zhí)行v2.35.0一個組合查詢替代每序列一查瀏覽器合并View SQL 展示完整查詢。小數(shù)值 Y 軸刻度保留小數(shù)v2.38.0絕對值 10 的刻度遵循圖表 Number Format 小數(shù)位上限 2≥10 與恰為 0 的刻度保持整數(shù)CLI 終端圖同步修復(fù)。Recharts 2.13 → 3.xv2.31.0縮放刷選、點擊下鉆、tooltip 釘住全部遷移到 Recharts 3 API圖表交互面廣泛改動。查詢正確性修復(fù)搜索側(cè)_與%恢復(fù)字面含義v2.34.0搜索詞不再被直接插進 ILIKE 模式當作通配符。每個 URL 都被轉(zhuǎn)義v2.34.0多 URL 查詢不再把后續(xù)冒號編譯為字段查詢。開區(qū)間/排他區(qū)間/非數(shù)值邊界v2.34.0Duration:[* TO 500]、{100 TO 500}、帶時區(qū)的DateTime(UTC)、Date32/Nullable(Date)等均按預(yù)期處理。搜索分面查詢參數(shù)內(nèi)聯(lián)v2.36.0約 100 個鍵的批量分面值查詢曾超出 ClickHouse web 客戶端 URL 參數(shù)預(yù)算、被代理網(wǎng)關(guān)拒收現(xiàn)內(nèi)聯(lián)為轉(zhuǎn)義字面量參數(shù)個數(shù)恒定。儀表盤過濾器、變量與相對時間范圍過濾器標記為 requiredv2.39.0儀表盤過濾器可從可選改為必選僅在某取值下才有意義的儀表盤把這一預(yù)期隨身攜帶設(shè)置貫穿 schema、API 與應(yīng)用經(jīng) API 往返不丟失。靜態(tài)取值列表過濾器v2.38.0過濾器可配置固定取值集渲染為選擇器而非從數(shù)據(jù)發(fā)現(xiàn)UI 過濾器編輯器可創(chuàng)建MCP 服務(wù)器也理解靜態(tài)過濾器。Prometheus 標簽值過濾器v2.38.0過濾器取值來自 Prometheus 標簽并接受 series selectormatcher收窄來源序列。變量與廣播設(shè)置v2.35.0變量進入 builder tilev2.36.0builder tile 與原始 SQL tilev2.35.0都會做變量替換SQL 編輯器自動補全并校驗變量用法變量的取值查詢可依賴其他變量宏參數(shù)內(nèi)嵌套變量/宏也會展開v2.37.0 起變量對所有部署開放移除 feature toggle支持 Lucene 精確匹配展開、PromQL 替換與 MCP。相對時間范圍v2.39.0儀表盤可保存最近一小時/最近一天這類相對窗口每次打開都錨定當前時間設(shè)置同樣貫通 schema 與 API。過濾器取值按變量持久化v2.37.0下鉆到搜索時展開變量值而非名稱v2.37.0 修復(fù)。tile 預(yù)覽可跟隨儀表盤過濾器v2.39.0tile 懶加載v2.29.0tile 滾動進入視口才執(zhí)行 ClickHouse 查詢并緩存結(jié)果。表格 tile 按列著色與條件規(guī)則v2.32.0行點擊外鏈v2.29.0數(shù)字 tile 背景 sparkline、As Ratio、條件顏色v2.29.0。Snap gridv2.32.0拖拽/縮放 tile 時背后繪制網(wǎng)格并高亮實際落點。tile 告警在公式圖上評估公式、share_of_total尊重ratioModev2.36.0 修復(fù)tile 名稱為空被 MCP 拒絕v2.29.0 破壞性。LLM 可觀測性儀表盤betav2.38.0 引入/llmbeta 儀表盤v2.39.0 顯著加速無需改動插樁直接讀取已攝入的 traces 并在查詢時解釋。要點理解 OTel GenAI 語義約定、OpenLLMetry、OpenInference、Vercel AI SDK對早先采集的遙測追溯生效。圖表維度LLM 流量、token 拆分uncached/cached/cache-write/output/reasoning、按模型的估算成本、延遲與首 token 時間、工具調(diào)用per-session 時間線含對話視圖與并排 LLM span/日志搜索。成本來自內(nèi)置價格目錄考慮 cache-read 折扣與 cache-write 溢價自身上報的成本屬性優(yōu)先于估算多插樁方言并存時選一個權(quán)威報告者保證一次調(diào)用只計一次。v2.39.0 的加速tile 過濾器改用mapContains走 trace schema 的 key 索引staging 表上 LLM span 謂詞從 36 秒 planning 停滯降到 7ms雙鍵過濾從 1,306 個 granule 降到 3 個。伴隨行為變化帶gen_ai.system的 span 即視為 LLM span。新增按最終用戶過濾v2.39.0與 session 過濾器并列下拉列出所搜范圍內(nèi) LLM span 上的去重用戶并作用于包括 Errors 頁簽關(guān)聯(lián)日志事件在內(nèi)的所有頁簽選擇進入 URL 可分享。MCP 服務(wù)器工具改名、指標一等公民與批量查詢v2.29.0 是 MCP 服務(wù)器的大版本所有工具從hyperdx_*重命名為clickstack_*服務(wù)器也更名為clickstack任何顯式引用工具名的 Agent 配置、提示詞或自動化都需要更新。隨后的能力積累指標一等公民v2.29.0clickstack_list_metrics按 kind、名稱模式、時間窗分頁與clickstack_describe_metrickind、unit、描述、屬性鍵、采樣值clickstack_timeseries/clickstack_table接受metricType/metricName/isDelta與aggFn: increasev2.35.0 增加 summary 類指標。整儀表盤一次校驗v2.35.0clickstack_query_tiles接收 dashboard ID 與可選 tile ID 列表默認所有非 markdown tile返回逐 tile 成功/失敗摘要與聚合計數(shù)失敗 tile 內(nèi)聯(lián)報告而非中斷整次調(diào)用。量化分析工具v2.34.0clickstack_emerging_signals對比基線窗口與當前窗口的日志/事件模式回答發(fā)生了什么變化。其判定邏輯在 packages/api/src/mcp/tools/query/emergingSignals.ts 中實現(xiàn)為純函數(shù)classifyShift基線缺失且當前份額 ≥newPatternShareFloor判為 emerging當前缺失或份額反向達到ratio倍判為 disappeared比較采用交叉相乘curShare ratio * baseShare避免除零并帶 1e-9 相對容差與真實方向變化守衛(wèi)防止minShareRatio: 1把穩(wěn)態(tài)模板刷成新信號。讀/寫注解v2.35.0每個工具帶 annotations客戶端可區(qū)分只讀查詢工具與 save/patch/delete 等破壞性工具工具選擇策略在連接時呈現(xiàn)引導(dǎo) Agent 優(yōu)先 builder 查詢工具而非原始 SQL后者失敗率約高一倍。Agent 構(gòu)建 tile 的過濾器歸位v2.35.0save/patch 拒絕 table/line/stacked bar/number/pie/bar tile 的 tile 級where指引使用每序列wheresearch/heatmap/event pattern 仍保留 tile 級過濾器。錯誤分類v2.30.0span 與hyperdx.mcp.tool.errors計數(shù)器帶error_category屬性ClickHouse 錯誤按類型與 cause chain 自動分類為 user/server。安全與互操作修復(fù)工具 schema 通過 JSON Schema draft 2020-12 校驗v2.36.0修復(fù)colorRulesbetween元組序列化導(dǎo)致 Gemini 類客戶端拒收整個工具列表的問題quantilelevel改為 string enumv2.37.0失敗的 MCP 調(diào)用在 spanStatusMessage中呈現(xiàn)錯誤v2.36.0readonly2使max_execution_time真正生效v2.29.0。采集器、存儲與運維遙測管道與自托管細節(jié)OTel Collector 能力OIDC bearer token 認證v2.35.0standalone 采集器可針對 OIDC 提供方發(fā)布的 JWKS 校驗 OTLP 請求替代單一長期共享密鑰——設(shè)置OIDC_ISSUER_URL與OIDC_AUDIENCE即可靜態(tài)OTLP_AUTH_TOKEN仍可用。Bearer 頭兩種大小寫均可v2.38.0OpAMP 管理模式與 standalone 的OTLP_AUTH_TOKEN均接受Bearer/bearer/BEARER前綴RFC 6750 客戶端不再被拒。spanmetrics connector 編譯進采集器v2.39.0通過CUSTOM_OTELCOL_CONFIG_FILE提供的自定義 pipeline 可直接引用spanmetricsconnector從 span 推導(dǎo)調(diào)用次數(shù)與時長RED指標——尤其解決datadogreceiver攝入的 Datadog Agent traces 此前無法產(chǎn)出 RED 指標的問題。純增量變更默認 pipeline 不變。Datadog receiveropt-inv2.30.0設(shè)置ENABLE_DATADOG_RECEIVER后采集器在0.0.0.0:8126掛載 traces/metrics/logs pipeline啟用認證時以DD-API-KEY頭對團隊 API key 校驗。PromQL 端點v2.29.0 實驗性僅當CLICKHOUSE_PROMETHEUS_METRICS_ENDPOINT設(shè)置時才聲明prometheusremotewriteexporter 與metrics/promqlpipeline。trace schema 種子帶文本索引v2.39.0新建 trace schema 時即建文本索引僅在建表時執(zhí)行。exporter 超時可配置v2.36.0HYPERDX_OTEL_EXPORTER_TIMEOUT默認 5 秒。ClickHouse 存儲與查詢PromQL 走 Prometheus HTTP APIv2.39.0破壞性ClickHouse 支持的/query、/query_range代理到連接的/prometheus/api/v1/*ClickHouse 26.8 引入的prometheus_api_v1handler不再調(diào)用prometheusQuery/prometheusQueryRange表函數(shù)。自帶 ClickHouse 鏡像升級到 26.8自管 ClickHouse 必須升級到 26.8 并啟用該 handler否則 ClickHouse 支持下的 PromQL 查詢會失敗。database/table參數(shù)繼續(xù)轉(zhuǎn)發(fā)。PromQL 代理保留 Connection host 路徑前綴v2.38.0破壞性VictoriaMetricsvmselect這類帶路徑的 host 不再被改寫但從 Prometheus UI 復(fù)制來的http://prom:9090/graph這類偶然可用的 host 會變成 404升級前請清理 host 中的多余路徑。host 上的 query 參數(shù)僅作為固定 Prometheus API 參數(shù)集query、time、start、end、step、match/match[]、limit、timeout、stats的回退請求值優(yōu)先curl/Terraform 直接調(diào)用傳來的非 Prometheus 參數(shù)會被丟棄。每次請求關(guān)閉子列尺寸計算v2.39.0ClickHouse 26.3 默認開啟allow_calculating_subcolumns_sizes_for_merge_tree_reading使 PREWHERE 規(guī)劃為每個被引用的 map key 拉取 per-part 尺寸SharedMergeTree 上等于每 key×活動 part 一次 S3 GET且max_execution_time無法中斷LLM 儀表盤等讀 ~64 個屬性鍵的查詢可能卡住數(shù)分鐘查詢現(xiàn)在在服務(wù)器支持處發(fā)送0。per-signal TTLv2.36.0HYPERDX_OTEL_EXPORTER_LOGS_TTL、..._TRACES_TTL、..._METRICS_TTL、..._SESSIONS_TTL各自回退到HYPERDX_OTEL_EXPORTER_TABLES_TTL可讓日志/追蹤留半年、指標 30 天淘汰HYPERDX_OTEL_EXPORTER_RECONCILE_TABLE_TTLtrue時 migrate 工具把保留策略應(yīng)用到已存在的表。Reconciliation 默認關(guān)閉且刻意保守延長保留不刪數(shù)據(jù)、縮短保留不在啟動時批量刪除、復(fù)合策略tiering/RECOMPRESS/GROUP BYrollups與日歷單位保留會被報告并跳過。指標 schema 更精簡v2.30.0更高效的主鍵與更好的時間剪枝。服務(wù)可用性與運維MongoDB 啟動重試與 /ready 探針v2.36.0初始連接失敗不再不重試初始連接以封頂指數(shù)退避重試直至成功API 與 OpAMP 均暴露GET /readyMongoDB 未連接時返回 503——Kubernetes 就緒探針應(yīng)指向它/health保持純存活檢查。API 日志級別默認infov2.36.0破壞性BaseClickhouseClient不再無條件打印原始 SQL查詢?nèi)罩靖淖?pino 的debug級。生產(chǎn)環(huán)境依賴 SQL 日志需設(shè)HYPERDX_LOG_LEVELdebug空值Compose 未設(shè)變量時的情形回退到默認值而不是讓 pino 啟動報錯。webhook SSRF 校驗v2.32.0破壞性Webhook 目標統(tǒng)一按 SSRF 防護檢查私有/保留地址默認攔截投遞到內(nèi)網(wǎng) host 需加入WEBHOOK_HOSTNAME_ALLOWLIST逗號分隔hostname 條目覆蓋子域IPv4/IPv6 精確匹配。該白名單不繞過協(xié)議校驗、Slack hostname 校驗以及對所配置 ClickHouse/MongoDB host 的封禁。配置讀取見 packages/api/src/config.ts。第三方令牌靜態(tài)加密v2.39.0設(shè)置TOKEN_ENCRYPTION_KEY32 字節(jié)base64 或 64 位 hex后Slack bot token、OAuth access/refresh token 等以 AES-256-GCM 加密落盤不設(shè)置則維持明文存儲。實現(xiàn)見 packages/api/src/utils/tokenEncryption.ts存儲格式為v1:provider:payloadpayload 布局為iv || tag || ciphertext信封前綴作為附加認證數(shù)據(jù)AAD防止負載被換名重放解密按信封內(nèi)的 provider 分發(fā)因此切換 provider 后舊行仍可讀啟動時以固定哨兵串做加解密自檢verifyTokenEncryption密鑰不可解析會直接阻斷啟動。已知限制信封不帶 key id輪換TOKEN_ENCRYPTION_KEY會使存量行不可讀v1版本字段就是為此預(yù)留。密鑰生成示例openssl rand -base64 32。個人 API access key 可輪換v2.36.0Team Settings → API Agents 增加 Rotate輪換即時吊銷舊 key需同步更新 MCP/AI Agent 配置、Terraform provider 與 CI 腳本瀏覽器會話不受影響。External API v2 列表分頁v2.30.0破壞性/api/v2/alerts、/api/v2/saved-searches、/api/v2/webhooks接受limit1–1000默認 1000與offset默認 0返回meta: { total, limit, offset }按_id排序保證分頁穩(wěn)定并設(shè)X-Total-Count頭DELETE /api/v2/alerts/:id對不存在資源改返 404。v2 外部 API 資源管理擴展v2.30.0saved-search/webhook/source 全套 CRUDwebhookheaders/queryParams只寫不讀避免泄露鑒權(quán) tokenPOST /api/v2/dashboards/validate預(yù)校驗負載。邀請撤銷限定團隊范圍v2.34.0DELETE /team/invitation/:id只允許撤銷本團隊待處理邀請未知/越權(quán) id 返回 404Authorization與Cookie頭從 API 請求日志中脫敏。限流按 access key 鍵控v2.34.0此前按原始Authorization頭值分桶改動Bearer前綴即可繞過配額現(xiàn)按鍵本身分桶無 key 時回退客戶端 IP。token 加密計數(shù)器hyperdx.token_encryption.plaintext_reads與hyperdx.token_encryption.disabled兩個指標可觀測加密關(guān)閉狀態(tài)使其可告警。會話回放與前端體驗回放器升級 rrweb 2.1.1v2.36.0從2.0.0-alpha.8遷移到穩(wěn)定版吸收多年樣式表/虛擬 DOM/adopted stylesheets 修復(fù)用舊rrweb1.1.3與當前 SDK 錄制的會話驗證過回放保真度。超大錄制事件不再丟失v2.37.0超過錄制器約 950KB chunk 大小的 rrweb 事件被拆成共享同一時間戳的多個 chunk此前按時間戳排序會被 ClickHouse 打亂導(dǎo)致整段常是內(nèi)聯(lián) CSS 的完整 DOM 快照被丟棄現(xiàn)在流按確定性排序、chunk 按顯式索引重組、無法重建的事件在播放器中標示。存量錄制無需重采即可正確回放。多行 SQL 字段自適應(yīng)高度v2.39.0搜索 WHERE/SELECT/ORDER BY、圖表編輯器的 SQL 與 PromQL 字段失焦不再折疊搜索欄語言切換高度一致共享同一高度表。Whats new 內(nèi)嵌應(yīng)用v2.37.0Help 菜單的完整 changelog 模態(tài)改為內(nèi)聯(lián)區(qū)塊 View all releases 抽屜 未讀時 Help 圖標上的 sparklechangelog 構(gòu)建期解析而非運行時拉取。v2.39.0 修復(fù)每次部署都閃爍提示鍵從NEXT_PUBLIC_APP_VERSION部署會蓋入構(gòu)建 id改為 changelog 中最新的發(fā)布版本僅當嚴格更新才提示回滾也不再全員打擾。復(fù)制調(diào)試信息v2.38.0Help 菜單 Copy debug info 一鍵打包前后端版本可分別部署、部署模式、用戶/團隊 id、啟用的功能開關(guān)、URL/屏幕/視口/OS/瀏覽器與會話 id控制臺可用window.hdx.report()取同樣摘要。破壞性變更速查表升級前必讀版本變更影響與處置v2.39.0ClickHouse 支持的 PromQL 走/prometheus/api/v1/*自管 ClickHouse 需 ≥26.8 并啟用prometheus_api_v1handlerv2.38.0PromQL 代理保留 Connection host 路徑清理 host 上多余的路徑與 query 字符串v2.36.0API 日志級別默認info不再打印查詢 SQL需要 SQL 日志設(shè)HYPERDX_LOG_LEVELdebugv2.35.0Terraform 導(dǎo)出使用團隊級 import idteam_id/resource_idprovider 需 3.25.0升級后重新導(dǎo)出再導(dǎo)入v2.34.0時間圖表默認限制高基數(shù)序列需要全量序列的 API 客戶端把seriesLimit顯式傳0v2.32.0Webhook 目標按 SSRF 校驗內(nèi)網(wǎng)投遞加入WEBHOOK_HOSTNAME_ALLOWLISTv2.30.0v2 列表端點分頁 上限客戶端讀取meta.total并用offset翻頁DELETE /api/v2/alerts/:id對不存在資源返 404v2.29.0MCP 工具hyperdx_*→clickstack_*更新所有顯式引用工具名的 Agent 配置v2.29.0User.accessKey唯一索引升級前清理重復(fù) access key否則啟動失敗v2.29.0指標序列分組區(qū)分屬性作用域僅影響跨作用域搬運屬性的 collector 處理器配置v2.29.0圖表調(diào)色板 token 改色相命名存量儀表盤自動遷移ClickStack 的chart-1會由藍變綠可在色相選擇器重選v2.29.0MCP tile 名稱必須非空空名稱name: 報校驗錯誤常用環(huán)境變量與功能開關(guān)一覽變量作用備注TOKEN_ENCRYPTION_KEY第三方令牌 AES-256-GCM 靜態(tài)加密32 字節(jié)base64 或 64 hex輪換會使存量行不可讀WEBHOOK_HOSTNAME_ALLOWLISTWebhook 內(nèi)網(wǎng) host 白名單逗號分隔hostname 條目覆蓋子域HYPERDX_LOG_LEVELAPI 日志級別v2.36.0 起默認infoHYPERDX_OTEL_EXPORTER_LOGS/TRACES/METRICS/SESSIONS_TTL按信號的表保留策略回退到..._TABLES_TTLHYPERDX_OTEL_EXPORTER_RECONCILE_TABLE_TTLmigrate 時應(yīng)用到存量表默認關(guān)保守語義HYPERDX_OTEL_EXPORTER_TIMEOUT采集器 exporter 超時默認 5 秒OIDC_ISSUER_URL/OIDC_AUDIENCEOTLP OIDC 認證替代靜態(tài)OTLP_AUTH_TOKENCUSTOM_OTELCOL_CONFIG_FILE自定義采集器 pipeline可引用spanmetricsconnectorENABLE_DATADOG_RECEIVERDatadog Agent 接入掛載在0.0.0.0:8126CLICKHOUSE_PROMETHEUS_METRICS_ENDPOINT聲明 PromQL exporter/pipeline實驗性NEXT_PUBLIC_ENABLE_ALERT_DETAILS告警詳情頁/alerts/:id默認關(guān)v2.35.0 實驗性e2e 配置可見 packages/app/playwright.config.tsNEXT_PUBLIC_ENABLE_EXPONENTIAL_HISTOGRAMS指數(shù)直方圖指標默認關(guān)v2.32.0 實驗性INGESTION_API_KEYall-in-one 認證鏡像的預(yù)共享攝入 keyv2.30.0 修復(fù)鏡像名匹配升級路線與持續(xù)追蹤綜合來看v2.29 → v2.39 的演進主線可概括為告警從發(fā)一條消息進化為可編程、可評估、可審計的完整生命周期圖表查詢從會畫圖進化為公式、指標發(fā)現(xiàn)與性能可控儀表盤從靜態(tài)畫布進化為變量驅(qū)動、可過濾、可導(dǎo)出 IaC 的資源同時LLM 可觀測性與 MCP Agent 集成成為兩條全新產(chǎn)品線底層則是ClickHouse 26.x 時代的查詢代理路徑與存儲運維現(xiàn)代化。升級前請按上表逐條核對破壞性變更重點檢查ClickHouse 服務(wù)器版本v2.39.0 要求 ≥26.8、Prometheus Connection 的 host 寫法、Webhook 是否投遞內(nèi)網(wǎng)、Terraform provider 版本以及 MCP/Agent 配置中的工具名。每個包的細粒度變更可在各 packages/*/CHANGELOG.md 中追蹤產(chǎn)品內(nèi) Help 菜單的 Whats new 也直接渲染根級發(fā)布說明是跟進新版本最快的第一手入口。贊分享可觀測性云原生運維【免費下載鏈接】hyperdxResolve production issues, fast. An open source observability platform unifying session replays, logs, metrics, traces and errors powered by ClickHouse and OpenTelemetry.項目地址https://gitcode.com/gh_mirrors/hy/hyperdx點擊查看免費下載相關(guān)推薦nextra-theme-blog 版本演進深度解讀從 2.0 到 4.6 的破壞性變更與能力圖譜nextra theme blog 版本演進深度解讀從 2.0 到 4.6 的破壞性變更與能力圖譜 本篇技術(shù)指南以 nextra theme blog 的 C前端文檔/教程EUI 2025 年度版本演進深度解讀從 v99 到 v111 的關(guān)鍵更新、破壞性變更與升級實踐指南EUI 2025 年度版本演進深度解讀從 v99 到 v111 的關(guān)鍵更新、破壞性變更與升級實踐指南 本指南基于 elastic/eui 在 2025 年度前端UI組件設(shè)計系統(tǒng)Monolog 變更日志全解讀從 1.0 到 3.11 的版本演進、破壞性變更與關(guān)鍵技術(shù)點Monolog 變更日志全解讀從 1.0 到 3.11 的版本演進、破壞性變更與關(guān)鍵技術(shù)點 導(dǎo)讀 本文以 Monolog 項目 CHANGELOG.md ht后端上一篇G-Helper深度配置指南華碩筆記本性能調(diào)優(yōu)與自動化管理下一篇VAP動畫播放技術(shù)突破跨平臺特效渲染的性能瓶頸創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考