technik: Aufrufe über ein Ereignis-Log zählen statt im Request

Bisher lief pro Seitenaufruf ein UPDATE press_releases SET hits = hits + 1 im
Request. Auf der über 1 GB großen Tabelle blockiert dieser Schreibzugriff,
sobald dort eine Schemaänderung läuft — die wartenden Requests belegten dabei
PHP-FPM-Worker und DB-Verbindungen, bis die ganze Seite stand.

Der Request schreibt jetzt nur noch in die kleine Append-Tabelle
press_release_events, und selbst dabei wird jeder Fehler geschluckt und
gemeldet: Ein Aufruf-Zähler darf eine Seite niemals langsamer oder kaputt
machen. Die Summierung in press_releases.hits übernimmt gebündelt der
Scheduler.

Der Fortschritt läuft über eine Wasserstandsmarke (höchste bereits verbuchte
Event-ID) statt über einen Zwischenspeicher, damit bei einem Neustart kein
Aufruf verloren geht. Zähler und Marke werden je Durchgang gemeinsam
committet — sonst wäre nur der Durchgang wiederanlaufsicher, nicht der Abbruch
darin, und der nächste Lauf verbuchte dieselben Aufrufe doppelt. Eine Migration
setzt die Marke beim Deploy auf den Ist-Stand; ohne sie würde der erste Lauf
den gesamten Altbestand ein zweites Mal aufaddieren.

Weil das Log damit mit dem Traffic wächst und als einzige Log-Tabelle des
Systems keine Bereinigung hatte, begrenzt press-releases:purge-events es auf
einen Aufbewahrungszeitraum (Default 395 Tage = 13 Monate, damit der
Vorjahresmonats-Vergleich möglich bleibt). Gelöscht wird ausschließlich
unterhalb der Wasserstandsmarke — alles darüber ist noch nicht in hits verbucht
und wäre sonst dauerhaft verloren. Fehlt die Marke, bricht der Lauf ab, statt
zu raten.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Kevin Adametz 2026-09-01 11:05:28 +00:00
parent f8728c5bca
commit 6a34ab48ee
11 changed files with 565 additions and 12 deletions

View file

@ -43,6 +43,17 @@ class AppSetting extends Model
public static function setValue(string $key, mixed $value): void
{
static::query()->updateOrCreate(['key' => $key], ['value' => $value]);
static::forgetCached($key);
}
/**
* Verwirft den zwischengespeicherten Wert. Nötig überall dort, wo an
* `app_settings` vorbei geschrieben wird — insbesondere in Migrationen,
* die den Query Builder benutzen: `getValue()` cacht dauerhaft
* (`rememberForever`), ein Direktschreiber bliebe sonst unsichtbar.
*/
public static function forgetCached(string $key): void
{
Cache::forget("app-setting.{$key}");
}
}

View file

@ -356,15 +356,24 @@ class PressRelease extends Model
*/
public static function recordDeferredView(int $pressReleaseId): void
{
static::query()
->withoutGlobalScope(PortalScope::class)
->whereKey($pressReleaseId)
->increment('hits');
PressReleaseEvent::create([
'press_release_id' => $pressReleaseId,
'type' => PressReleaseEventType::View,
]);
// Bewusst NUR das Ereignis-Log (kleine Append-Tabelle). Der frühere
// `increment('hits')` traf die über 1 GB große press_releases-Tabelle
// und blockierte dort, sobald eine Schemaänderung lief — die
// wartenden Requests belegten PHP-FPM-Worker und DB-Verbindungen, bis
// die gesamte Seite stand. Die Summierung übernimmt jetzt gebündelt
// der Scheduler (AggregatePressReleaseViews).
//
// Der Aufruf-Zähler ist eine Nebensache: Er darf eine Seite niemals
// langsamer oder kaputt machen, deshalb wird jeder Fehler geschluckt
// und nur gemeldet.
try {
PressReleaseEvent::create([
'press_release_id' => $pressReleaseId,
'type' => PressReleaseEventType::View,
]);
} catch (\Throwable $e) {
report($e);
}
}
/**