aggregate command
출처: 문서
본문
aggregate 명령어
aggregate 명령어는 여러 테스트 실행을 하나의 집계된 결과로 결합하여, 여러 테스트 실행을 수행하고 분석하는 더 간소화된 방법을 제공해요. 집계 방법에는 두 가지가 있어요:
자동 집계
자동 집계 방법은 벤치마크 테스트의 여러 반복을 실행하고 결과를 자동으로 집계해요. 이 모든 작업이 단일 명령어로 이루어져요. 여기에 설명된 플래그를 execute 명령어와 함께 사용할 수 있어요.
사용법
다음 예제는 geonames 워크로드를 실행하고 결과를 두 번 집계해요:
opensearch-benchmark execute --test-iterations=2 --aggregate=true --workload=geonames --target-hosts=127.0.0.1:9200
{% include copy-curl.html %}
자동 집계 플래그
다음 새 플래그를 사용하여 자동 집계 방법을 사용자 지정할 수 있어요:
--test-iterations: 워크로드를 실행할 횟수를 지정해요(기본값은1).--aggregate: 여러 테스트 실행의 결과를 집계할지 여부를 결정해요(기본값은true).--sleep-timer: 다음 테스트 실행을 시작하기 전에 대기할 시간(초)을 지정해요(기본값은5).--cancel-on-error: 설정하면 테스트 반복 중 하나에서 오류가 발생할 경우 테스트 실행을 중지해요(기본값은false).
수동 집계
aggregate 명령어를 사용하여 여러 테스트 실행의 결과를 수동으로 집계할 수 있어요.
사용법
여러 테스트 실행을 수동으로 집계하려면 집계하려는 test_run_ids를 지정해요. 다음 예제를 참조하세요:
opensearch-benchmark aggregate --test-executions=<test_run_id1>,<test_run_id2>,...
{% include copy-curl.html %}
응답
OpenSearch Benchmark는 다음과 같이 응답해요:
____ _____ __ ____ __ __
/ __ \____ ___ ____ / ___/___ ____ ___________/ /_ / __ )___ ____ _____/ /_ ____ ___ ____ ______/ /__
/ / / / __ \/ _ \/ __ \\__ \/ _ \/ __ `/ ___/ ___/ __ \ / __ / _ \/ __ \/ ___/ __ \/ __ `__ \/ __ `/ ___/ //_/
/ /_/ / /_/ / __/ / / /__/ / __/ /_/ / / / /__/ / / / / /_/ / __/ / / / /__/ / / / / / / / / /_/ / / / ,<
\____/ .___/\___/_/ /_/____/\___/\__,_/_/ \___/_/ /_/ /_____/\___/_/ /_/\___/_/ /_/_/ /_/ /_/\__,_/_/ /_/|_|
/_/
Aggregate test run ID: aggregate_results_geonames_9aafcfb8-d3b7-4583-864e-4598b5886c4f
----------------------------------
[INFO] ✅ SUCCESS (took 1 seconds)
----------------------------------
결과는 하나의 테스트 실행으로 집계되어 출력에 표시된 ID로 저장돼요.
추가 옵션
--test-execution-id: 집계된 테스트 실행의 고유 ID를 정의해요.--results-file: 집계된 결과를 제공된 파일에 작성해요.--workload-repository: OpenSearch Benchmark가 워크로드를 로드할 리포지토리를 정의해요(기본값은default).
집계된 결과
집계된 결과에는 다음 정보가 포함돼요:
- 상대 표준 편차(RSD): 각 메트릭에 대해 추가로
mean_rsd값이 테스트 실행 간 결과의 분포를 보여줘요. - 전체 최소/최대값: 최소값과 최대값을 평균내는 대신 집계된 결과에는 모든 테스트 실행에서 실제 최소값/최대값을 반영하는
overall_min과overall_max가 포함돼요. - 저장소: 집계된 테스트 결과는
test-runs폴더와 함께 별도의aggregated_results폴더에 저장돼요.
다음 예제는 집계된 결과를 보여줘요:
"throughput": {
"overall_min": 29056.890292903263,
"mean": 50115.8603858536,
"median": 50099.54349684457,
"overall_max": 72255.15946248993,
"unit": "docs/s",
"mean_rsd": 59.426059705973664
},