Configurarea jurnalelor Cloudflare AI Gateway trebuie să înceapă cu dovezile necesare echipei și conținutul care nu trebuie păstrat. Un tablou de bord poate face cererile vizibile, dar poate crea și un nou depozit de prompturi, răspunsuri și metadate. Configurația corectă depinde de utilizarea operațională și contractul actual al jurnalizării contului.
Stabilește dacă gateway-ul folosește actualul sistem Workers Logs sau Legacy Logs, apoi configurează deliberat colectarea și stocarea payloadurilor. Testează traseul real cu marcatori sintetici și inspectează înregistrările rezultate. Păstrează metadate operaționale utile unde este potrivit, fără să presupui că dezactivarea payloadurilor elimină date din toate celelalte sisteme.
Imaginează-ți un asistent ale cărui prompturi includ corespondența clienților. Inginerii trebuie să diagnosticheze eșecuri ale furnizorilor și să atribuie consum. Nu au neapărat nevoie ca întreaga corespondență să fie copiată într-un depozit general de diagnostic. Este o problemă de configurație și dovezi, nu un motiv să renunți la observabilitate.
Ghidul se concentrează pe o configurație propusă. Nu oferă certificare juridică a conformității și nu presupune aceleași prețuri, retenții și exporturi pentru toate conturile.
Configurarea jurnalelor Cloudflare AI Gateway depinde de eligibilitate
Documentația actuală AI Gateway distinge clienții după crearea primului gateway. Cei care îl creează începând cu 24 septembrie 2026 urmează tarifele și retenția Workers Logs; cei anteriori folosesc Legacy Logs. Verifică eligibilitatea contului configurat.
Nu importa perioada retenției sau cota jurnalelor dintr-un articol vechi în fiecare implementare. Înregistrează sistemul aplicabil, setările și data verificării. Recontrolează la schimbarea contului sau arhitecturii.
Documentația separă colectarea întregii înregistrări de stocarea payloadurilor cererii și răspunsului. Distincția permite o discuție mai precisă decât activarea sau dezactivarea simplă.
| Decizie | Întrebare de stabilit |
|---|---|
| Sistemul jurnalizării | Ce contract actual sau legacy se aplică? |
| Întreaga înregistrare | Trebuie să existe diagnostic pentru această clasă? |
| Payloaduri | Este necesară păstrarea promptului și răspunsului? |
| Acces | Cine poate inspecta sau exporta? |
| Retenție | Când expiră copiile primare și exportate? |
Definește întâi întrebările incidentelor
Scrie întrebările operatorului. Ce sarcină a eșuat? Ce furnizor și rută de model au fost folosite? A reluat aplicația cererea? A revenit răspuns înainte ca utilizatorul să nu mai aștepte? Sarcina destinației este încă nerezolvată?
Multe întrebări pot fi rezolvate cu metadate delimitate și referințe operaționale. Nu cer întotdeauna promptul integral. Invers, investigația calității conținutului poate cere un eșantion controlat explicit pe care metadatele generale nu îl explică.
Separă utilizările. Diagnosticul obișnuit urmează o politică, investigația autorizată folosește alt proces verificat de dovezi. Nu păstra textul fiecărui client pentru totdeauna fiindcă ar putea cândva reproduce un defect.
Ghidul nostru AI Gateway acoperă rolul mai larg de proxy și control al costului. Aici trebuie stabilite dovezile existente efectiv și dovedit comportamentul colectării.
Configurează separat înregistrarea și payloadurile
Cloudflare documentează cf-aig-collect-log pentru întreaga înregistrare și cf-aig-collect-log-payload pentru payloadurile cererii și răspunsului. Valoarea false pentru payload poate păstra metadate fără corpurile brute; dezactivarea întregii înregistrări o suprimă inclusiv cu metadate. Citește semantica actuală înainte să aplici antetele.
Aceasta este o politică ilustrativă a antetului, nu o cerere completă sau dovada rezultatului implementat:
1cf-aig-collect-log-payload: false
Aplică politica într-o componentă de încredere. Un apelant care nu este de încredere nu trebuie să poată modifica politica organizației privind dovezile prin injectarea unor antete arbitrare de control al gateway-ului. Decide ce antete sunt transmise, setate sau eliminate de server.
Nu deduce valoarea implicită dintr-o singură cerere reușită. Verifică separat setarea gateway-ului și suprascrierea per cerere. Configurația bună pentru ruta principală poate diferi prin rută alternativă sau alt client.
Păstrează înregistrarea politicii efective
Versionează configurația aplicativă și înregistrează setările relevante ale gateway-ului. Descrie clasele care păstrează payload, numai metadate sau suprimă colectarea.
La adăugarea altui model, verificarea include traseul jurnalelor. Altfel aplicația acumulează rute cu retenții diferite, în timp ce echipa crede într-o politică globală unică.
Folosește metadate care nu devin alt payload
Referințele opace leagă dovezile gateway-ului de înregistrările aplicației. Identificatorul cazului poate ajunge pentru găsirea sursei sub accesul existent. Copierea subiectului ori e-mailului în metadate poate anula motivul excluderii prompturilor.
Definește o schemă permisă. Verifică valorile și numele câmpurilor. Câmpul label poate conține date personale ori confidențiale dacă aplicația îl umple cu textul utilizatorului.
| Alegere | Utilizare operațională | Atenție la verificare |
|---|---|---|
| Identificator opac al sarcinii | Atribuie consum unei funcții | Evită conținutul clientului |
| Referința operațiunii | Leagă incidentul de stare | Accesul înregistrării rămâne controlat |
| Revizia configurației | Reproduce ruta efectivă | Fără secrete în valoare |
| Categoria eșecului | Grupează probleme abordabile | Fără excepții brute cu text sursă |
Păstrează referințele suficient de coerente pentru investigație. Operatorul urmărește eșecul fără copierea integrală a prompturilor sau acces la sistemul clientului pentru fiecare inginer.
Verifică colectarea cu marcatori sintetici
Trimite o cerere de test nesensibilă cu un marcator distinctiv. Inspectează destinația jurnalelor și confirmă dacă apare în payload, metadate, exporturi sau jurnale aplicative conform politicii.
Testează răspuns normal, eroare în amonte și rută alternativă dacă se folosește. Tratarea erorilor este un loc frecvent de copiere a corpurilor în câmpuri de diagnostic în afara colectării normale.
| Test | Dovezi așteptate pentru numai metadate |
|---|---|
| Inferență normală | Metadate utile fără marcatorul corpului |
| Eroare a furnizorului | Categorie și corelare fără payload copiat |
| Reluare aplicativă | Tentative legate fără conținut duplicat în etichete |
| Cerere neautorizată | Refuz conform politicii accesului |
| Export sau destinație externă | Politica conținutului și retenției rămâne valabilă |
Documentația gateway-ului autentificat este referința controlului accesului. Verifică credențiala și ruta reale, fără să presupui că jurnalizarea protejează și endpoint-ul.
Include exporturile și celelalte depozite
Suprimarea payloadurilor nu dovedește lipsa retenției în aplicație, la furnizor sau în observabilitatea externă. Desenează traseul real și verifică fiecare depozit sub propriul contract.
Pentru exporturi, documentează cine are permisiunea de a citi destinația și când expiră acele copii. Eliminarea dintr-un serviciu nu dovedește ștergerea exportului anterior. Procedura trebuie să atribuie sistemelor dovezile lor.
Verifică și trasee, urmăritoare de excepții și capturi de asistență. Echipa poate configura corect gateway-ul, dar poate totuși lipi promptul unui client într-un tichet vizibil unui grup mai larg.
Folosește cazuri sintetice pentru regresie obișnuită. Când este necesar conținut real, stabilește scop specific și acces controlat, nu modifica politica generală fără înregistrare.
Bugetează dovezile utile și întreținerea lor
Implementarea include analiza traseului, conectarea politicii, schema metadatelor, acces și verificare. Costurile recurente depind de sistemul de jurnalizare aplicabil, de volum și de depozitele din aval; verifică tarifele actuale ale contului înainte de a face o estimare.
Cere propunere în GBP care identifică sistemul gateway-ului și testele livrate. Configurația singură diferă de reconstruirea jurnalizării pe mai multe rute și exporturi.
Predarea trebuie să includă politica efectivă, responsabilitățile, rezultatele testelor sintetice și procedura pentru investigarea dovezilor lipsă. Precizează schimbările care cer reverificare, mai ales alt client, rută sau destinație.
Putem verifica limita într-un pilot delimitat IA . Cere o evaluare a jurnalelor gateway-ului cu eligibilitate, rute, destinații și întrebări de incident. Observabilitatea devine utilă fără colectarea conținutului doar fiindcă setarea implicită permite.
Întrebări frecvente
Toate conturile AI Gateway folosesc același sistem de jurnalizare? Nu. Documentația actuală distinge clienții care și-au creat primul gateway începând cu 24 septembrie 2026 de cei care l-au creat anterior. Verifică Workers Logs sau Legacy Logs înaintea ipotezelor de preț și retenție.
Putem păstra metadate fără prompt și răspuns? Controlul documentat permite numai metadate când este configurat potrivit. Verifică politica efectivă generală și per cerere și inspectează rezultatele în destinația reală.
Care este diferența dintre antete? Controlul întregii înregistrări decide colectarea ei. Controlul payloadului privește corpurile brute, metadatele putând rămâne. Dezactivarea întregii înregistrări elimină și metadatele, deci alege după dovezi.
Suprimarea payloadurilor înseamnă că nimeni nu stochează datele? Nu. Alte jurnale, furnizori, exporturi și instrumente au comportamente și contracte proprii. Verifică traseul complet, nu considera setarea o garanție universală.
Cum testăm fără date ale clienților? Folosește marcatori sintetici în cereri nesensibile și inspectează înregistrări și exporturi. Include succes, erori, reluări și alternative. Confirmă că marcatorul nu ajunge indirect în metadate.
Clienții ar trebui să aleagă politica? Numai unde autoritatea este intenționată. Aplică politica organizației în server de încredere și definește antete acceptate sau suprascrise. Apelantul obișnuit nu o schimbă neobservat.
Ce trebuie să livreze evaluarea? Contractul aplicabil, depozitele, politica efectivă, responsabilii accesului și retenția. Include verificări sintetice și procedură repetabilă pentru noi rute sau destinații.