> 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 accompagne dans la configuration de Cloudflare pour diffuser vers AirOps via **Logpush**. Une fois connecté, AirOps analyse automatiquement votre trafic, classe les visites des bots 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](/docs/fr/insights/onsite/traffic/cloudflare-worker-agent-analytics.md), elle ne nécessite aucun code à déployer ni à maintenir, mais elle n'est disponible que sur le **Enterprise** forfait. {% hint style="info" %} **Logpush ou Worker ?** Utiliser **Logpush** si vous êtes sur un forfait Cloudflare Enterprise. C’est l’option la plus simple et ne nécessite aucun code. Si vous êtes sur un autre forfait, utilisez plutôt l' [intégration Cloudflare Worker](/docs/fr/insights/onsite/traffic/cloudflare-worker-agent-analytics.md) où vous déployez et maintenez un petit Worker. {% endhint %} *** ## Prérequis * Un **AirOps** compte actif avec Agent Analytics activé * Un **compte** compte sur le **Enterprise** forfait (Logpush est réservé à Enterprise) * Accès administrateur à la zone Cloudflare qui sert votre site web * Votre **clé API du Workspace**, disponible dans `Paramètres → Workspace` * Votre **ID du Brand Kit**, disponible dans l’URL en naviguant vers `Contexte → Brand Kits`. L’URL a la forme `https://app.airops.com//data/brand_kits/` *** ## Configuration via le tableau de bord La configuration via le tableau de bord est l' **approche recommandée** approche la plus adaptée à la plupart des sites web. Logpush met en tampon les événements de journal par requête et les transmet à AirOps par lots compressés selon son propre rythme. ### Étape 1 : Créez une tâche Logpush 1. Ouvrez le **tableau de bord Cloudflare** et sélectionnez le domaine qui sert 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électionnez les champs du journal Sélectionnez les champs suivants. AirOps les utilise pour des analyses complètes, et l'envoi de champs supplémentaires n'a pas d'effet négatif. | 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 : Configurez 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. Votre clé API Workspace est transmise en tant qu'en-tête de requête personnalisé. | Paramètre | Valeur | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------- | | **URL de destination** | `https://ingest.airops.com/api/v1/cloudflare-logpush//ingest?header_X-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_=`. Le `header_X-API-Key=` paramètre est la façon dont Cloudflare envoie votre clé API Workspace AirOps avec chaque livraison. {% endhint %} ### Étape 4 : Terminez le défi de propriété Avant que la tâche puisse être créée, Cloudflare vérifie que vous êtes bien 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 : Activez la tâche 1. Vérifiez la configuration de la tâche. 2. Activez la tâche pour commencer à livrer 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 avant d'envoyer). 1. Dans le **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 bots s'affiche une fois que des crawlers visitent votre site. *** ## 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 automatiser des scripts ou gérer de nombreuses zones. Vous aurez besoin d'un jeton API Cloudflare avec l' **Logs Edit** autorisation et votre **ID de zone**. ```bash curl --request POST \ "https://api.cloudflare.com/client/v4/zones//logpush/jobs" \ --header "Authorization: Bearer " \ --header "Content-Type: application/json" \ --data '{ "name": "airops-log-collector", "dataset": "http_requests", "destination_conf": "https://ingest.airops.com/api/v1/cloudflare-logpush//ingest?header_X-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 `` fourni dans le `destination_conf` doit être la même valeur que votre clé API Workspace, disponible dans `Paramètres → Workspace`. Lorsque vous créez la tâche via l'API, Cloudflare exige tout de même l'étape de défi de propriété décrite ci-dessus avant que les livraisons commencent. {% endhint %} *** ## À quoi s'attendre après la configuration * Les journaux commencent à atteindre le **destination HTTP** que vous avez configuré en **quelques minutes**. Logpush regroupe les événements de journal selon son propre rythme avant de les livrer. Il s'agit du temps de livraison vers ce point de terminaison, et non du moment où le trafic apparaît dans votre tableau de bord. * Agent Analytics affiche **le trafic des bots et des crawlers IA uniquement**. Le trafic humain n'est pas affiché. * Un brand kit apparaît comme configuré une fois que Logpush livre son premier lot. Les pages spécifiques apparaissent une fois qu'un bot explore une page suivie. *** ## Si vous ne voyez pas de données | Symptôme | Cause probable | Correctif | | --------------------------------------------------------------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | 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 | Revérifiez l'ID du Brand Kit dans l'URL et confirmez `?header_X-API-Key=` qu'il s'agit bien de votre clé API Workspace AirOps actuelle | | Cloudflare affiche des `401` / `403` réponses | Clé incorrecte ou renouvelée, ou mauvais espace de travail | Vérifiez que la clé API est à jour et que le Brand Kit appartient à cet espace de travail | | Livraison réussie mais Agent Analytics est vide | Attendu : seul le trafic des bots est affiché | Attendez qu'un crawler visite ; les visites humaines ne sont pas affichées | | Les premières lignes de bot ne sont pas encore apparues | Timing de crawl | Les premières lignes visibles apparaissent dès que le crawler effectue sa prochaine visite, ce qui dépend de la fréquence de crawl | 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**. *** ## Arrêt ou déconnexion Pour cesser d'envoyer des données à AirOps, désactivez ou supprimez la tâche Logpush dans le tableau de bord Cloudflare. Faire tourner votre clé API Workspace AirOps arrête également la livraison, car Cloudflare continuera à 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 bots IA**: identifie les visites de ChatGPT, Claude, Google, Perplexity, Gemini, Meta, Apple, Bing, ByteDance, Common Crawl et d'autres * **catégorise le comportement de crawl**: distingue les robots d’entraînement IA, les récupérations pour la recherche IA, l’indexation IA et la navigation IA initiée par l’utilisateur * **affiche des analyses**: répartition du trafic des bots IA et des crawlers, 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/cloudflare-logpush-agent-analytics.md?ask=&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.