Skip to main content
Utilisez un log drain Netlify General HTTP pour envoyer les enregistrements de trafic du site à Analytics des crawlers.

​
Avant de commencer

Il vous faut :
  • un compte Netlify Enterprise autorisé à configurer le site cible ;
  • un site 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 Netlify.
  2. Sélectionnez Créer une clé.
  3. Saisissez un nom et le fuseau horaire IANA utilisé pour les instantanés quotidiens.
  4. Copiez le secret lorsqu’il apparaît. Qwairy n’en affiche ensuite que le préfixe.
  5. Conservez le secret dans le réglage d’autorisation de Netlify. Ne l’ajoutez ni à la chaîne de requête du point de terminaison, ni au gestionnaire de code source, ni à du code exécuté dans le navigateur.
Pour une rotation, créez une clé de remplacement, mettez à jour la valeur d’autorisation dans Netlify, confirmez la livraison, puis supprimez l’ancienne clé. Une intégration peut avoir jusqu’à cinq clés actives.

​
Configurer le log drain

  1. Dans le site Netlify cible, ouvrez Logs & Metrics > Log Drains.
  2. Sélectionnez Enable a log drain et choisissez General HTTP endpoint.
  3. Sélectionnez Traffic logs. N’ajoutez pas les logs Function, Edge Function ou Deploy pour ce connecteur.
  4. Laissez Exclude personally identifiable information (PII) décoché. La classification des crawlers nécessite le champ user_agent.
  5. Définissez l’URL complète du point de terminaison sur :
  6. Définissez la valeur de l’en-tête d’autorisation sur :
  7. Choisissez JSON ou NDJSON comme Log Drain Format.
  8. Sélectionnez Connect.
Le payload de trafic de Netlify peut inclure client_ip. Qwairy ignore ce champ avant l’agrégation et ne conserve ni les payloads bruts, ni les paramètres de requête, ni les requêtes humaines. Consultez Netlify Log Drains pour la procédure actuelle du fournisseur.

​
Tester la livraison

Demandez un chemin sans risque sur le site suivi avec un User-Agent de crawler reconnu :
Vérifiez que Netlify indique une livraison réussie du drain. Dans Qwairy, le connecteur ne quitte l’état en attente qu’après l’acceptation d’une ligne de trafic contenant un nom d’hôte correspondant, un horodatage récent, une méthode GET ou HEAD, un chemin et un User-Agent de crawler reconnu.

​
Limites, filtrage et coût

  • Le drain General HTTP de Netlify envoie le flux de trafic sélectionné et ne propose pas de filtre limité aux crawlers pour cette intégration.
  • Les lignes humaines et celles au User-Agent inconnu sont écartées par Qwairy, mais elles comptent quand même dans le volume de livraison de Netlify et dans les plafonds d’entrée de Qwairy.
  • Consultez les tarifs actuels de Netlify pour les log drains et la livraison de trafic avant d’activer l’intégration sur un site à fort trafic.
  • Si l’exclusion des PII retire user_agent, Qwairy ne peut pas classer la requête et l’écarte.
  • Les plafonds quotidiens partagés par intégration et par équipe facturée sont décrits dans la présentation d’Analytics des crawlers.

​
Dépannage

  • Le drain ne parvient pas à se connecter : vérifiez l’URL HTTPS complète du point de terminaison et le préfixe Bearer devant la clé actuelle.
  • Qwairy reste en attente : vérifiez que Traffic logs est sélectionné et que l’exclusion des PII est désactivée, puis générez une requête récente avec un User-Agent de crawler reconnu.
  • Les lignes sont acceptées mais pas comptées : vérifiez que log_type vaut traffic, que le nom d’hôte de l’URL correspond à la marque, que la méthode est GET ou HEAD et que l’événement a un horodatage valide.
  • Les comptes sont inférieurs au trafic source : les lignes humaines, de recherche traditionnelle, inconnues, exclues, invalides ou hors périmètre n’entrent pas dans les agrégats de crawlers.
  • Le volume de livraison est anormalement élevé : Netlify transmet l’intégralité du flux de trafic sélectionné. Réévaluez le coût fournisseur avant de laisser le connecteur actif.

​
Page associée