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.
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 travailVotre ID du Brand Kit, disponible dans l'URL en naviguant vers
Contexte → Kits de marque. L'URL prend la formehttps://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.
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.
É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

É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.
Générez un peu de trafic vers votre site web.
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.
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.
É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
É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.
Générez un peu de trafic vers votre site web.
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 ?