K6 Load Testing Training

1. การติดตั้ง K6 ด้วย Docker

ความต้องการ

• Docker และ Docker Compose ที่ติดตั้งแล้ว

วิธีการติดตั้ง

วิธีที่ 1: ใช้ Docker Compose (แนะนำ)

# รันโดยตรง
docker-compose up

# หรือรันเฉพาะ service
docker-compose run k6 run /scripts/basic-test.js

วิธีที่ 2: ใช้ Docker Command

# รัน K6 script
docker run --net=host --rm -v $(pwd)/scripts:/scripts -v $(pwd)/results:/results grafana/k6 run /scripts/basic-test.js

# รันพร้อมเก็บผลลัพธ์
docker run --net=host --rm -v $(pwd)/scripts:/scripts -v $(pwd)/results:/results -e K6_OUT=json=/results/result.json grafana/k6 run /scripts/basic-test.js

# รันแบบกําหนด full options
docker run --rm \
        --ulimit nofile=65536:65536 \
        --sysctl net.core.somaxconn=65535 \
        --sysctl net.ipv4.tcp_fin_timeout=30 \
        --sysctl net.ipv4.tcp_tw_reuse=1 \
        --privileged \
        -v $(pwd)/scripts:/scripts \
        -v $(pwd)/results:/results \
        -e K6_OUT=json=/results/${test_name}_${timestamp}.json,csv=/results/${test_name}_${timestamp}.csv \
        -e K6_WEB_DASHBOARD=true \
        -e K6_WEB_DASHBOARD_EXPORT=/results/${test_name}_${timestamp}_report.html \
        grafana/k6 run /scripts/${script_name}

2. การรัน Script

การรันแบบพื้นฐาน

# รัน script ผ่าน docker-compose
docker-compose run k6 run /scripts/basic-test.js

# รัน script แบบกำหนด virtual users และ duration
docker-compose run k6 run --vus 10 --duration 30s /scripts/basic-test.js

การรันแบบขั้นสูง

# รันแบบ stages
docker-compose run k6 run /scripts/stress-test.js

# รันแบบ spike test
docker-compose run k6 run /scripts/spike-test.js

3. ตัวอย่าง Scripts

Basic Test

• scripts/basic-test.js - การทดสอบพื้นฐาน

Advanced Tests

• scripts/load-test.js - Load testing
• scripts/stress-test.js - Stress testing
• scripts/spike-test.js - Spike testing
• scripts/api-test.js - API testing

4. การเก็บผลลัพธ์

รูปแบบ JSON

docker-compose run -e K6_OUT=json=/results/result.json k6 run /scripts/basic-test.js

รูปแบบ CSV

docker-compose run -e K6_OUT=csv=/results/result.csv k6 run /scripts/basic-test.js

หลายรูปแบบพร้อมกัน

docker-compose run -e K6_OUT=json=/results/result.json,csv=/results/result.csv k6 run /scripts/basic-test.js

5. การอ่านผลลัพธ์

การอ่านไฟล์ JSON

• ใช้ jq command หรือเครื่องมือ JSON viewer
• Import เข้า monitoring tools เช่น Grafana

การอ่านไฟล์ CSV

• เปิดด้วย Excel หรือ Google Sheets
• ใช้ Python pandas สำหรับการวิเคราะห์

ตัวชี้วัดสำคัญ

• Response Time: เวลาตอบสนอง
• Throughput: จำนวน requests per second
• Error Rate: อัตราข้อผิดพลาด
• Virtual Users: จำนวน concurrent users

6. การปรับแต่งระบบปฏิบัติการ (OS Tuning)

สำหรับการทดสอบ load ที่มี concurrent users สูง ควรปรับแต่งระบบปฏิบัติการเพื่อรองรับการเชื่อมต่อจำนวนมาก

การปรับแต่งแบบอัตโนมัติ

# รัน OS tuning script (ต้องใช้ sudo)
sudo ./scripts/tune-os.sh

การปรับแต่งแบบ Manual

1. เพิ่ม File Descriptor Limits

แก้ไขไฟล์ /etc/security/limits.conf:

* soft nofile 65536
* hard nofile 65536
* soft nproc 65536
* hard nproc 65536

2. ปรับแต่ง Network Parameters

แก้ไขไฟล์ /etc/sysctl.conf:

# TCP connection limits
net.core.somaxconn = 65535
net.core.netdev_max_backlog = 5000
net.ipv4.tcp_max_syn_backlog = 65535

# TCP timeout settings
net.ipv4.tcp_fin_timeout = 30
net.ipv4.tcp_keepalive_time = 1200
net.ipv4.tcp_tw_reuse = 1

# Port range
net.ipv4.ip_local_port_range = 1024 65535

3. Apply Settings

# Apply sysctl settings
sudo sysctl -p

# Set current session limits
ulimit -n 65536
ulimit -u 65536

Docker Configuration

Docker Compose ได้รับการปรับแต่งแล้วใน docker-compose.yml:

• ulimits: เพิ่ม file descriptor limits
• sysctls: ปรับแต่ง network parameters
• privileged: true: อนุญาตให้ container ใช้ system resources

การตรวจสอบการปรับแต่ง

# ตรวจสอบ file descriptor limit
ulimit -n

# ตรวจสอบ network settings
sysctl net.core.somaxconn
sysctl net.ipv4.tcp_fin_timeout

7. การรันแบบ Docker และส่งผลไปยัง Grafana

การตั้งค่า Grafana สำหรับรับข้อมูล K6

วิธีที่ 1: ใช้ InfluxDB + Grafana

# สร้าง InfluxDB container
docker run -d \
  --name influxdb \
  -p 8086:8086 \
  -e INFLUXDB_DB=k6 \
  influxdb:1.8

# รัน K6 พร้อมส่งข้อมูลไปยัง InfluxDB
docker run --rm \
  --net=host \
  -v $(pwd)/scripts:/scripts \
  -v $(pwd)/results:/results \
  grafana/k6 run \
  --out influxdb=http://localhost:8086/k6 \
  /scripts/basic-test.js

วิธีที่ 2: ใช้ Prometheus + Grafana

# รัน K6 พร้อม Prometheus metrics
docker run --rm \
  --net=host \
  -v $(pwd)/scripts:/scripts \
  -v $(pwd)/results:/results \
  -e K6_PROMETHEUS_RW_SERVER_URL=http://localhost:9090/api/v1/write \
  grafana/k6 run \
  --out experimental-prometheus-rw \
  /scripts/basic-test.js

วิธีที่ 3: ใช้ Docker Compose พร้อม Grafana Stack

สร้างไฟล์ docker-compose-grafana.yml:

version: '3.8'
services:
  influxdb:
    image: influxdb:1.8
    environment:
      - INFLUXDB_DB=k6
    ports:
      - "8086:8086"
  
  grafana:
    image: grafana/grafana:latest
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=admin
    volumes:
      - grafana-storage:/var/lib/grafana
  
  k6:
    image: grafana/k6:latest
    command: run --out influxdb=http://influxdb:8086/k6 /scripts/basic-test.js
    volumes:
      - ./scripts:/scripts
      - ./results:/results
    depends_on:
      - influxdb

volumes:
  grafana-storage:

การรันพร้อม Grafana Dashboard

# รัน Grafana stack
docker-compose -f docker-compose-grafana.yml up -d

# รัน K6 test พร้อมส่งข้อมูลไปยัง InfluxDB
docker-compose -f docker-compose-grafana.yml run k6 run \
  --out influxdb=http://influxdb:8086/k6 \
  /scripts/load-test.js

# เข้าถึง Grafana ที่ http://localhost:3000 (admin/admin)

การนำเข้า K6 Dashboard ใน Grafana

1. เข้าสู่ Grafana (http://localhost:3000)
2. ไปที่ Import Dashboard
3. ใช้ ID: 2587 (K6 Load Testing Results)
4. เลือก InfluxDB data source
5. กำหนดชื่อ database เป็น k6

การใช้งาน

1. Clone repository นี้
2. ปรับแต่งระบบปฏิบัติการ (แนะนำ): sudo ./scripts/tune-os.sh
3. สร้าง scripts ใน folder scripts/
4. รัน docker-compose up หรือ command ตามต้องการ
5. ดูผลลัพธ์ใน folder results/
6. (ตัวเลือก) ตั้งค่า Grafana dashboard สำหรับ real-time monitoring
7. รัน Docker พร้อมส่งผลไปยัง Grafana สำหรับการติดตามแบบ real-time

References

1. Fine-tune OS for K6 Load Testing
2. K6 Reference Documentation