> 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/fr/insights/onsite/traffic/netlify-agent-analytics.md).

# Netlify

Connectez votre site Netlify à AirOps pour suivre le trafic des bots IA via Netlify Log Drains.

Connectez votre site Netlify à AirOps pour suivre le trafic des bots IA. Vous ajoutez un **Drain de logs Netlify** qui diffuse les journaux de trafic edge vers AirOps, lequel classe les visites de bots IA (ChatGPT, Claude, Perplexity, Google, et plus encore) et fait ressortir des insights dans votre tableau de bord Agent Analytics.

La configuration est une étape manuelle unique dans le tableau de bord Netlify. Les Log Drains sont une **Netlify Enterprise** . Aucun tag de site ni script côté client n'est requis.

***

## Prérequis

* Un **AirOps** compte actif avec Agent Analytics activé
* Un **Netlify Enterprise** compte (les Log Drains ne sont pas disponibles sur les offres Free, Personal ou Pro)
* Un **site Netlify** diffusant votre site web
* Un **Brand Kit** dans AirOps pour ce site. Définissez son URL de marque sur le domaine de votre site afin que les répartitions au niveau des pages fonctionnent (configurable sous Context > Brand Kits > Brand URL)

Si vous n'êtes pas sûr que votre kit de marque soit correctement configuré, vérifiez avec votre contact Customer Success chez AirOps avant de configurer le drain.

***

## Étape 1 : obtenez votre point de terminaison et votre jeton AirOps

Dans AirOps, ouvrez **Insights → Sur site → Analytics des agents**, cliquez sur **Configurez Agent Analytics** et choisissez **Netlify**. Le panneau affiche les deux valeurs dont vous avez besoin :

* le **l'URL du point de terminaison d'ingestion** pour votre kit de marque
* votre **jeton API de l'espace de travail**, masqué par défaut. Cliquez sur **Afficher** pour le révéler, ou **Copier** pour le copier directement dans votre presse-papiers.

Le jeton est la `valeur Authorization: Bearer` à l'étape 2.

{% hint style="info" %}
Si le jeton n'est pas affiché, votre rôle n'a pas accès à la clé API de l'espace de travail. Demandez à un administrateur de l'espace de travail.

Vous pouvez aussi assembler le point de terminaison vous-même : `https://ingest.airops.com/api/v1/netlify/<YOUR_BRAND_KIT_ID>/ingest`. Votre Brand Kit ID se trouve dans l'URL sous Context > Brand Kits, sous la forme `https://app.airops.com/<YOUR_WORKSPACE_SLUG>/data/brand_kits/<YOUR_BRAND_KIT_ID>`. Le jeton se trouve aussi sous Settings > Workspace.
{% endhint %}

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5368cd65ba16a0cb5b6fe548d7e1ec5ee4e272a4%2Fagent-netlify-01-setup-panel.png?alt=media" alt="Set up Agent Analytics panel for Netlify with the ingest endpoint URL and workspace API token to copy"><figcaption><p>Copiez les valeurs AirOps pour la configuration Netlify.</p></figcaption></figure>

## Étape 2 : ajoutez un Log Drain dans Netlify

Dans Netlify, allez dans **Logs & Metrics > Log Drains > Add log drain**, puis :

1. **Service :** Point de terminaison HTTP générique
2. **Types de logs :** Trafic uniquement (laissez désactivés les logs function, edge, deploy et firewall)
3. **Format :** NDJSON
4. **URL du point de terminaison :** le point de terminaison AirOps de l'étape 1
5. **En-tête :** ajoutez `Authorization: Bearer <your token>`
6. **Exclure les données personnelles :** laissez cette option **désactivée** (voir l'avertissement ci-dessous)
7. Cliquez sur **Connecter** pour enregistrer le drain.

{% hint style="warning" %}
Laissez **"Exclure les données personnelles" désactivé**. L'option d'exclusion des données personnelles de Netlify supprime le User-Agent et l'adresse IP du client des journaux de trafic. AirOps identifie les agents IA à partir du User-Agent ; avec les données personnelles exclues, aucun trafic de bot ne peut être classé et votre tableau de bord reste vide. Laissez cette option désactivée pour Agent Analytics.
{% endhint %}

## Étape 3 : Vérifiez la connexion

De retour dans AirOps, rouvrez **Configurez Agent Analytics** et choisissez **Netlify** , puis cliquez sur **J'ai configuré cela**. Netlify affiche maintenant un badge vert **Connecté** dans la liste des sources.

Votre drain est actif dès que Netlify l'accepte, et le trafic apparaît dans le tableau de bord au fur et à mesure que les agents IA explorent vos pages suivies.

{% hint style="info" %}
Testez avec un chemin réel existant sur votre site. Les requêtes vers des pages inexistantes peuvent être servies depuis le cache edge de Netlify sans atteindre le drain, donc un test en 404 ne produira pas de données. Vérifiez aussi que le type de log du drain est réglé sur **Trafic**.
{% endhint %}

***

## Dépannage

| Symptôme                                                                         | Cause probable                                                                             | Correction                                                                                                                                                |
| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Impossible de voir le **J'ai configuré cela** bouton                             | Votre rôle ne peut pas modifier les kits de marque                                         | Demandez à un administrateur de l'espace de travail de confirmer la connexion pour vous.                                                                  |
| Drain enregistré dans Netlify mais aucune donnée n'apparaît dans Agent Analytics | Aucun bot IA n'a encore visité le site, ou « Exclure les données personnelles » est activé | Confirmez qu'un trafic réel atteint le site, et désactivez « Exclure les données personnelles » sur le drain.                                             |
| Le trafic brut apparaît mais rien n'est classé                                   | « Exclure les données personnelles » est activé, donc le User-Agent est absent             | Modifiez le drain dans Netlify et désactivez l'exclusion des données personnelles. AirOps a besoin du User-Agent pour identifier les bots.                |
| Les données au niveau des pages sont absentes dans Page360                       | Le domaine de votre kit de marque ne correspond pas au site                                | Dans AirOps, ouvrez les paramètres du Brand Kit et confirmez que l'URL de marque correspond au domaine servi par votre site Netlify.                      |
| Drain configuré mais aucune ligne après quelques minutes                         | Vous avez testé un chemin qui renvoie une 404, ou le type de log n'est pas Trafic          | Visitez un chemin valide connu qui existe dans votre déploiement, et confirmez que le type de log du drain est **Trafic** (pas uniquement function/edge). |
| Impossible de trouver Log Drains dans Netlify                                    | Votre équipe n'est pas sur une offre Enterprise                                            | Les Log Drains nécessitent **Netlify Enterprise**. Passez à une offre supérieure avant de configurer.                                                     |

***

## Exigences de plan

Les Log Drains Netlify sont disponibles uniquement sur l'offre **Netlify Enterprise** . Free, Personal et Pro ne peuvent pas créer de drains ; votre équipe doit disposer d'Enterprise avant de configurer cela.

Netlify ne publie pas de frais distincts par Go pour l'egress des Log Drains ; tout coût lié aux données fait partie de votre contrat Netlify Enterprise. Pour réduire le volume, laissez le drain **journaux de trafic uniquement**.

***

## Configuration de sécurité et de moindre privilège

### Autorisations requises pour configurer

**Sur Netlify :** un membre de l'équipe capable de gérer les Log Drains sur votre équipe Enterprise peut ajouter le drain.

**Sur AirOps :** l'utilisateur doit être connecté à AirOps et membre de l'espace de travail cible ; n'importe quel rôle AirOps convient.

### Authentification à l’exécution

Aucune session utilisateur n'est impliquée dans la livraison d'un drain. Chaque livraison s'authentifie avec un **jeton Bearer** dans l’en-tête `Authorization` en-tête, qui correspond à votre **clé API AirOps de votre espace de travail**, saisi dans la configuration du drain lors de la mise en place. Le jeton est au niveau de l'espace de travail, pas de l'utilisateur. Il n'y a pas de secret de signature séparé à gérer.

### 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 Netlify utilise l'ancien jeton dans son `Authorization` en-tête sortant. Après rotation, mettez à jour l'en-tête du drain dans Netlify avec le nouveau jeton, sinon les livraisons commenceront à échouer lors de l'authentification.
* La même clé API de l'espace de travail authentifie les autres API AirOps (API publique, serveur MCP, SDK). La faire tourner les affecte toutes, pas seulement Netlify.

### Ce que cette intégration ne fait pas

* Il ne reçoit que les journaux de trafic que le drain envoie. Il n'a aucun accès à votre compte Netlify, aux variables d'environnement, aux journaux de build ou aux déploiements.
* Il n'écrit rien dans votre compte Netlify. Après la configuration, AirOps ne reçoit que les données du drain.

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 Netlify :

1. Dans Netlify, ouvrez **Logs & Metrics > Log Drains** et supprimez le drain AirOps.
2. Dans AirOps, déconnectez **Netlify** du sélecteur de source de données.

Vos données historiques Netlify restent dans AirOps après la déconnexion. Pour reprendre le suivi, configurez à nouveau le drain.

***

## Ce qu'AirOps suit

Une fois connecté, AirOps :

* **Ingère toutes les requêtes servies par Netlify** transportées dans les journaux de trafic : 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 crawlers d'entraînement IA (GPTBot, ClaudeBot, etc.), les requêtes 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


---

# 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/fr/insights/onsite/traffic/netlify-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.
