5分鐘給cpp-httplib接上請(qǐng)求追蹤ID、耗時(shí)、狀態(tài)碼一條日志全帶出來(lái)【免費(fèi)下載鏈接】cpp-httplibA C header-only HTTP/HTTPS server and client library項(xiàng)目地址: https://gitcode.com/GitHub_Trending/cp/cpp-httplibcpp-httplib 是一個(gè) header-only 的 C HTTP 庫(kù)一個(gè)httplib.h就能跑起來(lái)。但服務(wù)一旦上線這個(gè)請(qǐng)求是誰(shuí)發(fā)的、跑了多久、最后返回了什么就全靠自己猜。讀完這篇文章你只需要改不到 30 行代碼就能讓每個(gè)請(qǐng)求都帶著 request ID、耗時(shí)和狀態(tài)碼進(jìn)日志排查時(shí)直接按 ID 過(guò)濾。5分鐘跑通一個(gè)最小追蹤例子思路很簡(jiǎn)單請(qǐng)求進(jìn)門時(shí)打一張時(shí)間戳和 ID 的標(biāo)簽請(qǐng)求結(jié)束時(shí)統(tǒng)一結(jié)算。cpp-httplib 的四個(gè)鉤子剛好覆蓋這兩端——set_pre_routing_handler()在路由前對(duì)每個(gè)請(qǐng)求生效set_logger()在請(qǐng)求結(jié)束響應(yīng)發(fā)出前時(shí)觸發(fā)中間用res.user_data傳數(shù)據(jù)。下面這份代碼可以直接編譯運(yùn)行g(shù) -stdc17 -O2 trace_demo.cc -o trace_demo -lpthread把httplib.h放在同目錄#include httplib.h // header-only 庫(kù)單頭文件搞定 #include atomic #include chrono #include iostream int main() { httplib::Server svr; // 進(jìn)門登記給每個(gè)請(qǐng)求生成 ID并把開始時(shí)間塞進(jìn) user_data svr.set_pre_routing_handler( [](const httplib::Request req, httplib::Response res) { static std::atomicunsigned long long seq{0}; res.set_header(X-Request-ID, std::to_string(seq)); // ID 同時(shí)回寫給客戶端 res.user_data.set(start, std::chrono::steady_clock::now()); return httplib::Server::HandlerResponse::Unhandled; // 放行繼續(xù)走業(yè)務(wù)路由 }); // 出門結(jié)算請(qǐng)求結(jié)束時(shí) logger 觸發(fā)此時(shí)響應(yīng)已經(jīng)生成能算出真實(shí)耗時(shí) svr.set_logger([](const httplib::Request req, const httplib::Response res) { auto *start res.user_data.getstd::chrono::steady_clock::time_point(start); auto ms std::chrono::duration_caststd::chrono::milliseconds( std::chrono::steady_clock::now() - *start).count(); std::cout req.remote_addr req.method req.path - res.status ms ms std::endl; }); svr.Get(/hello, [](const httplib::Request , httplib::Response res) { res.set_content(hello, text/plain); }); svr.listen(0.0.0.0, 8080); }啟動(dòng)后訪問(wèn)http://localhost:8080/hello控制臺(tái)會(huì)看到類似這樣的輸出用curl -i還能在響應(yīng)頭里拿到X-Request-ID127.0.0.1 GET /hello - 200 1ms 127.0.0.1 GET /nope - 404 0ms注意第二條沒匹配到路由的 404 也會(huì)被記錄因?yàn)?pre-routing 鉤子攔的是所有請(qǐng)求不挑路由。原理速拆誰(shuí)登記、誰(shuí)結(jié)算把一次請(qǐng)求想象成餐廳流程set_pre_routing_handler()是門口領(lǐng)位員。客人請(qǐng)求還沒被分配到具體餐桌路由匹配之前領(lǐng)位員先做三件事發(fā)個(gè)號(hào)request ID、在號(hào)牌上寫下進(jìn)門時(shí)間user_data.set(start, ...)、決定放不放行返回Handled直接拒絕返回Unhandled放行。res.user_data是號(hào)牌本身。它掛在Response上任意類型隨便塞后面的處理器都能通過(guò)res.user_data.getT(start)取回。官方 cookbook 里就叫它handlers 之間的數(shù)據(jù)交接袋參考 S12. Pass Data between Handlers with res.user_data。set_logger()是結(jié)賬柜臺(tái)。客人離桌后響應(yīng)生成完畢、即將發(fā)往客戶端統(tǒng)一結(jié)算號(hào)牌上的進(jìn)門時(shí)間還在減去現(xiàn)在就是耗時(shí)狀態(tài)碼也已經(jīng)寫在res.status里了。對(duì)應(yīng)的真實(shí)定義都在httplib.h這一個(gè)文件里關(guān)鍵就四行using Logger std::functionvoid(const Request , const Response ); // 請(qǐng)求結(jié)束時(shí)觸發(fā) Server set_pre_routing_handler(HandlerWithResponse handler); // 路由前 Server set_post_routing_handler(Handler handler); // 路由后、發(fā)響應(yīng)前 class UserData; // res.user_data任意類型的口袋為什么不能全塞進(jìn) pre-routing 里打印因?yàn)槟菚r(shí)業(yè)務(wù) handler 還沒跑res.status還是空的、耗時(shí)也算不出。登記和結(jié)算必須分開這正是埋點(diǎn) 結(jié)算兩步的結(jié)構(gòu)。生產(chǎn)環(huán)境你會(huì)踩的坑1. 耗時(shí)永遠(yuǎn)是 0或者get出來(lái)的指針是空的現(xiàn)象日志里耗時(shí)列全是 0加斷點(diǎn)發(fā)現(xiàn)user_data.get...(start)返回nullptr。 原因set和get的類型必須逐字符一致——存成std::chrono::steady_clock::time_point卻按const ...time_point取類型 ID 對(duì)不上直接返回空。 修復(fù)set和getT用同一個(gè)精確類型取到后先判空再解引用。2. 想在 pre-routing 里打印狀態(tài)碼結(jié)果全是 0現(xiàn)象埋點(diǎn)位置打印res.status輸出 0 或 200 的固定值。 原因pre-routing 跑在業(yè)務(wù) handler 之前響應(yīng)根本沒生成此時(shí)打印狀態(tài)碼沒有意義。 修復(fù)狀態(tài)碼相關(guān)的日志一律挪到set_logger()里埋點(diǎn)鉤子只負(fù)責(zé)登記。3. 高并發(fā)下日志行互相串現(xiàn)象QPS 上去后一條日志被拆成兩行、和別的請(qǐng)求的輸出交錯(cuò)。 原因cpp-httplib 每個(gè) worker 線程同步執(zhí)行 logger多線程同時(shí)寫std::cout沒有任何鎖。 修復(fù)logger 里加std::lock_guardstd::mutex lk(log_mtx);或改用自帶線程安全的日志庫(kù)。4. 在 logger 里直接寫盤或遠(yuǎn)程上報(bào)QPS 被拖垮現(xiàn)象接入追蹤后接口延遲整體上升壓測(cè)吞吐掉檔。 原因logger 運(yùn)行在請(qǐng)求處理線程上是同步的磁盤 I/O 或網(wǎng)絡(luò)上報(bào)的耗時(shí)會(huì)原樣加到每個(gè)請(qǐng)求上。 修復(fù)logger 里只做queue.push(record);入隊(duì)由獨(dú)立后臺(tái)線程異步落盤或上報(bào)。自建埋點(diǎn)、set_logger 和 OpenTelemetry 的取舍方案適用場(chǎng)景取舍pre-routing user_data logger本文自己打點(diǎn)要 request ID、耗時(shí)、慢請(qǐng)求告警代碼最少、零依賴但跨服務(wù)傳播要自己拼請(qǐng)求頭只用set_logger()只需要 nginx 風(fēng)格的 access log十幾行搞定但沒有請(qǐng)求級(jí)預(yù)處理無(wú)法注入 ID 或計(jì)時(shí)OpenTelemetry C SDK要和現(xiàn)有 APM 平臺(tái)、其他語(yǔ)言的分布式鏈路打通換來(lái)標(biāo)準(zhǔn) traceparent 傳播和采樣代價(jià)是多一套 SDK 依賴和配置如果走分布式方案客戶端側(cè)的傳播在 cpp-httplib 里也很直接把 trace 上下文放進(jìn)默認(rèn)頭下游服務(wù)讀出來(lái)即可例如client.set_default_headers({{traceparent, ctx_string}});。到這里開頭的承諾已經(jīng)兌現(xiàn)不到 30 行你的每個(gè)請(qǐng)求都有了可追蹤的 ID、真實(shí)耗時(shí)和狀態(tài)碼。下一步就做一件事把示例里的計(jì)數(shù)器換成 UUID然后curl -i http://localhost:8080/hello對(duì)著響應(yīng)頭里的X-Request-ID去日志里 grep 一遍——能對(duì)上追蹤鏈路就算真正通了?！久赓M(fèi)下載鏈接】cpp-httplibA C header-only HTTP/HTTPS server and client library項(xiàng)目地址: https://gitcode.com/GitHub_Trending/cp/cpp-httplib創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考