Vercel
Connectez votre projet Vercel à AirOps pour suivre le trafic des bots IA via Vercel Log Drains.
Connectez votre projet Vercel à AirOps pour suivre le trafic des bots IA. AirOps provisionne automatiquement un Drain de logs Vercel lorsque vous installez l’intégration, classe les visites des bots IA (ChatGPT, Claude, Perplexity, Google, et plus encore) et affiche des insights dans votre tableau de bord Agent Analytics.
Prérequis
Un AirOps compte actif avec Agent Analytics activé
Un Vercel Pro ou Enterprise compte (les drains de logs ne sont pas disponibles sur les formules Hobby)
Un projet Vercel qui diffuse votre site Web sur un domaine personnalisé
Un Brand Kit dans AirOps dont le domaine correspond à votre domaine de déploiement Vercel (configurable sous Context > Brand Kits > Brand URL)
Si vous n’êtes pas sûr que votre brand kit est correctement configuré, vérifiez auprès de votre contact Customer Success AirOps avant l’installation.
Étape 1 : Installez AirOps depuis la Vercel Marketplace
Ouvrez l’URL d’installation :
https://vercel.com/integrations/airops-agent-analytics/newVercel affiche un sélecteur d’équipe. Sélectionnez l’ équipe Vercel qui possède le projet que vous souhaitez suivre.
Vercel affiche l’écran Installer AirOps Agent Analytics écran. Sous « Sélectionnez les projets auxquels l’intégration aura accès », choisissez Projets spécifiques et sélectionnez uniquement le ou les projets qui diffusent le site de votre marque suivi.
Cliquez sur Installer.
Étape 2 : Connectez-vous à votre espace de travail AirOps
Après autorisation dans Vercel, vous serez redirigé vers AirOps.
Si votre compte AirOps a accès à un espace de travail, l’intégration se connecte automatiquement.
Si vous avez accès à plusieurs espaces de travail, un sélecteur apparaît. Sélectionnez l’espace de travail auquel vous souhaitez rattacher cette intégration Vercel.
AirOps provisionne automatiquement un Vercel Log Drain sur l’équipe sélectionnée. Aucune configuration manuelle des URL de point de terminaison, des secrets de signature ou des en-têtes Bearer n’est requise.
Vous serez redirigé vers la page d’intégration AirOps Agent Analytics sur Vercel, ce qui confirme que l’installation est terminée.
Étape 3 : Vérifiez la connexion
Dans AirOps, accédez à Insights > Paramètres > Général pour n’importe quel brand kit, puis faites défiler jusqu’à la Intégrations connectées section.
Vous devriez voir une Vercel ligne avec :
Un badge vert Connecté badge
le nom de l’équipe Vercel connectée
Une Désinstaller dans Vercel action
Les données commencent à circuler dès que votre site reçoit du trafic d’un bot IA. À faible volume de trafic, Vercel regroupe les enregistrements et les transmet toutes les 30 à 60 secondes.

Dépannage
la ligne Vercel affiche Connecté mais aucune donnée n’apparaît dans Insights Traffic
Le domaine de votre brand kit ne correspond pas à votre domaine de déploiement Vercel
Dans AirOps, ouvrez les paramètres Brand Kit et confirmez que l’URL de marque correspond au domaine réellement servi par votre projet Vercel (par exemple, acme.com pas www.acme.com si votre site est servi à acme.com).
Vercel vous envoie un e-mail « drain errored »
Le point de terminaison AirOps a renvoyé des erreurs 4xx/5xx pour plus de 50 envois en une heure, ou pour plus de 80 % des envois en une heure
Contactez le Customer Success d’AirOps. Nous pouvons diagnostiquer cela à partir des journaux du serveur.
Le drain s’affiche comme « actif » mais aucune ligne n’apparaît après 5 minutes
Vous avez testé avec l’URL de déploiement générée automatiquement par Vercel (par exemple, <project>-<hash>.vercel.app)
La protection de déploiement de Vercel sur les plans Pro renvoie une erreur 401 aux bots sur ces URL. Utilisez plutôt l’alias public de votre projet ou un domaine personnalisé.
Le bouton Test passe, mais aucune donnée réelle n’apparaît jamais
Vous avez atteint des chemins qui renvoient une 404 sur un déploiement statique
Les 404 sur les déploiements statiques sont servies depuis le cache de périphérie de Vercel sans invoquer le drain. Visitez un chemin valide qui existe réellement dans votre déploiement.
La colonne Bytes affiche 0 pour certaines requêtes
Les accès statiques mis en cache n’incluent pas responseByteSize
C’est attendu pour les ressources statiques mises en cache par Vercel. Les autres métriques (statut, user-agent, timing) ne sont pas affectées.
Vous avez supprimé l’intégration dans Vercel, mais AirOps affiche toujours Connecté
La page affiche un état obsolète
Effectuez un rechargement forcé de la page AirOps (Cmd+Shift+R sur Mac, Ctrl+Shift+R sur Windows). Le webhook de désinstallation Vercel est asynchrone et met quelques secondes à arriver.
Exigences de plan
Les Vercel Log Drains sont disponibles sur Vercel Pro et Enterprise uniquement. Les plans Hobby ne peuvent pas créer de drains ; si votre équipe est sur Hobby, vous devrez effectuer une mise à niveau avant l’installation.
Vercel facture la sortie du drain à environ 0,50 $ par Go diffusé, facturé sur votre facture Vercel. Pour les sites à faible trafic, cela représente généralement moins de 1 $ par mois. Pour les sites à fort trafic, réduisez les coûts de deux façons : limitez l’installation à Projets spécifiques au seul projet du site de marque (voir l’étape 1), et dans les paramètres par environnement de Vercel, commencez avec Production uniquement et excluez les déploiements de prévisualisation.
Configuration de sécurité et de moindre privilège
Autorisations requises pour installer
Sur Vercel : tout utilisateur disposant du rôle Membre sur votre équipe Vercel peut installer l’intégration. Le rôle Owner n’est pas requis. La configuration des intégrations fait partie des responsabilités standard du rôle Member (rôles d’accès Vercel).
Sur AirOps : l’utilisateur qui effectue l’installation doit être connecté à AirOps et membre de l’espace de travail cible, et n’importe quel rôle AirOps convient.
Utilisateur de type service dédié
AirOps ne dispose pas d’un identifiant machine distinct d’un utilisateur, mais l’intégration est conçue de sorte que l’utilisateur installateur soit uniquement l’acteur au moment de l’installation et non le principal à l’exécution. Vous pouvez respecter les exigences de moindre privilège en traitant un compte utilisateur dédié comme un proxy de compte de service :
Invitez un utilisateur nommé et dédié (par exemple,
vercel-airops@yourcompany.com) dans votre espace de travail AirOps. Utilisez le rôle le plus restreint disponible dans votre espace de travail.Connectez-vous une fois en tant que cet utilisateur et terminez l’installation OAuth.
Une fois l’installation terminée, cet utilisateur n’a aucune autorité à l’exécution. L’intégration continue de s’authentifier via le jeton API de l’espace de travail décrit ci-dessous. Vous pouvez ensuite supprimer l’utilisateur de l’espace de travail si votre politique de sécurité l’exige ; l’intégration continue de fonctionner.
Le même schéma s’applique côté Vercel : un utilisateur Vercel dédié avec le rôle Member peut effectuer l’installation puis rester comme membre inactif de l’équipe.
Authentification à l’exécution
Après l’installation, aucune session utilisateur n’intervient dans la livraison du drain. L’authentification de chaque livraison comporte deux couches :
signature HMAC-SHA1 du corps de la requête, basée sur un secret de drain spécifique à l’installation généré par AirOps au moment de l’installation. Vercel envoie la signature dans l’en-tête
x-vercel-signatureà chaque livraison.jeton Bearer dans l’en-tête
Authorization. Le jeton est la clé API AirOps de votre espace de travail, inscrite dans la configuration du drain lors de l’installation.
Ces deux éléments sont au niveau de l’espace de travail, et non de l’utilisateur. L’utilisateur installateur n’est enregistré que dans les métadonnées d’audit d’AirOps.
Rotation du jeton
La clé API de l’espace de travail peut être renouvelée dans l’application sous Compte > Espace de travail > Clé API (nécessite le rôle d’administrateur de l’espace de travail AirOps). Deux éléments à comprendre avant la rotation :
Le drain Vercel contient l’ancien jeton intégré dans son envoi sortant
Authorizationen-tête. Après rotation, le drain commencera à échouer à l’authentification jusqu’à ce que l’intégration soit réinstallée depuis Vercel (ce qui écrit le nouveau jeton dans un nouveau drain).La même clé API de l’espace de travail authentifie d’autres API AirOps (Public API, serveur MCP, SDK). La faire tourner affecte tous ces services, pas seulement Vercel.
Si la cadence de rotation fait partie de votre politique de conformité, la séquence sûre est la suivante : faites tourner le jeton AirOps, puis réinstallez immédiatement l’intégration Vercel depuis la fiche Marketplace de Vercel.
Ce que cette intégration ne fait pas
Elle ne demande pas d’autorisations sur votre compte Vercel au-delà de ce qui est nécessaire pour créer et gérer un log drain sur l’équipe sélectionnée. Elle ne peut pas lire le code source du projet, les variables d’environnement ou les journaux de déploiement en dehors du flux de requêtes du drain.
Elle n’écrit pas régulièrement vers votre compte Vercel. Après le provisionnement initial du drain, AirOps ne reçoit des données que de Vercel ; il n’appelle plus l’API de Vercel sauf si vous réinstallez ou déconnectez.
Si votre revue de sécurité nécessite des détails supplémentaires, contactez le Customer Success AirOps et nous pourrons guider votre équipe à travers le flux de données au niveau de l’implémentation.
Déconnexion
Pour supprimer l’intégration Vercel :
Dans AirOps, ouvrez Insights > Paramètres > Général > Intégrations connectées.
Cliquez sur Désinstaller dans Vercel dans la ligne Vercel. Cela vous amène à la page des intégrations de votre équipe Vercel.
Trouvez l’intégration AirOps et cliquez sur Supprimer. Confirmez.
AirOps marque l’intégration comme Déconnectée lors du prochain rafraîchissement de la page.
Vos données Vercel historiques restent dans AirOps après la déconnexion. Pour reprendre le suivi, cliquez sur Réinstaller sur Vercel dans la même ligne.
Ce qu'AirOps suit
Une fois connecté, AirOps :
Ingestion de toutes les requêtes servies par Vercel : pages vues, ressources, appels API
Classe le trafic des bots IA : identifie les visites provenant de ChatGPT, Claude, Google, Perplexity, Meta, Apple, Bing, Bytedance, Common Crawl et d’autres
Catégorise le comportement de crawl : distingue les robots d’exploration d’entraînement IA (GPTBot, ClaudeBot, etc.), les récupérations de recherche IA (PerplexityBot, OAI-SearchBot, etc.) et la navigation IA initiée par l’utilisateur (ChatGPT-User, Claude-User, etc.)
Met en avant les analyses : répartitions du trafic, ratios bots/humains et tendances de crawl dans votre tableau de bord
Mis à jour
Ce contenu vous a-t-il été utile ?