[Performance JMeter] Bài 10 - Functional Helper 2

📘 Functional Helper 2

1. Property Function

• Cú pháp: ${__P(varName,defauldValue)}
• Cách hoạt động: ${__P()} đọc JMeter properties (global cho toàn test). __P() là shorthand hay dùng khi truyền -J từ CLI. Biết rõ: properties khác variables (variables là thread-local). jmeter.apache.org+1
• Ví dụ: Trong TestPlan bạn cấu hình
• 
• Khi chạy non-GUI cần thay đổi thông tin thay vì bạn phải mở testplan ra và thay đổi thì có thể truyền trực tiếp: jmeter -n -t testplan.jmx -Jthread=10 -Jram_up=10 -Jduration=300 -l results.jtl -o htmlreport
• Dùng để tham số hóa bất kì biến nào

2. Counter (Bộ đếm)

• Cú pháp: ${__counter(booleanPerUser, varName)}
• Cách hoạt động: booleanPerUser=true → mỗi thread có counter riêng (đếm số vòng/iteration của thread đó). booleanPerUser=false → counter chung (global) cho tất cả threads. Kết quả được trả về và có thể lưu vào biến. blazemeter.com
• Ví dụ:

  ${__counter(TRUE,myCounter)}   -> mỗi thread có myCounter = 1,2,3...

  ${__counter(FALSE,globalCnt)} -> shared counter giữa các thread

  Tạo sequence number cho orderId (global) hoặc đếm iteration cho debug (per-user).

3. ThreadNum (Bộ đếm thread)

• Cú pháp: ${__threadNum}
• Cách hoạt động: ${__threadNum} trả số thứ tự thread hiện tại (từ 1 .. N). Chỉ unique trong scope thread group (không đảm bảo global uniqueness). ${__machineName} trả host name của máy đang chạy (hữu ích khi chạy distributed). jmeter.apache.org+1
• Ví dụ: Trong các hệ thống lớn thì việc cấu hình distributed(Kết hợp nhiều máy sẽ tìm hiểu ở bài sau). Để biết request này xuất phát từ máy nào thì chúng ta có thể sử dụng ${__machineName}:${__threadNum} vào một số trường trong api để đánh dấu.
• {
    "name": "iPhone 15 Pro",
    "description": "${__machineName}:${__threadNum}",
    "price": 25000000.00,
    "merchant_id": 1,
    "is_deleted": false
  }

4. Mã hóa/Hash (plugin)

a. MD5

• Cú pháp: ${__MD5(String,varName)}
• Cách hoạt động: Hàm __MD5 sẽ nhận một chuỗi đầu vào và trả về chuỗi băm (hash) theo thuật toán MD5 (32 ký tự hex).
• Ví dụ: Sinh mã hash cho mật khẩu trước khi gửi request. So sánh chữ ký (signature) với hệ thống backend. ${__MD5(${username},hashedUser)} 👉 Biến ${hashedUser} sẽ chứa MD5 hash của giá trị ${username}.

b. Base64Encode

• Cú pháp: ${__base64Encode(string,varName)}
• Cách hoạt động: Mã hóa (encode) chuỗi ký tự sang Base64.
• Thường dùng để:

  • Encode dữ liệu nhị phân (binary) thành chuỗi text (ví dụ: file, ảnh).

  • Tạo Basic Authorization ${__base64Encode(${clientId}:${clientSecret},authB64)}

    👉 header: Authorization: Basic ${authB64}

  • Encode chuỗi tĩnh:${__base64Encode(hello)} 👉aGVsbG8=

  • Encode biến JMeter: Giả sử ${password} = 123456 -> ${__base64Encode(${password})} 👉 MTIzNDU2

c. Base64Decode

• Cú pháp: ${__base64Decode(string,variableName)}
• Cách hoạt động: Giải mã (decode) một chuỗi Base64 trở lại chuỗi gốc.
• Thường dùng để:

  • Decode chuỗi tĩnh ${__base64Decode(aGVsbG8=)} 👉 hello

  • Decode biến JMeter:Giả sử ${token} = MTIzNDU2 -> ${__base64Decode(${token})} 👉123456

5. Groovy inline

• Cú pháp: ${__groovy(script, varName?)}
• Cách hoạt động: ${__groovy(script, varName?)} chạy Groovy code và trả về giá trị (string). Biến và môi trường nhất định (ví dụ vars, props, log, ctx) có thể truy cập trong JSR223/Groovy; tài liệu JMeter nêu rõ cách và khuyến nghị dùng __groovy cho hiệu năng tốt hơn ở số lượng thread lớn so với __javaScript. svn.apache.org+1
• Ví dụ: Lấy đường dãn thư mục
• 
  

  Mục tiêu	Function	Giá trị trả về (ví dụ)
  File .jmx	${__groovy(org.apache.jmeter.services.FileServer.getFileServer().getScriptName(), jmxFile)}	D:/Projects/TestPlan/my_test.jmx
  Thư mục chứa .jmx (cấp 1)	${__groovy(org.apache.jmeter.services.FileServer.getFileServer().getBaseDir(), jmxDir)}	D:/Projects/TestPlan
  Thư mục cha (cấp 2)	${__groovy(new File(org.apache.jmeter.services.FileServer.getFileServer().getBaseDir()).getParent(), jmxParentDir)}	D:/Projects
  Thư mục cha cấp 3	${__groovy(new File(org.apache.jmeter.services.FileServer.getFileServer().getBaseDir()).getParentFile().getParent(), jmxGrandParentDir)}	D:/

6. Tổng hợp ví dụ thực tế(Tổng hợp các function)

Kịch bản: Test flow “Register -> Login -> Create Order” với dữ liệu dynamic:

• Email từ file: ${__StringFromFile(/data/emails.txt,email)}
• Username = user_${__RandomString(5,abcdefghijklmnopqrstuvwxyz,)}
• created_at = ${__time(yyyy-MM-dd'T'HH:mm:ssZ,createdAt)}
• orderId = ${__UUID} hoặc ${__counter(FALSE,globalOrder)}
• Authorization header = Basic ${__base64Encode(${clientId}:${clientSecret},authB64)}

Best practices & tips (các lưu ý quan trọng)

• Dùng đúng tool cho dữ liệu lớn: CSV Data Set Config > StringFromFile/CSVRead cho performance; tránh dùng hàm phức tạp ở mỗi request nếu có thể generate trước. blazemeter.com+1
• Biết rõ scope: variable là thread-local; property là global. Dùng __P() để param hóa khi chạy CLI/CI. jmeter.apache.org
• Plugin functions: cài plugin (Plugin Manager) nếu cần base64/MD5/chooseRandom. Kiểm tra encoding issues khi xử lý tiếng Việt. jmeter-plugins.org+1
• Tránh tính nặng trong function call liên tục: __groovy rất tiện nhưng heavy; cache logic ở JSR223 nếu cần nhiều lần. svn.apache.org

Tài liệu tham khảo (một vài nguồn chính)

• Apache JMeter — Functions and Variables (manual). jmeter.apache.org
• CSVRead API (chi tiết alias / next()). jmeter.apache.org
• StringFromFile / StringToFile API. jmeter.apache.org+1
• JMeter-Plugins — functions (chooseRandom, base64, MD5, ...). jmeter-plugins.org+1
• timeShift / RandomDate docs & ví dụ. jmeter.apache.org+1
• Groovy function in JMeter (with examples & warnings). svn.apache.org+1

JMeter Functions Cheat Sheet