Cloudflare

Läuft Ihre Domain über Cloudflare, kommen die Zugriffe ohne Umweg über den Webserver bei Agent Franz an. Es gibt zwei Wege: einen Cloudflare Worker, der in jedem Cloudflare-Tarif läuft, auch im kostenlosen, und Logpush, das Cloudflare nur im Enterprise-Tarif anbietet. Nehmen Sie nur einen der beiden; laufen beide, zählen Zugriffe doppelt.

Voraussetzungen

• Ihre Domain läuft über Cloudflare, das heißt, ihr DNS liegt bei Cloudflare.
• Zugang zum Cloudflare-Dashboard dieser Domain.
• Ein API-Schlüssel des Arbeitsbereichs. Erzeugen darf ihn nur die Rolle Admin.

Einrichtungsseite öffnen

Öffnen Sie im Menü Traffic die Seite Überblick, dann Integration einrichten und Cloudflare. Die Seite führt in sieben Schritten durch den Weg mit dem Worker. Das Fragezeichen neben dem Titel öffnet diese Hilfeseite.

Einrichtung mit dem Worker

1. Prüfen Sie, dass die Domain über Cloudflare läuft.
2. Klicken Sie im Schritt API-Schlüssel in Agent Franz erzeugen auf API-Schlüssel erzeugen und erzeugen Sie einen Schlüssel. Er wird nur einmal angezeigt. Kopieren Sie ihn sofort.
3. Laden Sie mit Worker-Code herunterladen (agentfranz-worker.txt) den Code des Workers herunter. Legen Sie im Cloudflare-Dashboard unter Workers & Pages eine neue Anwendung an, beginnend mit „Hello World“, benennen Sie den Worker und stellen Sie ihn bereit. Ersetzen Sie dann über „Edit code“ den gesamten Inhalt durch den Inhalt der heruntergeladenen Datei und stellen Sie ihn erneut bereit. Die Einrichtungsseite zeigt dazu Bilder aus dem Cloudflare-Dashboard.
4. Legen Sie im Worker unter „Settings“, „Variables and Secrets“ diese Werte an:
   • AGENTFRANZ_API_KEY mit Ihrem API-Schlüssel, als verschlüsseltes Secret.
   • AGENTFRANZ_ENDPOINT mit der Adresse, die die Einrichtungsseite zum Kopieren anbietet.
   • AGENTFRANZ_CAPTURE, freiwillig: all übermittelt alle Zugriffe, bots nur die von KI-Crawlern und anderen Programmen. Ohne diese Variable gilt all.
5. Legen Sie den Worker unter „Settings“, „Domains & Routes“ mit einer Route auf Ihre Domain, etwa schwabenmaschinen.de/*. Erst mit der Route läuft der Verkehr durch den Worker.
6. Fertig. Die Einrichtungsseite zeigt, woran Sie erkennen, dass es läuft.
7. Freiwillig: eigene Geräte von der Zählung ausnehmen, siehe den Abschnitt „Eigene Besuche nicht zählen“ weiter unten.

Wer lieber auf der Kommandozeile arbeitet, findet unter Für Fortgeschrittene / abweichende Setups die Befehle für Wrangler.

Worker aktualisieren oder abschalten

Ist der Worker schon eingerichtet, laden Sie den aktuellen Code herunter, ersetzen unter „Edit code“ den gesamten Inhalt und stellen ihn bereit. Variablen und Secret bleiben erhalten. Die aktuelle Version ist 0.3.0. Sie liefert die Zugriffe vollständiger: Sie sammelt kurz, schickt größere Pakete und versucht eine abgewiesene Lieferung erneut. Schickt Ihr Arbeitsbereich noch eine ältere Version, weist die Seite Überblick oben darauf hin.

Um die Übermittlung vorübergehend anzuhalten, setzen Sie die Variable AGENTFRANZ_ENABLED auf false. Der Worker bleibt dabei bestehen.

Eigene Besuche nicht zählen

Ihre eigenen Besuche und die Ihres Teams sollen die Zahlen nicht verfälschen. Im Schritt Eigene Besuche nicht zählen der Einrichtungsseite stehen dafür zwei Links. Dieses Gerät nicht mehr zählen öffnet Ihre Website; der Worker merkt sich den Browser mit einem Cookie und meldet dessen Zugriffe nicht mehr an Agent Franz. Wieder zählen hebt das wieder auf.

Das gilt je Browser und ab Worker-Version 0.3.0. Öffnen Sie den Link also in jedem Browser, mit dem Sie oder Ihr Team die Website besuchen. Ein gelöschtes Cookie oder ein neuer Browser wird wieder gezählt.

Einrichtung mit Logpush

Im Enterprise-Tarif schickt Cloudflare seine eigenen Zugriffsprotokolle an Agent Franz, ohne Worker. Sie legen dafür im Cloudflare-Dashboard einen Logpush-Job an:

1. Datensatz „HTTP requests“, Ziel „HTTP destination“.
2. Als Ziel-Adresse den Pfad /api/ingest/cloudflare-logpush der Adresse https://app.agentfranz.ai, mit dem Parameter header_Authorization und dem Wert Bearer%20<IHR-API-SCHLÜSSEL>. Cloudflare macht daraus den Kopf Authorization; %20 steht für das Leerzeichen nach Bearer.
3. Diese sechs Felder auswählen: EdgeStartTimestamp, ClientIP, ClientRequestUserAgent, ClientRequestURI, ClientRequestMethod und EdgeResponseStatus. Weitere Felder schaden nicht.
4. Als Zeitformat RFC3339 wählen. Die Voreinstellung unixnano liest Agent Franz ebenfalls.
5. Den Job aktivieren.

Beim Anlegen schickt Cloudflare eine Testnachricht. Mit gültigem Schlüssel bestätigt Agent Franz sie, und der Job lässt sich speichern.

So sehen Sie, dass es klappt

Die ersten Zugriffe erscheinen auf der Seite Überblick. Das kann Stunden bis Tage dauern, weil KI-Crawler unregelmäßig vorbeikommen. Bei Cloudflare gibt es keine Warnung in Agent Franz, wenn keine Daten mehr kommen; sehen Sie gelegentlich selbst nach.

Typische Fehler

• Es kommen keine Daten an, obwohl der Worker bereitsteht: Prüfen Sie die Route aus Schritt 5. Ohne sie läuft kein Verkehr durch den Worker.
• Der API-Schlüssel stimmt nicht. Die Schnittstelle antwortet dann mit 401 und dem Code unauthenticated. Der Worker meldet das nur in seinen eigenen Protokollen bei Cloudflare, nicht in Agent Franz. Erzeugen Sie einen neuen Schlüssel und tragen Sie ihn als Secret ein.
• AGENTFRANZ_ENABLED steht auf false.
• Logpush lässt sich nicht speichern: Prüfen Sie in der Ziel-Adresse das %20 nach Bearer und den Schlüssel.
• Laufen Worker und Logpush oder Cloudflare und der Abruf vom Webhosting gleichzeitig, zählen Zugriffe doppelt; siehe Logs anbinden.

Wie die Schnittstelle hinter dem Worker antwortet, beschreibt Eigene Anbindung über die Schnittstelle.

Datenschutz

Welche Angaben übertragen werden, listet die Einrichtungsseite unter Das wird übertragen. Seit Version 0.3.0 schickt der Worker zusätzlich seine eigene Versionsnummer mit.

Das Cookie zum Ausnehmen eines Geräts enthält keine Kennung, nur den Wert 1, und wird nur auf ausdrücklichen Wunsch gesetzt; es ist dafür technisch notwendig (§ 25 Abs. 2 Nr. 2 TDDDG). Wenn Sie den Link nutzen, nennen Sie das Cookie in der Datenschutzerklärung Ihrer Website, zum Beispiel: Wer sein Gerät auf eigenen Wunsch von der Zählung ausnimmt, erhält ein Cookie ohne Kennung mit einer Laufzeit von 400 Tagen; es ist dafür technisch notwendig. Wie Agent Franz damit umgeht, steht in der Datenschutzerklärung.