Skip to main content
Utilisez un Vercel Drain pour transmettre les logs de requêtes de production Static et Runtime à Analytics des crawlers.

​
Avant de commencer

Il vous faut :
  • une équipe Vercel Pro ou Enterprise autorisée à gérer les Drains ;
  • un projet de production qui sert le nom d’hôte configuré pour la marque Qwairy ;
  • un accès à Measure > Analytics des crawlers > Paramètres ;
  • un endroit sûr pour conserver le secret du connecteur, affiché une seule fois.

​
Créer et protéger la clé

  1. Dans les paramètres d’Analytics des crawlers, sélectionnez Vercel.
  2. Sélectionnez Créer une clé.
  3. Saisissez un nom et le fuseau horaire IANA qui doit définir les instantanés quotidiens.
  4. Copiez le secret lorsqu’il apparaît. Il ne pourra plus être affiché.
  5. Conservez-le dans la configuration du Vercel Drain ou dans un autre coffre de secrets restreint. Ne l’incluez ni dans une URL, ni dans un dépôt, ni dans une variable côté client.
Pour renouveler la clé, créez une clé de remplacement, mettez à jour l’en-tête du Drain, confirmez la livraison, puis supprimez l’ancienne clé. Une intégration peut avoir jusqu’à cinq clés actives.

​
Configurer le drain

  1. Dans le tableau de bord Vercel, ouvrez Team Settings > Drains > Add Drain.
  2. Choisissez une destination de logs personnalisée et définissez le type de données sur Logs.
  3. Sélectionnez le format JSON.
  4. Sélectionnez l’environnement Production.
  5. Incluez les sources Static et Runtime.
  6. Définissez le point de terminaison sur :
  7. Ajoutez cet en-tête personnalisé, avec comme valeur le secret copié depuis Qwairy :
    Les Drains existants qui utilisent x-qwairy-token restent compatibles. Préférez X-API-Key pour les nouvelles configurations.
  8. Gardez le trafic de production à 100 % d’échantillonnage, ou n’ajoutez aucune règle d’échantillonnage. Un taux inférieur produit des comptes partiels.
  9. Enregistrez le Drain.
Consultez la référence des Log Drains de Vercel pour les réglages et le schéma actuels du fournisseur.

​
Tester la livraison

Utilisez le test de destination de Vercel pour vérifier le point de terminaison et l’en-tête. Ce test peut ne contenir aucune requête de crawler acceptée : à lui seul, il ne fait donc pas passer le connecteur Qwairy à l’état connecté. Demandez ensuite un chemin autorisé sur le nom d’hôte de production suivi, avec un User-Agent de crawler reconnu. Par exemple, remplacez l’URL ci-dessous par un chemin sans risque de votre site :
Vérifiez que le Vercel Drain indique une livraison réussie. Dans Qwairy, le connecteur quitte l’état en attente dès que le pipeline d’agrégation accepte un événement pour le nom d’hôte configuré.

​
Limites, échantillonnage et coût

  • Vercel ne peut pas restreindre ce Drain par User-Agent. Il transmet le trafic Static et Runtime correspondant, et Qwairy écarte à la réception les requêtes qui ne viennent pas de l’IA.
  • Le trafic humain transmis peut tout de même compter dans le volume de livraison et la facturation de Vercel. Consultez les tarifs actuels de Vercel avant d’activer le Drain sur un site à fort trafic.
  • Toute règle d’échantillonnage Vercel inférieure à 100 % rend partiels les totaux d’Analytics des crawlers.
  • Qwairy applique les plafonds partagés d’événements, de requêtes et d’ingestion quotidienne décrits dans la présentation d’Analytics des crawlers.

​
Dépannage

  • Le test de destination échoue : vérifiez le point de terminaison HTTPS, le nom de l’en-tête X-API-Key ou de l’ancien x-qwairy-token, et le secret affiché une seule fois.
  • Le Drain réussit mais Qwairy reste en attente : vérifiez que les sources de production Static et Runtime sont sélectionnées, puis envoyez une requête GET ou HEAD récente avec un User-Agent de crawler reconnu vers le nom d’hôte configuré pour la marque.
  • Les comptes sont inférieurs aux logs Vercel : vérifiez les règles d’échantillonnage, l’environnement et les sources sélectionnés, les règles d’exclusion de Qwairy et les alertes de continuité de livraison.
  • Les comptes diffèrent de l’ensemble du trafic : seules les requêtes classées comme crawlers d’IA entrent dans Analytics des crawlers ; les autres lignes sont volontairement écartées.
  • Les erreurs de livraison persistent après une rotation : vérifiez que le Drain utilise la clé de remplacement avant de supprimer l’ancienne.

​
Page associée