Migrating from 1.X to 2.X
출처: 문서
본문
1.X에서 2.X로 마이그레이션
OpenSearch Benchmark와 통합된 시스템을 이미 운영 중인 사용자라면, OpenSearch Benchmark 2.0으로 원활하게 전환하기 위해 다음 단계를 수행하는 것을 권장해요.
Benchmark.ini 업데이트
OpenSearch Benchmark는 benchmark.ini에 의존하는데, 이 파일은 기본적으로 ~/.benchmark 디렉터리에서 찾을 수 있어요. 이 설정 파일은 메트릭이 어디로 보고되는지, 워크로드를 어떻게 가져오는지 등과 관련된 설정을 제공해요. OpenSearch Benchmark 2.0에서는 [results_publishing]의 이름을 [reporting]으로 변경했어요.
설정 파일은 다음과 같아야 해요:
[reporting]
datastore.type = in-memory
datastore.host = <host-url>
datastore.port = <host-port>
datastore.secure = False
datastore.ssl.verification_mode = <ssl-verification-details>
datastore.user = <username>
datastore.password = <password>
...
OpenSearch Benchmark 설정 방법에 대한 자세한 내용은 OpenSearch Benchmark 설정하기를 참고하세요.
외부 메트릭 데이터 스토어 업데이트
많은 사용자가 이전 테스트 실행의 결과와 메트릭을 저장하기 위해 외부 메트릭 데이터 스토어를 사용해요.
OpenSearch Benchmark 1.X는 테스트 상세 정보를 benchmark-test-executions-* 인덱스 패턴을 가진 인덱스에 저장했어요. 하지만 2.X에서는 benchmark-test-runs-* 인덱스 패턴을 가진 인덱스에 저장해요. 메트릭 데이터 스토어에 이 새로운 인덱스 패턴을 추가하고, 아직 이전 인덱스 패턴을 사용하고 있을 수 있는 대시보드도 함께 업데이트하는 것을 권장해요.
| 이전 인덱스 패턴 | 새 인덱스 패턴 |
|---|---|
| benchmark-test-executions-* | benchmark-test-runs-* |
스크립트 업데이트
일부 사용자는 야간 성능 테스트를 실행하기 위해 커스텀 스크립트로 OpenSearch Benchmark를 감싸서 사용해요. 이러한 스크립트는 2.X에서 더 이상 사용되지 않는 일부 용어에 의존하고 있을 수 있어요.
다음 용어를 확인하고 스크립트를 그에 맞게 조정하세요.
| 1.X 용어 | 2.X 용어 |
|---|---|
| execute-test, test-execution-id, TestExecution | run, test-run, TestRun |
| results_publishing, results_publisher | reporting, publisher |
| provision-configs, provision-config-instances | cluster-configs, cluster-config-instances |
| load-worker-coordinator-hosts | worker-ips |
OpenSearch Benchmark를 1.X에서 2.X로 마이그레이션하는 과정에서 문제가 발생하면, 다음 방법 중 하나로 OpenSearch Benchmark 메인테이너에게 연락해 보세요:
- OpenSearch Benchmark Slack 채널에 질문 올리기.
- 커뮤니티 미팅, 오피스 아워, 이슈 트리아지 참석하기.
- OpenSearch Benchmark GitHub 저장소에 이슈 생성하기.