Lasttest der Lizenzprüfung mit k6
Sie führen Lasttests für Ihren Checkout und Ihr Login durch, aber der Aufruf, der entscheidet, ob die Software überhaupt laufen darf — die Lizenzaktivierung — trifft die Produktionslast meist zum ersten Mal bei einem flottenweiten Neustart. Diese Anleitung bringt den Prüfpfad mit k6 unter Last: Sie trennt die günstige lokale Signaturprüfung (die nie das Netz berührt) von den Aktivierungs- und Refresh-Aufrufen (die es tun), modelliert den Aktivierungssturm, den ein Deployment tatsächlich auslöst, definiert Schwellen für p95-Latenz und Fehlerrate und übt den bedingten Refresh, damit Sie sehen, dass der 304-Schnellpfad hält.
Sie testen die Pfade unter Last, die Sie ohnehin als tragend respektieren: den Checkout, das Login, das Suchfeld. Und dann gibt es den einen Aufruf, der entscheidet, ob die Software überhaupt laufen darf — die Lizenzprüfung — und er sieht fast nie einen Lasttest. In der Entwicklung läuft er einwandfrei, wo sich genau eine Instanz genau einmal aktiviert. Das erste Mal, dass er echter Nebenläufigkeit begegnet, ist in der Produktion, im denkbar schlechtesten Moment: Ein Deployment oder ein Neustart bringt die ganze Flotte auf einmal zurück, jede Instanz mit kaltem Cache, alle greifen in denselben zwei Sekunden nach einer Lizenz.
Eine Lizenzprüfung ist ein Abhängigkeitsaufruf wie jeder andere, und der Aktivierungspfad hat eine Kapazität. Dieser Beitrag bringt ihn mit k6 unter Last, und die erste Aufgabe ist, präzise zu sein, welchen Teil Sie eigentlich testen.
Was lokal ist und was über die Leitung geht
Der verbreitete Irrtum ist, sich jede Lizenzprüfung als Hin- und Rückweg zu einem Server vorzustellen. Mit Keyright ist sie das nicht. Die Prüfung im Normalbetrieb ist eine lokale Operation: Das SDK hält eine signierte Lizenz, und Validate() prüft ihre Signatur gegen den eingebetteten öffentlichen Schlüssel und liest ihre Claims. Kein Socket, kein DNS, Mikrosekunden.
// Steady state: no network at all. Validate() checks the signature on the
// cached, signed license with the embedded public key, then reads claims.
LicenseInfo info = _client.Validate(licenseKey);
if (info.Status != LicenseStatus.Valid)
throw new LicenseException(info.Status); // fail closed
Diesen Aufruf unter Last zu testen ist sinnlos — es ist CPU-gebundene Signatur-Arithmetik ohne geteilte Ressource, um die man konkurrieren könnte. Was das Netz berührt und daher eine Kapazität hat, die Sie erschöpfen können, sind zwei Dinge:
- Aktivierung. Wenn eine Instanz zum ersten Mal startet, oder zum ersten Mal nach dem Verlust ihres Caches, ruft sie den Ausstellungsdienst auf, um eine signierte Lizenz für ihre Maschinenidentität zu erhalten. Das ist der teure Aufruf, und der, der nach einem Deployment als Herde auftritt.
- Refresh. In einem Intervall validiert das SDK neu, damit sich eine Sperrung oder eine Berechtigungsänderung ausbreitet. Das ist eine bedingte Anfrage: Sie sendet die Versionsmarke, die sie bereits hat, und erhält meist ein günstiges
304 Not Modified.
Der echte Lasttest ist also nicht „eine Lizenz millionenfach prüfen“. Er ist „was passiert mit dem Aktivierungsendpunkt, wenn 300 Instanzen im selben Moment von einem Deployment zurückkehren und sich dann in ein stetiges Summen bedingter Refreshes einpendeln“.
Die HTTP-Aufrufe im Test
Die Aktivierung ist ein einfaches POST. Der Client sendet das Produkt, das er aktiviert, den Lizenzschlüssel und eine stabile Maschinenidentität; er erhält ein signiertes Lizenzdokument zurück.
POST /v1/activate HTTP/1.1
Host: license.example.com
Content-Type: application/json
{ "productKey": "prod_designer", "licenseKey": "KR-7Q2F-...", "machineId": "a1b2c3d4" }
Ein Refresh ist ein bedingtes GET. Der Client sendet die Versionsmarke, die er bereits hat; wenn sich nichts geändert hat, erhält er ein 304 mit leerem Rumpf — das ist der ganze Sinn: Eine gesunde Flotte erzeugt überwiegend 304er, keine vollständigen Lizenzdokumente.
GET /v1/license/lic_8f3a HTTP/1.1
Host: license.example.com
If-None-Match: "v7-2026-11-01"
→ HTTP/1.1 304 Not Modified
Das sind die beiden Anfragen, die k6 erzeugen wird.
Den Aktivierungssturm modellieren
Der Standard-Executor von k6 hält eine feste Zahl virtueller Nutzer, aber das ist hier nicht die Form des Risikos. Das Risiko ist eine Rampe: von null auf ein paar hundert Instanzen in Sekunden, während ein Rollout die Flotte neu startet. Nutzen Sie ramping-vus und machen Sie jeden virtuellen Nutzer zu einer eigenen Maschine, die online geht.
import http from 'k6/http';
import { check, sleep } from 'k6';
import { Trend, Rate } from 'k6/metrics';
const activateLatency = new Trend('activate_latency', true);
const activateFailed = new Rate('activate_failed');
export const options = {
scenarios: {
// A deploy brings the fleet back with a cold cache: everyone activates at once.
activation_storm: {
executor: 'ramping-vus',
startVUs: 0,
stages: [
{ duration: '30s', target: 300 }, // ramp to 300 concurrent clients
{ duration: '1m', target: 300 }, // hold the herd
{ duration: '30s', target: 0 }, // drain
],
},
},
thresholds: {
// Activation is on the critical path of a cold start. If p95 crosses
// 800ms, a fleet restart visibly stalls; fail the run if it does.
activate_latency: ['p(95)<800'],
activate_failed: ['rate<0.01'], // under 1% may fail under the storm
checks: ['rate>0.99'],
},
};
const BASE = __ENV.KEYRIGHT_URL; // e.g. https://license.staging.example.com
export default function () {
// Each VU/iteration is a distinct machine identity.
const machineId = `load-${__VU}-${__ITER}`;
const res = http.post(`${BASE}/v1/activate`, JSON.stringify({
productKey: __ENV.PRODUCT_KEY,
licenseKey: __ENV.LICENSE_KEY,
machineId,
}), { headers: { 'Content-Type': 'application/json' } });
activateLatency.add(res.timings.duration);
activateFailed.add(res.status !== 200);
check(res, {
'status is 200': (r) => r.status === 200,
'body is a signed license': (r) => {
try { return (JSON.parse(r.body).signature || '').length > 0; }
catch { return false; }
},
});
sleep(1);
}
Zwei Details tragen das Gewicht. Der check auf den Rumpf zählt, weil ein Aktivierungsendpunkt unter Stress ein 200 mit abgeschnittener oder fehlerhafter Nutzlast zurückgeben kann; zählte man nur Statuscodes, würde eine kaputte Antwort als Erfolg durchgehen. Und die Schwellen sind der Test: Ein k6-Lauf ohne Schwellen druckt nur Zahlen, aber Schwellen lassen ihn bestehen oder scheitern, und genau das erlaubt es, ihn in die CI einzubinden und eine Regression zu fangen, bevor sie ausgeliefert wird.
Führen Sie ihn mit Ziel und Zugangsdaten in der Umgebung aus, nie fest im Skript verdrahtet:
k6 run \
-e KEYRIGHT_URL=https://license.staging.example.com \
-e PRODUCT_KEY=prod_designer \
-e LICENSE_KEY=KR-7Q2F-TEST \
activation-storm.js
Auch den günstigen Pfad üben
Ein zweites Szenario beweist, dass der Refresh im Normalbetrieb günstig bleibt. Hier ist die interessante Zusicherung, dass die meisten Antworten 304 sind — wenn Ihre Flotte bei jedem Refresh ein vollständiges Lizenzdokument bezahlt, respektiert etwas weiter oben die Versionsmarke nicht, und das vervielfacht still Ihre Dauerkosten.
export function refresh() {
const res = http.get(`${BASE}/v1/license/${__ENV.LICENSE_ID}`, {
headers: { 'If-None-Match': __ENV.ETAG },
});
check(res, {
'not-modified fast path': (r) => r.status === 304,
});
}
Fügen Sie es neben dem Sturm als zweites Szenario mit einem constant-arrival-rate-Executor hinzu, damit es eine feste Anfragerate unabhängig davon modelliert, wie langsam die Antworten werden — genau so verhält sich eine Flotte von Timern.
Das Ergebnis lesen, und was es nicht sagt
Ein grüner Lauf bedeutet, dass Ihr Deployment die Herde innerhalb Ihres Latenzbudgets abfängt und Refreshes überwältigend über den 304-Schnellpfad bedient. Das ist die Zahl, die Sie vor dem nächsten großen Rollout wollen.
Seien Sie ehrlich zu den Grenzen.
- Sie testen Ihr Deployment, nicht die Prüf-Arithmetik. Die Signaturprüfung ist lokal und nahezu konstant in der Zeit; nichts, was Sie in k6 tun, stresst sie. Die Kapazität, die Sie messen, gehört dem Ausstellungsdienst, den Sie aufstellen.
- Der Missbrauchsschutz wird Ihren Lastgenerator bekämpfen, zu Recht. Ein Aktivierungsendpunkt, der ein Deployment wert ist, hat Ratenbegrenzung und Anti-Missbrauchs-Regeln. Ein Lasttest kann sie auslösen, und ein
429ist kein Kapazitätsfehler — es ist der Dienst, der seine Arbeit tut. Testen Sie gegen ein Staging-Deployment und ein Produkt, das mit Limits konfiguriert ist, die den Lauf durchlassen, sonst messen Sie den Ratenbegrenzer, nicht den Dienst. - Reaktivierung sollte idempotent sein, modellieren Sie also frische Maschinen. Dieselbe
machineIdzweimal zu aktivieren sollte günstig sein und darf keinen zweiten Platz verbrauchen. Deshalb leitet das Skript pro Iteration eine eigene Identität ab: Ein Lasttest, der eine Maschine reaktiviert, misst den idempotenten Schnellpfad, nicht den Sturm. - Richten Sie es nie auf einen geteilten oder Live-Dienst. Richten Sie es nur auf ein Deployment, das Sie besitzen und zurücksetzen können, mit einer dedizierten Testlizenz. Die selbstgehostete Community Edition von Keyright reicht, um ein realistisches Ziel aufzustellen.
Fazit
Die Lizenzprüfung ist eine tragende Abhängigkeit, und die Hälfte, die das Netz berührt, hat eine Kapazität wie jeder andere Endpunkt. k6 lässt Sie diese Kapazität zu Ihren Bedingungen finden: indem Sie den synchronisierten Kaltstart-Burst modellieren, den ein Deployment wirklich auslöst, auf p95 und Fehlerrate zusichern statt einen Graphen nach Augenmaß zu beurteilen, und bestätigen, dass der Refresh-Pfad auf seiner günstigen 304-Spur bleibt. Tun Sie es einmal in Staging, und der nächste flottenweite Neustart ist nicht länger der Moment, in dem Sie die Grenze entdecken.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.