QPS-Schätzung und Skalierung
Parallelität wird mit QPS (Queries per second) gemessen, also der Anzahl gültiger Serviceanfragen, die der Server pro Sekunde empfängt. Unabhängig davon, ob die Lokalisierung erfolgreich ist, wird eine Anfrage in die Parallelitätsstatistik aufgenommen, sobald sie die korrekte AppId der Cloud-Lokalisierungskartenbibliothek enthält und authentifiziert wurde.
Nach erfolgreicher Initialisierung sendet ein Gerät standardmäßig einmal pro Sekunde Lokalisierungsanfragen. Aufgrund von Netzwerklatenz und unterschiedlichen Ankunftszeiten der Anfragen kann die momentane Parallelität das QPS-Limit überschreiten. Beispielsweise können 10 QPS theoretisch 10 Geräte unterstützen, aber wenn in derselben Sekunde mehr als 10 Anfragen eingehen, werden die überzähligen Anfragen abgelehnt. Um die Stabilität des Dienstes in Szenarien mit mehreren gleichzeitigen Geräten sicherzustellen, wird empfohlen, beim Kauf von QPS etwas Reserve einzuplanen. Für 10 Geräte können Sie beispielsweise 11-12 QPS konfigurieren.
Cloud-Lokalisierungsdienstgruppen bieten standardmäßig 10 gleichzeitige Anfragen, was die Anforderungen der meisten Anwendungsszenarien erfüllt. Für Szenarien mit höherer Parallelität bieten wir flexible Ressourcenerweiterungsoptionen:
- In Phasen hoher Parallelität, etwa an Feiertagen, können Sie ein kurzfristiges Erweiterungspaket wählen, um die Parallelitätsfähigkeit temporär zu erhöhen
- Für Anwendungen mit vielen Benutzern und Bedarf an stabiler hoher Parallelität können zusätzliche Parallelitätsressourcen langfristig innerhalb der Gültigkeitsdauer an die Cloud-Dienstgruppe gebunden werden
Auf Basis von 10 QPS können Sie flexibel kurzfristige Zusatzpakete wählen oder langfristig feste Parallelitätsquoten erhöhen, um den Ressourcenbedarf verschiedener Geschäftsphasen abzudecken.
Verhalten bei Überschreitung des Parallelitätslimits
Wenn Anfragen den zugewiesenen QPS-Wert momentan überschreiten, gibt der Dienst folgende Fehlermeldung zurück (Beispiel):
statuCode: 21, message: "Exceed your QPS limitation"
Wenn Testbenutzer keine Lokalisierung erhalten, liegt dies wahrscheinlich an unzureichendem QPS. Es wird empfohlen, mit Mega Toolbox die Logs zu öffnen und die Antwortnachrichten zu prüfen, wie unten gezeigt:

Anmerkung
Testbenutzer haben eine relativ kleine Parallelitätsquote. Wenn keine Lokalisierung möglich ist, achten Sie besonders auf Fehlermeldungen wegen Überschreitung des Limits.
Skalierung gleichzeitiger QPS
Sie können die Parallelitätsquote auf zwei Wegen erweitern:
- Offline-Beratung mit Vertrieb oder Kundendienst (geeignet für große, langfristige oder kundenspezifische Anforderungen)
- Direktes Online-Upgrade in der Verwaltungskonsole (geeignet für temporäre oder kleine Erweiterungen)
Offline-Vertriebsberatung für Upgrade
Wenn die erwartete tägliche Parallelität 50 QPS überschreitet, wird empfohlen, EasyAR-Vertrieb oder Kundendienst zu kontaktieren, um Kapazitätserweiterung und Ressourcengarantie zu arrangieren. Melden Sie sich nach der Erweiterung im Entwickler-Backend an, um zu prüfen, ob die Quote wirksam ist.
Der Vorgang zum Bestätigen der Parallelitätsquote ist im folgenden Rahmen dargestellt:
Bedienschritte:
- Developer Center -> Block Cloud Localization -> Cloud-Lokalisierungsdienstgruppe -> Current QPS

Es wird empfohlen, die QPS-Anzahl nach dem Upgrade und die Gültigkeitsdauer zu bestätigen. Dies kann in der EasyAR-Verwaltungsoberfläche angezeigt werden. Der nächste Abschnitt beschreibt die Bedienung: Verwaltung gleichzeitiger QPS
Online-Upgrade
Die Konsole bietet zwei Einstiegspunkte für Online-QPS-Upgrades, wie unten gezeigt:
Developer Center -> Block Cloud Localization -> Cloud-Lokalisierungsdienstgruppe -> Upgrade
Developer Center -> Block Cloud Localization -> Cloud-Lokalisierungsdienstgruppe -> QPS details -> Upgrade

Wichtig
Für hohe Parallelitätsanforderungen über 50 QPS ist weiterhin eine Vertriebsberatung erforderlich, um eine stabile Ressourcenbereitstellung sicherzustellen.
Gleichzeitige QPS verwalten
Die Parallelitätsverwaltung umfasst hauptsächlich:
- Aktuelle QPS-Anzahl anzeigen
- QPS skalieren
- Gültigkeitsdauer eines Teils der QPS verlängern
Verwaltungsoberfläche
Bedienschritte
- Im Developer Center anmelden -> Block Cloud Localization -> Cloud-Lokalisierungsdienstgruppe -> QPS details
QPS-Anzahl und Gültigkeitsdauer aktualisieren

Nach dem Öffnen von QPS details sieht die Oberfläche wie oben dargestellt aus. Die aktuelle QPS-Anzahl wird im rechten Kasten des Bildes angezeigt.
Die Zeitleiste in der Mitte der Oberfläche zeigt die Gültigkeitsdauer des Basis-QPS-Teils und des aktualisierten QPS-Teils.
Die Kaufdatensätze unten zeigen Upgrade-Bestellungen und Details zur Gültigkeitsdauer.
Empfehlungen
- Schätzen Sie die erwartete Spitzenparallelität statt der durchschnittlichen Parallelität und reservieren Sie Reserve für den Spitzenwert (zum Beispiel wird bei einem Spitzenwert von 10 QPS empfohlen, 11-12 QPS zu kaufen).
- Während Feiertagen oder Veranstaltungen können kurzfristige Zusatzpakete temporär gekauft werden, um hohe Parallelitätsanforderungen zu erfüllen.
- Überprüfung nach der Erweiterung: Verwenden Sie Mega Toolbox in Szenarien hoher Parallelität, um sicherzustellen, dass Anfragen nicht abgelehnt werden und Antworten stabil sind.
- Bei anhaltenden Ablehnungen oder Ausnahmen sammeln Sie Logs und kontaktieren Sie das Supportteam zur Fehleranalyse, einschließlich Zeitfenster, AppId der Cloud-Lokalisierungskartenbibliothek und möglichst Paketmitschnitten mit Anfragebeispielen und Fehlercodes.