Matomo Cronjob einrichten: Berichte automatisch archivieren

Einrichtung

Schritt für Schritt

1. Token für die Anmeldung erzeugen

   Melden Sie sich als Superuser an und gehen Sie auf Administration → Persönlich → Sicherheit. Legen Sie unten unter „Auth-Tokens“ ein neues Token an und schreiben Sie sich die 32 Zeichen auf – Matomo zeigt sie nur einmal.

2. Archivierung im Browser abschalten

   Unter Administration → System → Allgemeine Einstellungen stellen Sie „Berichte archivieren, wenn sie im Browser aufgerufen werden“ auf Nein und „Berichte höchstens alle X Sekunden archivieren“ auf 3600. Ohne diesen Schritt rechnet Matomo weiterhin bei jedem Aufruf mit.

3. Konto bei Cronjob.de anlegen

   Die Registrierung dauert eine Minute und ist kostenlos. Drei Cronjobs bleiben dauerhaft gratis, die ersten 14 Tage laufen im Unlimited-Tarif.

4. Cronjob anlegen – das Token gehört in den Body

   Tragen Sie als Adresse https://ihre-domain.de/matomo/misc/cron/archive.php ein, wählen Sie als Methode POST und schreiben Sie das Token in den Anfrage-Body. Matomo empfiehlt das ausdrücklich, damit das Token nicht in Server-Protokollen und Verlaufslisten landet. Als Zeitplan genügt eine feste Minute jeder Stunde.

   token_auth=IHR32ZEICHENTOKEN
   
   # Zeitplan, stündlich um :17
   17 * * * *

5. Fehler-Benachrichtigung einschalten

   Hinterlegen Sie in den Einstellungen des Ordners eine E-Mail-Adresse. Wenn die Archivierung ausfällt, veralten Ihre Berichte still – ohne Benachrichtigung merkt man das erst Wochen später.

Kontrolle

Läuft es wirklich?

Im Aufrufprotokoll von Cronjob.de steht nach dem ersten Lauf die Ausgabe des Archivierers, die mit einer Zusammenfassung endet („Done archiving!“). In Matomo selbst finden Sie unter Administration → System → Allgemeine Einstellungen den Zeitpunkt der letzten erfolgreichen Archivierung. Steht dort ein alter Zeitpunkt, kommt der Aufruf nicht an.

FAQ

Häufige Fragen zu Matomo

Die Archivierung dauert länger als eine Minute. Wird sie abgebrochen?

Der Aufruf von außen endet nach 45 Sekunden (kostenlos) beziehungsweise 60 Sekunden (Plus und Unlimited). Matomo läuft auf Ihrem Server aber weiter, wenn PHP die Verbindung nicht überwacht – setzen Sie dafür in der php.ini ignore_user_abort = On. Bei sehr großen Installationen empfiehlt Matomo ohnehin den Aufruf per Kommandozeile; die Archivierung kann dort Stunden dauern.

Warum stündlich und nicht alle fünf Minuten?

Weil Matomo die Berichte ohnehin nur einmal je Stunde neu rechnet, wenn Sie „höchstens alle 3600 Sekunden“ eingestellt haben. Häufigere Aufrufe erzeugen nur Last, ohne dass die Zahlen aktueller werden. Wer Berichte näher an Echtzeit braucht, senkt beide Werte gemeinsam.

Muss das Token wirklich in den Body?

Nötig ist es nicht, Matomo akzeptiert es auch als Parameter in der Adresse. Es ist aber die Empfehlung von Matomo selbst: eine Adresse steht in Zugriffsprotokollen, in Fehlermeldungen und in der Liste Ihrer Cronjobs. Ein Token im Body steht dort nicht.

Ich bekomme Fehler 401 oder „token_auth is invalid“.

Dann gehört das Token keinem Superuser oder es wurde inzwischen gelöscht. Legen Sie unter Administration → Persönlich → Sicherheit ein neues an. Achten Sie darauf, dass beim Kopieren kein Leerzeichen mitgeht.

Kann ich auch die API-Adresse statt archive.php aufrufen?

Ja, ?module=API&method=CoreAdminHome.runScheduledTasks stößt die geplanten Aufgaben an – etwa den Versand der E-Mail-Berichte. Das ist aber nicht dasselbe wie die Archivierung. Für Berichte, die schnell laden sollen, ist archive.php der richtige Weg.

Ich betreibe Matomo für mehrere Seiten. Ändert das etwas?

Nein, archive.php arbeitet alle Seiten Ihrer Installation nacheinander ab. Es kann nur sein, dass der Lauf dadurch länger dauert als das Zeitfenster eines Aufrufs – siehe die erste Frage.