Matomo-Berichte laden ewig: Archivierung per Cron einrichten
Kurz gesagt: Wenn Ihr selbst betriebenes Matomo beim Öffnen von Berichten minutenlang lädt, mit Zeitüberschreitungen abbricht oder morgens das Dashboard nicht zeigt, wird die Auswertung vermutlich noch im Browser angestossen. Matomo verarbeitet die gesammelten Rohdaten erst zu Berichten, wenn jemand sie aufruft, ausser Sie richten eine automatische Archivierung ein. Laut Matomo-Hilfe kann das bei Websites mit mehr als einigen hundert Besuchen pro Tag einige Minuten dauern, und der beste Weg dagegen ist ein Cronjob, der den Befehl core:archive regelmässig ausführt. Danach stellen Sie in den Einstellungen ein, dass Berichte nicht mehr beim Ansehen im Browser erstellt werden.
Warum Matomo langsam wirkt
Matomo speichert jeden Besuch zunächst als Rohdaten. Für die Berichte, die Sie im Dashboard sehen, also Besuche pro Tag, Seiten, Herkunft oder Ziele, müssen diese Rohdaten zusammengefasst werden. Diesen Schritt nennt Matomo Archivierung.
Laut Matomo-Hilfe hat bis zur Einrichtung eines Cronjobs die Oberfläche selbst die Archivierung gelegentlich angestossen: Wer einen Bericht anklickte, löste die Verarbeitung aus und musste warten. Bei wenig Besuch fällt das kaum auf. Bei einem Shop, einer Gemeinde-Website mit vielen Seiten oder einer Hotelgruppe mit mehreren Websites wird daraus schnell eine Geduldsprobe.
Typische Anzeichen:
- Das Dashboard lädt am Morgen lange, danach ist es schneller.
- Berichte für längere Zeiträume, etwa ein Jahr, brechen ab.
- Der Server zeigt beim Öffnen von Matomo hohe Last.
- Kolleginnen öffnen Matomo nicht mehr, weil es „sowieso hängt“.
Die Lösung in zwei Schritten
Schritt 1: Cronjob für die Archivierung
Die Matomo-Hilfe beschreibt für Linux-Server einen Eintrag in einer Cron-Datei, etwa unter /etc/cron.d/matomo-archive. Das Beispiel aus der Hilfe führt jede Stunde in Minute 5 den Befehl aus:
MAILTO="ihre-adresse@example.ch"
5 * * * * www-data /usr/bin/php /pfad/zu/matomo/console core:archive --url=https://statistik.example.ch/ > /var/log/matomo-archive.log
Dafür braucht es laut Hilfe PHP auf der Kommandozeile und SSH-Zugang zum Server. Die Pfade und der Benutzer, unter dem der Webserver läuft, hängen von Ihrem Server ab. Das richtet in der Regel die Person ein, die Ihren Server oder Ihr Hosting betreut.
Die Hilfe empfiehlt ausserdem, den Befehl zuerst von Hand zu testen und die Ausgabe zu prüfen. Damit sehen Sie sofort, ob die Archivierung durchläuft oder an fehlendem Speicher oder falschen Pfaden scheitert.
Schritt 2: Archivierung im Browser abschalten
Erst wenn der Cronjob zuverlässig läuft, stellen Sie Matomo so ein, dass die Oberfläche nur noch fertige Berichte liest. Laut Hilfe melden Sie sich dazu als Superuser an und öffnen unter Administration, System, Allgemeine Einstellungen die Archivierungsoptionen. Dort wählen Sie:
- „Berichte beim Ansehen im Browser archivieren“: Nein.
- „Berichte höchstens alle X Sekunden archivieren“: 3600 Sekunden, also einmal pro Stunde.
Ab jetzt öffnet das Dashboard die vorbereiteten Berichte, statt sie neu zu berechnen.
Wenn Ihr Hosting keinen Cron erlaubt
Nicht jedes einfache Webhosting bietet Cronjobs oder SSH. Die Matomo-Hilfe beschreibt für diesen Fall einen sogenannten Web-Cron: Eine bestimmte Adresse Ihrer Matomo-Installation wird regelmässig aufgerufen und startet die Archivierung. Laut Hilfe sollte dieser Aufruf mindestens einmal pro Stunde erfolgen, zum Beispiel über einen Überwachungsdienst, der eine Seite regelmässig abfragt. Auch Verwaltungsoberflächen wie Plesk oder cPanel werden in der Hilfe mit eigenen Anleitungen genannt.
Prüfen Sie bei einem Web-Cron besonders, dass die Adresse geschützt ist und nicht von Dritten beliebig oft aufgerufen werden kann. Die genaue Absicherung beschreibt die Matomo-Dokumentation zum jeweiligen Weg.
Weitere Punkte bei viel Verkehr
Die Hilfe nennt für Websites mit mittlerem bis hohem Verkehr weitere Massnahmen, etwa ein höheres PHP-Speicherlimit für die Archivierung. Wenn der Cronjob regelmässig mit einem Speicherfehler abbricht, ist das der erste Ansatzpunkt. Bei sehr vielen Websites in einer Installation kann es sinnvoll sein, mehrere Archivierungsprozesse parallel laufen zu lassen. Auch das beschreibt die Hilfe in einem eigenen Abschnitt.
So prüfen Sie, ob alles läuft
- Schauen Sie in die Logdatei, die der Cronjob schreibt. Dort sollte jede Stunde ein Durchlauf mit Abschlussmeldung stehen.
- Öffnen Sie das Dashboard am Morgen. Es sollte ohne lange Wartezeit erscheinen.
- Rufen Sie einen Jahresbericht auf. Wenn er schnell lädt, sind auch längere Zeiträume archiviert.
- Tragen Sie bei MAILTO eine Adresse ein, die gelesen wird. So bekommen Sie Fehlermeldungen per E-Mail statt sie erst Wochen später zu bemerken.
Ein Punkt wird oft übersehen: Nach einem Server-Umzug oder einem Wechsel der PHP-Version stimmt der Pfad im Cronjob manchmal nicht mehr. Die Berichte werden dann still nicht mehr aktualisiert, und im Dashboard fehlen plötzlich die letzten Tage. Nehmen Sie den Cronjob deshalb in Ihre Checkliste für Umzüge und Updates auf.
Was sich für Ihr Team ändert
Mit stündlicher Archivierung sind die Zahlen im Dashboard bis zu einer Stunde alt. Für die meisten Entscheidungen in kleinen und mittleren Betrieben spielt das keine Rolle. Für den Echtzeit-Blick gibt es in Matomo eigene Ansichten mit den letzten Besuchen. Erklären Sie dem Team kurz, warum die Tageszahl am Vormittag noch nicht ganz vollständig ist, dann gibt es keine Verwirrung. Hilfreich ist ausserdem eine kurze Notiz im internen Wiki: wann die Archivierung läuft, wo die Logdatei liegt und wer bei Fehlermeldungen zuständig ist. Wer neu im Team ist, findet so in einer Minute heraus, warum eine Zahl noch fehlt, und muss nicht raten oder die Informatik anrufen.
Ein Beispiel
Ein Hotel in Luzern nutzt Matomo auf dem eigenen Server, um Buchungsanfragen und Herkunft der Besucher auszuwerten (Beispiel zur Veranschaulichung). Das Marketing klagt, dass Monatsberichte oft nicht laden. Der Hoster richtet den Cronjob nach der Matomo-Anleitung ein, testet ihn von Hand und stellt danach die Browser-Archivierung ab. Seit der Umstellung öffnen sich die Berichte ohne Wartezeit, und Fehlermeldungen der Archivierung kommen per E-Mail an die Informatik.
Häufige Fragen
Verliere ich Daten, wenn ich die Browser-Archivierung abschalte?
Nein. Die Rohdaten werden weiter gesammelt. Sie werden nur zu einem anderen Zeitpunkt zu Berichten verarbeitet, nämlich durch den Cronjob.
Wie oft sollte der Cronjob laufen?
Die Matomo-Hilfe zeigt ein stündliches Beispiel. Für die meisten Websites ist das ein guter Ausgangspunkt.
Betrifft das auch Matomo in der Cloud?
Diese Anleitung gilt für selbst betriebene Installationen. Bei gehosteten Angeboten kümmert sich in der Regel der Anbieter um die Archivierung.
Was, wenn die Archivierung mit einem Fehler abbricht?
Prüfen Sie die Ausgabe des Befehls und das PHP-Speicherlimit. Die Matomo-Hilfe hat dazu einen eigenen Abschnitt zur Ausgabe von core:archive.
Wenn Ihr Matomo schneller und verlässlicher Zahlen liefern soll, unterstützen wir Sie gerne.