La configurazione dei log Cloudflare AI Gateway deve partire dalle prove necessarie al gruppo e dai contenuti da non conservare. Una dashboard rende visibili le richieste ma può creare un nuovo archivio di prompt, risposte e metadati. L’impostazione corretta dipende sia dall’uso operativo sia dal contratto di logging attuale dell’account.
Stabilisci se il gateway usi l’attuale sistema Workers Logs o Legacy Logs, poi configura deliberatamente raccolta e conservazione dei payload. Verifica il percorso reale con marcatori sintetici e ispeziona i record risultanti. Conserva metadati utili dove opportuno, senza presumere che disattivare i payload elimini dati da ogni altro sistema.
Immagina un assistente di supporto con corrispondenza dei clienti nei prompt. I tecnici devono diagnosticare guasti dei fornitori e attribuire i consumi. Non richiedono necessariamente copie integrali della corrispondenza in un archivio diagnostico generale. È un problema di configurazione e prove, non un motivo per rinunciare all’osservabilità.
La guida si concentra su una configurazione operativa proposta. Non certifica conformità legale e non presume prezzi, conservazione ed esportazioni identici per ogni account.
La configurazione dei log Cloudflare AI Gateway dipende dall’idoneità
L’attuale documentazione del logging distingue i clienti secondo la creazione del primo gateway. Chi crea il primo gateway dal 24 settembre 2026 segue prezzi e conservazione di Workers Logs; i clienti precedenti usano Legacy Logs. Verifica il caso dell’account configurato.
Non importare periodi di conservazione o quote di log da vecchi articoli applicandoli a ogni distribuzione. Registra accordo applicabile, impostazioni e data della verifica. Ricontrolla quando cambiano l’account o l’architettura di logging.
La stessa documentazione separa raccolta dell’intero record e conservazione dei payload di richiesta e risposta. Permette una discussione più precisa di una semplice scelta tra logging attivo o disattivo.
| Decisione | Domanda da risolvere |
|---|---|
| Sistema di logging | Quale contratto corrente o legacy si applica? |
| Raccolta dell’intera voce | Serve un record diagnostico per questa classe? |
| Payload | È necessario conservare prompt e risposta? |
| Accesso | Chi può ispezionare o esportare? |
| Conservazione | Quando scadono copie primarie ed esportate? |
Definire prima le domande sugli incidenti
Scrivi che cosa deve capire l’operatore: quale carico è fallito, quale fornitore e percorso del modello siano stati usati, se l’applicazione abbia riprovato, se la risposta sia arrivata prima che l’utente smettesse di aspettare e se l’attività resti irrisolta.
Molte domande richiedono solo metadati delimitati e riferimenti applicativi, non sempre il prompt intero. Un’indagine sulla qualità può invece richiedere un campione esplicitamente controllato che i metadati generali non spiegano.
Separa questi usi. La diagnostica ordinaria può seguire una politica mentre un’indagine autorizzata usa un processo probatorio distinto e revisionato. Non conservare ogni testo per sempre perché potrebbe un giorno riprodurre un difetto.
La nostra guida ad AI Gateway tratta proxy e controllo dei costi. Qui occorre stabilire quali prove esistano davvero e dimostrare il comportamento di raccolta scelto.
Configurare separatamente voce intera e payload
Cloudflare documenta cf-aig-collect-log per l’intera voce e cf-aig-collect-log-payload per i corpi di richiesta e risposta. Il controllo dei payload a false può mantenere metadati senza corpi grezzi; disabilitare l’intera voce sopprime anche i metadati. Leggi la semantica attuale delle intestazioni prima di applicarle.
Questa è una politica illustrativa delle intestazioni, non una richiesta completa o prova del risultato distribuito:
1cf-aig-collect-log-payload: false
Applica la politica in un componente attendibile. Un chiamante non attendibile non deve poter cambiare le prove aziendali iniettando intestazioni arbitrarie di controllo del gateway. Decidi quali vengano inoltrate, impostate o rimosse dal server.
Non dedurre valori predefiniti da una sola richiesta riuscita. Verifica separatamente impostazione generale e override della richiesta. Una configurazione valida per il percorso principale può comportarsi diversamente attraverso ripiego o client alternativi.
Registrare la politica effettiva
Versiona la configurazione applicativa e registra le impostazioni pertinenti del gateway. Descrivi quali classi conservino payload, quali soltanto metadati e quali sopprimano la raccolta.
Quando si aggiunge un’altra integrazione, la revisione deve includere il percorso dei log. Altrimenti si accumulano percorsi con conservazioni differenti mentre il gruppo crede in un’unica politica globale.
Evitare che i metadati diventino un altro payload
Riferimenti opachi delle attività e delle richieste possono collegare le prove del gateway ai record dell’applicazione. L’identificatore del caso può bastare per trovare la fonte nel modello di accesso esistente. Copiare l’oggetto del messaggio o l’indirizzo e-mail del cliente in un campo dei metadati può vanificare il motivo per cui i corpi dei prompt sono stati esclusi.
Definisci uno schema consentito e verifica valori oltre ai nomi dei campi. Un campo label può ancora contenere dati personali o riservati se viene riempito con testo dell’utente.
| Scelta | Uso operativo | Attenzione nella revisione |
|---|---|---|
| Identificatore opaco del carico | Attribuire consumi a una funzione | Evitare contenuti del cliente |
| Riferimento dell’operazione | Collegare incidente e attività | Accesso al record ancora controllato |
| Revisione della configurazione | Riprodurre il percorso effettivo | Nessun segreto nel valore |
| Categoria di guasto | Raggruppare problemi gestibili | Evitare eccezioni grezze con contenuti sorgenti |
Mantieni coerenti i riferimenti per l’indagine. L’operatore deve tracciare il guasto senza copiare prompt interi tra strumenti o concedere a ogni tecnico accesso al sistema cliente.
Verificare la raccolta con marcatori sintetici
Invia una richiesta non sensibile con un marcatore distintivo. Ispeziona la destinazione dei log e verifica la presenza del marcatore in payload, metadati, esportazioni o log applicativi secondo la politica.
Prova risposta normale, errore a monte e ripiego se utilizzato. Nella gestione degli errori è frequente copiare corpi in campi diagnostici esterni al normale percorso.
| Prova | Evidenza attesa con soli metadati |
|---|---|
| Inferenza normale | Metadati utili senza marcatore del corpo |
| Errore del fornitore | Categoria e correlazione senza payload copiato |
| Nuovo tentativo applicativo | Tentativi collegabili senza contenuto nelle etichette |
| Richiesta non autorizzata | Rifiuto secondo i permessi del gateway |
| Esportazione o destinazione a valle | Contenuti e conservazione seguono l’accordo |
La documentazione del gateway autenticato è il riferimento per quel controllo. Verifica credenziale e percorso reali, senza presumere che l’impostazione dei log protegga anche l’endpoint.
Includere esportazioni e altri archivi
Sopprimere i payload non prova che applicazione, fornitore o osservabilità esterna non conservino nulla. Disegna il percorso reale e rivedi ogni archivio secondo il suo contratto.
Per i log esportati documenta chi legga la destinazione e quando scadano le copie. Eliminare un record da un servizio non prova la rimozione di esportazioni precedenti. Il manuale deve attribuire a ogni sistema le sue prove.
Rivedi anche tracce, monitoraggio delle eccezioni e schermate di assistenza. Il gruppo può configurare correttamente il gateway e poi incollare un prompt in un ticket visibile a più persone.
Usa casi sintetici per le regressioni ordinarie. Se servono contenuti reali, stabilisci finalità specifica e accessi controllati senza cambiare la politica generale senza registrarlo.
Prevedere prove utili e manutenzione
Il costo include revisione del percorso dati, collegamento delle politiche, schema dei metadati, accessi e verifica. I costi ricorrenti dipendono da accordo di logging, volume e archivi a valle: verifica le tariffe attuali dell’account.
Chiedi una proposta in GBP che identifichi sistema e prove da consegnare. Configurare un’opzione è diverso da ricostruire i log applicativi su più percorsi ed esportazioni.
Il passaggio di consegne deve includere la politica effettiva, le responsabilità, i risultati delle prove sintetiche e la procedura per indagare le prove mancanti. Includi modifiche che richiedano nuove verifiche, soprattutto client, percorsi o destinazioni aggiuntivi.
Possiamo rivedere il confine in un progetto pilota di integrazione IA delimitato . Richiedi una valutazione dei log del gateway con idoneità dell’account, percorsi, destinazioni e domande sugli incidenti. L’osservabilità diventa utile senza raccogliere contenuti solo perché il valore predefinito lo permette.
Domande frequenti
Tutti gli account AI Gateway usano lo stesso logging? No. La documentazione distingue il primo gateway creato dal 24 settembre 2026 dai clienti precedenti. Verifica se si applichino Workers Logs o Legacy Logs prima di basarti su prezzi o conservazione.
Possiamo conservare metadati senza prompt e risposte? Il controllo documentato dei payload supporta voci con soli metadati se configurato adeguatamente. Verifica politica generale e per richiesta e ispeziona i risultati nella destinazione effettiva.
Qual è la differenza tra le due intestazioni? Il controllo dell’intera voce decide se raccoglierla. Quello dei payload decide la conservazione dei corpi grezzi mentre i metadati possono restare. Disabilitare la voce elimina anche questi: scegli dalle prove necessarie.
Sopprimere payload significa che nessuno conserva i dati? No. Log applicativi, fornitori, esportazioni e strumenti hanno comportamenti e contratti propri. Rivedi il percorso completo senza considerare un’impostazione garanzia universale.
Come verificare senza dati dei clienti? Usa marcatori sintetici in richieste non sensibili e ispeziona record ed esportazioni. Includi risultati normali, errori, tentativi e ripiego. Conferma che i metadati non contengano indirettamente il marcatore.
I client devono scegliere la politica dei log? Solo se tale autorità è intenzionale. Applica la politica in un server attendibile e definisci intestazioni accettate o sovrascritte. Un chiamante ordinario non deve cambiarla silenziosamente.
Che cosa deve consegnare una valutazione? La valutazione deve identificare il contratto applicabile, gli archivi dei dati, la politica effettiva di raccolta, i responsabili degli accessi e le decisioni di conservazione. Includi risultati sintetici e procedura ripetibile per controllare nuovi percorsi o destinazioni.