> 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/netlify-agent-analytics.md). # Netlify Verbinde deine Netlify-Website mit AirOps, um KI-Bot-Traffic über Netlify Log Drains zu verfolgen. Verbinden Sie Ihre Netlify-Site mit AirOps, um den Traffic von KI-Bots zu verfolgen. Sie fügen einen **Netlify Log Drain** hinzu, der Edge-Traffic-Protokolle an AirOps streamt, das Besuche von KI-Bots (ChatGPT, Claude, Perplexity, Google und mehr) klassifiziert und Einblicke in Ihrem Agent Analytics-Dashboard anzeigt. Die Einrichtung ist ein einmaliger manueller Schritt im Netlify-Dashboard. Log Drains sind eine **Netlify Enterprise** Funktion. Es ist kein Site-Tag oder clientseitiges Skript erforderlich. *** ## Voraussetzungen * Ein aktives **AirOps** Konto mit aktiviertem Agent Analytics * Ein **Netlify Enterprise** Konto (Log Drains sind in Free-, Personal- oder Pro-Plänen nicht verfügbar) * Ein **Netlify-Site** das Ihre Website bereitstellt * Ein **Brand Kit** in AirOps für diese Site. Setzen Sie die Brand-URL auf die Domain Ihrer Site, damit Aufschlüsselungen auf Seitenebene aufgelöst werden (konfigurierbar unter Context > Brand Kits > Brand URL) Wenn Sie nicht sicher sind, ob Ihr Brand Kit korrekt eingerichtet ist, wenden Sie sich vor der Einrichtung des Drains an Ihren AirOps Customer-Success-Ansprechpartner. *** ## Schritt 1: Holen Sie sich Ihren AirOps-Endpunkt und Ihr Token Öffnen Sie in AirOps **Einblicke → Vor Ort → Agenten-Analysen**, klicken Sie auf **Agent Analytics einrichten** und wählen Sie **Netlify**. Das Panel zeigt beide Werte an, die Sie benötigen: * die **Ingest-Endpunkt-URL** für Ihr Brand Kit * Ihr **Workspace-API-Token**, standardmäßig ausgeblendet. Klicken Sie auf **Anzeigen** um ihn anzuzeigen, oder **Kopieren** um ihn direkt in die Zwischenablage zu kopieren. Das Token ist der `Authorization: Bearer` Wert in Schritt 2. {% hint style="info" %} Wenn das Token nicht angezeigt wird, hat Ihre Rolle keinen Zugriff auf den Workspace-API-Schlüssel. Bitten Sie einen Workspace-Administrator. Sie können den Endpunkt auch selbst zusammenstellen: `https://ingest.airops.com/api/v1/netlify//ingest`. Ihre Brand Kit ID finden Sie in der URL unter Context > Brand Kits, in der Form `https://app.airops.com//data/brand_kits/`. Das Token befindet sich außerdem unter Settings > Workspace. {% endhint %} ## Schritt 2: Fügen Sie einen Log Drain in Netlify hinzu Gehen Sie in Netlify zum **Logs & Metrics > Log Drains > Add log drain**Ihres Teams und dann: 1. **Service:** Allgemeiner HTTP-Endpunkt 2. **Log-Typen:** Nur Traffic (Funktions-, Edge-, Deploy- und Firewall-Protokolle deaktiviert lassen) 3. **Format:** NDJSON 4. **Endpunkt-URL:** der AirOps-Endpunkt aus Schritt 1 5. **Header:** hinzufügen `Authorization: Bearer ` 6. **PII ausschließen:** lassen Sie dies **aus** (siehe Warnhinweis unten) 7. Klicken Sie auf **Verbinden** um den Drain zu speichern. {% hint style="warning" %} Lassen Sie **"PII ausschließen" aus**. Netlifys Option zum Ausschließen von PII entfernt den User-Agent und die Client-IP aus Traffic-Protokollen. AirOps identifiziert KI-Agenten anhand des User-Agent, daher kann bei ausgeschlossener PII kein Bot-Traffic klassifiziert werden und Ihr Dashboard bleibt leer. Lassen Sie es für Agent Analytics deaktiviert. {% endhint %} ## Schritt 3: Die Verbindung überprüfen Zurück in AirOps öffnen Sie erneut **Agent Analytics einrichten** und wählen Sie **Netlify**, dann klicken Sie auf **Ich habe dies eingerichtet**. Netlify zeigt jetzt ein grünes **Connected** Badge in der Quellenliste an. Ihr Drain ist live, sobald Netlify ihn akzeptiert, und Traffic erscheint im Dashboard, während KI-Agenten Ihre verfolgten Seiten crawlen. {% hint style="info" %} Testen Sie mit einem realen, vorhandenen Pfad auf Ihrer Site. Anfragen an nicht existierende Seiten können aus Netlifys Edge-Cache bedient werden, ohne den Drain zu erreichen, sodass ein 404-Test keine Daten erzeugt. Vergewissern Sie sich außerdem, dass der Log-Typ des Drains auf **Traffic**. {% endhint %} *** ## Fehlerbehebung | Symptom | Wahrscheinliche Ursache | Behebung | | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Können Sie die **Ich habe dies eingerichtet** Schaltfläche | Ihre Rolle kann Brand Kits nicht bearbeiten | Bitten Sie einen Workspace-Administrator, die Verbindung für Sie zu bestätigen. | | Drain in Netlify gespeichert, aber keine Daten erscheinen in Agent Analytics | Noch hat kein KI-Bot die Site besucht, oder "PII ausschließen" ist aktiviert | Bestätigen Sie, dass echter Traffic die Site erreicht, und schalten Sie "PII ausschließen" am Drain aus. | | Roh-Traffic wird angezeigt, aber nichts wird klassifiziert | "PII ausschließen" ist aktiviert, daher fehlt der User-Agent | Bearbeiten Sie den Drain in Netlify und deaktivieren Sie den PII-Ausschluss. AirOps benötigt den User-Agent, um Bots zu identifizieren. | | Daten auf Seitenebene fehlen in Page360 | Die Domain Ihres Brand Kits stimmt nicht mit der Site überein | Öffnen Sie in AirOps die Brand-Kit-Einstellungen und bestätigen Sie, dass die Brand-URL mit der Domain übereinstimmt, über die Ihre Netlify-Site ausgeliefert wird. | | Drain konfiguriert, aber nach einigen Minuten keine Zeilen | Sie haben einen Pfad getestet, der einen 404 ergibt, oder der Log-Typ ist nicht Traffic | Besuchen Sie einen bekannten, gültigen Pfad, der in Ihrer Bereitstellung existiert, und bestätigen Sie, dass der Log-Typ des Drains **Traffic** (nicht nur Function/Edge). | | Kann Log Drains in Netlify nicht finden | Ihr Team hat keinen Enterprise-Plan | Log Drains erfordern **Netlify Enterprise**. Führen Sie vor der Einrichtung ein Upgrade durch. | *** ## Anforderungen an den Tarif Netlify Log Drains sind nur im **Netlify Enterprise** Plan verfügbar. Mit Free-, Personal- und Pro-Plänen können keine Drains erstellt werden; Ihr Team benötigt Enterprise, bevor Sie dies einrichten. Netlify veröffentlicht keine separate Gebühr pro GB für den ausgehenden Traffic von Log Drains; etwaige Datenkosten sind Teil Ihrer Netlify-Enterprise-Vereinbarung. Um das Volumen niedrig zu halten, leiten Sie **nur Traffic-Protokolle**. *** ## Sicherheit und Einrichtung nach dem Least-Privilege-Prinzip ### Erforderliche Berechtigungen zum Einrichten **In Netlify:** Ein Teammitglied, das Log Drains in Ihrem Enterprise-Team verwalten kann, kann den Drain hinzufügen. **In AirOps:** Der Nutzer muss bei AirOps angemeldet und Mitglied des Ziel-Workspaces sein; jede AirOps-Rolle funktioniert. ### Laufzeit-Authentifizierung Bei der Bereitstellung eines Drains ist keine Benutzersitzung beteiligt. Jede Zustellung authentifiziert sich mit einem **Bearer-Token** im `Authorization` Header, der Ihr **AirOps-API-Schlüssel des Workspaces**, der während der Einrichtung in die Drain-Konfiguration eingetragen wird. Das Token gilt auf Workspace-Ebene, nicht auf Benutzerebene. Es gibt kein separates Signing-Secret, das verwaltet werden muss. ### Token-Rotation Der Workspace-API-Schlüssel kann in der App unter **Account > Workspace > API Key** rotiert werden (erfordert die AirOps-Workspace-Admin-Rolle). Vor der Rotation sind zwei Dinge wichtig: * Der Netlify-Drain hat das vorherige Token in seinem ausgehenden `Authorization` Header. Aktualisieren Sie nach der Rotation den Header des Drains in Netlify mit dem neuen Token, andernfalls schlägt die Authentifizierung der Zustellungen fehl. * Mit demselben Workspace-API-Schlüssel werden auch andere AirOps-APIs authentifiziert (Public API, MCP-Server, SDK). Eine Rotation wirkt sich auf alle davon aus, nicht nur auf Netlify. ### Was diese Integration nicht tut * Er erhält nur die Traffic-Protokolle, die der Drain sendet. Er hat keinen Zugriff auf Ihr Netlify-Konto, Umgebungsvariablen, Build-Protokolle oder Deploys. * Er schreibt nichts in Ihr Netlify-Konto zurück. Nach der Einrichtung empfängt AirOps nur noch Daten vom Drain. Wenn Ihre Sicherheitsprüfung weitere Details benötigt, wenden Sie sich an den AirOps Customer Success, und wir können Ihr Team auf Implementierungsebene durch den Datenfluss führen. *** ## Trennen Um die Netlify-Integration zu entfernen: 1. Öffnen Sie in Netlify **Logs & Metrics > Log Drains** und entfernen Sie den AirOps-Drain. 2. Trennen Sie in AirOps **Netlify** vom Quellen-Auswahlmenü. Ihre historischen Netlify-Daten bleiben nach der Trennung in AirOps erhalten. Um das Tracking fortzusetzen, richten Sie den Drain erneut ein. *** ## Was AirOps verfolgt Sobald die Verbindung hergestellt ist, führt AirOps automatisch Folgendes aus: * **Erfasst alle von Netlify ausgelieferten Anfragen** enthalten in den Traffic-Protokollen: Seitenaufrufe, Assets, API-Aufrufe * **Klassifiziert KI-Bot-Traffic:** identifiziert Besuche von ChatGPT, Claude, Google, Perplexity, Meta, Apple, Bing, Bytedance, Common Crawl und anderen * **Kategorisiert Crawl-Verhalten:** unterscheidet zwischen KI-Trainings-Crawlern (GPTBot, ClaudeBot usw.), KI-Suchabrufen (PerplexityBot, OAI-SearchBot usw.) und vom Nutzer initiiertem KI-Browsing (ChatGPT-User, Claude-User usw.) * **Stellt Analysen bereit:** Traffic-Aufschlüsselungen, Verhältnisse von Bots zu Menschen und 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/netlify-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.