TopGit
Đánh giá repo GitHub

wrk: Công cụ benchmark HTTP

wg/wrk
WTopGit review image for wg/wrk
Review by Topgit.dev for wg/wrk, with GitHub repository stats and README context.
Nhận định nhanh

wrk chỉ làm đúng một việc nhưng làm rất tốt: dồn càng nhiều tải HTTP vào một endpoint càng tốt trên một máy nhiều lõi, rồi in ra các mốc percentile độ trễ mà nhiều công cụ chỉ đo requests/sec bỏ qua. wrk không có file cấu hình, không có logic ramp-up — bạn chỉ có vài flag dòng lệnh, cần thêm thì viết script LuaJIT. Sự tối giản đó chính là điểm hấp dẫn: chạy nhanh, đọc kết quả nhanh, và wrk không giả vờ là một nền tảng load-testing đầy đủ.

Sao
★ 40.4k
Fork
⑂ 3.0k
Ngôn ngữ
C
Giấy phép
Xem trong repo
Chủ đề
—
Cập nhật
Dec 2023
Trang chủ
—
GitHub

wrk là gì?

wrk là công cụ benchmark HTTP chạy dòng lệnh, viết bằng C, tạo tải lên một URL bằng kiến trúc đa luồng kết hợp epoll trên Linux và kqueue trên macOS. wrk có thể chạy thêm script LuaJIT tùy chọn để tùy biến cách tạo request, xử lý response và báo cáo kết quả. wrk nhắm vào một máy nhiều lõi duy nhất, không phải một cụm máy tạo tải phân tán.

Tính năng cốt lõi

  • ✓Lõi đa luồng trải kết nối ra nhiều luồng (-t), giúp một máy nhiều lõi tạo tải đồng thời ở mức đáng kể
  • ✓Dùng epoll trên Linux và kqueue trên macOS để một tiến trình quản lý hàng nghìn socket đang mở mà không cần busy-wait
  • ✓Script LuaJIT tùy chọn (-s) để tùy biến cách tạo request, xử lý response và báo cáo tùy chỉnh, chi tiết nằm trong tài liệu SCRIPTING
  • ✓Có sẵn các script Lua mẫu trong thư mục scripts/ để bắt đầu thay vì viết từ đầu
  • ✓Thêm header HTTP tùy chỉnh (-H) vào mọi request, ví dụ token xác thực, mà không cần đụng tới script
  • ✓Thống kê độ trễ chi tiết (--latency) gồm trung bình, độ lệch chuẩn, giá trị lớn nhất và phân phối
  • ✓Xử lý timeout (--timeout) để response chậm được tính là lỗi thay vì treo cả lần chạy
Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao ↗

Khi nào nên dùng wrk

  • •Kiểm tra tải cho một API endpoint hoặc file tĩnh trên server của bạn trước một đợt tăng traffic
  • •So sánh hai cấu hình server (số worker, cài đặt keep-alive) bằng cách chạy cùng một lệnh wrk cho từng cấu hình
  • •Viết script LuaJIT để mô phỏng chuỗi đăng nhập rồi gọi API khi vòng lặp GET/POST đơn giản không phản ánh đúng thực tế
  • •Ghi lại percentile độ trễ cho việc kiểm tra hồi quy hiệu năng trong CI, vì --latency in ra nhiều hơn con số req/sec đơn thuần

Build và cài đặt wrk từ mã nguồn

README được cung cấp không có hướng dẫn build từng bước. Điều được xác nhận: wrk là mã nguồn C, đóng gói sẵn LuaJIT của Mike Pall, http-parser từ nginx/joyent/node.js, và event loop 'ae' từ redis (theo phần Acknowledgements và file NOTICE), nên build wrk sẽ kéo theo các thành phần này chứ không phải một binary độc lập duy nhất. Ngoài ra, câu lệnh compiler hay make target cụ thể không được nêu rõ trong tài liệu này.

Chạy một benchmark cơ bản

Cách dùng cơ bản chỉ gói trong một dòng: `wrk -t12 -c400 -d30s http://127.0.0.1:8080/index.html` chạy test 30 giây với 12 luồng giữ 400 kết nối mở. -t đặt số luồng, -c đặt tổng số kết nối (chia đều cho các luồng), -d đặt thời lượng (nhận giá trị kiểu 2s, 2m, 2h), -s trỏ tới script LuaJIT, -H thêm header tùy chỉnh như 'User-Agent: wrk' vào mọi request, --latency in ra thống kê độ trễ chi tiết, và --timeout đánh dấu response là trễ nếu không về kịp. Lần chạy mẫu trong README ghi nhận 22464657 requests in 30.00s, 17.76GB read, Requests/sec 748868.53 và Transfer/sec 606.33MB — con số của bạn sẽ phụ thuộc hoàn toàn vào target và phần cứng.

Điểm mạnh

  • ✓Chỉ là một binary độc lập sau khi build xong — không có agent phía server, không có dashboard SaaS, chỉ cần wrk và một URL đích
  • ✓Kiến trúc đa luồng cùng epoll/kqueue giúp wrk tạo tải gần sát khả năng thực tế của máy client nhiều lõi, thay vì bị nghẽn ở một luồng duy nhất
  • ✓Script LuaJIT xử lý những trường hợp flag không làm được — header tùy biến theo từng request, luồng nghiệp vụ không phải GET đơn thuần, báo cáo tùy chỉnh — mà không cần đổi công cụ
  • ✓Báo cáo percentile độ trễ (trung bình/độ lệch chuẩn/lớn nhất cộng phân phối với --latency) thay vì chỉ một con số requests/sec trơ trọi

Giới hạn và lưu ý cần biết

  • △README được cung cấp không có hướng dẫn cài đặt/build, nên bạn phải tự lo phần compiler và dependency (LuaJIT, http-parser)
  • △Chỉ chạy dòng lệnh — không có file cấu hình, nên muốn nhiều kịch bản test thì phải viết script shell bao quanh wrk hoặc viết LuaJIT
  • △Logic Lua chạy theo từng request (tạo request mới hoặc gọi response()) làm giảm tải mà wrk có thể tạo ra, đúng như benchmarking tips trong README
  • △Muốn đủ kết nối để làm bão hòa server thì phải tự tinh chỉnh ephemeral port và tái sử dụng socket trên máy chạy wrk — việc ở tầng OS mà wrk không lo hộ
  • △Giấy phép không được nêu trong metadata cung cấp, và Cryptography Notice trong README có nhắc tới yếu tố kiểm soát xuất khẩu cho phần mã hóa đi kèm

Công cụ benchmark HTTP thay thế

Apache Bench (ab) — đi kèm dự án Apache HTTP Server, chạy đơn luồng, là lựa chọn mặc định lâu đời mà nhiều dev đã có sẵnhey — một binary Go duy nhất, không cần build, gần với tinh thần benchmark nhanh qua CLI của wrk nhưng không có script LuaJITsiege — thêm khả năng mô phỏng nhiều user đồng thời từ một danh sách URL, hữu ích khi muốn test nhiều endpoint trong một lần chạy thay vì mộtvegeta — xoay quanh một tốc độ request cố định thay vì tối đa thông lượng, phù hợp hơn để trả lời 'server chịu được N req/sec liên tục không' thay vì 'chạy nhanh tối đa được bao nhiêu'

Câu hỏi thường gặp

wrk có thể tạo request HTTP tùy chỉnh bằng LuaJIT không?

wrk hỗ trợ script LuaJIT tùy chọn qua flag -s để tạo request HTTP tùy chỉnh, xử lý response và tạo báo cáo riêng. Các script mẫu có sẵn trong thư mục scripts/, còn chi tiết đầy đủ về scripting nằm trong tài liệu SCRIPTING của dự án.

wrk dùng cơ chế event notification nào trên Linux và macOS?

wrk dùng epoll để xử lý event trên Linux và kqueue trên macOS, cả hai đều nằm trong kiến trúc đa luồng của wrk để một tiến trình theo dõi được số lượng lớn kết nối đang mở mà không cần polling từng cái.

wrk có hỗ trợ benchmark HTTPS và TLS không?

README của wrk không nói thẳng điều này, nhưng có nêu rằng bản phân phối wrk gồm phần mềm mã hóa, được xếp loại kiểm soát xuất khẩu ECCN 5D002.C.1 trong Cryptography Notice — xác nhận wrk có sẵn mã cần thiết để nhắm tới target https://, dù README không đi sâu vào các tùy chọn TLS.

wrk báo cáo những thống kê độ trễ nào?

wrk mặc định báo cáo độ trễ trung bình, độ lệch chuẩn và giá trị lớn nhất cho mỗi luồng, còn flag --latency bổ sung thêm phân phối chi tiết hơn. Lần chạy mẫu trong README cho thấy các con số như độ trễ trung bình 635.91us và giá trị lớn nhất 12.92ms, cùng cột '+/- Stdev'.

wrk xử lý được bao nhiêu kết nối và luồng trên một CPU?

README của wrk không nêu con số tối đa cho kết nối hay luồng — chỉ mô tả wrk có khả năng tạo tải đáng kể từ một CPU nhiều lõi duy nhất nhờ kiến trúc đa luồng kết hợp epoll/kqueue. Ví dụ trong tài liệu chạy 12 luồng và 400 kết nối, nhưng đó là ví dụ minh họa, không phải giới hạn được ghi nhận.

Vì sao wrk cần nhiều ephemeral port đến vậy?

wrk mở một kết nối TCP đi ra cho mỗi kết nối client mà nó mô phỏng, và mỗi kết nối chiếm một ephemeral port trên máy chạy wrk. Benchmarking tips trong chính README lưu ý máy client cần đủ ephemeral port và cần tái sử dụng socket đã đóng thật nhanh, nếu không bạn sẽ hết port trước khi server kịp thành nút thắt cổ chai.

Vấn đề wrk giải quyết

Nhiều developer khi cần biết server của mình chịu được bao nhiêu request mỗi giây thường chọn giữa viết vòng lặp curl tạm bợ hoặc dựng hẳn một nền tảng load-testing phân tán cồng kềnh. wrk nằm ở giữa: một binary C duy nhất tạo tải đồng thời thật từ một máy và in ra percentile độ trễ, không tốn công dựng cluster mà cũng không thô sơ như một đoạn bash loop.

Nên dùng wrk khi nào — và khi nào nên bỏ qua

Nên thử wrk nếu bạn thoải mái với việc build từ mã nguồn và sống chung với flag cùng LuaJIT để lấy con số throughput và độ trễ thật cho API hay file tĩnh trên server của mình. Nên bỏ qua nếu bạn muốn GUI, dashboard được host sẵn, hoặc một công cụ có binary dựng sẵn và file cấu hình ngay từ đầu — wrk mặc định bạn thà viết sáu dòng LuaJIT còn hơn click qua một wizard.

Nguồn & ghi công

Thông tin và trích dẫn lấy từ repo GitHub wg/wrk (https://github.com/wg/wrk), gồm README, tài liệu SCRIPTING được nhắc tới, và phần Acknowledgements/NOTICE.

Dữ liệu GitHub · đồng bộ lần cuối 15 thg 8, 2026Đánh giá bởi Henry
← Về TopGit

Chưa chắc wrk có hợp với bạn?

Để ChatGPT, Claude hoặc Perplexity tìm hiểu giúp — bấm bên dưới và xem AI nói gì về wrk.

GitHub