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 öffnen Sie Administration → Persönlich → Sicherheit. Unter „Authentifizierungstoken“ klicken Sie auf „Neuen Token generieren“. Setzen Sie dabei den Haken bei „Nur zur sicheren Verwendung“: Das Token gilt dann nur per POST, nicht als Parameter in der Adresse. Matomo zeigt das Token nur ein einziges Mal an. Speichern Sie es sofort.

2. Archivierung im Browser abschalten

   Unter Administration → System → Allgemeine Einstellungen stellen Sie „Berichte archivieren, wenn diese im Browser angezeigt werden“ auf Nein. Das Feld „Archiviere Berichte mindestens alle X Sekunden“ setzen Sie 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. Fünf Cronjobs bleiben dauerhaft gratis, die ersten 14 Tage laufen im Unlimited-Tarif.

   Kostenlos starten 14 Tage Unlimited inklusive, keine Zahlungsdaten

4. Cronjob anlegen: Methode POST, Token in den Body

   Wählen Sie als Methode POST und tragen Sie als Adresse https://ihre-domain.de/matomo/misc/cron/archive.php ein. Als Content-Type nehmen Sie application/x-www-form-urlencoded, in den Anfrage-Body schreiben Sie token_auth= und Ihr Token. Matomo empfiehlt POST aus Sicherheitsgründen. Tragen Sie die endgültige https-Adresse ein: Bei einer Weiterleitung wird aus POST wieder GET, und der Body geht verloren. Als Zeitplan genügt eine feste Minute jeder Stunde.

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

5. Fehler-Benachrichtigung einschalten

   Hinterlegen Sie unter Benachrichtigungen eine E-Mail-Adresse. Fällt die Archivierung aus, veralten Ihre Berichte still. Ohne Benachrichtigung merkt man das oft erst Wochen später. Die Fehlerbenachrichtigung per E-Mail gibt es ab dem Tarif Plus, in den ersten 14 Tagen ist sie kostenlos dabei.

Was die fünf Felder eines Ausdrucks wie */5 * * * * bedeuten, steht in der Crontab-Referenz – mit Beispielen und den häufigsten Stolpersteinen. Bauen können Sie den Ausdruck im Crontab-Generator. Ob Sie dafür überhaupt einen Dienst von außen brauchen, zeigt der Vergleich der drei Wege.

Kontrolle

Läuft es wirklich?

In Matomo öffnen Sie Administration → Diagnose → Systemprüfung. Unter „Letzter erfolgreicher Abschluss der Archivierung“ steht, wann die Archivierung zuletzt fertig wurde. Steht dort ein alter Zeitpunkt, kommt der Aufruf nicht an. Ab Plus zeigt das Aufrufprotokoll von Cronjob.de auch die Antwort: Die Ausgabe des Archivierers endet mit „Done archiving!“ und einer Zusammenfassung.

FAQ

Häufige Fragen zu Matomo

Wie oft sollte der Matomo-Cronjob laufen?

Mindestens einmal pro Stunde, so steht es in der Matomo-Anleitung zur automatischen Archivierung. Häufiger bringt nur dann etwas, wenn Sie auch den Wert „mindestens alle X Sekunden“ senken. Sonst rechnet Matomo die Berichte trotzdem nur einmal je Stunde neu, und die zusätzlichen Aufrufe erzeugen nur Last.

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

Unser Aufruf endet nach 45 Sekunden (kostenlos) beziehungsweise 60 Sekunden (Plus und Unlimited). Ob Matomo danach auf Ihrem Server weiterläuft, hängt von PHP ab: Mit ignore_user_abort = On in der php.ini arbeitet das Skript weiter, bis das Zeitlimit Ihres Servers greift. Für große Installationen empfiehlt Matomo die Kommandozeile.

Warum soll das Matomo-Token per POST statt in der Adresse stehen?

Matomo empfiehlt POST aus Sicherheitsgründen. Eine Adresse taucht in Zugriffsprotokollen und Fehlermeldungen auf, ein Body nicht. Haben Sie das Token als „Nur zur sicheren Verwendung“ angelegt, akzeptiert Matomo es ohnehin nur noch per POST.

Ich bekomme „token_auth is invalid“ oder Fehler 401.

Dann gehört das Token keinem Superuser, es wurde gelöscht oder es ist abgelaufen. Matomo kann Tokens mit Ablaufdatum anlegen; nach diesem Datum lehnt Matomo sie ab und schickt vorher eine Erinnerung per E-Mail. Legen Sie unter Administration → Persönlich → Sicherheit ein neues Token an. Achten Sie darauf, dass beim Kopieren kein Leerzeichen mitgeht.

Brauche ich zusätzlich einen Aufruf für die geplanten Aufgaben?

Normalerweise nicht. archive.php führt nach der Archivierung auch die geplanten Aufgaben aus, etwa den Versand geplanter E-Mail-Berichte. Die API-Methode CoreAdminHome.runScheduledTasks stößt nur die geplanten Aufgaben an, ohne Archivierung.

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

Nein, archive.php arbeitet alle Webseiten Ihrer Installation nacheinander ab. Der Lauf kann dadurch länger dauern als das Zeitfenster eines Aufrufs. Siehe dazu die Frage zur Laufzeit.