> 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/vercel-agent-analytics.md). # Vercel Verbinden Sie Ihr Vercel-Projekt mit AirOps, um den Traffic von KI-Bots über Vercel Log Drains zu verfolgen. Verbinden Sie Ihr Vercel-Projekt mit AirOps, um den Traffic von KI-Bots zu verfolgen. AirOps stellt automatisch einen **Vercel Log Drain** bereit, klassifiziert beim Installieren der Integration Besuche von KI-Bots (ChatGPT, Claude, Perplexity, Google und mehr) und zeigt Erkenntnisse in Ihrem Agent Analytics-Dashboard an. *** ### Voraussetzungen * Ein aktives **AirOps** Konto mit aktiviertem Agent Analytics * Ein **Vercel Pro oder Enterprise** Konto (Log Drains sind in Hobby-Tarifen nicht verfügbar) * Ein **Vercel-Projekt** das Ihre Website auf einer benutzerdefinierten Domain bereitstellt * Ein **Brand Kit** in AirOps, dessen Domain mit der Domain Ihrer Vercel-Bereitstellung übereinstimmt (konfigurierbar unter Context > Brand Kits > Brand URL) Wenn Sie nicht sicher sind, ob Ihr Brand Kit korrekt eingerichtet ist, wenden Sie sich vor der Installation an Ihren AirOps Customer-Success-Ansprechpartner. *** ### Schritt 1: AirOps aus dem Vercel Marketplace installieren 1. Öffnen Sie die Installations-URL: [`https://vercel.com/integrations/airops-agent-analytics/new`](https://vercel.com/integrations/airops-agent-analytics/new) 2. Vercel zeigt einen Teamauswähler an. Wählen Sie das **Vercel-Team** aus, dem das Projekt gehört, das Sie verfolgen möchten. 3. Vercel zeigt den **Install AirOps Agent Analytics** Bildschirm an. Wählen Sie unter „Select which projects the integration will have access to“ **Specific Projects** und wählen Sie nur das bzw. die Projekte aus, die Ihre verfolgte Marken-Website bereitstellen. 4. Klicken Sie auf **Installieren**. {% hint style="info" %} Wir empfehlen dringend **Specific Projects** anstatt **All Projects**. „All Projects“ gewährt der Integration Zugriff auf jedes Projekt unter Ihrem Vercel-Team, einschließlich nicht zusammenhängender Projekte (Marketing-Websites, interne Tools, Preview-Deployments). AirOps filtert Protokolle heraus, die nicht mit der Domain Ihres Brand Kits übereinstimmen, bevor sie gespeichert werden, aber sie verursachen dennoch Vercel-Drain-Egress-Kosten (ca. 0,50 $/GB) auf Ihrer Rechnung. Wenn Sie nur das Projekt der Marken-Website auswählen, bleiben die Vercel-Kosten vorhersehbar und es wird vermieden, Traffic zu streamen, der verworfen wird. {% endhint %} *** ### Schritt 2: Mit Ihrem AirOps-Workspace verbinden Nach der Autorisierung in Vercel werden Sie zurück zu AirOps weitergeleitet. * Wenn Ihr AirOps-Konto Zugriff auf **einen Workspace**hat, wird die Integration automatisch verbunden. * Wenn Sie Zugriff auf **mehrere Workspaces**haben, erscheint ein Auswähler. Wählen Sie den Workspace aus, an den diese Vercel-Integration angehängt werden soll. AirOps stellt automatisch einen Vercel Log Drain für Ihr ausgewähltes Team bereit. Eine manuelle Konfiguration von Endpoint-URLs, Signatur-Secrets oder Bearer-Headern ist nicht erforderlich. Sie werden zur Integrationsseite von AirOps Agent Analytics auf Vercel weitergeleitet, was bestätigt, dass die Installation abgeschlossen ist. *** ### Schritt 3: Die Verbindung überprüfen Navigieren Sie in AirOps zu **Insights > Settings > General** für beliebiges Brand Kit und scrollen Sie zum **Verbundene Integrationen** Abschnitt. Sie sollten eine **Vercel** Zeile sehen mit: * Ein grünes **Connected** Abzeichen * dem Namen Ihres verbundenen Vercel-Teams * Eine **Uninstall in Vercel** Aktion Die Daten beginnen zu fließen, sobald Ihre Website Traffic von einem KI-Bot erhält. Bei geringem Trafficvolumen bündelt Vercel die Datensätze und liefert sie alle **30 bis 60 Sekunden**. {% hint style="warning" %} Vercels **Test** Schaltfläche (in den Drain-Einstellungen auf Vercels Seite) sendet nur synthetische Protokolle ohne Request-Daten. Ein bestandener Test bedeutet **nicht** dass echter Traffic in AirOps erscheint; er bestätigt nur, dass der Endpoint erreichbar ist. Echter Agenten-Traffic trifft ein, sobald ein KI-Bot eine Anfrage an Ihre Website sendet, die mit Ihren konfigurierten Projekten übereinstimmt. {% endhint %} *** ### Fehlerbehebung | Symptom | Wahrscheinliche Ursache | Behebung | | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Die Vercel-Zeile zeigt **Connected** aber in Insights Traffic erscheinen keine Daten | Die Domain Ihres Brand Kits stimmt nicht mit der Domain Ihrer Vercel-Bereitstellung überein | Öffnen Sie in AirOps die Brand-Kit-Einstellungen und bestätigen Sie, dass die Brand-URL mit der Domain übereinstimmt, die Ihr Vercel-Projekt tatsächlich bereitstellt (zum Beispiel `acme.com` nicht `www.acme.com` wenn Ihre Website unter `acme.com`). | | Vercel sendet Ihnen eine E-Mail mit „drain errored“ | Der AirOps-Endpoint hat bei mehr als 50 Zustellungen in einer Stunde oder bei mehr als 80 % der Zustellungen in einer Stunde 4xx/5xx zurückgegeben | Kontaktieren Sie den AirOps Customer Success. Wir können dies anhand der Serverprotokolle diagnostizieren. | | Drain wird als „active“ angezeigt, aber nach 5 Minuten erscheinen keine Zeilen | Sie haben mit Vercels automatisch generierter Deployment-URL getestet (zum Beispiel `-.vercel.app`) | Vercels Deployment Protection in Pro-Tarifen gibt für Bots auf diesen URLs 401 zurück. Verwenden Sie stattdessen Ihren öffentlichen Alias oder eine benutzerdefinierte Domain. | | Test-Schaltfläche besteht, aber es erscheinen nie echte Daten | Sie rufen Pfade auf, die bei einem statischen Deployment 404 zurückgeben | 404s auf rein statischen Deployments werden aus Vercels Edge-Cache bereitgestellt, ohne den Drain aufzurufen. Rufen Sie einen bekannten, tatsächlich in Ihrer Bereitstellung vorhandenen Pfad auf. | | Die Bytes-Spalte zeigt bei einigen Anfragen 0 an | Zwischengespeicherte statische Treffer enthalten keine `responseByteSize` | Das ist bei von Vercel zwischengespeicherten statischen Assets zu erwarten. Andere Metriken (Status, User-Agent, Timing) sind davon nicht betroffen. | | Sie haben die Integration in Vercel entfernt, aber AirOps zeigt immer noch **Connected** | Die Seite zeigt einen veralteten Status an | Machen Sie einen Hard-Refresh der AirOps-Seite (Cmd+Shift+R auf dem Mac, Ctrl+Shift+R unter Windows). Der Vercel-Deinstallations-Webhook ist asynchron und braucht ein paar Sekunden, um anzukommen. | *** ### Anforderungen an den Tarif Vercel Log Drains sind verfügbar auf **Vercel Pro und Enterprise** nur in Tarifen. Hobby-Tarife können keine Drains erstellen; wenn Ihr Team im Hobby-Tarif ist, müssen Sie vor der Installation upgraden. Vercel berechnet Drain-Egress mit ca. 0,50 $ pro gestreamtem GB und stellt dies auf Ihrer Vercel-Rechnung in Rechnung. Bei Websites mit geringem Traffic liegt dies typischerweise unter 1 $ pro Monat. Bei Websites mit hohem Traffic senken Sie die Kosten auf zwei Arten: Beschränken Sie die Installation auf **Specific Projects** nur auf das Projekt der Marken-Website (siehe Schritt 1), und beginnen Sie in Vercels Einstellungen pro Umgebung mit nur Production und schließen Sie Preview-Deployments aus. *** ### Sicherheit und Einrichtung nach dem Least-Privilege-Prinzip #### Für die Installation erforderliche Berechtigungen **In Vercel:** jeder Benutzer mit der **Mitglied** Rolle in Ihrem Vercel-Team kann die Integration installieren. Ein Owner ist nicht erforderlich. Das Einrichten von Integrationen gehört zu den Standardaufgaben der Member-Rolle ([Vercel-Zugriffsrollen](https://vercel.com/docs/rbac/access-roles)). **In AirOps:** der Benutzer, der die Installation abschließt, muss bei AirOps angemeldet sein und Mitglied des Ziel-Workspaces sein, und jede AirOps-Rolle funktioniert. #### Dedizierter Benutzer im Service-Stil AirOps hat keine separate maschinenbezogene Identität, die sich von einem Benutzer unterscheidet, aber die Integration ist so konzipiert, dass der installierende Benutzer nur der Akteur zur Installationszeit ist und nicht der Laufzeitakteur. Sie können die Erwartungen an das Least-Privilege-Prinzip erfüllen, indem Sie ein dediziertes Benutzerkonto als Service-Account-Proxy behandeln: 1. Laden Sie einen benannten, dedizierten Benutzer ein (zum Beispiel `vercel-airops@yourcompany.com`) in Ihren AirOps-Workspace. Verwenden Sie die Rolle mit den geringstmöglichen Rechten, die Ihr Workspace anbietet. 2. Melden Sie sich einmal als dieser Benutzer an und schließen Sie die OAuth-Installation ab. 3. Nach Abschluss der Installation hat dieser Benutzer keine Laufzeitberechtigung mehr. Die Integration authentifiziert weiterhin über das unten beschriebene Workspace-API-Token. Sie können den Benutzer danach aus dem Workspace entfernen, wenn Ihre Sicherheitsrichtlinie dies erfordert; die Integration funktioniert weiterhin. Dasselbe Muster gilt auf der Vercel-Seite: Ein dedizierter Vercel-Benutzer mit der Member-Rolle kann die Installation durchführen und danach als inaktives Teammitglied bestehen bleiben. #### Laufzeit-Authentifizierung Nach der Installation ist bei keiner Drain-Zustellung eine Benutzersitzung beteiligt. Die Authentifizierung bei jeder Zustellung erfolgt in zwei Ebenen: * **HMAC-SHA1-Signatur** des Request-Bodys, mit einem pro Installation vergebenen Drain-Secret, das von AirOps zum Zeitpunkt der Installation generiert wird. Vercel sendet die Signatur im `x-vercel-signature` Header bei jeder Zustellung. * **Bearer-Token** im `Authorization` Header. Das Token ist Ihr **AirOps-API-Schlüssel des Workspaces**, der während der Installation in die Drain-Konfiguration geschrieben wird. Beide Faktoren gelten auf Workspace-Ebene, nicht auf Benutzerebene. Der installierende Benutzer wird in den Audit-Metadaten von AirOps nur erfasst. #### 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 Vercel-Drain hat das vorherige Token fest in seinem ausgehenden `Authorization` Header eingebettet. Nach der Rotation wird die Authentifizierung des Drains fehlschlagen, bis die Integration von Vercel aus erneut installiert wird (wodurch das neue Token in einen neuen Drain geschrieben wird). * Derselbe Workspace-API-Schlüssel authentifiziert auch andere AirOps-APIs (Public API, MCP-Server, SDK). Seine Rotation betrifft all diese, nicht nur Vercel. Wenn die Rotationshäufigkeit Teil Ihrer Compliance-Richtlinie ist, ist die sichere Reihenfolge: Das AirOps-Token rotieren und dann sofort die Vercel-Integration über den Marketplace-Eintrag von Vercel erneut installieren. #### Was diese Integration nicht tut * Sie fordert auf Ihrem Vercel-Konto keine Scopes an, die über das hinausgehen, was zum Erstellen und Verwalten eines Log Drains für das ausgewählte Team erforderlich ist. Sie kann keinen Projekt-Quellcode, keine Umgebungsvariablen oder Deployment-Protokolle außerhalb des Request-Streams des Drains lesen. * Sie schreibt nicht laufend in Ihr Vercel-Konto zurück. Nach der ersten Bereitstellung des Drains empfängt AirOps nur noch Daten von Vercel; es ruft die Vercel-API nur erneut auf, wenn Sie die Integration erneut installieren oder trennen. 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 So entfernen Sie die Vercel-Integration: 1. Öffnen Sie in AirOps **Insights > Settings > General > Connected Integrations**. 2. Klicken Sie auf **Uninstall in Vercel** in der Vercel-Zeile. Dadurch gelangen Sie zur Integrationsseite Ihres Vercel-Teams. 3. Suchen Sie die AirOps-Integration und klicken Sie auf **Entfernen**. Bestätigen Sie. 4. AirOps markiert die Integration beim **Getrennt** bei Ihrem nächsten Seiten-Refresh. Ihre historischen Vercel-Daten bleiben nach dem Trennen in AirOps erhalten. Um die Verfolgung fortzusetzen, klicken Sie auf **In Vercel erneut installieren** in derselben Zeile. *** ### Was AirOps verfolgt Sobald die Verbindung hergestellt ist, führt AirOps automatisch Folgendes aus: * **Nimmt alle von Vercel bereitgestellten Requests auf:** 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/vercel-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.