QPS-Schätzung und Erweiterung

Die Anzahl gleichzeitiger Anfragen wird in QPS (Queries per second) gemessen, also der Anzahl gültiger Serviceanfragen, die der Server pro Sekunde empfängt. Jede Anfrage, die eine korrekte Cloud-Bibliotheks-AppId enthält und authentifiziert ist, wird in die Statistik einbezogen – unabhängig davon, ob die Ortung erfolgreich war oder nicht.

Nach erfolgreicher Initialisierung sendet ein Gerät standardmäßig jede Sekunde eine Ortungsanfrage. Aufgrund von Netzwerklatenzen und Schwankungen in der Ankunftszeit der Anfragen kann es zu kurzzeitigen Überschreitungen des QPS-Limits kommen. Beispiel: 10 QPS sollten theoretisch 10 Geräte unterstützen. Werden jedoch innerhalb derselben Sekunde mehr als 10 Anfragen empfangen, werden die überschüssigen Anfragen abgelehnt. Um die Stabilität des Dienstes bei mehreren gleichzeitigen Geräten zu gewährleisten, wird empfohlen, beim Kauf von QPS einen gewissen Puffer einzuplanen. Für 10 Geräte könnten beispielsweise 11–12 QPS konfiguriert werden.

Ein Cloud-Ortungsdienstpaket bietet standardmäßig 10 gleichzeitige Anfragen (QPS), was den meisten Anwendungsfällen gerecht wird. Für Szenarien mit höherem Durchsatz bieten wir flexible Erweiterungsoptionen:

• Während Zeiten hoher Auslastung, wie Feiertagen, können kurzfristige Aufstockungspakete zur temporären Erhöhung der Kapazität erworben werden.
• Für Anwendungen mit vielen Nutzern und stabil hohem Durchsatz können zusätzliche QPS-Ressourcen für die gesamte Laufzeit des Cloud-Dienstpakets fest zugebucht werden.

Auf Basis der 10 QPS können Sie flexibel zwischen kurzfristigen Ergänzungspaketen oder der dauerhaften Erhöhung Ihres festen QPS-Kontingents wählen, um sich an die Ressourcenanforderungen verschiedener Geschäftsphasen anzupassen.

Verhalten bei überschrittenen QPS-Grenzwerten

Wenn Anfragen das zugeteilte QPS-Limit kurzzeitig überschreiten, gibt der Dienst folgende Fehlermeldung zurück (Beispiel):

statuCode: 21, message: "Exceed your QPS limitation"

Wenn Nutzer im Teststatus keine Ortung erhalten, liegt dies häufig an unzureichendem QPS. Es wird empfohlen, die Protokolle mit der Mega Toolbox zu überprüfen und die Antwortnachrichten zu prüfen. Siehe Abbildung:

Anmerkung

Testnutzer haben ein geringes QPS-Kontingent. Falls keine Ortung erfolgt, prüfen Sie bitte, ob Fehlermeldungen über eine Grenzwertüberschreitung vorliegen.

Erweiterung der QPS-Kapazität

Sie können Ihr QPS-Kontingent auf zwei Wegen erhöhen:

• Persönliche Anfrage über Vertrieb oder Kundenservice (empfohlen für große, langfristige oder maßgeschneiderte Anforderungen)
• Direktes Upgrade über das Management-Dashboard (geeignet für temporäre oder kleinere Erweiterungen)

Persönliche Anfrage über Vertrieb

Wenn der erwartete tägliche Durchsatz 50 QPS überschreitet, wird empfohlen, den EasyAR-Vertrieb oder Kundenservice für Kapazitätserweiterung und Ressourcensicherung zu kontaktieren. Nach der Erweiterung bestätigen Sie bitte im Entwickler-Dashboard, ob das neue Kontingent aktiv ist.

Der Prozess zur Überprüfung des QPS-Kontingents ist in der folgenden Abbildung markiert:

Schritte:

• Entwicklerzentrum -> Block Cloud-Ortung -> Cloud-Ortungsdienstpaket -> Aktuelles QPS

Es wird empfohlen, die Anzahl der QPS nach dem Upgrade sowie die Gültigkeitsdauer zu bestätigen. Dies kann über die EasyAR-Management-Oberfläche eingesehen werden. Details finden Sie im nächsten Abschnitt: Verwaltung von QPS

Online-Upgrade

Das Dashboard bietet zwei Zugänge für ein Online-QPS-Upgrade, wie unten dargestellt:

1. Entwicklerzentrum -> Block Cloud-Ortung -> Cloud-Ortungsdienstpaket -> Upgrade
2. Entwicklerzentrum -> Block Cloud-Ortung -> Cloud-Ortungsdienstpaket -> QPS-Details -> Upgrade

Wichtig

Für Anforderungen über 50 QPS hinaus ist weiterhin die Kontaktaufnahme mit dem Vertrieb erforderlich, um eine stabile Ressourcenbereitstellung sicherzustellen.

Verwaltung von QPS

Die Verwaltung der gleichzeitigen Anfragen umfasst hauptsächlich:

• Anzeige der aktuellen QPS-Anzahl
• Erweiterung der QPS-Kapazität
• Verlängerung der Gültigkeitsdauer für einen Teil der QPS

Verwaltungsoberfläche

Schritte

• Einloggen im Entwicklerzentrum -> Block Cloud-Ortung -> Cloud-Ortungsdienstpaket -> QPS-Details

Upgrade von QPS-Anzahl und Gültigkeitsdauer

    In den QPS-Details (siehe Abbildung oben) wird die aktuelle QPS-Anzahl im markierten Bereich rechts angezeigt.

    Die Zeitleiste in der Mitte zeigt die Gültigkeitsdauer des Basis-QPS-Anteils sowie des erweiterten QPS-Anteils.

    Die Kaufhistorie unten listet Upgrade-Bestellungen und Details zur Gültigkeitsdauer auf.

Empfehlungen

• Kalkulieren Sie den erwarteten Spitzendurchsatz, nicht den Durchschnitt, und planen Sie einen Puffer für Spitzen ein (z.B. bei 10 QPS Spitzenlast empfiehlt sich der Kauf von 11–12 QPS).
• Während Feiertagen oder Veranstaltungen können kurzfristige Ergänzungspakete für hohe Auslastung erworben werden.
• Nach der Erweiterung prüfen: Nutzen Sie die Mega Toolbox in einem Hochlast-Szenario, um sicherzustellen, dass Anfragen nicht abgelehnt werden und die Antworten stabil sind.
• Bei anhaltenden Ablehnungen oder Anomalien sammeln Sie bitte Protokolle und wenden Sie sich an das Support-Team (inklusive Zeitfenster, AppId der Cloud-Ortungsbibliothek, idealerweise mit einer Netzwerk-Mitschnittdatei mit Anfragebeispielen und Fehlercodes).

Nächstes Thema lesen

Erläuterung zu Erweiterungen und Kontingenten anderer Mega-Dienste