Aller au contenu
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cloudflare Worker

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

Ce guide vous explique comment configurer Cloudflare pour diffuser vers AirOps via Workers. 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 ou Worker ? Si vous êtes sur un forfait Cloudflare Enterprise, nous recommandons Cloudflare Logpush à la place. C'est l'option la plus simple et ne nécessite aucun code. Utilisez Workers lorsque Logpush n'est pas disponible, par exemple sur les forfaits non Enterprise.


Prérequis

  • Un AirOps compte actif avec Agent Analytics activé

  • Un Cloudflare compte Cloudflare qui sert votre site web et qui est soit au niveau Enterprise, soit dispose de l'option complémentaire Workers Paid

  • Une machine de développement avec Node.js installé

  • 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>


Regroupement avec Workers

L'intégration de regroupement est l' recommandée approche recommandée pour la plupart des sites web. Elle utilise une Cloudflare Queue pour mettre en mémoire tampon les événements de journal par requête et les envoyer à AirOps par lots, vous maintenant bien en dessous de la limite de débit AirOps même en cas de trafic élevé.

Étape 1 : initialiser le Worker Cloudflare

Pour ce processus, nous utiliserons la version 2.68.2 de la CLI Cloudflare. D'autres versions mineures peuvent fonctionner, mais il peut y avoir des différences dans les invites de la CLI.

Selon votre environnement de développement, vous devrez peut-être installer manuellement les paquets Node suivants : node-addon-api, node-gyp, et sharp.

Définissez le répertoire sur airops-log-collector.

Définissez l'exemple de départ sur exemple Hello World.

Définissez le modèle sur Worker consommateur et producteur de file d'attente.

Définissez la langue sur TypeScript.

Choisissez Oui pour utiliser git pour le contrôle de version.

Choisissez Non pour déployer votre application (nous le ferons plus tard).

Étape 2 : configurer la route du Worker Cloudflare

Modifiez le wrangler.json fichier et configurez votre motif, zone_name, liaisons de file d'attente et AIROPS_API_URL.

La motif doit être votre domaine réel ou l'URL du site cible, tandis que le zone_name doit être le domaine canonique. Par exemple, si votre site cible est https://blog.example.com, le motif doit être blog.example.com et votre zone_name doit être example.com.

Étape 3 : configurer le code du Worker Cloudflare

Remplacez le contenu du src/index.ts fichier par le code suivant.

Étape 4 : configurer la clé API AirOps

Votre AIROPS_API_KEY doit être définie sur la même valeur que votre clé API d'espace de travail, disponible dans Paramètres → Espace de travail.

Set up Agent Analytics panel for Cloudflare Worker with the ingest endpoint URL and workspace API token to copy
Copiez les valeurs AirOps pour la configuration du Worker Cloudflare.

Étape 5 : créer la file d'attente Cloudflare

Étape 6 : déployer le Worker Cloudflare

Étape 7 : vérifier la connexion

Après le déploiement du Worker Cloudflare, les données devraient commencer à circuler dans les 2 à 5 minutes.

  1. Générez un peu de trafic vers votre site web.

  2. Dans votre tableau de bord AirOps, accédez à Agent Analytics. Les données de trafic devraient apparaître sous peu.


Workers alternatif

L'approche d'intégration alternative envoie un événement à AirOps à chaque visite de page. Elle convient mieux aux sites web ayant moins de visites afin d'éviter de dépasser les limites de débit et n'est donc pas recommandée pour la plupart des sites web.

Étape 1 : initialiser le Worker Cloudflare

Pour ce processus, nous utiliserons la version 2.68.2 de la CLI Cloudflare. D'autres versions mineures peuvent fonctionner, mais il peut y avoir des différences dans les invites de la CLI.

Selon votre environnement de développement, vous devrez peut-être installer manuellement les paquets Node suivants : node-addon-api, node-gyp, et sharp.

Définissez le répertoire sur airops-log-collector.

Définissez l'exemple de départ sur exemple Hello World.

Définissez le modèle sur Worker uniquement.

Définissez la langue sur TypeScript.

Choisissez Oui pour utiliser git pour le contrôle de version.

Choisissez Non pour déployer votre application (nous le ferons plus tard).

Étape 2 : configurer la route du Worker Cloudflare

Modifiez le wrangler.json fichier et configurez votre motif, zone_name, et AIROPS_API_URL.

La motif doit être votre domaine réel ou l'URL du site cible, tandis que le zone_name doit être le domaine canonique. Par exemple, si votre site cible est https://blog.example.com, le motif doit être blog.example.com et votre zone_name doit être example.com.

Étape 3 : configurer le code du Worker Cloudflare

Remplacez le contenu du src/index.ts fichier par le code suivant.

Étape 4 : configurer la clé API AirOps

Votre AIROPS_API_KEY doit être définie sur la même valeur que votre clé API d'espace de travail, disponible dans Paramètres → Espace de travail.

Étape 5 : déployer le Worker Cloudflare

Étape 6 : vérifier la connexion

Après le déploiement du Worker Cloudflare, les données devraient commencer à circuler dans les 2 à 5 minutes.

  1. Générez un peu de trafic vers votre site web.

  2. Dans votre tableau de bord AirOps, accédez à Agent Analytics. Les données de trafic devraient apparaître sous peu.


Limites de débit

L'ingesteur AirOps applique une limite de débit de 5 requêtes par minute et par clé API. Le Worker en temps réel envoie une requête par visite de page, donc cette option convient mieux aux sites à faible trafic. Pour les sites à fort trafic, regroupez les requêtes ou utilisez une option d'ingestion tamponnée.


Ce qu'AirOps suit

Une fois connecté, AirOps :

  • Ingeste toutes les requêtes Cloudflare : pages vues, ressources et appels API

  • Classe le trafic des robots IA : identifie les visites provenant de ChatGPT, Claude, Google, Perplexity, 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, ratios robots/humains et tendances d'exploration dans votre tableau de bord

Mis à jour

Ce contenu vous a-t-il été utile ?