# HTTP Client 플랫폼 — 성능 기준선 인증 lane은 처리량 목표가 아니라 **자원 상한**을 단언한다. 실패하는 upstream, 큰 본문, 교체가 메모리, connection, 스레드, upstream 트래픽을 끝없이 먹지 못함을 증명하려는 것이다. 여기 있는 어떤 것도 실행 중 적응형 기본값이 되지 않는다. 모든 상한은 profile에 명시한 설정에서 온다. ## 돌리는 법 ```bash # 모든 상한: 구조적 상한과 기계에 따른 상한 ./gradlew :adapter:outbound:httpclient:httpClientPerformanceTest --console=plain # JMH benchmark: 숫자만 낸다. 게이트가 아니다 ./gradlew :adapter:outbound:httpclient:jmh --console=plain ``` lane은 매번 모든 상한을 단언한다. 기계에 따라 다른 상한을 끄는 스위치는 없다. 빌드가 `performance.assertions.enabled`에 `true` 아닌 값을 넣으면 strict lane convention이 성능 lane을 돌기 전에 실패시키고, 테스트 하나라도 건너뛰면 실패시킨다. `main.yml`의 nightly `performance` job(`:performanceCheck`)과 `release.yml`이 도는 것도 같은 명령이다. 매번 잰 heap 증가량(`[httpclient-performance] streaming download heap increase … bytes, bound … bytes`)을 테스트 출력과 보고서에 찍고, 실패한 상한은 단언 메시지에 그 값을 다시 적는다. 판정 없는 숫자가 필요하면 JMH를 쓴다. ## 인증한 상한 | 테스트 | 상한 | 종류 | |---|---|---| | `RetryStormBudgetTest` | 실패하는 upstream에 대한 논리 호출 10 000개가 10 % 예산에서 물리 시도를 최대 11 000개 만든다 | 구조적 | | `LargeBodyResourceTest` | 32 MiB 스트리밍 다운로드가 payload를 heap에 버퍼링하지 않고 모든 바이트를 읽는다 | 구조적 + 기계에 따른 heap 상한 | | `PoolSaturationPerformanceTest` | connection 4개짜리 pool에 대한 동시 호출 24개가 모두 끝 상태에 닿는다. 멈춘 것이 없다 | 구조적 | | `OAuthRefreshContentionTest` | 정말 동시에 부르는 호출자 100개가 token 요청을 정확히 하나 만든다 | 구조적 | | `RuntimeRotationDrainTest` | 교체 50번이 내린 세대 50개를 모두 닫고 drain 스레드를 남기지 않는다 | 구조적 | ## 기준선 기록하기 배포를 인증할 때는 숫자와 함께 이것을 적는다: 정확한 명령, commit, 하드웨어, JVM flag, 시험한 profile YAML, p50/p95/p99/max, 최대 heap, 최대 direct memory, 스레드 수, connection 수, 물리 시도 수, 오류 수. profile과 하드웨어 없는 지연 숫자는 기준선이 아니라 일화다. | 항목 | 값 | |---|---| | 명령 | _인증할 때 채운다_ | | Commit | _채운다_ | | 하드웨어 / JVM | _채운다_ | | 시험한 profile | _채운다_ | | p50 / p95 / p99 / max | _채운다_ | | 최대 heap / direct memory | _채운다_ | | 스레드 / connection | _채운다_ | | 물리 시도 / 오류 | _채운다_ | 이 표는 저장소에서 일부러 비워 둔다. 빌드 agent에서 잰 숫자를 인증한 기준선처럼 내놓는 것은 기준선이 없는 것보다 나쁘다.