> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Netlify Log Drains

> Connectez les logs de trafic Netlify à Analytics des crawlers via un log drain General HTTP.

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 :

   ```text theme={null}
   https://www.qwairy.co/api/v1/logs/netlify
   ```

6. Définissez la valeur de l’en-tête d’autorisation sur :

   ```text theme={null}
   Bearer YOUR_CRAWLER_KEY
   ```

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](https://docs.netlify.com/manage/monitoring/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 :

```bash theme={null}
curl --head --user-agent "GPTBot/1.0" "https://www.example.com/docs/crawler-check"
```

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

* [Analytics des crawlers](/fr/documentation/measure/crawler-analytics)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.