a301_mmo_game_server/ClientTester

ClientTester - MMO 서버 테스트 도구

MMO Game Server의 네트워크 성능 검증 및 부하 테스트를 위한 클라이언트 시뮬레이터.

---

1. 환경 (라이브러리)

항목	버전	용도
.NET	9.0	런타임
LiteNetLib	2.0.2	UDP 네트워크 통신 (서버와 동일)
protobuf-net	3.2.56	패킷 직렬화/역직렬화
Serilog	4.3.1	구조적 로깅
Serilog.Sinks.Console	6.0.0	콘솔 출력
Serilog.Sinks.File	7.0.0	파일 로깅
Microsoft.Diagnostics.NETCore.Client	0.2.553101	크래시 힙 덤프 (Release만)

빌드

cd ClientTester/EchoClientTester
dotnet build

---

2. 디렉토리 구조

ClientTester/
├── EchoClientTester/
│   ├── Program.cs                          # 진입점 (대화형 + CLI)
│   ├── EchoClientTester.csproj
│   ├── Vector3.cs                          # 위치 구조체
│   │
│   ├── DummyService/                       # 이동 테스트
│   │   ├── DummyClientService.cs           # 다중 더미 클라 관리
│   │   ├── DummyClients.cs                 # 개별 더미 클라 (이동 시뮬)
│   │   └── MapBounds.cs                    # 맵 경계 / 벽 충돌
│   │
│   ├── EchoDummyService/                   # Echo RTT 테스트
│   │   ├── EchoDummyClientService.cs       # 다중 에코 클라 관리
│   │   └── EchoDummyClients.cs             # 개별 에코 클라 (RTT 측정)
│   │
│   ├── StressTest/                         # 부하/스트레스 테스트
│   │   ├── StressTestService.cs            # 오케스트레이터 (Ramp-up, 통계, CSV)
│   │   └── StressTestClient.cs             # 통합 클라 (이동 + Echo 동시)
│   │
│   ├── Packet/                             # 패킷 정의 (서버와 동일 프로토콜)
│   │   ├── PacketHeader.cs                 # PacketCode Enum
│   │   ├── PacketBody.cs                   # Protobuf 패킷 클래스
│   │   └── PacketSerializer.cs             # 직렬화 유틸
│   │
│   └── Utils/
│       └── CrashDumpHandler.cs             # 크래시 로그 + 힙 덤프
│
└── TempServer/                             # 간이 에코 서버 (독립 테스트용)
    └── Program.cs

---

3. 사용방법

3.1 대화형 모드

dotnet run

========== 더미 클라 테스터 ==========
1. 에코 서버
2. 더미 클라(이동만)
3. 스트레스 테스트 (부하)
====================================
1 / 2 / 3 :

모드	설명
1. 에코 서버	Echo 패킷 송수신, RTT(Round-Trip Time) 측정
2. 더미 클라	이동(Transform) 패킷 전송, 패킷 손실률 측정
3. 스트레스 테스트	Ramp-up + 이동 + Echo 동시, 퍼센타일 레이턴시, CSV 내보내기

3.2 CLI 모드 (스트레스 테스트)

# 기본 실행 (50명, 60초)
dotnet run -- stress

# 100명 클라이언트, 120초 테스트
dotnet run -- stress -c 100 -d 120

# 원격 서버 대상, 커스텀 설정
dotnet run -- stress -c 200 -d 60 -r 500 -b 20 --ip 192.168.0.10 --port 9500

# 도움말
dotnet run -- --help

CLI 옵션

옵션	축약	기본값	설명
--clients	-c	50	총 클라이언트 수
--duration	-d	60	테스트 지속 시간 (초, 0=무제한)
--interval	-i	100	패킷 전송 주기 (ms)
--ramp	-r	1000	Ramp-up 간격 (ms)
--batch	-b	10	Ramp-up 당 추가 클라이언트 수
--ip		localhost	서버 IP 주소
--port		9500	서버 포트

3.3 출력 파일

경로	내용
logs2/log_{timestamp}.txt	전체 실행 로그
results/stress_{N}clients_{timestamp}.csv	스트레스 테스트 결과 (클라이언트별 통계)
crashes/crash_{timestamp}.log	크래시 스택 트레이스
crashes/crash_{timestamp}.dmp	힙 덤프 (Release 빌드만)

---

4. 파이프라인

4.1 에코 테스트 (모드 1)

[클라이언트 N개 동시 생성]
        ↓
[연결] UDP Connect → ServerBase.OnConnectionRequest()
        ↓
[PollLoop]  10ms 주기로 네트워크 이벤트 처리
[SendLoop]  100ms 주기로 Echo 패킷 전송
        ↓
[송신] EchoPacket { Str = "Echo seq:{N}" }
       → PacketSerializer.Serialize()
       → 4바이트 헤더(type + size) + Protobuf 페이로드
       → DeliveryMethod.ReliableUnordered
        ↓
[수신] 서버가 Echo 패킷 그대로 반환
       → seq 번호로 pendingPings 조회
       → RTT 계산: (수신시각 - 송신시각) / Stopwatch.Frequency
        ↓
[통계] 클라이언트별: AvgRTT, LastRTT, Sent, Recv, PacketLoss%
       전체: 총 Sent/Recv, 평균 RTT

4.2 이동 테스트 (모드 2)

[클라이언트 N개 동시 생성]
        ↓
[연결 + 인증]
       DummyAccTokenPacket { Token = clientId }
       → DeliveryMethod.ReliableOrdered
        ↓
[이동 시뮬레이션 - UpdateDummy()]
       ┌────────────────────────────────────────┐
       │ 1. 델타 타임 계산 (Stopwatch)            │
       │ 2. 남은 거리 = 0 이면:                    │
       │    - 벽 근처? → 반대 방향 회전              │
       │    - 아니면 → 현재 방향 ±30도 랜덤 회전      │
       │    - 목표 거리 = moveSpeed × (3~12초)      │
       │ 3. 이번 틱 이동 (moveSpeed × delta)       │
       │ 4. MapBounds.Clamp() → 벽 충돌 처리        │
       └────────────────────────────────────────┘
        ↓
[송신] TransformPlayerPacket { PlayerId, Position(X,0,Z), RotY }
       → DeliveryMethod.Unreliable (손실 감수)
        ↓
[통계] 클라이언트별: Sent, Recv, PacketLoss%

4.3 스트레스 테스트 (모드 3 / CLI)

[설정 입력] CLI 인자 또는 대화형 입력
        ↓
[Ramp-up Loop]
       ┌────────────────────────────────────┐
       │ rampInterval(1000ms)마다             │
       │ clientsPerRamp(10)명씩 클라이언트 생성  │
       │ → totalClients 도달 시 중단            │
       └────────────────────────────────────┘
        ↓ (병렬 실행)
[PollLoop]   10ms 주기 네트워크 이벤트
[SendLoop]   sendInterval(100ms) 주기
             ├─ UpdateAndSendTransform() (이동 - Unreliable)
             └─ SendPing()              (Echo - ReliableUnordered)
[StatsLoop]  10초마다 실시간 통계 출력
        ↓
[지속시간 만료 또는 Ctrl+C]
        ↓
[최종 리포트]
       ├─ 처리량: 총 Sent/Recv, 패킷/초
       ├─ 레이턴시: Min, Avg, P50, P95, P99, Max
       ├─ 최악 RTT 상위 5 클라이언트 상세
       └─ CSV 파일 자동 저장

4.4 패킷 직렬화 파이프라인

객체 (e.g. TransformPlayerPacket)
        ↓
protobuf-net Serialize → byte[] payload
        ↓
PacketSerializer.Serialize()
        ↓
┌──────────────────────────────┐
│ [2B type] [2B size] [payload] │
│  ushort    ushort    byte[]   │
└──────────────────────────────┘
        ↓
NetDataWriter.Put(data)
        ↓
peer.Send(writer, DeliveryMethod)

---

5. 테스트 모드별 기능 비교

기능	에코 (1)	이동 (2)	스트레스 (3)
동시접속 클라이언트	10 (고정)	10 (고정)	N (설정 가능)
인증 패킷 전송	X	O	O
이동 시뮬레이션	X	O	O
Echo RTT 측정	O	X	O
패킷 손실 추적	O	O	O
점진적 Ramp-up	X	X	O
지속시간 제한	무제한	무제한	설정 가능
실시간 통계	X	X	O (10초 주기)
퍼센타일 레이턴시	X (평균만)	X	O (P50/P95/P99)
CSV 내보내기	X	X	O
CLI 인자	X	X	O
최악 클라이언트 분석	X	X	O (상위 5)

---

6. 구현 진행도

완료

항목	상태	설명
Echo RTT 측정	완료	seq 기반 ping/pong, Stopwatch 고정밀 타이머
더미 이동 시뮬레이션	완료	벽 충돌, 랜덤 방향 전환, 델타 타임 기반 이동
맵 경계 처리	완료	MapBounds (Clamp, 벽 반대 방향 계산)
패킷 손실 추적	완료	LiteNetLib.NetStatistics 활용
크래시 덤프	완료	Debug: .log / Release: .log + .dmp
로깅 (콘솔+파일)	완료	Serilog 타임스탬프별 로그 파일
Graceful Shutdown	완료	Ctrl+C → CancellationToken → 통계 출력 후 종료
스트레스 테스트	완료	Ramp-up, 퍼센타일, CSV, CLI 인자
CLI 인자 지원	완료	stress -c N -d T --ip --port

미구현 / 향후 작업

항목	상태	설명
채널 입장 시뮬레이션	미구현	INTO_CHANNEL 패킷 전송 후 게임 루프 진입
전투 액션 시뮬레이션	미구현	ACTION_PLAYER (공격/스킬) 패킷 전송
상태 변경 시뮬레이션	미구현	STATE_PLAYER (HP/MP) 패킷 전송
JWT 토큰 인증 테스트	미구현	ACC_TOKEN 방식 인증 플로우 검증
서버 응답 검증	미구현	수신 패킷 내용 파싱 및 정합성 체크
테스트 시나리오 스크립트	미구현	JSON/YAML 기반 테스트 시나리오 정의
그래프 출력	미구현	RTT/처리량 시계열 차트 생성

---

7. 설정 참고

서버 연결 기본값

항목	값
IP	localhost
Port	9500
Connection Key	test

이동 시뮬레이션 파라미터

항목	값	설명
moveSpeed	3.5	이동 속도 (units/sec)
맵 범위	-50 ~ 50 (X, Z)	100x100 영역
벽 감지 마진	0.5	벽 근처 판정 거리
목표 거리	moveSpeed x 3~12초	직진 후 방향 전환
방향 전환	현재 ±30도 랜덤	벽 근처 시 반대 방향 강제

스트레스 테스트 기본값

항목	값	설명
클라이언트 수	50	-c 옵션
지속 시간	60초	-d 옵션
전송 주기	100ms	-i 옵션
Ramp-up 간격	1000ms	-r 옵션
Ramp-up 배치	10명	-b 옵션
실시간 통계 주기	10초	고정
Echo 최대 pending	500	메모리 누수 방지