
Im Admin sieht der Katalog alt aus: Preise stimmen auf der Produktdetailseite, die Kategorie zeigt noch den alten Stand, die Suche findet den neuen Artikel nicht. Der erste Reflex ist oft bin/magento indexer:reindex über alle Indexer. Adobe schreibt dazu klar: dieser Befehl reindexiert einmal. Damit der Shop aktuell bleibt, braucht es einen laufenden Cron – nicht einen zweiten Full-Reindex in der Mittagspause.
Dieser Beitrag ist eine Betriebsliste für Magento-2-Indexer, kein Benchmark. In der Magento-2- und Server-Betreuung trennen wir Indexer-Stau von Session-Locks und MSI-Reservierungen. Checkout-Wartezeiten durch Redis haben wir unter Redis-Sessions: Locking bremst den Checkout beschrieben; hier geht es um Katalog, Preis, Suche und Customer Grid.
Zwei Modi – und was 2.4.8 geändert hat
Adobe dokumentiert zwei Update-Modi (CLI: bin/magento indexer:set-mode):
- Update on Save (
realtime): der Indexer schreibt mit, sobald jemand im Admin speichert – zum Beispiel Kategorieprodukte nach einer Zuweisung. - Update by Schedule (
schedule): der Indexer arbeitet die Changelog-Warteschlange über Cron ab. Inindexer:statussteht dann «Update On: Schedule» plus Backlog.
Seit Magento Open Source / Adobe Commerce 2.4.8 gilt für neue Indexer der Default «Update by Schedule». Vorher war der Default «Update on Save». Bestehende Indexer bleiben unverändert; nur neu hinzukommende (inkl. vieler Drittanbieter-Indexer) starten auf Schedule. Das steht in den 2.4.8-Release Notes (GitHub-36419) und in der Adobe-Seite Manage the indexers (Stand 19. August 2026).
Der Customer Grid-Indexer hat sich in 2.4.8 extra bewegt:
- Vor 2.4.8: nur Update on Save, kein Schedule.
- Ab 2.4.8: beide Modi, Default ist Schedule.
Wer nach einem Upgrade den Customer Grid noch als «nur Save» im Runbook führt, arbeitet mit einer veralteten Annahme.
Klickpfad und CLI – zuerst Status, nicht Reindex
Admin: System → Tools → Index Management. Dort stehen Status, Modus und ob ein Reindex nötig ist. Parallel auf der CLI, immer als Dateisystem-Owner:
bin/magento indexer:info– Liste der Indexer-IDs.bin/magento indexer:status– Status, Update On, Schedule Status, Backlog, letzte Schedule-Aktualisierung.bin/magento indexer:show-mode– nur die Modi, ohne Status-Tabelle.
Was ihr sucht: ein Indexer auf Schedule mit wachsendem Backlog, Status «Reindex required», oder Schedule Status «working», obwohl kein PHP-Prozess mehr läuft. Das letzte ist oft ein abgebrochener Lauf (OOM, Deploy, manuell gekillter Cron) – kein Beweis, dass «reindex all» die Ursache behebt.
Use Case
Ein Schweizer Magento-2.4.8-Shop legt nach dem Upgrade neue Katalogregeln an. Der Preisindex bleibt «Ready», die Suche hängt auf «working». Im Admin wirkt die Suche tot. Jemand startet indexer:reindex ohne Argument – Full-Reindex über den ganzen Katalog, mitten im Tagesgeschäft. Adobe warnt ausdrücklich: ein kompletter Reindex kann bei vielen Produkten, Kunden, Kategorien und Regeln lange dauern. Der Cron indexer_update_all_views läuft parallel weiter oder überlappt. Ergebnis: zwei Jobs auf demselben Indexer, Tabelle bleibt «working», Storefront unverändert.
Richtiger erster Schritt: indexer:status catalogsearch_fulltext, dann cron:run bzw. die Tabelle cron_schedule auf hängende indexer_*-Jobs. Erst wenn kein Prozess mehr lebt, gezielt bin/magento indexer:reset catalogsearch_fulltext (invalidiert den Status) oder ab 2.4.7 bin/magento indexer:set-status invalid catalogsearch_fulltext – und danach diesen Indexer, nicht alle.
Modus wechseln: Wartung, nicht «schnell im Admin»
Adobe verlangt vor einem Moduswechsel: Shop in den Maintenance-Modus, Cron deaktivieren. Sonst lockt ihr die Datenbank gegen laufende Schedule-Walker. Befehl:
bin/magento indexer:set-mode {realtime|schedule} [indexer]
Beispiel: Kategorieprodukte und Produktkategorien auf Schedule
bin/magento indexer:set-mode schedule catalog_category_product catalog_product_category
Beim Wechsel auf Schedule legt Magento die DB-Trigger an, beim Wechsel auf realtime entfernt es sie. Fehlen die Trigger trotz Schedule-Modus: zuerst auf realtime, dann zurück auf schedule. Das setzt die Trigger neu. In 2.4.8 werden Changelog-Tabellen beim Unsubscribe (Schedule → Save) entfernt; der Indexer gilt danach als invalid, damit keine Änderung verloren geht.
Status setzen statt Hoffen (ab 2.4.7)
Seit Adobe Commerce / Magento 2.4.7 gibt es bin/magento indexer:set-status {invalid|suspended|valid} [indexer]:
invalid– veraltet, nächster Cron soll reindexen (sofern nicht suspended).suspended– stoppt automatische Cron- und Materialized-View-Updates, auch für Indexer mit gleichemshared_index. Nützlich bei Import oder Wartung.valid– gilt als aktuell. Adobe warnt: von suspended/invalid auf valid ohne vollständigen Index verschlechtert die Performance, wenn unindexierte Daten liegen bleiben.
indexer:reindex reindexiert auch als suspended markierte Indexer. Deshalb eignet sich Reindex für den gezielten Handlauf, nicht als Ersatz für den Cron im Normalbetrieb.
Checkliste
- Admin → System → Tools → Index Management und
indexer:statusstimmen überein (Modus, Backlog, nicht nur die Ampel). - Cron existiert und schreibt in
cron_schedule. Ohne Cron ist Schedule-Modus nur eine stille Warteschlange. - Kein Full-Reindex, solange ein einzelner Indexer den Stau erklärt.
- Nach 2.4.8-Upgrade: neue Indexer und Customer Grid auf Schedule erwartet; Runbook aktualisieren.
- Moduswechsel nur in Maintenance, Cron aus, Trigger danach prüfen.
set-status validnie «damit die Ampel grün wird», sondern erst nach nachgewiesenem Index.
Vorher / Nachher
Vorher: Kategorie und Suche divergieren. Im Chat steht «reindex all». Cron ist ungeprüft. Customer Grid hängt nach dem 2.4.8-Upgrade im alten «nur Save»-Bild. Niemand hat Backlog oder einen toten «working»-Status notiert.
Nachher: Ein Indexer, ein Backlog, ein Cron-Nachweis. Gezielter Reset oder set-status invalid, danach ein einzelner Reindex oder der nächste Cron. Storefront gegen genau diese Fläche geprüft (Kategorie, Suche, Preis, Kundenliste). Modus und Trigger stehen im Runbook.
Kennzahl für den Betrieb: geschlossen ist nicht «alle Indexer grün nach Full-Reindex», sondern: dokumentierter Status vor/nach, Cron schreibt, Backlog geht gegen null, Storefront zeigt denselben Stand wie der Admin.
Fünf Schritte, bevor jemand reindex all tippt
- Welche Fläche ist falsch – Preis, Kategorie, Suche, Kundenliste? Das ist der Indexer, nicht «der Katalog».
- Steht der Indexer auf Schedule mit Backlog – oder auf Save und der Admin-Save ist gar nicht durchgelaufen?
- Läuft noch ein PHP-Prozess zu diesem Indexer, oder ist nur der Status «working» übrig?
- Ist der Cron der letzten Stunden in
cron_schedulesichtbar – oder ist Schedule seit dem Deploy tot? - Erst den einen Indexer invalidieren und nachziehen. Full-Reindex bleibt die Ausnahme für Wartungsfenster, nicht der Default um 10:30.
Indexer sind Warteschlange plus Cron, nicht ein magischer Knopf. Wer Magento 2 nach einem Upgrade oder einem hängenden Katalog betreibt, prüft Status und Cron, bevor er den ganzen Index neu schreibt. Wenn Status, Cron und Storefront nicht dieselbe Geschichte erzählen, gehen wir die drei Stellen mit euch durch. Kontaktiert uns für eine saubere Indexer- und Cron-Prüfung.





