Qps оценка и масштабирование
Параллелизм измеряется в QPS (Queries per second), то есть количестве действительных запросов на обслуживание, получаемых сервером в секунду. Независимо от того, успешно ли выполнено позиционирование, любой запрос, содержащий правильный AppId облачной библиотеки позиционирования и прошедший аутентификацию, учитывается в статистике параллелизма.
После успешной инициализации устройство по умолчанию отправляет запросы на позиционирование с частотой 1 раз в секунду. Из-за сетевых задержек и различий во времени поступления запросов возможны ситуации мгновенного превышения лимита QPS. Например, 10 QPS теоретически поддерживают 10 устройств, но если в течение одной секунды поступит более 10 запросов, превышающие лимит запросы будут отклонены. Для обеспечения стабильности обслуживания в сценариях с высокой параллельной нагрузкой от множества устройств рекомендуется предусматривать запас при покупке QPS. Например, для поддержки 10 устройств можно настроить 11–12 QPS.
Группа облачных сервисов позиционирования по умолчанию предоставляет 10 параллельных соединений, что удовлетворяет потребности большинства сценариев использования. Для сценариев, требующих более высокой параллельной обработки, мы предлагаем гибкую схему масштабирования ресурсов:
- В периоды высокой нагрузки, такие как праздники, можно выбрать краткосрочные пакеты расширения для временного увеличения пропускной способности.
- Для приложений с большой пользовательской базой, требующих стабильной поддержки высокой параллельной нагрузки, поддерживается долгосрочное выделение дополнительных ресурсов параллелизма на срок действия группы облачных сервисов.
Поверх базовых 10 QPS вы можете гибко выбирать краткосрочные дополнения или долгосрочное увеличение фиксированной квоты параллелизма в соответствии с потребностями в ресурсах на разных этапах бизнеса.
Поведение при превышении лимита параллелизма
При мгновенном превышении выделенного QPS сервис возвращает следующую ошибку (пример):
statuCode: 21, message: "Exceed your QPS limitation"
Если пользователь в пробном режиме не может выполнить позиционирование, вероятной причиной является недостаток QPS. Рекомендуется включить логи с помощью Mega Toolbox и просмотреть ответное сообщение. Как показано на рисунке:

Примечание
Пользователи на пробном периоде имеют небольшую квоту параллелизма. При невозможности позиционирования рекомендуется обращать внимание на наличие сообщений об ошибках превышения лимита.
Масштабирование QPS параллелизма
Увеличить квоту параллелизма можно двумя способами:
- Офлайн-консультация с коммерческим отделом или службой поддержки (подходит для крупномасштабных, долгосрочных или кастомизированных потребностей).
- Прямое обновление через панель управления онлайн (подходит для временного или небольшого увеличения).
Офлайн-консультация для обновления
Если ожидаемая ежедневная нагрузка превышает 50 QPS, рекомендуется связаться с отделом продаж EasyAR или службой поддержки для организации расширения мощностей и гарантии ресурсов. После масштабирования войдите в панель разработчика, чтобы подтвердить активацию квоты.
Процесс подтверждения квоты параллелизма показан в рамке на рисунке ниже:
Шаги выполнения:
- Центр разработки -> Block Облачное позиционирование -> Группа облачных сервисов позиционирования -> Текущий QPS

Рекомендуется подтвердить количество QPS после обновления и срок действия. Просмотр через интерфейс управления EasyAR описан в следующем разделе: Управление QPS параллелизма
Онлайн-обновление
Панель управления предоставляет два входа для онлайн-обновления QPS, как показано на рисунке:
- Центр разработки -> Block Облачное позиционирование -> Группа облачных сервисов позиционирования -> Обновить
- Центр разработки -> Block Облачное позиционирование -> Группа облачных сервисов позиционирования -> Детали QPS -> Обновить

Важно
Для потребностей в высокой параллельной нагрузке свыше 50 QPS все равно требуется консультация с коммерческим отделом для обеспечения стабильности поставки ресурсов.
Управление QPS параллелизма
Основные аспекты управления параллелизмом включают:
- Просмотр текущего количества QPS
- Масштабирование QPS
- Продление срока действия части QPS
Интерфейс управления
Шаги выполнения
- Войдите в Центр разработки -> Block Облачное позиционирование -> Группа облачных сервисов позиционирования -> Детали QPS
Обновление количества QPS и срока действия

Войдя в раздел "Детали QPS", вы увидите интерфейс, показанный выше. Текущее количество QPS отображается в области, отмеченной рамкой справа.
Временная шкала в середине интерфейса показывает срок действия базовой части QPS и части обновленного QPS.
В самом низу раздел "История покупок" отображает детали заказов на обновление и сроков действия.
Рекомендации
- Оценивайте ожидаемый пиковый параллелизм, а не средний, предусматривая запас для пиков (например, для пика в 10 QPS рекомендуется приобретать 11–12 QPS).
- В праздничные дни или в периоды проведения мероприятий можно временно приобрести краткосрочные дополнения для удовлетворения потребности в высокой параллельной нагрузке.
- Проверка после масштабирования: используйте Mega Toolbox в условиях высокой нагрузки, чтобы убедиться, что запросы не отклоняются и ответы стабильны.
- При постоянных отказах или аномалиях соберите логи и обратитесь в службу поддержки для анализа (включите временное окно, AppId облачной библиотеки позиционирования, желательно предоставить файл сниффера с примерами запросов и кодами ошибок).