Matomo-Archivierung: Wenn Berichte fehlen, hängen oder sich ändern

· 9 Min. Lesezeit ·

Themen: Betrieb & Performance

Leere Berichte, Zahlen von vorgestern, ein Monatswert, der sich über Nacht ändert, oder ein Cronjob, der nie fertig wird: Hinter diesen Symptomen steckt in Matomo fast immer dieselbe Stelle, die Archivierung. Wer versteht, wie sie arbeitet, findet die Ursache meist schnell.

Dieser Artikel erklärt das Prinzip, die empfohlene Einrichtung, die typischen Fehler mit ihrer Lösung und die Werkzeuge zur Diagnose. Stand: Oktober 2026, Matomo 5; die genannten Befehle und Einstellungen gibt es auch in Matomo 6.

Ablauf der Archivierung: 1. Tracking schreibt Rohdaten in die Log-Tabellen. 2. core:archive rechnet stündlich die Tagesberichte. 3. Woche, Monat und Jahr entstehen aus den Tagesberichten. 4. Berichte und API lesen aus den Archivtabellen. Nachträgliche Daten markieren Zeiträume als veraltet, der nächste Lauf rechnet sie neu. Eigene Zeiträume entstehen erst beim Abruf.
Vom Rohdatum zum Bericht: Matomo liest Berichte aus vorab gerechneten Archiven.

So arbeitet die Archivierung#

Matomo speichert jede erfasste Aktion zunächst als Rohdatum in den Log-Tabellen. Berichte rechnet Matomo nicht bei jedem Aufruf neu aus, sondern liest sie aus Archiven: vorab verdichteten Kennzahlen und Tabellen, getrennt nach Website, Zeitraum und Segment. Tagesberichte entstehen aus den Rohdaten, Wochen, Monate und Jahre setzt Matomo aus den Tagesberichten zusammen. Gespeichert wird das in Monatstabellen wie matomo_archive_numeric_2026_10 und matomo_archive_blob_2026_10.

Wann gerechnet wird, entscheidet einer von zwei Auslösern:

  • Browser-Archivierung: Ruft jemand einen Bericht auf und gibt es kein aktuelles Archiv, rechnet Matomo es sofort. Das ist bequem, bei viel Traffic aber langsam.
  • Cron-Archivierung: Der Befehl core:archive läuft regelmäßig im Hintergrund und arbeitet eine Warteschlange ab. Matomo empfiehlt das, sobald eine Website mehr als einige hundert Besuche am Tag hat.

Die Warteschlange füllt Matomo selbst. Der heutige Tag wird neu gerechnet, wenn es Besuche gibt und das Archiv älter als die eingestellte Frist ist. „Gestern“ wird nach dem Datumswechsel noch einmal vollständig verarbeitet. Dazu kommen alle Zeiträume, die als veraltet markiert wurden.

Die empfohlene Einrichtung#

Matomo empfiehlt einen stündlichen Cronjob, ausgeführt als Benutzer des Webservers, damit keine Probleme mit Dateirechten entstehen:

# /etc/cron.d/matomo-archive
MAILTO="admin@example.org"
5 * * * * www-data /usr/bin/php /var/www/matomo/console core:archive --matomo-domain=https://analytics.example.org > /var/log/matomo-archive.log

Die Ausgabe landet in einer Logdatei außerhalb des Webverzeichnisses, weil sie interne Details enthält. Fehlermeldungen gehen per Mail an MAILTO. Die Option --url aus älteren Anleitungen ist seit Matomo 5 veraltet und durch --matomo-domain ersetzt; das alte Skript misc/cron/archive.sh entfällt mit Matomo 6 (siehe unsere Checkliste für das Upgrade auf Matomo 6). Testen Sie den Befehl vorab als Webserver-Benutzer, etwa mit su www-data -s /bin/bash -c "…". Am Ende sollte eine Zusammenfassung ohne Fehler stehen.

Danach schalten Sie die Browser-Archivierung ab: Unter Administration > System > Allgemeine Einstellungen stellen Sie „Berichte archivieren, wenn diese im Browser angezeigt werden“ auf Nein und die Frist für die heutigen Berichte auf 3600 Sekunden. Das allein reicht nicht, denn benutzerdefinierte Segmente lösen sonst weiterhin Archivierung aus. Zuverlässig wird es erst mit dieser Zeile in der config/config.ini.php:

[General]
browser_archiving_disabled_enforce = 1

Dauert ein Lauf länger als eine Stunde, empfiehlt Matomo, ihn seltener zu starten, etwa alle 2, 6 oder 12 Stunden.

Invalidierung: warum sich Zahlen nachträglich ändern#

Invalidieren heißt: Matomo markiert ein Archiv als veraltet, der nächste Lauf rechnet es aus den Rohdaten neu. Bis dahin zeigt Matomo weiter die alten Zahlen. Automatisch passiert das unter anderem, wenn:

  • Daten für vergangene Tage eintreffen, etwa beim Import von Webserver-Logs oder über die Tracking-API mit dem Parameter cdt,
  • Besuche gelöscht werden, über die DSGVO-Werkzeuge von Matomo oder mit unserem kostenlosen Plugin Delete Visits Filter für Bot-Traffic und Testdaten,
  • Segmente angelegt oder geändert werden; auch manche Plugins mit eigenen Berichten rechnen so die Vergangenheit nach.

Wird ein Tag invalidiert, gelten Woche, Monat und Jahr darüber automatisch mit als veraltet. Von Hand geht es so:

./console core:invalidate-report-data --dates=2026-09-01,2026-09-30 --sites=1

Mit --periods, --segment und --cascade (auch die Tage unterhalb einer Woche oder eines Monats) grenzen Sie das ein, --dry-run zeigt vorher, was passieren würde. Neu gerechnet wird beim nächsten core:archive.

Voraussetzung sind die Rohdaten. Haben Sie unter Datenschutz das regelmäßige Löschen alter Rohdaten aktiviert, lassen sich Berichte für gelöschte Zeiträume nicht neu erzeugen. core:invalidate-report-data überspringt solche Tage deshalb von sich aus. Die Option --ignore-log-deletion-limit hebelt diesen Schutz aus; sie ist für Sonderfälle gedacht, etwa für aus Google Analytics importierte Daten ohne Rohdaten.

Segmente: Echtzeit oder vorab verarbeitet#

Beim Speichern eines Segments legen Sie fest, ob seine Berichte in Echtzeit (beim Abruf) oder vorab im Cron verarbeitet werden. Echtzeit passt zu wenig Traffic oder selten genutzten Segmenten, setzt aber voraus, dass der Browser archivieren darf.

Mit der empfohlenen Einstellung oben verarbeitet der Cron alle gespeicherten Segmente, neue Segmente werden automatisch vorab verarbeitet. Nicht gespeicherte Ad-hoc-Segmente, etwa per segment= in API-Abfragen, rechnet Matomo dann nicht mehr. Statt Daten erscheint der Hinweis, das Segment werde aus Performancegründen nicht angewendet. Speichern Sie solche Segmente und fragen Sie sie per idSegment ab.

Zwei Folgen für den Betrieb:

  • Jedes Segment kostet Rechenzeit, für jede Website und jeden Zeitraum. Viele Segmente sind eine häufige Ursache für lange Läufe. --skip-segments-today verarbeitet Segmente nur für gestern, nicht für heute.
  • Neue Segmente rechnen die Vergangenheit nach, mit dem Standardwert "beginning_of_time" von process_new_segments_from bis zu sieben Jahre zurück. Auf großen Instanzen begrenzen Sie das, etwa mit "last30" (30 Tage vor dem Anlegen).

Typische Ursachen und ihre Lösung#

Der Cron läuft nicht (mehr)#

Leere Berichte bei abgeschalteter Browser-Archivierung bedeuten meist: core:archive läuft nicht. Typisch sind ein falscher PHP-Pfad, der falsche Benutzer oder ein Server-Umzug ohne Cronjob. Nach einer längeren Pause berücksichtigt Matomo laut eigener Entwicklerdokumentation nicht, dass zwischen dem letzten Lauf und gestern noch Besuche dazugekommen sein können. Invalidieren Sie diesen Zeitraum deshalb gezielt.

Zu wenig Speicher#

Bricht der Lauf mit „Allowed memory size of … bytes exhausted“ ab, fehlt PHP Speicher. Entscheidend ist die PHP-Konfiguration der Kommandozeile, die oft eine andere php.ini nutzt als der Webserver (php -i | grep "Configuration File"). Matomo nennt mindestens 2 GB, viele Installationen nutzen 4 bis 8 GB. Zum Testen: php -d memory_limit=8G console core:archive. Von sich aus hebt Matomo das Limit beim Archivieren nur auf 768 MB an.

Überlappende Läufe und hängende Einträge#

Startet der Cron stündlich, braucht ein Lauf aber zwei Stunden, laufen mehrere Archivierer gleichzeitig. Matomo begrenzt das pro Server mit --concurrent-archivers (Standard: 3); darüber bricht ein neuer Lauf mit „Archiving will stop now because … archivers are already running“ ab. Wer bewusst parallel archiviert, startet die Läufe laut Matomo um einige Sekunden oder Minuten versetzt. Vorsicht mit --force-idsites: Damit können zwei Läufe dieselbe Website gleichzeitig verarbeiten.

Wird ein Lauf hart abgebrochen (Speicherfehler, Neustart, Deployment), bleiben Einträge als „in Bearbeitung“ stehen. Matomo wertet sie erst nach 24 Stunden als gescheitert (archive_failure_recovery_timeout). Seit Matomo 5.3 setzen Sie sie gezielt zurück, aber nur, wenn wirklich kein Lauf mehr aktiv ist:

./console core:reset-invalidations --idsite=1 --older-than="1 hour ago" --dry-run

MySQL-Fehler und max_allowed_packet#

„MySQL server has gone away“ hat laut Matomo zwei Hauptursachen: Die Datenbank hat die Verbindung wegen Zeitüberschreitung geschlossen (wait_timeout prüfen, Matomo nennt 28800 als Beispiel), oder ein Paket war zu groß. Dann erhöhen Sie max_allowed_packet in der my.cnf, laut Matomo zunächst auf 128M, bei viel Traffic bis 1024M. Die Systemprüfung warnt bereits unter 64 MB.

Riesige Archivtabellen#

Dass die Datenbank wächst, ist normal: Matomo behält Archive für jeden Tag, jede Woche, jeden Monat und jedes Jahr. Veraltete und invalidierte Archive räumen geplante Tasks auf. Laufen diese nicht, etwa wegen --disable-scheduled-tasks ohne eigenen scheduled-tasks:run, wachsen die Tabellen. Was in einer Tabelle steckt, zeigt ./console diagnostics:analyze-archive-table 2026_09. Aufräumen und Platz freigeben:

./console core:purge-old-archive-data all
./console database:optimize-archive-tables all

Matomo empfiehlt, beide Befehle monatlich per Cron laufen zu lassen. Mehr zu Datenbank und Server steht in unserem Artikel zur Matomo-Performance.

Zeitzone und Tagesgrenzen#

Matomo speichert Zeiten in UTC, rechnet Tage aber in der Zeitzone der Website. Ein Tag ist erst vollständig, wenn er dort vorbei ist und danach ein Lauf stattgefunden hat. Wer nur einmal täglich archiviert, legt den Lauf deshalb kurz nach Mitternacht der Website-Zeitzone, nicht der Server-Zeit. Eine geänderte Zeitzone wirkt nur auf künftige Berichte. Für ältere Zeiträume hilft Invalidieren, solange die Rohdaten vorhanden sind.

Browser-Archivierung noch aktiv#

Laufen Cron und Browser-Archivierung parallel, rechnen beide, und Berichte laden langsam. Die Systemprüfung meldet dann „Browser- und Autoarchivierung aktiviert“. Abhilfe schafft die Einrichtung oben, inklusive browser_archiving_disabled_enforce.

Lange Zeiträume#

Eigene Zeiträume, etwa vom 1. Januar bis heute, rechnet der Cron nicht vorab. Matomo setzt sie beim Abruf aus Tagesberichten zusammen, standardmäßig auch bei abgeschalteter Browser-Archivierung. Das kostet Speicher im Webserver-PHP und endet bei großen Instanzen leicht im Timeout mit Fehler 504. Häufig genutzte Zeiträume holen Sie mit archiving_custom_ranges[] in den Cron. Fehlende eindeutige Besucher in Jahres- und Zeitraumberichten sind übrigens kein Fehler: Matomo berechnet sie dort standardmäßig nicht.

Diagnose: was läuft, was hängt?#

  1. Systemprüfung: Unter Administration > Diagnose > Systemprüfung (oder ./console diagnostics:run) zeigt „Letzter erfolgreicher Abschluss der Archivierung“ bei abgeschalteter Browser-Archivierung eine Warnung nach einem Tag und einen Fehler nach zwei Tagen. Daneben stehen Speicherlimit, Paketgröße und die Zahl der Einträge in der Warteschlange.
  2. Archivierungsstatus: Seit Matomo 5.1 bündelt ./console diagnostics:archiving-status Warteschlange, Kennzahlen und die wirksamen Einstellungen in einem Bericht. --with-stats ergänzt Instanzstatistiken, einzeln gibt es diagnostics:archiving-queue, diagnostics:archiving-metrics und diagnostics:archiving-config.
  3. Die Ausgabe von core:archive: Das Log zeigt, welche Website, welcher Zeitraum und welches Segment gerade verarbeitet wird; mit -vvv wird es ausführlich. Zum Eingrenzen archivieren Sie eine einzelne Website mit --force-idsites=1 --concurrent-requests-per-website=1, am besten bei pausiertem Cron.

Meldet die Ausgabe „Got invalid response from API request“, bekommt der Archivierer keine gültige Antwort von Matomo. Prüfen Sie PHP-Fehlerlog, matomo.log und Webserver-Log; laut Matomo stecken oft SSL, DNS, ein Proxy oder eine Firewall dahinter.

Archivierung ist Betrieb, kein einmaliges Setup#

Mehr Traffic, neue Segmente oder ein Update verändern die Last, und eine Archivierung, die heute läuft, kann in drei Monaten an ihre Grenzen kommen. Deshalb gehört sie überwacht, nicht nur eingerichtet. Im SLA-Betrieb prüft unser Monitoring Endpoint, Archivierung und Datenbank rund um die Uhr, auch auf Ihrer eigenen Infrastruktur. In unserem Matomo-Hosting läuft die Archivierung als überwachter Hintergrundjob, abgestimmt auf Ihren Traffic.

Peter Boehlke

Über den Autor

Peter Boehlke

Gründer von feinwerk · Matomo-Spezialist seit 2009

Peter Boehlke arbeitet seit 2009 mit Matomo: als Mitglied des Matomo-Teams, Contributor zum Open-Source-Projekt und Implementation Partner im Matomo-Partnerprogramm. Mit feinwerk betreibt er Matomo-Instanzen bis in den High-Traffic-Bereich, entwickelt eigene Plugins für Matomo und berät zu Tag Management, Tracking-Konzepten und datenschutzkonformer Messung.

  • Matomo seit 2009
  • Matomo Implementation Partner
  • Matomo Contributor
  • Eigene Plugins für Matomo

Passt zu

SLA-Betrieb

Verbindliche Zusagen statt Best Effort: Monitoring, Härtung und Sicherheit als laufender Vertrag.

Mehr zum SLA →

Passende Plugins

Plugins für Matomo aus eigener Entwicklung, die zu diesem Thema passen.

Hosting ab 99 € pro Monat · Angebot nach Bedarf

Erzählen Sie uns von Ihrem Matomo.

Beschreiben Sie kurz Traffic, Infrastruktur und Anforderungen. Sie erhalten innerhalb eines Werktags eine ehrliche Einschätzung und ein Angebot.

Worum geht es?