> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/de/insights/onsite/traffic/cloudflare-logpush-agent-analytics.md). # Cloudflare Logpush Diese Anleitung führt dich durch die Konfiguration von Cloudflare Logpush, um HTTP-Anforderungsprotokolle für Agent Analytics in AirOps zu streamen. Dieser Leitfaden führt dich durch die Konfiguration von Cloudflare, um über **Logpush**. Sobald die Verbindung hergestellt ist, analysiert AirOps deinen Traffic automatisch, klassifiziert Besuche von KI-Bots (ChatGPT, Claude, Perplexity, Google und mehr) und zeigt Einblicke in deinem Agent-Analytics-Dashboard an. Logpush ist eine native, von Cloudflare verwaltete Funktion, die Anforderungsprotokolle bündelt und an einen HTTP-Endpunkt liefert. Anders als die [Workers-Integration](/docs/de/insights/onsite/traffic/cloudflare-worker-agent-analytics.md), erfordert keine Codebereitstellung oder Wartung, ist aber nur im **Enterprise** Tarif verfügbar. {% hint style="info" %} **Logpush oder Worker?** Verwenden **Logpush** wenn Sie einen Cloudflare Enterprise-Tarif haben. Es ist die einfachste Option und erfordert keinen Code. Wenn Sie einen anderen Tarif haben, verwenden Sie die [Cloudflare Worker-Integration](/docs/de/insights/onsite/traffic/cloudflare-worker-agent-analytics.md) stattdessen, wobei Sie einen kleinen Worker bereitstellen und warten. {% endhint %} *** ## Voraussetzungen * Ein aktives **AirOps** Konto mit aktiviertem Agent Analytics * Ein **Cloudflare** Konto im **Enterprise** Tarif (Logpush ist nur für Enterprise verfügbar) * Administratorzugriff auf die Cloudflare-Zone, die Ihre Website bereitstellt * Dein **Workspace-API-Schlüssel**, verfügbar in `Einstellungen → Workspace` * Dein **Brand-Kit-ID**, verfügbar in der URL durch Navigieren zu `Kontext → Brand Kits`. Die URL hat die Form `https://app.airops.com//data/brand_kits/` *** ## Einrichtung im Dashboard Die Einrichtung im Dashboard ist der **empfohlene** Ansatz für die meisten Websites. Logpush puffert Protokollereignisse pro Anfrage und liefert sie in komprimierten Paketen in seinem eigenen Rhythmus an AirOps. ### Schritt 1: Erstellen Sie einen Logpush-Job 1. Öffnen Sie das **Cloudflare-Dashboard** und wählen Sie die Domain aus, die Ihre Website bereitstellt. Logpush-Jobs sind domänenspezifisch, daher müssen Sie sich in der konkreten Domain (Zone) befinden, die Sie nachverfolgen möchten, nicht in der Kontoansicht. 2. Erweitern Sie in der linken Navigation **Untersuchen** und wählen Sie **Logpush**. 3. Klicken Sie auf **Logpush-Job erstellen**. 4. Wählen Sie für den Datensatz **HTTP-Anfragen**. ### Schritt 2: Protokollfelder auswählen Wählen Sie die folgenden Felder aus. AirOps verwendet sie für die vollständige Analyse, und das Senden zusätzlicher Felder ist unbedenklich. | Feld | Erforderlich | | ------------------------ | ------------ | | `EdgeStartTimestamp` | Ja | | `EdgeEndTimestamp` | Ja | | `EdgeResponseStatus` | Ja | | `EdgeResponseBytes` | Ja | | `ClientRequestMethod` | Ja | | `ClientRequestScheme` | Ja | | `ClientRequestHost` | Ja | | `ClientRequestURI` | Ja | | `ClientRequestUserAgent` | Ja | | `ClientRequestReferer` | Ja | | `ClientCountry` | Ja | | `ClientDeviceType` | Ja | ### Schritt 3: HTTP-Ziel konfigurieren Setzen Sie den Zieltyp auf **HTTP-Ziel** und geben Sie den AirOps-Ingest-Endpunkt als Ziel-URL ein. Ihr Workspace-API-Schlüssel wird als benutzerdefinierter Anfrage-Header übermittelt. | Einstellung | Wert | | ------------ | -------------------------------------------------------------------------------------------------------------------------- | | **Ziel-URL** | `https://ingest.airops.com/api/v1/cloudflare-logpush//ingest?header_X-API-Key=` | {% hint style="info" %} Cloudflare hängt benutzerdefinierte Anfrage-Header in Form von Query-Parametern an `header_=`. Der `header_X-API-Key=` Parameter ist die Art und Weise, wie Cloudflare Ihren AirOps-Workspace-API-Schlüssel bei jeder Zustellung übermittelt. {% endhint %} ### Schritt 4: Schließen Sie die Eigentumsprüfung ab Bevor der Job erstellt werden kann, überprüft Cloudflare, ob Ihnen das Ziel gehört. Cloudflare sendet ein Besitz-Token per POST an die Ziel-URL. Rufen Sie dieses Token ab und fügen Sie es wieder im Cloudflare-Dashboard ein, um die Verifizierung abzuschließen. ### Schritt 5: Aktivieren Sie den Job 1. Überprüfen Sie die Job-Konfiguration. 2. Aktivieren Sie den Job, um mit der Bereitstellung von Protokollen zu beginnen. ### Schritt 6: Überprüfe die Verbindung Nach dem Aktivieren des Logpush-Jobs sollten die Daten innerhalb von **ein paar Minuten** (Logpush bündelt vor dem Senden). 1. Im **Cloudflare-Dashboard**, überprüfen Sie den Zustellungsstatus des Logpush-Jobs. Eine kürzlich erfolgreiche Zustellung bedeutet, dass Daten AirOps erreichen. 2. In deinem **AirOps-Dashboard**, navigiere zu **Agent Analytics**. Die Cloudflare-Quelle wechselt in den verbundenen Status, und Bot-Traffic wird angezeigt, sobald Crawler Ihre Website besuchen. *** ## API-Einrichtung Sie können den Logpush-Job auch programmatisch mit der Cloudflare API erstellen. Das ist nützlich für Skripte oder die Verwaltung vieler Zonen. Sie benötigen ein Cloudflare-API-Token mit der **Protokolle bearbeiten** Berechtigung und Ihre **Zonen-ID**. ```bash curl --request POST \ "https://api.cloudflare.com/client/v4/zones//logpush/jobs" \\ --header "Authorization: Bearer " \\ --header "Content-Type: application/json" \\ --data '{ "name": "airops-log-collector", "dataset": "http_requests", "destination_conf": "https://ingest.airops.com/api/v1/cloudflare-logpush//ingest?header_X-API-Key=", "output_options": { "field_names": [ "EdgeStartTimestamp", "EdgeEndTimestamp", "EdgeResponseStatus", "EdgeResponseBytes", "ClientRequestMethod", "ClientRequestScheme", "ClientRequestHost", "ClientRequestURI", "ClientRequestUserAgent", "ClientRequestReferer", "ClientCountry", "ClientDeviceType" ], "timestamp_format": "rfc3339" }, "enabled": true }' ``` {% hint style="info" %} Die `` übergeben im `destination_conf` sollte denselben Wert wie Ihr Workspace-API-Schlüssel haben, verfügbar in `Einstellungen → Workspace`. Wenn Sie den Job über die API erstellen, verlangt Cloudflare vor Beginn der Zustellungen weiterhin den oben beschriebenen Schritt der Eigentumsprüfung. {% endhint %} *** ## Was Sie nach der Einrichtung erwarten können * Protokolle beginnen, den **HTTP-Ziel** von Ihnen konfigurierten innerhalb von **Minuten**. Logpush bündelt Protokollereignisse in seinem eigenen Rhythmus, bevor sie zugestellt werden. Das ist die Zustellzeit an diesen Endpunkt, nicht der Zeitpunkt, an dem der Traffic in Ihrem Dashboard erscheint. * Die Agent-Analysen zeigen **nur Traffic von KI-Bots und Crawlern**. Menschliches Surfen wird nicht angezeigt. * Ein Brand Kit wird als konfiguriert angezeigt, sobald Logpush seinen ersten Batch zustellt. Bestimmte Seiten erscheinen, sobald ein Bot eine verfolgte Seite crawlt. *** ## Wenn Sie keine Daten sehen | Symptom | Wahrscheinliche Ursache | Behebung | | ---------------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | Cloudflare-Job zeigt Zustellungsfehler / keine 2xx | Ziel-URL oder Authentifizierung ist falsch konfiguriert | Überprüfen Sie die Brand-Kit-ID in der URL erneut und bestätigen Sie `?header_X-API-Key=` Ihr aktueller AirOps-Workspace-API-Schlüssel ist | | Cloudflare zeigt `401` / `403` Antworten | Falscher oder rotierter Schlüssel oder falscher Workspace | Stellen Sie sicher, dass der API-Schlüssel aktuell ist und das Brand Kit diesem Workspace gehört | | Erfolgreiche Zustellung, aber die Agent-Analysen sind leer | Erwartet: Es wird nur Bot-Traffic angezeigt | Warten Sie, bis ein Crawler die Seite besucht; Besuche von Menschen werden nicht angezeigt | | Die ersten Bot-Zeilen sind noch nicht erschienen | Crawl-Timing | Die ersten sichtbaren Zeilen erscheinen, sobald ein Crawler das nächste Mal besucht; das hängt von der Crawl-Frequenz ab | Wenn Sie weiterhin nicht weiterkommen, wenden Sie sich mit Ihrem **Brand-Kit-ID** und dem Logpush-Job **Zustellungsstatus**. *** ## Anhalten oder Trennen Um die Übermittlung von Daten an AirOps zu stoppen, deaktivieren oder löschen Sie den Logpush-Job im Cloudflare-Dashboard. Das Rotieren Ihres AirOps-Workspace-API-Schlüssels stoppt die Zustellung ebenfalls, da Cloudflare weiterhin den alten Schlüssel senden wird. *** ## Was AirOps verfolgt Sobald die Verbindung hergestellt ist, führt AirOps automatisch Folgendes aus: * **Nimmt Ihre Cloudflare-Anforderungsprotokolle auf** über Logpush * **Klassifiziert KI-Bot-Traffic**: identifiziert Besuche von ChatGPT, Claude, Google, Perplexity, Gemini, Meta, Apple, Bing, ByteDance, Common Crawl und anderen * **Kategorisiert Crawling-Verhalten**: unterscheidet zwischen KI-Trainings-Crawlern, KI-Suchabrufen, KI-Indexierung und vom Nutzer initiiertem KI-Browsing * **Zeigt Analysen an**: Aufschlüsselungen des Traffics von KI-Bots und Crawlern sowie Crawl-Trends in Ihrem Dashboard --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.airops.com/docs/de/insights/onsite/traffic/cloudflare-logpush-agent-analytics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.