Fehler, die sonst nur in Server-Logs stünden, werden sichtbar, ohne dass sich jemand am Server anmelden muss. Monitorio holt die Log-Einträge deines Shops über unser Plugin ab, meldet Fehler ab der Stufe, die du festlegst, und warnt, wenn Log-Dateien zu groß werden oder zu schnell wachsen.
Unser Plugin stellt die Log-Einträge deines Shops über reine Lese-Endpunkte in der Shopware Admin-API bereit. Monitorio holt sie im Standard alle fünf Minuten ab, zählt sie nach Schwere und misst, wie viel Platz die Log-Dateien belegen – insgesamt und je Datei.
Der Shop-Log-Alarm zählt Einträge ab dem Level, das du festlegst, und alles darüber: ERROR zählt auch CRITICAL, ALERT und EMERGENCY mit.
Optional grenzt du mit Schlagwörtern weiter ein, kommagetrennt. Es genügt, wenn eines davon in Meldung, Channel oder Dateipfad vorkommt.
Maßgeblich ist der Zeitpunkt im Shop-Log, nicht der Zeitpunkt des Abholens. Fällt die Anzahl im Zeitfenster unter deine Schwelle, löst sich der Alarm von selbst wieder auf.
Der Sammler hat selbst eine Mindeststufe: Einträge darunter kommen gar nicht erst an. Ein stiller Alarm bedeutet deshalb nicht zwingend einen stillen Shop.
Ab einer gewissen Größe kann der Log-Sammler die Einträge nicht mehr abholen, weil das Lesen länger dauert, als der Shop antwortet. Dann verstummt auch der Shop-Log-Alarm, ohne dass der Shop ruhiger geworden wäre.
Bei einem Shop landete beim Bild-Import die Bilddatei selbst im Log, und die Datei wuchs in Stunden ins Gigabyte. Solche Ausreißer gehen in der Gesamtgröße unter – deshalb prüfen eigene Alarme Größe und Wachstum einzelner Dateien.
Der Shop-Log-Alarm zählt die Einträge im Log, die übrigen Alarme achten auf die Größe der Log-Dateien – insgesamt, je Datei und im Zuwachs pro Zeitfenster. Wie viel normal ist, hängt am Shop: Schau vor dem Einschalten unter „Statistiken → Shop Log“, wie laut deiner ist.
Meldet, wenn im Zeitfenster mindestens die eingestellte Anzahl Log-Einträge ab dem gewählten Level aufläuft, und löst sich von selbst wieder auf, sobald es weniger werden. Schlagwörter grenzen auf Wunsch weiter ein.
Voreinstellung: ab Level ERROR, mindestens 1 Eintrag in 15 Minuten, ohne Schlagwörter
Meldet, wenn das Log-Verzeichnis des Shops größer wird als eingestellt – und warnt so, bevor der Log-Sammler die Einträge nicht mehr abholen kann. Aufräumen heißt: Log-Rotation einrichten oder alte Dateien löschen.
Voreinstellung: 500 MB
Meldet, wenn eine einzelne Log-Datei größer wird als eingestellt. Dahinter steckt fast immer ein Fehler, der außer Kontrolle geraten ist – oder, langsamer, eine Datei ohne Rotation, die über Monate anschwillt. Welche Datei betroffen ist, steht in der Meldung.
Voreinstellung: 250 MB je Datei
Meldet die Datei, die gerade davonläuft, bevor sie groß genug für den Log-Datei-Alarm ist. Er rechnet je Datei, Rotation im selben Zeitfenster kann den Zuwachs also nicht verdecken.
Voreinstellung: 50 MB Zuwachs je Datei in 1 Stunde
Vergleicht die Größe des Log-Verzeichnisses mit dem Anfang des Zeitfensters und meldet zu starken Zuwachs, etwa durch einen Fehler, der sich in einer Schleife wiederholt. Schrumpft das Verzeichnis durch Rotation, löst er nicht aus.
Voreinstellung: 100 MB Zuwachs in 1 Stunde
Wie laut ein Shop-Log ist, unterscheidet sich von Shop zu Shop um Größenordnungen. Lies deshalb eine Woche unter „Statistiken → Shop Log“ mit, Filter auf „Error+“: Wie viele Einträge kommen an einem normalen Tag zusammen, und wiederholt sich dieselbe Meldung?
WARNING ist in den meisten Shopware-Installationen bereits Grundrauschen, und alles ab CRITICAL ist so selten, dass ein Alarm darauf zu spät kommt. Für den Anfang ist ERROR deshalb die richtige Wahl.
Bei einem ruhigen Log mit einzelnen Einträgen pro Tag bleibt die Mindestanzahl bei 1 – jeder Fehler meldet sich, und das ist gewollt. Bei einem lauten Log legst du sie deutlich über die normale Menge im Zeitfenster, damit der Alarm den Ausbruch vom Normalzustand unterscheidet.
Ein grober Alarm auf ERROR ohne Schlagwörter mit hoher Schwelle findet den Ausbruch. Ein scharfer Alarm mit Schlagwort und Mindestanzahl 1 fängt das bekannte Problem, etwa den fehlgeschlagenen Zahlungsabgleich, der zweimal am Tag auftritt und in der Masse untergeht.
Gesucht wird als Teilstück, nicht als ganzes Wort: „payment“ findet auch „PaymentMethodException“. Platzhalter wie „*“ gibt es nicht und werden nicht benötigt.
Ein Fenster von fünf Minuten kann danebenliegen: Der Eintrag ist noch nicht da, wenn geprüft wird, und schon zu alt, wenn er ankommt. Wähle es mindestens dreimal so groß wie das Sammelintervall – die voreingestellten 15 Minuten erfüllen das.
Der Shop-Log-Alarm löst sich von selbst wieder auf, sobald die Einträge aus dem Zeitfenster gewandert sind. Er sagt „gerade läuft etwas schief“ und ist kein Ticket, das jemand schließen muss.
Kommen keine Einträge mehr an, weil das Plugin deaktiviert wurde, der Endpunkt nicht mehr antwortet oder die Zugangsdaten abgelaufen sind, bleibt der Alarm grün. Wann zuletzt etwas angekommen ist, zeigt „Statistiken → Shop Log“.
Die Log-Überwachung braucht unser Plugin emz/monitorio im Shop. Es stellt die Log-Einträge über reine Lese-Endpunkte (GET) in der Shopware Admin-API bereit; fehlt es oder ist es deaktiviert, kommen keine Daten an und die Alarme bleiben still.
Monitorio holt im Standard alle fünf Minuten neue Messwerte ab. Gespeichert werden je Log-Eintrag Zeitpunkt, Level, Channel, Meldung, Kontext, Datei und Zeile; aufbewahrt werden die Einträge 30 Tage. Verlauf und Einstellungen findest du im Projekt unter „Statistiken → Shop Log“.
emz/monitorio auf PackagistJa, unser Plugin emz/monitorio. Es stellt die Log-Einträge über reine Lese-Endpunkte in der Shopware Admin-API bereit. Fehlt es oder ist es deaktiviert, kommen keine Daten an, und die Alarme bleiben still.
Mit der Voreinstellung meldet sich der Shop-Log-Alarm, sobald in 15 Minuten mindestens ein Eintrag ab Level ERROR aufläuft. Einträge unterhalb der Mindeststufe des Sammlers kommen allerdings gar nicht erst an. Ist dein Log laut, setzt du die Mindestanzahl deutlich über die normale Menge.
Im Standard alle fünf Minuten. Gezählt wird nach dem Zeitpunkt im Shop-Log, nicht nach dem Abholen – das Zeitfenster sollte deshalb mindestens dreimal so groß sein wie das Sammelintervall. Die voreingestellten 15 Minuten erfüllen das.
Kommen keine Einträge mehr an, etwa weil das Plugin deaktiviert wurde, der Endpunkt nicht antwortet oder die Zugangsdaten abgelaufen sind, sieht das für den Alarm aus wie ein fehlerfreier Shop. Auch ein zu großes Log kann der Sammler irgendwann nicht mehr abholen. Unter „Statistiken → Shop Log“ siehst du, wann zuletzt etwas angekommen ist.
Voreingestellt, wenn das Log-Verzeichnis 500 MB oder eine einzelne Datei 250 MB überschreitet. Die Wachstums-Alarme melden, wenn das Verzeichnis in einer Stunde um mehr als 100 MB oder eine einzelne Datei um mehr als 50 MB wächst. Alle Werte stellst du je Alarm ein.
30 Tage. Gespeichert werden je Eintrag Zeitpunkt, Level, Channel, Meldung, Kontext, Datei und Zeile.
Nach 5 Minuten kommen die ersten Messwerte – und du schläfst wieder durch, während Monitorio die Shops im Auge behält.