QPS 예상 및 확장
동시 실행 수는 QPS(Queries per second)로 측정되며, 이는 서버가 초당 수신하는 유효 서비스 요청 수입니다. 로컬라이제이션 성공 여부와 관계없이 요청에 올바른 클라우드 로컬라이제이션 맵 라이브러리 AppId가 포함되어 있고 인증을 통과하면 동시 실행 통계에 포함됩니다.
장치가 초기화에 성공한 후에는 기본적으로 초당 1회의 빈도로 로컬라이제이션 요청을 보냅니다. 네트워크 지연 및 요청 도착 시간 차이로 인해 순간 동시 실행이 QPS 제한을 초과할 수 있습니다. 예를 들어 10 QPS는 이론적으로 10대의 장치를 지원할 수 있지만, 같은 1초 안에 10개를 초과하는 요청이 수신되면 초과 요청은 거부됩니다. 다중 장치 동시 실행 시나리오에서 서비스 안정성을 보장하기 위해 QPS 구매 시 일정한 여유를 예약하는 것을 권장합니다. 예를 들어 10대의 장치를 지원할 때는 11-12 QPS를 구성할 수 있습니다.
클라우드 로컬라이제이션 서비스 그룹은 기본적으로 10개의 동시 실행을 제공하며, 대부분의 애플리케이션 시나리오 요구를 충족할 수 있습니다. 더 높은 동시 실행이 필요한 시나리오를 위해 유연한 리소스 확장 방안도 제공합니다.
- 휴일 등 고동시 실행 기간에는 단기 확장 패키지를 선택하여 일시적으로 동시 실행 능력을 높일 수 있습니다
- 사용자 수가 많고 안정적인 고동시 실행 지원이 필요한 애플리케이션의 경우, 추가 동시 실행 리소스를 클라우드 서비스 그룹 유효 기간 내에 장기 바인딩할 수 있습니다
10 QPS를 기반으로 단기 보충 패키지를 유연하게 선택하거나 고정 동시 실행 할당량을 장기적으로 늘려, 다양한 비즈니스 단계의 리소스 요구에 대응할 수 있습니다.
동시 실행 초과 시의 동작
요청이 순간적으로 할당된 QPS를 초과하면 서비스는 다음 오류 메시지를 반환합니다(예시).
statuCode: 21, message: "Exceed your QPS limitation"
평가판 사용자가 로컬라이제이션하지 못하는 경우 QPS 부족 때문일 가능성이 높습니다. Mega Toolbox로 로그를 열어 응답 메시지를 확인하는 것을 권장합니다. 아래 그림과 같습니다.
참고
평가판 사용자의 동시 실행 할당량은 비교적 작습니다. 로컬라이제이션되지 않을 때는 초과 제한 오류 메시지가 있는지 주의해서 확인하십시오.
동시 QPS 확장
다음 두 가지 방법으로 동시 실행 할당량을 확대할 수 있습니다.
- 오프라인으로 비즈니스 또는 고객 서비스에 문의(대규모, 장기 또는 맞춤 요구에 적합)
- 관리 콘솔에서 직접 온라인 업그레이드(임시 또는 소규모 확장에 적합)
오프라인 비즈니스 상담 업그레이드
예상 일상 동시 실행이 50 QPS를 초과하는 경우, EasyAR 영업 또는 고객 서비스에 연락하여 용량 확장 및 리소스 보장을 준비하는 것을 권장합니다. 확장 후 개발자 backend에 로그인하여 할당량이 적용되었는지 확인하십시오.
동시 실행 할당량 확인 과정은 아래 그림의 박스에 표시되어 있습니다.
작업 단계:
- Developer Center -> Block Cloud Localization -> 클라우드 로컬라이제이션 서비스 그룹 -> Current QPS
업그레이드 후 QPS 수량과 사용 유효 기간을 확인하는 것을 권장합니다. EasyAR 관리 인터페이스에서 확인할 수 있으며, 다음 절에서 작업을 소개합니다: 동시 QPS 관리
온라인 업그레이드
콘솔에는 온라인 QPS 업그레이드를 지원하는 두 개의 진입점이 있습니다. 아래 그림과 같습니다.
Developer Center -> Block Cloud Localization -> 클라우드 로컬라이제이션 서비스 그룹 -> Upgrade
Developer Center -> Block Cloud Localization -> 클라우드 로컬라이제이션 서비스 그룹 -> QPS details -> Upgrade
중요
50 QPS 이상의 대규모 동시 실행 요구에 대해서는 안정적인 리소스 공급을 보장하기 위해 여전히 비즈니스 상담이 필요합니다.
동시 QPS 관리
동시 실행 관리는 주로 다음을 포함합니다.
- 현재 QPS 수량 보기
- QPS 확장
- 일부 QPS의 유효 기간 업그레이드
관리 인터페이스
작업 단계
- Developer Center에 로그인 -> Block Cloud Localization -> 클라우드 로컬라이제이션 서비스 그룹 -> QPS details
QPS 수량 및 유효 기간 업그레이드
QPS details에 들어가면 인터페이스가 위 그림처럼 표시됩니다. 현재 QPS 수량은 그림 오른쪽 박스에 표시됩니다.
인터페이스 가운데의 타임라인은 기본 QPS 부분과 업그레이드 QPS 부분의 유효 기간을 표시합니다.
가장 아래의 구매 기록은 업그레이드 주문과 유효 기간의 상세 정보를 표시합니다.
권장 사항
- 평균 동시 실행이 아닌 예상 피크 동시 실행을 추정하고, 피크에 대한 여유를 확보하십시오(예: 피크 10 QPS는 11-12 QPS 구매 권장).
- 휴일 또는 이벤트 기간에는 단기 보충 패키지를 임시 구매하여 고동시 실행 요구를 충족할 수 있습니다.
- 확장 후 검증: 고동시 실행 시나리오에서 Mega Toolbox를 사용하여 요청이 거부되지 않고 응답이 안정적인지 확인합니다.
- 지속적인 거부 또는 이상이 발생하면 로그를 수집하고 지원팀에 연락하여 조사하십시오(시간 범위, 클라우드 로컬라이제이션 맵 라이브러리의 AppId 포함, 요청 샘플과 오류 코드가 포함된 패킷 캡처 파일 제공 권장).