> 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/cloudflare-logpush-agent-analytics.md).

# Cloudflare Logpush

Ce guide vous explique comment configurer Cloudflare Logpush pour diffuser les journaux de requêtes HTTP dans AirOps pour Agent Analytics.

Ce guide vous explique comment configurer Cloudflare pour diffuser vers AirOps via **Logpush**. Une fois connecté, AirOps analyse automatiquement votre trafic, classe les visites de robots IA (ChatGPT, Claude, Perplexity, Google, et plus encore) et met en avant des insights dans votre tableau de bord Agent Analytics.

Logpush est une fonctionnalité native gérée par Cloudflare qui regroupe les journaux de requêtes et les envoie vers un point de terminaison HTTP. Contrairement à [l’intégration Workers](https://docs.airops.com/docs/fr/insights/onsite/traffic/cloudflare-worker-agent-analytics.md), elle ne nécessite aucun code à déployer ou à maintenir, mais elle n’est disponible que sur le **Entreprise** plan.

{% hint style="info" %}
**Logpush ou Worker ?** Utilisez **Logpush** si vous êtes sur un abonnement Cloudflare Enterprise. C’est l’option la plus simple et ne nécessite aucun code. Si vous êtes sur un autre abonnement, utilisez la [l’intégration Cloudflare Worker](https://docs.airops.com/docs/fr/insights/onsite/traffic/cloudflare-worker-agent-analytics.md) à la place, où vous déployez et gérez un petit Worker.
{% endhint %}

***

## Prérequis

* Un **AirOps** compte actif avec Agent Analytics activé
* Un **Cloudflare** compte sur le **Entreprise** plan (Logpush est réservé à Enterprise)
* Accès administrateur à la zone Cloudflare qui héberge votre site web
* Votre **clé API de l'espace de travail**, disponible dans `Paramètres → Espace de travail`
* Votre **ID du Brand Kit**, disponible dans l'URL en naviguant vers `Contexte → Kits de marque`. L'URL prend la forme `https://app.airops.com/<YOUR_WORKSPACE_SLUG>/data/brand_kits/<YOUR_BRAND_KIT_ID>`

***

## Configuration du tableau de bord

La configuration du tableau de bord est la **recommandée** méthode pour la plupart des sites web. Logpush met en mémoire tampon les événements de journal par requête et les envoie à AirOps par lots compressés selon son propre rythme.

### Étape 1 : Créer une tâche Logpush

1. Ouvrez le **tableau de bord Cloudflare** et sélectionnez le domaine qui héberge votre site web. Les tâches Logpush sont spécifiques à un domaine, vous devez donc vous trouver dans le domaine spécifique (zone) que vous souhaitez suivre, et non dans la vue au niveau du compte.
2. Dans la navigation de gauche, développez **Investigate** et sélectionnez **Logpush**.
3. Cliquez sur **Créer une tâche Logpush**.
4. Pour l’ensemble de données, sélectionnez **Requêtes HTTP**.

### Étape 2 : Sélectionner les champs du journal

Sélectionnez les champs suivants. AirOps les utilise pour des analyses complètes, et l’envoi de champs supplémentaires est sans danger.

| Champ                    | Obligatoire |
| ------------------------ | ----------- |
| `EdgeStartTimestamp`     | Oui         |
| `EdgeEndTimestamp`       | Oui         |
| `EdgeResponseStatus`     | Oui         |
| `EdgeResponseBytes`      | Oui         |
| `ClientRequestMethod`    | Oui         |
| `ClientRequestScheme`    | Oui         |
| `ClientRequestHost`      | Oui         |
| `ClientRequestURI`       | Oui         |
| `ClientRequestUserAgent` | Oui         |
| `ClientRequestReferer`   | Oui         |
| `ClientCountry`          | Oui         |
| `ClientDeviceType`       | Oui         |

### Étape 3 : Configurer la destination HTTP

Définissez le type de destination sur **destination HTTP** et saisissez le point de terminaison d’ingestion AirOps comme URL de destination. La clé API de votre espace de travail est transmise comme en-tête de requête personnalisé.

| Paramètre              | Valeur                                                                                                                     |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **URL de destination** | `https://ingest.airops.com/api/v1/cloudflare-logpush/<YOUR_BRAND_KIT_ID>/ingest?header_X-API-Key=<YOUR_WORKSPACE_API_KEY>` |

{% hint style="info" %}
Cloudflare ajoute les en-têtes de requête personnalisés sous forme de paramètres de requête au format `header_<Name>=<Value>`. Le `header_X-API-Key=<YOUR_WORKSPACE_API_KEY>` paramètre est la manière dont Cloudflare envoie la clé API de votre espace de travail AirOps à chaque livraison.
{% endhint %}

### Étape 4 : terminer le défi de propriété

Avant que la tâche puisse être créée, Cloudflare vérifie que vous êtes propriétaire de la destination. Cloudflare envoie par POST un jeton de propriété à l’URL de destination. Récupérez ce jeton et collez-le à nouveau dans le tableau de bord Cloudflare pour terminer la vérification.

### Étape 5 : Activer la tâche

1. Vérifiez la configuration de la tâche.
2. Activez la tâche pour commencer à envoyer les journaux.

### Étape 6 : vérifier la connexion

Après l’activation de la tâche Logpush, les données devraient commencer à arriver en **quelques minutes** (Logpush regroupe les données par lots avant l’envoi).

1. Dans **tableau de bord Cloudflare**, vérifiez l’état de livraison de la tâche Logpush. Une livraison réussie récente signifie que les données atteignent AirOps.
2. Dans votre **tableau de bord AirOps**, accédez à **Agent Analytics**. La source Cloudflare passe à l’état connecté, et le trafic des robots s’affiche une fois que les crawlers accèdent à votre site.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-69321eb24d64bd25d0f457853c28502b3339fff2%2Fagent-logpush-01-setup-panel.png?alt=media" alt="Set up Agent Analytics source picker listing CloudFront, Vercel, Cloudflare Worker, and Netlify, with no Cloudflare Logpush option"><figcaption><p>Cloudflare Logpush n’apparaît pas dans le sélecteur de source actuel d’Agent Analytics.</p></figcaption></figure>

***

## Configuration de l’API

Vous pouvez également créer la tâche Logpush par programmation à l’aide de l’API Cloudflare. C’est utile pour les scripts ou pour gérer de nombreuses zones. Vous aurez besoin d’un jeton d’API Cloudflare avec l’ **Logs Edit** autorisation et de votre **ID de zone**.

```bash
curl --request POST \
  "https://api.cloudflare.com/client/v4/zones/<YOUR_ZONE_ID>/logpush/jobs" \\
  --header "Authorization: Bearer <YOUR_CLOUDFLARE_API_TOKEN>" \\
  --header "Content-Type: application/json" \\
  --data '{
    "name": "airops-log-collector",
    "dataset": "http_requests",
    "destination_conf": "https://ingest.airops.com/api/v1/cloudflare-logpush/<YOUR_BRAND_KIT_ID>/ingest?header_X-API-Key=<YOUR_WORKSPACE_API_KEY>",
    "output_options": {
      "field_names": [
        "EdgeStartTimestamp",
        "EdgeEndTimestamp",
        "EdgeResponseStatus",
        "EdgeResponseBytes",
        "ClientRequestMethod",
        "ClientRequestScheme",
        "ClientRequestHost",
        "ClientRequestURI",
        "ClientRequestUserAgent",
        "ClientRequestReferer",
        "ClientCountry",
        "ClientDeviceType"
      ],
      "timestamp_format": "rfc3339"
    },
    "enabled": true
  }'
```

{% hint style="info" %}
La `<YOUR_WORKSPACE_API_KEY>` transmis dans le `destination_conf` doit avoir la même valeur que votre clé API d’espace de travail, disponible dans `Paramètres → Espace de travail`. Lorsque vous créez la tâche via l’API, Cloudflare exige toujours l’étape du défi de propriété décrite ci-dessus avant le début des livraisons.
{% endhint %}

***

## À quoi s’attendre après la configuration

* Les journaux commencent à atteindre le **destination HTTP** que vous avez configuré dans **quelques minutes**. Logpush regroupe les événements de journal par lots selon son propre rythme avant de les livrer. Il s’agit du délai de livraison vers ce point de terminaison, et non du moment où le trafic apparaît dans votre tableau de bord.
* Agent Analytics affiche **uniquement le trafic des robots IA et des crawlers**. La navigation humaine n’est pas affichée.
* Un brand kit apparaît comme configuré une fois que Logpush a livré son premier lot. Les pages spécifiques apparaissent lorsqu’un bot explore une page suivie.

***

## Si vous ne voyez pas de données

| Symptôme                                                                    | Cause probable                                                | Correction                                                                                                                                 |
| --------------------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| La tâche Cloudflare affiche des erreurs de livraison / des réponses non-2xx | L’URL de destination ou l’authentification est mal configurée | Vérifiez à nouveau l’ID du Brand Kit dans l’URL et confirmez `?header_X-API-Key=` est votre clé API actuelle de l’espace de travail AirOps |
| Cloudflare affiche `401` / `403` des réponses                               | Clé erronée ou renouvelée, ou mauvais espace de travail       | Vérifiez que la clé API est actuelle et que le Brand Kit appartient à cet espace de travail                                                |
| Livraison réussie, mais Agent Analytics est vide                            | Attendu : seul le trafic des robots est affiché               | Attendez qu’un crawler visite le site ; les visites humaines ne sont pas affichées                                                         |
| Les premières lignes de robots ne sont pas encore apparues                  | Période d’exploration                                         | Les premières lignes visibles apparaissent lors de la prochaine visite d’un crawler, ce qui dépend de la fréquence d’exploration           |

Si vous êtes toujours bloqué, contactez l’assistance AirOps avec votre **ID du Brand Kit** et l’état de livraison de la tâche Logpush **état de livraison**.

***

## Arrêt ou déconnexion

Pour arrêter l’envoi des données à AirOps, désactivez ou supprimez la tâche Logpush dans le tableau de bord Cloudflare. La rotation de votre clé API d’espace de travail AirOps arrête également la livraison, car Cloudflare continuera d’envoyer l’ancienne clé.

***

## Ce qu'AirOps suit

Une fois connecté, AirOps :

* **Ingestion de vos journaux de requêtes Cloudflare** via Logpush
* **Classe le trafic des robots IA**: identifie les visites provenant de ChatGPT, Claude, Google, Perplexity, Gemini, Meta, Apple, Bing, ByteDance, Common Crawl et d’autres
* **Catégorise le comportement d'exploration** : distingue les robots d'entraînement IA, les récupérations de recherche IA, l'indexation IA et la navigation IA initiée par l'utilisateur
* **Met en avant des analyses**: répartitions du trafic des robots IA et des crawlers et tendances d’exploration 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/cloudflare-logpush-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.
