> 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.

Verbinde dein Vercel-Projekt mit AirOps, um den Traffic von KI-Bots zu verfolgen. AirOps richtet automatisch einen **Vercel-Log-Drain** ein, klassifiziert beim Installieren der Integration Besuche von KI-Bots (ChatGPT, Claude, Perplexity, Google und mehr) und zeigt Erkenntnisse in deinem 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 deine Website auf einer benutzerdefinierten Domain bereitstellt
* Ein **Brand Kit** in AirOps, deren Domain mit deiner Vercel-Deployments-Domain übereinstimmt (konfigurierbar unter Context > Brand Kits > Brand URL)

Wenn du nicht sicher bist, ob dein Brand Kit korrekt eingerichtet ist, wende dich vor der Installation an deinen AirOps Customer-Success-Kontakt.

***

### Schritt 1: AirOps aus dem Vercel Marketplace installieren

1. Öffne 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ähle das **Vercel-Team** aus, dem das Projekt gehört, das du verfolgen möchtest.
3. Vercel zeigt den **AirOps Agent Analytics installieren** Bildschirm an. Wähle unter „Select which projects the integration will have access to“ **Bestimmte Projekte** und wähle nur das bzw. die Projekte aus, die deine verfolgte Marken-Website bereitstellen.
4. Klicken Sie auf **Installieren**.

{% hint style="info" %}
Wir empfehlen dringend **Bestimmte Projekte** statt **Alle Projekte**. „Alle Projekte“ gewährt der Integration Zugriff auf jedes Projekt unter deinem Vercel-Team, einschließlich nicht zusammenhängender Projekte (Marketing-Websites, interne Tools, Preview-Deployments). AirOps filtert Protokolle heraus, die nicht zu deiner Brand-Kit-Domain passen, bevor sie gespeichert werden, aber sie verursachen dennoch Vercel-Drain-Egress (ungefähr 0,50 $/GB) auf deiner Rechnung. Wenn du nur das Marken-Website-Projekt auswählst, bleiben die Vercel-Kosten vorhersehbar und es wird vermieden, Traffic zu streamen, der ohnehin verworfen wird.
{% endhint %}

***

### Schritt 2: Mit deinem AirOps-Workspace verbinden

Nachdem du die Autorisierung in Vercel durchgeführt hast, wirst du zurück zu AirOps weitergeleitet.

* Wenn dein AirOps-Konto Zugriff auf **einen Workspace**hat, wird die Integration automatisch verbunden.
* Wenn du Zugriff auf **mehrere Workspaces**hast, erscheint ein Auswahldialog. Wähle den Workspace aus, mit dem diese Vercel-Integration verknüpft werden soll.

AirOps richtet auf deinem ausgewählten Team automatisch einen Vercel Log Drain ein. Eine manuelle Konfiguration von Endpoint-URLs, Signatur-Secrets oder Bearer-Headern ist nicht erforderlich.

Du wirst zur AirOps-Agent-Analytics-Integrationsseite auf Vercel weitergeleitet, was bestätigt, dass die Installation abgeschlossen ist.

***

### Schritt 3: Verbindung überprüfen

Navigiere in AirOps zu **Insights > Settings > General** für ein beliebiges Brand Kit und scrolle zum **Verbundenen Integrationen** Abschnitt.

Du solltest eine **Vercel** Zeile mit Folgendem sehen:

* Ein grünes **Verbunden** Badge
* Der Name deines verbundenen Vercel-Teams
* Eine **Deinstallation in Vercel** Aktion

Die Daten beginnen zu fließen, sobald deine Website Traffic von einem KI-Bot erhält. Bei geringem Traffic bündelt Vercel 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 Logs ohne Anfragedaten. Ein bestandener Test bedeutet **nicht** dass realer Traffic in AirOps erscheinen wird; er bestätigt nur, dass der Endpunkt erreichbar ist. Echter Agenten-Traffic trifft ein, sobald ein KI-Bot eine Anfrage an deine Website sendet, die zu deinen konfigurierten Projekten passt.
{% endhint %}

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-af54a5d372532d53bdeaf65d70dc7566611d100d%2Fagent-vercel-01-setup-panel.png?alt=media" alt="Set up Agent Analytics source picker with Vercel marked Connected, next to CloudFront, Cloudflare Worker, and Netlify"><figcaption><p>Vercel wird als Verbunden angezeigt, sobald die AirOps-Integration installiert ist.</p></figcaption></figure>

***

### Fehlerbehebung

| Symptom                                                                               | Wahrscheinliche Ursache                                                                                                                                              | Behebung                                                                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Vercel-Zeile zeigt **Verbunden** aber es erscheinen keine Daten in Insights Traffic   | Die Domain deines Brand Kits stimmt nicht mit deiner Vercel-Deployment-Domain überein                                                                                | Öffne in AirOps die Brand-Kit-Einstellungen und bestätige, dass die Brand URL mit der Domain übereinstimmt, die dein Vercel-Projekt tatsächlich bereitstellt (zum Beispiel `acme.com` nicht `www.acme.com` wenn deine Website unter `acme.com`). |
| Vercel sendet dir „drain errored“ per E-Mail                                          | Der AirOps-Endpunkt hat bei mehr als 50 Übermittlungen innerhalb einer Stunde oder bei mehr als 80 % der Übermittlungen innerhalb einer Stunde 4xx/5xx zurückgegeben | Kontaktiere den AirOps Customer Success. Wir können die Ursache anhand der Serverprotokolle diagnostizieren.                                                                                                                                     |
| Drain wird als „aktiv“ angezeigt, aber nach 5 Minuten erscheinen keine Zeilen         | Du hast mit der automatisch generierten Deployments-URL von Vercel getestet (zum Beispiel `<projekt>-<hash>.vercel.app`)                                             | Der Deployment-Schutz von Vercel in Pro-Tarifen gibt Bots auf diesen URLs 401 zurück. Verwende stattdessen den öffentlichen Alias deines Projekts oder eine benutzerdefinierte Domain.                                                           |
| Test-Schaltfläche funktioniert, aber es erscheinen nie echte Daten                    | Du rufst Pfade auf, die bei einem statischen Deployment 404 liefern                                                                                                  | 404s bei rein statischen Deployments werden aus dem Edge-Cache von Vercel ausgeliefert, ohne den Drain auszulösen. Rufe einen bekannten, funktionierenden Pfad auf, der in deinem Deployment tatsächlich existiert.                              |
| Die Bytes-Spalte zeigt bei einigen Anfragen 0 an                                      | Cachete statische Treffer enthalten kein `responseByteSize`                                                                                                          | Das ist bei von Vercel gecachten statischen Assets zu erwarten. Andere Metriken (Status, User-Agent, Timing) bleiben davon unberührt.                                                                                                            |
| Du hast die Integration in Vercel entfernt, aber AirOps zeigt weiterhin **Verbunden** | Die Seite zeigt einen veralteten Status an                                                                                                                           | Führe einen Hard-Refresh der AirOps-Seite durch (Cmd+Shift+R auf Mac, Ctrl+Shift+R unter Windows). Der Vercel-Deinstallations-Webhook ist asynchron und benötigt einige Sekunden, bis er ankommt.                                                |

***

### Anforderungen an den Tarif

Vercel Log Drains sind nur verfügbar auf **Vercel Pro und Enterprise** Tarifen. Hobby-Tarife können keine Drains erstellen; wenn dein Team auf Hobby ist, musst du vor der Installation upgraden.

Vercel berechnet den Drain-Egress mit etwa 0,50 $ pro gestreamtem GB, auf deiner Vercel-Rechnung abgerechnet. Bei Websites mit wenig Traffic liegt das normalerweise unter 1 $ pro Monat. Bei Websites mit hohem Traffic reduzierst du die Kosten auf zwei Arten: beschränke die Installation auf **Bestimmte Projekte** nur das Marken-Website-Projekt (siehe Schritt 1), und beginne in den Umgebungs-Einstellungen von Vercel mit nur Produktion und schließe Preview-Deployments aus.

***

### Sicherheit und Einrichtung nach dem Least-Privilege-Prinzip

#### Erforderliche Berechtigungen für die Installation

**In Vercel:** jeder Benutzer mit der **Mitglied** Rolle in deinem 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; jede AirOps-Rolle ist geeignet.

#### Dedizierter benutzerähnlicher Dienstaccount

AirOps hat keine separate Maschinenidentität, die sich von einem Benutzer unterscheidet, aber die Integration ist so konzipiert, dass der installierende Benutzer nur die Rolle des Installations-Akteurs hat und nicht die Laufzeitrolle. Du kannst die Least-Privilege-Erwartungen erfüllen, indem du ein dediziertes Benutzerkonto als Proxy für ein Servicekonto behandelst:

1. Lade einen benannten, dedizierten Benutzer ein (zum Beispiel `vercel-airops@yourcompany.com`) in deinen AirOps-Workspace. Verwende die Rolle mit den geringsten Berechtigungen, die dein Workspace anbietet.
2. Melde dich einmal als dieser Benutzer an und führe die OAuth-Installation durch.
3. Nach Abschluss der Installation hat dieser Benutzer keine Laufzeitberechtigung mehr. Die Integration authentifiziert sich weiterhin über das unten beschriebene Workspace-API-Token. Du kannst den Benutzer danach aus dem Workspace entfernen, wenn deine Sicherheitsrichtlinie dies erfordert; die Integration funktioniert weiterhin.

Dasselbe Muster gilt auf 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-Übermittlung eine Benutzersitzung beteiligt. Die Authentifizierung bei jeder Übermittlung erfolgt zweistufig:

* **HMAC-SHA1-Signatur** des Request-Bodys, abgesichert durch ein installationsspezifisches Drain-Secret, das von AirOps bei der Installation erzeugt wird. Vercel sendet die Signatur im `x-vercel-signature` Header bei jeder Übermittlung.
* **Bearer-Token** im `Authorization` -Header. Das Token ist der **AirOps-API-Schlüssel deines Workspaces**, der bei der Installation in die Drain-Konfiguration geschrieben wird.

Beide Faktoren sind auf Workspace-Ebene, nicht auf Benutzerebene. Der installierende Benutzer wird nur in den Audit-Metadaten von AirOps erfasst.

#### Token-Rotation

Der Workspace-API-Schlüssel kann in der App unter **Account > Workspace > API Key** rotiert werden (erfordert die Rolle AirOps Workspace Admin). Vor der Rotation sind zwei Dinge zu beachten:

* Der Vercel-Drain hat das vorherige Token fest in seinem ausgehenden `Authorization` Header eingebettet. Nach der Rotation schlägt die Authentifizierung des Drains fehl, bis die Integration in Vercel neu 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). Wenn du ihn rotierst, betrifft das all diese Systeme, nicht nur Vercel.

Wenn eine Rotationsfrequenz Teil deiner Compliance-Richtlinie ist, ist die sichere Reihenfolge: AirOps-Token rotieren und dann die Vercel-Integration unmittelbar über den Marketplace-Eintrag von Vercel neu installieren.

#### Was diese Integration nicht tut

* Sie fordert keine Scopes für dein Vercel-Konto an, die über das hinausgehen, was zum Erstellen und Verwalten eines Log Drains für das ausgewählte Team erforderlich ist. Sie kann keinen Quellcode des Projekts, keine Umgebungsvariablen und keine Deployment-Logs außerhalb des Request-Streams des Drains lesen.
* Sie schreibt nicht fortlaufend in dein Vercel-Konto zurück. Nach der ersten Bereitstellung des Drains empfängt AirOps nur Daten von Vercel; es ruft die Vercel-API nicht erneut auf, außer du installierst neu oder trennst die Verbindung.

Wenn deine Sicherheitsprüfung zusätzliche Details benötigt, kontaktiere den AirOps Customer Success; wir können dein Team auf Implementierungsebene durch den Datenfluss führen.

***

### Verbindung trennen

Um die Vercel-Integration zu entfernen:

1. Öffne in AirOps **Insights > Settings > General > Connected Integrations**.
2. Klicken Sie auf **Deinstallation in Vercel** in der Vercel-Zeile. Dadurch gelangst du zur Integrationsseite deines Vercel-Teams.
3. Suche die AirOps-Integration und klicke auf **Entfernen**. Bestätige.
4. AirOps markiert die Integration beim **Getrennt** bei deinem nächsten Seiten-Refresh.

Deine historischen Vercel-Daten bleiben nach dem Trennen in AirOps erhalten. Um das Tracking fortzusetzen, klicke auf **Erneut auf Vercel installieren** in derselben Zeile.

***

### Was AirOps erfasst

Sobald die Verbindung hergestellt ist, führt AirOps automatisch folgende Schritte aus:

* **Erfasst alle von Vercel bereitgestellten Anfragen:** Seitenaufrufe, Assets, API-Aufrufe
* **Klassifiziert KI-Bot-Traffic:** erkennt 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 von Nutzern ausgelöstem KI-Browsing (ChatGPT-User, Claude-User usw.)
* **Zeigt Analysen an:** Traffic-Aufschlüsselungen, Bot-gegen-Mensch-Verhältnisse und Crawl-Trends in deinem 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=<question>&goal=<user_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.
