Nutzung je Feature mit mehreren Kredit-Pools messen
Echte Produkte messen mehr als eine Sache — KI-Tokens, Render-Minuten, Exporte — und alles in einen einzigen Kredittopf zu werfen verschleiert die Kosten und blockiert unbeteiligte Funktionen, sobald eine erschöpft ist. So modellieren Sie mehrere unabhängige Kredit-Pools auf einer Keyright-Lizenz: die Form eines Pools, idempotentes Zählen pro Pool, das isoliert fail-closed verhält, die Abbuchungsreihenfolge vom inkludierten Kontingent zur Prepaid-Aufladung, atomare Abbuchungen über mehrere Pools für eine Operation, die zwei Zähler gleichzeitig verbraucht, und der pro-Pool-Abgleich, der auch offline funktioniert.
Die meisten Mess-Leitfäden, einschließlich unserer eigenen Einführung, raten Ihnen, eine abrechenbare Einheit zu wählen und sie sauber zu messen. Dieser Rat ist richtig, und dort fangen fast alle an. Dann wächst das Produkt. Das KI-Dokumentenwerkzeug, das pro verarbeitetem Dokument abrechnete, rendert nun auch PDFs, ruft ein Modell auf, das pro Token abrechnet, und lässt in eine Handvoll Formate unter einem Monatslimit exportieren. Drei verschiedene Dinge kosten Sie Geld, liefern unterschiedlichen Wert und erschöpfen sich in unterschiedlichem Tempo — und ein einziger „Guthaben“-Topf beschreibt keines davon mehr ehrlich.
In diesem Beitrag geht es um den nächsten Schritt: mehrere Ressourcen auf einer Lizenz zu messen, jede als eigenen Kredit-Pool, ohne dass die Pools einander in die Quere kommen.
Kernaussage: Wenn ein Produkt mehr als eine Ressource misst, geben Sie jeder ihren eigenen Pool, statt alles in generisches Guthaben umzurechnen. Getrennte Pools halten den Preis ehrlich, erlauben eine eigene Zurücksetzungs-Kadenz und Überschreitungs-Politik pro Ressource und — am wichtigsten — erschöpfen sich unabhängig, sodass ein leerer Export-Pool nie einen Render-Job blockiert. Der Preis ist etwas mehr Mechanik: idempotente Abbuchungen pro Pool, eine explizite Abbuchungsreihenfolge, wenn Pools sich überschneiden, und atomare Abbuchungen über mehrere Pools für eine Operation, die zwei Zähler gleichzeitig verbraucht.
Warum ein einziger Kredittopf nicht reicht
Die verlockende Abkürzung ist ein einziger Saldo abstrakter „Credits“ mit einer Preisliste, die sagt, ein Dokument koste 1 Credit, eine Render-Minute 4 und ein Export 10. Sie zerbricht beim Kontakt mit echten Kunden:
- Der Wechselkurs ist eine Fiktion, die Sie ewig pflegen. Sobald sich Ihre Render-Kosten ändern, verschiebt sich auch der effektive Preis, den jeder Kunde für Dokumente zahlt, weil sie sich einen Topf teilen. Sie können eine Ressource nicht neu bepreisen, ohne alle neu zu bepreisen.
- Die Erschöpfung ist Alles-oder-nichts. Ein Kunde, der den Topf mit Renders verbrennt, kann ein Dokument, für dessen Verarbeitung er bereits bezahlt hat, nicht mehr exportieren. Eine außer Kontrolle geratene Funktion hungert alle anderen aus.
- Niemand kann den eigenen Verbrauch lesen. „Sie haben noch 4.000 Credits“ beantwortet keine Frage, die der Kunde sich wirklich stellt, nämlich „Wie viele Berichte kann ich diesen Monat noch exportieren?“.
Getrennte Pools beheben alle drei Punkte. Jede Ressource hat ihren eigenen Saldo, ihre eigene Zurücksetzungs-Kadenz und ihre eigene Überschreitungs-Politik, und einen zu erschöpfen hat keine Wirkung auf die anderen.
Was ein Pool ist
Ein Pool ist ein benannter, verbrauchbarer Saldo, den die Lizenz neben ihren Flags und Limits trägt. Drei Eigenschaften definieren ihn:
- Art. Ein Kontingent-Pool füllt sich in einer Kadenz wieder auf (etwa 2.000 Render-Minuten, die am Ersten jedes Monats zurückgesetzt werden). Ein Prepaid-Pool ist ein vom Kunden gekaufter Block, der bis zum Verbrauch bestehen bleibt und sich nie selbst auffüllt.
- Überschreitungs-Politik. Was bei null passiert — harter Stopp, ein kleiner Kulanzpuffer oder gemessene, nachträglich abgerechnete Überschreitung. Entscheiden Sie das pro Pool; ein harter Stopp bei Exporten und Überschreitung bei KI-Tokens ist eine völlig vernünftige Mischung.
- Abgleich. Wie die lokale Abbuchung gegen den maßgeblichen Server-Saldo abgeglichen wird, was für Offline- und On-Premise-Deployments am meisten zählt.
Gegen einen benannten Pool messen
Bei einem Pool nannte der SDK-Aufruf eine Einheit; bei mehreren nennt er den Pool. Alles andere aus der Ein-Pool-Messung gilt weiter — am Engpass zählen, einen stabilen Idempotenzschlüssel übergeben und fail-closed sein — aber jetzt gilt jede dieser Regeln pro Pool.
var client = KeyrightClient.Initialize(options);
// At the single point where render minutes are consumed.
var draw = await client.MeterAsync(
pool: "render-minutes",
amount: job.Minutes,
idempotencyKey: job.Id); // stable: a retry never double-charges
if (!draw.Allowed)
{
// This pool is empty. Fail closed — do not render — but say which pool.
ShowTopUpPrompt(pool: "render-minutes", message: draw.Message);
return;
}
RunRenderJob(job); // only runs when a render minute was actually metered
MeterAsync gibt ein MeterResult zurück, das Allowed, eine lesbare Message und Remaining trägt, sodass Sie ein Banner für niedrigen Saldo ohne zweiten Aufruf steuern können. Wie bei jeder Keyright-Prüfung schlägt eine Abbuchung gegen einen unbekannten oder erschöpften Pool fail-closed fehl — Allowed ist false — sodass der Verweigerungspfad das Standardverhalten ist, nicht etwas, woran Sie denken müssen.
Unabhängige Erschöpfung ist der ganze Sinn
Weil die Abbuchung auf einen Pool begrenzt ist, stoppt ein leerer Pool nur seine eigenen Operationen. In der Abbildung oben ist der Export-Pool bei null, doch ein Render gelingt weiterhin, weil die Render-Abbuchung den Export-Saldo nie berührt. Lesen Sie Salden direkt, wenn Sie Status anzeigen oder früh warnen müssen:
PoolBalance exports = client.GetBalance("exports");
// ResetsAt is non-null for a quota pool, null for a prepaid block.
if (exports.Remaining == 0)
DisableExportButton(reason: $"Export quota resets {exports.ResetsAt:d}.");
else if (exports.Remaining <= exports.Limit * 0.2)
ShowLowBalanceBanner(exports); // warn at 20% — a surprise is a support ticket
Den Export-Knopf auszublenden ist UX, keine Durchsetzung: Die maßgebliche Prüfung ist die MeterAsync-Abbuchung an der Stelle, an der der Export erzeugt wird. Das Banner sorgt nur dafür, dass der Kunde von einem leeren Pool erfährt, bevor er mitten in einer Aufgabe darauf stößt.
Abbuchungsreihenfolge: inkludiertes Kontingent vor Prepaid-Aufladung
Pools werden interessant, wenn zwei von ihnen dieselbe Operation bezahlen können. Eine verbreitete Form: Jeder Tarif enthält ein monatliches Kontingent an Render-Minuten, und Kunden können Prepaid-Blöcke für alles darüber kaufen. Sie wollen die inkludierten Minuten zuerst ausgeben — sie verfallen zum Monatsende, die Prepaid-Minuten nicht — damit der Kunde nie Geld verbrennt, das er gratis hätte nutzen können.
Drücken Sie das als geordneten Durchlauf durch die Kandidaten-Pools aus:
// Spend the resetting quota first, then fall back to the prepaid block.
static async Task<MeterResult> MeterWithFallbackAsync(
KeyrightClient client, string[] poolsInOrder, long amount, string idempotencyKey)
{
foreach (var pool in poolsInOrder)
{
var draw = await client.MeterAsync(pool, amount, idempotencyKey);
if (draw.Allowed) return draw; // first pool with room wins
}
return MeterResult.Denied("All matching pools exhausted. Top up to continue.");
}
var draw = await MeterWithFallbackAsync(
client,
poolsInOrder: ["render-minutes-included", "render-minutes-prepaid"],
amount: job.Minutes,
idempotencyKey: job.Id);
Der einzige idempotencyKey steht für die ganze Operation, nicht für einen einzelnen Pool, sodass ein abgelehnter Versuch nichts belastet und ein Wiederholungsversuch das verbuchte Ergebnis abspielt, egal welcher Pool am Ende bezahlt hat. Wenn Sie die Reihenfolge lieber nicht im Client-Code tragen wollen, deklarieren Sie sie einmal auf dem Server als Pool-Gruppe — eine geordnete Menge, die das SDK für Sie auflöst — und kehren zu einem schlichten MeterAsync(pool: "render-minutes", …) zurück, das im Hintergrund inkludiert-dann-Prepaid durchläuft.
Eine Operation, zwei Pools: atomare Abbuchungen über mehrere Pools
Der schwierige Fall ist eine einzelne logische Operation, die aus mehr als einem Pool gleichzeitig ausgibt. Ein Render-Job kann sowohl Render-Minuten als auch die KI-Tokens verbrauchen, die sein Untertitelungsschritt verbrennt. Sie mit zwei separaten MeterAsync-Aufrufen zu belasten ist eine Falle: Gelingt der erste und scheitert der zweite, haben Sie einen Pool für Arbeit belastet, die Sie gleich abbrechen, und es gibt keinen sauberen Weg, dieses Guthaben zurückzugeben.
Die Lösung ist eine Alles-oder-nichts-Mehrfach-Abbuchung. Beschreiben Sie jeden Pool, den die Operation berührt, und lassen Sie das SDK alle prüfen, sie gemeinsam belasten oder keinen belasten:
var plan = new[]
{
new MeterDraw(pool: "render-minutes", amount: job.Minutes),
new MeterDraw(pool: "ai-tokens", amount: job.CaptionTokens),
};
// Every pool must have room, or nothing is debited.
var result = await client.MeterManyAsync(plan, idempotencyKey: job.Id);
if (!result.Allowed)
{
// ShortfallPool names the first pool that could not cover its draw.
ShowTopUpPrompt(pool: result.ShortfallPool, message: result.Message);
return;
}
RunRenderJob(job); // both pools debited together, under one idempotency key
Das ist das Mess-Äquivalent einer Transaktion: Die Invariante ist, dass die Salden des Kunden und die gelieferte Arbeit sich nie widersprechen. ShortfallPool sagt Ihnen, welcher Zähler den Job blockiert hat, sodass die Auflade-Aufforderung auf den richtigen Pool zeigt statt auf ein generisches „keine Credits mehr“.
Resets, Abgleich und offline
Jeder Pool wird nach seinen eigenen Bedingungen abgeglichen. Ein Kontingent-Pool füllt sich in seiner Kadenz wieder auf; der Server setzt Remaining an der Periodengrenze auf Limit zurück, und das SDK spiegelt das beim nächsten Abgleich. Ein Prepaid-Pool sinkt nur, bis der Kunde einen weiteren Block kauft.
Für Offline-Deployments gilt derselbe Mechanismus signierter Blöcke wie bei der Ein-Pool-Messung, einmal pro Pool. Der Server stellt für jeden Pool ein kryptografisch signiertes Guthaben aus — „diese Lizenz hält 2.000 Render-Minuten und 1.000.000 KI-Tokens“ — das der Client gegen seinen eingebetteten öffentlichen Schlüssel prüft und lokal abbucht, ohne Netzwerkaufruf pro Abbuchung. Verbindet sich die Maschine wieder, gleicht sie jeden Pool unabhängig ab: Sie meldet den Verbrauch, der Server gleicht jedes Guthaben ab und stellt frische signierte Blöcke aus. Ein abgeschotteter oder On-Premise-Kunde kann mehrere Ressourcen gleichzeitig messen, ohne während einer Abbuchung je online zu sein.
Die ehrliche Grenze ändert sich gegenüber jedem clientseitigen Zähler nicht: Ein entschlossener Angreifer mit einem Decompiler kann versuchen, einen lokalen Saldo zu patchen, daher bleibt der maßgebliche Zählerstand auf einem Server, den Sie kontrollieren, signierte Blöcke werden dagegen abgeglichen, und Sie machen den Client schwer patchbar — siehe Ihre Lizenzprüfungen schützen. Offline-Messung pro Pool ist eine kontrollierte Vertrauenserweiterung für legitimen getrennten Betrieb, keine Garantie gegen Manipulation.
Mit Keyright umsetzen
Keyright behandelt jeden Pool als erstklassigen Teil der Lizenz, neben Sitzen, Feature-Flags und numerischen Limits. Sie deklarieren einen Pool pro gemessener Ressource — seine Art, Zurücksetzungs-Kadenz und Überschreitungs-Politik —, verkaufen Kontingente und Prepaid-Blöcke dagegen, und das SDK (.NET, Node, Python, Java) misst jeden Pool unabhängig, idempotent und fail-closed. Pool-Gruppen lassen Sie die Abbuchungsreihenfolge einmal deklarieren; MeterManyAsync hält eine Operation über mehrere Pools atomar; und signierte Blöcke pro Pool tragen das Ganze offline und gleichen ab, sobald eine Maschine sich wieder verbindet. Weil es dieselbe Lizenz ist, die bereits Ihre Testphasen, Sitze und Berechtigungen verwaltet, ist das Messen mehrerer Ressourcen Teil der Lizenz, nicht ein daneben geschraubtes Abrechnungssystem.
Die Community Edition ist kostenlos und selbst gehostet, Sie können also ein Produkt mit mehreren Pools modellieren und von Anfang bis Ende verdrahten, bevor Sie sich festlegen — sehen Sie sich die Preise an oder lesen Sie die Keyright-Dokumentation für die genaue Mess-Oberfläche. Wenn nutzungsbasierte Bepreisung pro Funktion für Ihr Produkt zentral ist, geht die Funktionsübersicht ausführlich auf Pools, Kontingente und Überschreitungen ein.
Fazit: Ein einziger Kredit-Pool ist das richtige Modell für genau eine gemessene Ressource. Sobald Sie eine zweite messen, geben Sie ihr ihren eigenen Pool — unabhängiger Saldo, unabhängiger Reset, unabhängige Erschöpfung — und greifen Sie zur geordneten Abbuchung, wenn Pools sich überschneiden, und zu einer atomaren Mehrfach-Abbuchung, wenn eine Operation zwei Zähler gleichzeitig verbraucht.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.