Logs anbinden

Stand: 3. Oktober 2026

Die Seiten unter Traffic zählen, welche KI-Crawler Ihre Website abgerufen haben. Grundlage sind die Zugriffsprotokolle Ihres Webservers, auch Access-Logs genannt. Solange keine ankommen, bleiben die Seiten leer. Dieses Kapitel beschreibt, wie die Protokolle zu Agent Franz kommen.

Die Wege im Überblick

  • Logdatei hochladen: Sie laden das Zugriffsprotokoll bei Ihrem Hoster herunter und in Agent Franz hoch. An der Website ändert sich nichts. Neue Zugriffe kommen erst mit der nächsten Datei.
  • Abruf vom Webhosting: Sie richten einmal einen Zugang per SFTP oder FTPS ein, der den Log-Ordner lesen kann. Agent Franz holt die Protokolle danach jeden Morgen selbst ab.
  • Cloudflare: Läuft Ihre Domain über Cloudflare, schaltet ein kleines Programm von Agent Franz (ein Cloudflare Worker) sich vor die Website und meldet die Zugriffe laufend. Der kostenlose Tarif von Cloudflare genügt. Im Enterprise-Tarif geht es auch ohne dieses Programm über Logpush.
  • Eigene Anbindung: Ihr eigenes System schickt die Zugriffe über eine Schnittstelle an Agent Franz. Das ist ein Weg für Entwickler.

WordPress-Plugin und TYPO3-Erweiterung: Wird nicht mehr unterstützt.

Den passenden Weg wählen

  • Ihre Domain läuft schon über Cloudflare: Nehmen Sie den Weg über Cloudflare. Die App empfiehlt ihn auch, wenn Ihr Hoster keine Zugriffsprotokolle herausgibt.
  • Ihr Hoster bietet SFTP oder FTPS an, und Sie können dort einen zusätzlichen Benutzer anlegen: Nehmen Sie den Abruf vom Webhosting. Reines, unverschlüsseltes FTP genügt nicht.
  • Ihre Website liegt auf einem eigenen Linux-Server: Auch dafür ist der Abruf vom Webhosting gedacht. Die Einrichtungsseite zeigt die Befehle für Ubuntu und Debian.
  • Sie möchten nichts einrichten oder nur einen Zeitraum ansehen: Laden Sie eine Logdatei hoch.
  • Sie haben ein eigenes System, das Zugriffe sammelt: Bauen Sie eine eigene Anbindung.

Einrichtung finden

Öffnen Sie im Menü Traffic die Seite Überblick. Sind schon Daten da, stehen oben rechts zwei Schaltflächen:

  • Integration einrichten öffnet eine Auswahl mit Cloudflare und Webhosting (SFTP, FTPS). Jeder Eintrag führt zu einer Einrichtungsseite mit nummerierten Schritten.
  • Neue Log-Datei hochladen öffnet das Fenster zum Hochladen.

Die Auswahl hinter der Schaltfläche zum Einrichten einer Integration

In einem Arbeitsbereich ohne Daten zeigt dieselbe Seite eine Einführung mit beiden Integrationen und der Fläche zum Hochladen. Was dort steht, erklärt Wenn keine Daten ankommen.

Zwei Wege gleichzeitig

Jeder Weg liefert dieselben Zugriffe. Laufen zwei Wege für dieselbe Website, zählt Agent Franz jeden Zugriff doppelt. Die Testverbindung beim Abruf vom Webhosting weist darauf hin, wenn der Arbeitsbereich schon Daten über eine andere Integration empfängt. Schalten Sie dann einen der beiden Wege ab.

Dasselbe gilt für hochgeladene Dateien: Überschneiden sich die Zeiträume zweier Dateien, zählen die Zugriffe an diesen Tagen mehrfach. Eine Datei mit genau demselben Inhalt nimmt die App kein zweites Mal an.

Wer das darf

  • Logdateien hochladen dürfen die Rollen Ändern und Admin.
  • Den Abruf vom Webhosting einrichten, ändern, pausieren und trennen darf nur die Rolle Admin. Alle anderen Mitglieder sehen auf der Einrichtungsseite einen Hinweis darauf und, sobald ein Abruf eingerichtet ist, seinen Stand.
  • API-Schlüssel erzeugen und widerrufen darf nur die Rolle Admin; die Übersicht steht unter Rollen und Rechte. Die Wege über Cloudflare und die eigene Anbindung brauchen einen solchen Schlüssel.

Mit der Rolle Nur lesen sehen Sie die Zahlen, richten aber nichts ein.

Datenschutz

Zugriffsprotokolle enthalten personenbezogene Daten wie IP-Adressen. Wie Agent Franz sie verarbeitet, steht in der Datenschutzerklärung.