La configuration des journaux Cloudflare AI Gateway doit partir des preuves nécessaires et du contenu à ne pas conserver. Un tableau de bord rend les requêtes visibles, mais peut créer un nouveau stockage de prompts, réponses et métadonnées. Le bon réglage dépend du besoin opérationnel et du contrat actuel du compte.
Établissez si la passerelle utilise Workers Logs ou Legacy Logs, puis configurez volontairement collecte et stockage des contenus. Testez le vrai parcours avec des marqueurs synthétiques et inspectez les traces obtenues. Gardez les métadonnées utiles si nécessaire sans supposer que désactiver les contenus les efface de tous les autres systèmes.
Imaginez un assistant de support dont les prompts incluent la correspondance client. Les ingénieurs doivent diagnostiquer les pannes fournisseurs et attribuer l’usage. Ils n’ont pas forcément besoin de recopier toute cette correspondance dans un stockage général de diagnostic. C’est un problème de configuration et de preuve, pas une raison d’abandonner l’observabilité.
Ce guide propose une installation opérationnelle. Il ne certifie pas la conformité juridique et ne suppose pas mêmes prix, conservation et exports pour tous les comptes.
La configuration des journaux Cloudflare AI Gateway dépend du régime
La documentation actuelle des journaux distingue les clients selon la création de leur première passerelle. Ceux qui la créent à partir du 24 septembre 2026 suivent tarifs et conservation Workers Logs ; les précédents utilisent Legacy Logs. Vérifiez le régime du compte configuré.
Ne transposez pas durée ou quota d’un ancien article à chaque déploiement. Consignez régime applicable, réglages choisis et date de vérification. Revérifiez après changement de compte ou d’architecture.
La même documentation distingue collecte de l’entrée entière et stockage des contenus de requête et réponse. Cela permet une discussion plus précise qu’un simple état activé ou désactivé.
| Décision | Question à résoudre |
|---|---|
| Régime | Quel contrat actuel ou historique s’applique ? |
| Collecte complète | Faut-il une trace pour cette classe de requêtes ? |
| Contenu | Faut-il conserver prompts et réponses ? |
| Accès | Qui peut examiner ou exporter ? |
| Conservation | Quand expirent copies primaires et exportées ? |
Définir d’abord les questions d’incident
Écrivez ce que l’opérateur doit savoir. Quelle charge a échoué ? Quel fournisseur et modèle ? L’application a-t-elle répété ? La réponse est-elle arrivée avant la fin d’attente utilisateur ? La tâche à destination reste-t-elle non résolue ?
Des métadonnées limitées et références d’opérations répondent à beaucoup de ces questions sans prompt complet. À l’inverse, une enquête de qualité peut nécessiter un échantillon explicitement contrôlé que les métadonnées générales n’expliquent pas.
Séparez ces usages. Les diagnostics courants suivent une politique, tandis qu’une enquête autorisée utilise un processus de preuve distinct et révisé. Ne gardez pas éternellement chaque texte client parce qu’il pourrait servir un jour.
Notre guide AI Gateway couvre proxy et contrôle des coûts. Ici, il faut établir quelles preuves existent et démontrer le comportement de collecte choisi.
Régler séparément entrée entière et contenus
Cloudflare documente cf-aig-collect-log pour l’entrée entière et cf-aig-collect-log-payload pour les contenus. Le réglage de contenu à false peut garder les métadonnées sans corps bruts ; désactiver l’entrée supprime aussi les métadonnées. Lisez la sémantique actuelle avant application.
Voici une politique d’en-tête illustrative, pas une requête complète ni une preuve du résultat déployé :
1cf-aig-collect-log-payload: false
Appliquez la politique dans un composant fiable. Un appelant non fiable ne doit pas modifier la politique de preuve en injectant des en-têtes de contrôle arbitraires. Définissez lesquels le serveur transmet, impose ou retire.
N’inférez pas une valeur par défaut d’une seule réussite. Vérifiez séparément réglage global et surcharge par requête. Une configuration correcte sur la route principale peut différer sur un repli ou un autre client.
Consigner la politique effective
Versionnez la configuration applicative et consignez les réglages de passerelle. Décrivez les classes gardant contenus, métadonnées seules ou aucune collecte.
Quand un développeur ajoute un modèle, sa voie de journalisation doit être examinée. Sinon, les routes accumulent des conservations différentes alors que l’équipe croit à une politique globale.
Éviter que les métadonnées deviennent un autre contenu
Des références opaques relient les preuves de passerelle aux dossiers applicatifs. Un identifiant de support peut suffire à retrouver la source avec les accès existants. Copier sujet ou courriel client dans les métadonnées peut annuler l’intérêt d’exclure les prompts.
Définissez un schéma autorisé. Vérifiez valeurs et noms de champs. Un label peut contenir du personnel ou confidentiel si l’application le remplit de texte utilisateur.
| Choix | Usage | Préoccupation de révision |
|---|---|---|
| Identifiant opaque de charge | Attribuer l’usage à une fonction | Ne pas intégrer de contenu client |
| Référence d’opération | Relier incident et état de tâche | Garder l’accès au dossier contrôlé |
| Révision de configuration | Reproduire la route effective | Exclure les secrets |
| Catégorie d’échec | Grouper les problèmes traitables | Éviter les exceptions brutes avec source |
Gardez les références applicatives et passerelle suffisamment cohérentes. L’opérateur doit retracer une panne sans copier des prompts entiers entre outils ni donner à chaque ingénieur accès au système client.
Vérifier la collecte avec des marqueurs synthétiques
Envoyez une requête non sensible avec un marqueur distinctif. Inspectez la destination applicable et vérifiez sa présence dans contenus, métadonnées, exports ou journaux applicatifs selon la politique.
Testez réponse normale, erreur amont et repli utilisé. Le traitement d’erreur est un lieu fréquent de copie des corps dans des champs diagnostiques hors du parcours normal.
| Test | Preuve attendue avec métadonnées seules |
|---|---|
| Inférence normale | Métadonnées utiles sans marqueur du corps |
| Erreur fournisseur | Catégorie et référence sans contenu copié |
| Nouvelle tentative | Tentatives reliées sans contenu dans les libellés |
| Requête non autorisée | Rejet selon la politique d’accès |
| Export ou destination secondaire | Politique de contenu et conservation toujours respectée |
La documentation de passerelle authentifiée est la référence d’accès. Vérifiez identifiant et route réels sans supposer que le réglage des journaux protège aussi le point d’accès.
Inclure exports et autres stockages
Supprimer le contenu dans la passerelle ne prouve aucune absence de stockage dans l’application, chez le fournisseur ou l’observabilité externe. Dessinez le trajet réel et examinez chaque stockage selon son contrat.
Pour les exports, documentez lecteurs autorisés et expiration des copies. Supprimer un enregistrement d’un service ne prouve pas l’effacement d’un export antérieur. La procédure doit indiquer quel système possède quelle preuve.
Examinez traces, suivi d’exceptions et captures de support. Une passerelle correctement configurée n’empêche pas l’équipe de coller un prompt dans un ticket plus largement visible.
Employez du synthétique pour les régressions courantes. Si le contenu réel est indispensable, définissez un but précis et des accès contrôlés plutôt que modifier la politique générale sans trace.
Budgéter preuves utiles et maintenance
La réalisation comprend revue du trajet, politique des requêtes, schéma de métadonnées, accès et vérification. Le récurrent dépend du régime, du volume et des destinations secondaires ; vérifiez les tarifs actuels avant estimation.
Demandez un devis en GBP identifiant régime de passerelle et tests livrés. Une tâche de configuration diffère d’une refonte des journaux sur plusieurs modèles et destinations d’export.
La remise doit contenir politique effective, propriétaires, tests synthétiques et procédure d’enquête sur les preuves absentes. Précisez les changements déclenchant une revérification : client, route ou destination supplémentaire notamment.
Notre pilote d’intégration IA cadré peut examiner cette frontière. Demandez une évaluation des journaux de passerelle avec régime du compte, routes, destinations et questions d’incident. L’observabilité devient utile sans collecter du contenu simplement parce qu’un défaut le permet.
Questions fréquentes
Tous les comptes AI Gateway suivent-ils le même régime ? Non. La documentation distingue la première passerelle créée à partir du 24 septembre 2026 des clients précédents. Vérifiez Workers Logs ou Legacy Logs avant toute hypothèse de prix ou conservation.
Peut-on garder les métadonnées sans prompts ni réponses ? Le contrôle de contenu documenté permet des entrées de métadonnées seules si correctement configuré. Vérifiez politique globale, par requête et résultats de test dans la vraie destination.
Quelle différence entre les deux en-têtes ? Le premier contrôle la collecte de l’entrée entière. Le second gouverne le stockage des corps bruts en laissant éventuellement les métadonnées. Désactiver l’entrée supprime aussi ses métadonnées ; choisissez selon les preuves nécessaires.
Exclure les contenus signifie-t-il qu’aucun service ne stocke les données ? Non. Application, fournisseurs, exports et outils d’observabilité ont leurs comportements et contrats. Examinez tout le trajet plutôt que considérer un réglage comme garantie universelle de conservation.
Comment tester sans données clients ? Utilisez des marqueurs synthétiques non sensibles et inspectez traces et exports. Incluez résultats normaux, erreurs, répétitions et replis. Vérifiez que les métadonnées ne contiennent pas indirectement le marqueur.
Les clients doivent-ils choisir leur politique de journaux ? Seulement si cette autorité est volontaire. Appliquez la politique dans un composant serveur fiable et définissez les en-têtes acceptés ou écrasés. Un appelant ordinaire ne doit pas la changer silencieusement.
Que doit livrer une évaluation ? Contrat applicable, stockages, politique effective, propriétaires d’accès et décisions de conservation. Ajoutez résultats synthétiques et procédure reproductible pour les nouvelles routes ou destinations.