跳到主要内容
返回文章列表

Uptrace 2.1.0 ออกตัวเสถียรพร้อมระบบ incident hypotheses และแผนอัปเกรดที่ต้องระวัง

Uptrace 2.1.0 รุ่นเสถียรแรกของสาย 2.1 เปลี่ยน incident suspected cause เป็น hypotheses พร้อมข้อกำหนดฐานข้อมูลและพฤติกรรม ingest ใหม่

Uptrace 2.1.0 ออกตัวเสถียรพร้อมระบบ incident hypotheses และแผนอัปเกรดที่ต้องระวัง

Uptrace 2.1.0 ออกตัวเสถียรพร้อมระบบ incident hypotheses และแผนอัปเกรดที่ต้องระวัง

Uptrace เผยแพร่ เวอร์ชัน 2.1.0 เมื่อ 14 พฤศจิกายน 2026 เวลา 08:39:17 UTC เป็นรุ่นเสถียรแรกของสาย 2.1 ซึ่งรวมการเปลี่ยนจาก release candidates ทั้งสามรุ่น จุดที่ผู้ดูแลระบบต้องอ่านก่อนติดตั้งคือเส้นทาง migration ที่ต่างกันตามรุ่นเริ่มต้น การเปลี่ยนวิธีเก็บสาเหตุของ incident และพฤติกรรม timeout/การตอบรับของระบบ ingest การอัปเกรดแบบเปลี่ยน binary แล้วหวังให้ทุกอย่างทำงานเหมือนเดิมมีความเสี่ยง โดยเฉพาะระบบที่เชื่อม Kafka, ClickHouse และ PostgreSQL

เส้นทางอัปเกรดไม่เหมือนกันทุกต้นทาง

เอกสารรุ่นนี้ระบุให้สำรอง PostgreSQL และ ClickHouse ก่อน แล้วเรียก uptrace preflight เพื่อตรวจสิ่งที่ขวาง migration ก่อนใช้ uptrace migrate up ผู้ใช้ 2.1.0-rc.1 ถึง rc.3 สามารถติดตั้ง binary ใหม่และรัน migration ตามขั้นตอนของ systemd, Docker หรือ Helm แต่ถ้ามาจาก 2.0.0-beta.3 ถึง 2.0.3 หรือ 2.1 beta ต้องอ่านคู่มือเปลี่ยนจากสาย classic เพิ่ม เพราะต้องใช้ ClickHouse 26.3 ขึ้นไป, PostgreSQL 15 ขึ้นไป และตั้ง service.secret คำสั่ง migration แบบเดิมที่แยก pg/ch ถูกแทนด้วย uptrace migrate up

ผู้ใช้ v1.x และ v2.0.0-beta.1, beta.2 หรือ rc.2 ไม่สามารถอัปเกรดฐานข้อมูลเดิมโดยตรงตามประกาศ ต้องติดตั้ง 2.1.0 บนฐานข้อมูลใหม่ การระบุเวอร์ชันเริ่มต้นจึงเป็นขั้นแรกที่สำคัญกว่าเลือกคำสั่ง deploy หากองค์กรมีหลาย environment ให้บันทึกเวอร์ชันของแต่ละแห่งก่อนทำ runbook เดียว เพราะ staging กับ production อาจอยู่คนละเส้นทางการย้าย

preflight รุ่นนี้ตรวจ failed mutation, DDL แบบ ON CLUSTER ที่ค้าง, พื้นที่ดิสก์ไม่พอสำหรับ mutation ที่รอ และ compact part ที่ขาดคอลัมน์ซึ่ง index ต้องอ่าน ส่วน uptrace migrate up --plan ช่วยบอกจำนวนแถวและไบต์ที่ ClickHouse จะ rewrite แยกตาม host และ disk ข้อมูลนี้ควรใช้คำนวณเวลา maintenance และ headroom จริง ไม่ใช่ดูเพียงขนาดตารางรวม การมี backup ที่ทดสอบ restore ได้ยังจำเป็น เพราะขั้น migration เปลี่ยน schema และข้อมูล incident

จาก suspected cause เป็นหลักฐานหลายสมมติฐาน

Uptrace เปลี่ยนเครื่องหมายสาเหตุที่เคยระบุว่า suspected ใน incident เป็นรายการ hypotheses แต่ละสมมติฐานอ้างหลักฐานจาก alert, annotation หรือการอ่าน telemetry และมีสถานะ supported, unverified หรือ disproved เจ้าหน้าที่สามารถยืนยันหรือปฏิเสธข้อสันนิษฐาน แล้วการวิเคราะห์รอบต่อไปจะคงคำตัดสินนั้นไว้ หน้า incident แสดง origin alert จากสมมติฐานที่ยืนยันแทนป้าย suspected แบบเดิม

Migration จะล้างเครื่องหมาย suspected เดิมและถอดคอลัมน์ incident_alerts.suspected ระหว่าง restart กับการ backfill เสร็จ หน้าจอและ route ของ incident จะรอการย้ายข้อมูลตาม release notes จึงควรรัน migrate up ต่อทันทีหลัง restart และสื่อสารหน้าต่าง maintenance กับทีม on-call หากมีระบบภายนอกเรียก beta /internal/v1 API ต้องแก้ด้วย เพราะ response analysis ไม่คืน field hypotheses, suspectedCauseAlertIds และ alertsById แบบเดิมแล้ว มี endpoint แยกรายการสมมติฐานและ endpoint สำหรับ ruling รวมทั้ง MCP tool ใหม่ list_incident_hypotheses

Ingest timeout และสัญญาณ overload เปลี่ยน

ingest.request_timeout แทน ingest.produce_wait_timeout โดย deadline เดียวครอบคลุมตั้งแต่ request มาถึง ทั้งเวลารอ read slot, buffer และ Kafka acknowledgment ค่าเริ่มต้น 10 วินาทีและตั้งได้ไม่เกิน 10 นาที หาก client ส่ง deadline สั้นกว่าผ่าน header ที่รองรับ ก็จะบีบเวลาให้สั้นลงอีก คีย์เก่ายังทำงานแต่มี warning และใช้ uptrace config fix --write ช่วยเปลี่ยนชื่อได้ ทีมที่ตั้ง kafka.linger ต้องให้สั้นกว่าครึ่งหนึ่งของ request timeout เพื่อไม่ให้เวลาที่รอ batching กินงบเวลาจนหมด

Prometheus remote write จะได้รับ HTTP 503 เมื่อระบบ overload แทน 429 เพราะ Prometheus โดยปริยายอาจทิ้งข้อมูลเมื่อเห็น 429 ส่วน receiver อื่นยังตอบ 429 ที่ retry ได้พร้อม Retry-After การเปลี่ยนนี้สำคัญต่อ dashboard ที่จำแนก error และต่อ proxy/retry policy หากทีมมี alert ที่นับ 429 เป็นสัญญาณหลัก ควรปรับให้มอง 503 ของ remote write ด้วย และทดสอบว่าข้อมูลไม่หายเมื่อ Kafka หรือ buffer เต็ม

ฟีเจอร์ใหม่ด้าน Kafka ให้กำหนด acknowledgment แยกตาม pipeline ว่าต้องรอ replica ทุกตัวหรือ leader และเลือกรับคำขอเมื่อ producer รับ record โดยไม่รอ broker ack ได้ ตัวเลือกเหล่านี้แลกความทนทานกับ latency ไม่ควรเปิดเพียงเพื่อทำให้กราฟ response time สวยขึ้น อีกทางเลือกคือ topic แบบ single zone พร้อมคำสั่งตรวจและ rebalance placement ซึ่งมีประโยชน์เมื่อ follower ต่าง data center ทำให้ทุก ack ช้า ก่อนใช้ให้ตรวจ topology และแผนรับมือเมื่อ zone ล่ม

หลังอัปเกรดควรทดสอบ ingest ของ traces, logs และ Prometheus remote write, ดู Kafka lag, ตรวจ incident เดิมหลัง backfill และให้ on-call ทดลองยืนยันสมมติฐานหนึ่งรายการจริง หากพบหน้าจอ incident รอไม่จบ ให้ตรวจสถานะ migration และ ClickHouse mutation ก่อนสรุปว่า UI มีปัญหา รายละเอียดทั้งหมดในประกาศและคู่มืออัปเกรดของโครงการมีผลต่อการตัดสินใจเรื่อง downtime มากกว่าหมายเลขเวอร์ชันอย่างเดียว

แหล่งข่าวต้นทาง: Uptrace 2.1.0 release (ประกาศ 14 พฤศจิกายน 2026), changelog ทางการ และ คู่มืออัปเกรด