A Cloudflare AI Gateway naplózási beállítások tervezése a szükséges bizonyítékkal és kerülendő tartalomtárolással kezdődjön. Az irányítópult láthatóvá teszi a kérést, de prompt-, válasz- és metaadattárat is létrehozhat. A megfelelő érték az üzemeltetési céltól és a fiók aktuális naplózási szerződésétől függ.
Állapítsa meg, hogy a gateway jelenlegi Workers Logs vagy Legacy Logs rendet használ-e, majd tudatosan állítsa a gyűjtést és tartalomtárolást. Szintetikus jelölővel tesztelje a valódi kérési utat és vizsgálja a rekordot. Megfelelő esetben őrizzen hasznos metaadatot, de a tartalom letiltásából ne következtessen minden más rendszer adatmentességére.
Képzeljünk el ügyfélszolgálati asszisztenst, amelynek promptja ügyféllevelezést tartalmaz. A mérnök szolgáltatói hibát vizsgál és használatot rendel feladathoz. Nem feltétlenül kell a teljes levelezés másolata az általános diagnosztikába. Ez beállítási és bizonyítási kérdés, nem indok a megfigyelhetőség elhagyására.
Az útmutató javasolt üzemeltetési kialakítást tárgyal. Nem jogi megfelelőségi tanúsítvány, és nem feltételez azonos díjat, megőrzést vagy exportot minden fióknál.
A Cloudflare AI Gateway naplózási beállítások jogosultságfüggők
Az aktuális AI Gateway naplózási dokumentáció az első gateway létrehozása szerint különböztet ügyfelet. Aki első gatewayét 2026. szeptember 24. napján vagy később készíti, Workers Logs díjazást és megőrzést követ; a korábbi ügyfél Legacy Logs rendszert használ. A konfigurált fióknál igazolja ezt.
Régi cikkből ne vegyen át megőrzési időt vagy naplókeretet minden telepítéshez. Rögzítse a vonatkozó rendet, választott beállítást és ellenőrzési dátumot. Fiók- vagy architektúraváltozáskor ellenőrizze újra.
Ugyanaz a dokumentáció külön kezeli a teljes naplóbejegyzés gyűjtését és kérési, válaszadási tartalmának tárolását. Ez pontosabb kérdés annál, be vagy ki van-e kapcsolva a naplózás.
| Döntés | Tisztázandó kérdés |
|---|---|
| Naplózási rend | Mely aktuális vagy régi szerződés érvényes? |
| Teljes bejegyzés | Kell diagnosztikai rekord ehhez a kérésosztályhoz? |
| Tartalomtárolás | Szükséges a prompt és válasz megőrzése? |
| Hozzáférés | Ki vizsgálhatja és exportálhatja a rekordot? |
| Megőrzés | Mikor jár le az elsődleges és exportált másolat? |
Először az incidenskérdést határozza meg
Írja le az üzemeltető kérdéseit. Melyik terhelés hibázott? Melyik szolgáltatói és modellút futott? Ismételt az alkalmazás? Várakozás vége előtt jött válasz? Megoldatlan még a célfeladat?
Sok kérdés korlátozott metaadattal és alkalmazási művelethivatkozással megválaszolható teljes prompt nélkül. Tartalomminőségi vizsgálathoz viszont kifejezetten kontrollált minta kellhet, amelyet általános metaadat nem magyaráz.
Válassza külön az eseteket. A rutin diagnosztika egy gyűjtési szabályt követhet, az engedélyezett vizsgálat más, felülvizsgált bizonyítási folyamatot. Ne őrizzen minden ügyfélszöveget örökre csak lehetséges későbbi hibareprodukció miatt.
Korábbi AI Gateway útmutatónk az általános proxy- és költségkontrollt tárgyalja. Itt a létező bizonyíték megállapítása és a választott gyűjtés igazolása a feladat.
Külön állítsa a teljes bejegyzést és tartalmat
A Cloudflare a cf-aig-collect-log fejlécet teljes bejegyzéshez, a cf-aig-collect-log-payload fejlécet kérés- és választartalomhoz dokumentálja. Utóbbi false értéke megőrizheti a metaadatot nyers törzs nélkül; a teljes bejegyzés letiltása a metaadatot is elnyomja. Alkalmazás előtt olvassa az aktuális jelentést.
Ez szemléltető fejlécszabály, nem teljes kérés vagy a telepített eredmény bizonyítéka:
1cf-aig-collect-log-payload: false
A szabály megbízható alkalmazási komponensben legyen. Nem megbízható hívó ne változtathassa a szervezet bizonyítékszabályát tetszőleges vezérlőfejléccel. Döntse el a továbbított, beállított és eltávolított fejléceket.
Egy sikeres kérésből ne következtessen alapértékre. Külön vizsgálja a gatewaybeállítást és kérésenkénti felülírást. Elsődleges modellúton működő konfiguráció tartalék úton vagy más klienssel eltérhet.
Rögzítse a tényleges szabályt
Verziózza az alkalmazási konfigurációt és rögzítse a gateway fontos beállítását. Írja le, mely kérésosztály tart tartalmat, csak metaadatot vagy semmit.
Új modellintegrációnál a naplózási utat is vizsgálják felül. Különben eltérő megőrzésű útvonalak gyűlhetnek, miközben a csapat egy globális szabályban hisz.
A metaadat ne legyen második tartalom
Nem beszédes feladat- és kérésreferencia kötheti a gateway bizonyítékát alkalmazási rekordhoz. Ügyazonosító elég lehet a forrás megtalálására a meglévő joggal. Tárgy vagy ügyfél-e-mail metaadatba másolása alááshatja a promptkizárás célját.
Definiáljon engedélyezett metaadatsémát. Az értéket a mezőnév mellett ellenőrizze. A label személyes vagy bizalmas adatot tartalmazhat, ha felhasználói szöveg tölti ki.
| Metaadat | Üzemeltetési használat | Vizsgálati szempont |
|---|---|---|
| Nem beszédes terhelésazonosító | Használat alkalmazásfunkcióhoz rendelése | Ügyféltartalom ne legyen beágyazva |
| Művelethivatkozás | Incidens és feladatállapot összekötése | Kapcsolt rekord hozzáférése maradjon kontrollált |
| Konfigurációverzió | Tényleges útvonal reprodukálása | Titok ne legyen az értékben |
| Hibakategória | Kezelhető probléma csoportosítása | Ne nyers kivétel tartalmazzon forrást |
Az alkalmazási és gatewayreferencia legyen elég következetes a vizsgálathoz. Üzemeltető teljes prompt másolása vagy minden mérnöknek adott ügyfélrendszeri jog nélkül is kövesse a hibát.
Szintetikus jelölővel igazolja a gyűjtést
Küldjön nem érzékeny kérést egyedi jelölővel. Vizsgálja a megfelelő naplócélt és megjelenését tartalomban, metaadatban, exportban vagy kapcsolt alkalmazási naplóban a szabály szerint.
Teszteljen normál választ, szolgáltatói hibát és használt tartalék utat. Hibakezeléskor gyakran a normál gyűjtésen kívüli diagnosztikai mezőbe másolódik a kéréstörzs.
| Teszt | Elvárt bizonyíték csak metaadat mellett |
|---|---|
| Normál inferencia | Hasznos metaadat szintetikus törzsjelölő nélkül |
| Szolgáltatói hiba | Hibakategória és referencia másolt tartalom nélkül |
| Alkalmazási ismétlés | Összeköthető próbák tartalomismétlő címke nélkül |
| Jogosulatlan gatewaykérés | Hozzáférési szabály szerinti elutasítás |
| Export vagy további naplócél | Tartalom- és megőrzési szabály továbbra is érvényes |
A Cloudflare hitelesített gateway dokumentációja e hozzáféréskontroll hivatkozása. A valódi hitelesítő adatot és útvonalat vizsgálja, ne feltételezze a végpont védelmét a naplóbeállításból.
Az export és más tároló is legyen a vizsgálat része
A gateway tartalomelnyomása nem bizonyítja az alkalmazás, modellszolgáltató vagy külső megfigyelési rendszer tárolásmentességét. Rajzolja fel a valódi utat és külön szerződés szerint vizsgálja a tárolókat.
Exportnál dokumentálja az olvasókat és lejáratot. Egy rekord törlése az egyik szolgáltatásból nem bizonyítja, hogy egy korábbi exportból is eltávolították. Az üzemeltetési leírás mondja meg a bizonyíték gazdáját.
Vizsgálja a nyomokat, kivételkövetőt és supportképet is. Helyes gateway mellett is bemásolhatja a csapat az ügyfélpromptot szélesebb kör számára látható hibajegybe.
Rutin regresszióhoz szintetikus esetet használjon. Szükséges valódi tartalomnál konkrét gyűjtési célt és kontrollált hozzáférést alakítson ki, ne nyilvántartás nélkül változtassa az általános szabályt.
Tervezzen keretet hasznos bizonyítékra és karbantartásra
A megvalósítás adatútvizsgálatot, kérési bekötést, metaadatsémát, hozzáférést és tesztet tartalmaz. Rendszeres költsége a naplózási rendtől, mennyiségtől és további tárolótól függ; becslés előtt ellenőrizze a fiók díját.
Kérjen GBP-ajánlatot a gatewayrend és átadott teszt megnevezésével. Egyszerű konfiguráció más, mint több modellút és exportcél teljes alkalmazási naplózásának újraépítése.
Az átadás tartalmazzon tényleges szabályt, felelőst, szintetikus eredményt és hiányzó bizonyíték vizsgálati eljárását. Nevezze meg az újraellenőrzést kiváltó módosítást, különösen új klienst, útvonalat vagy naplócélt.
A határt körülhatárolt AI-integrációs pilotban vizsgálhatjuk. Kérjen gatewaynaplózási felmérést fiókfeltételekkel, modellutakkal, jelenlegi célokkal és incidenskérdésekkel. Így a megfigyelhetőség hasznos, nem csak az alapbeállítás miatt gyűjt tartalmat.
Gyakran ismételt kérdések
Minden AI Gateway fiók ugyanazt a naplózást használja? Nem. A dokumentáció megkülönbözteti a 2026. szeptember 24. napján vagy később első gatewayt létrehozó ügyfelet a korábbitól. Díj vagy megőrzés feltételezése előtt ellenőrizze a Workers Logs vagy Legacy Logs rendet.
Megmaradhat metaadat prompt és válasz nélkül? A dokumentált tartalomkontroll megfelelően konfigurálva támogatja a csak metaadatos bejegyzést. Vizsgálja a tényleges globális és kérési szabályt, valamint az eredményt a valódi naplócélban.
Mi a két gyűjtési fejléc különbsége? A teljes bejegyzés kontrollja a gyűjtést szabályozza. A tartalomkontroll a nyers kérés- és választörzs tárolását, miközben metaadat maradhat. A teljes bejegyzés letiltása ezt is törli; a szükséges bizonyíték alapján válasszon.
Tartalomtiltás esetén semmilyen szolgáltatás nem tárol? Nem. Más napló, szolgáltató, export és megfigyelő saját viselkedéssel és szerződéssel működik. A teljes adatút vizsgálandó, egyetlen gatewaybeállítás nem általános megőrzési garancia.
Hogyan teszteljünk ügyféladat nélkül? Használjon szintetikus jelölőt nem érzékeny kérésben, és vizsgálja a rekordot, exportot. Legyen normál eredmény, hiba, ismétlés és tartalék út. A metaadat közvetetten se tartalmazza a jelölőt.
Választhasson a kliens naplózási szabályt? Csak tudatos jogosultság esetén. Szervezeti szabályt megbízható szerverkomponens alkalmazzon meghatározott elfogadott vagy felülírt fejléccel. Normál hívó ne módosítsa csendben a bizonyítékszabályt.
Mit adjon át a felmérés? Vonatkozó szerződést, adattárolót, tényleges gyűjtési szabályt, hozzáférési felelőst és megőrzési döntést. Legyen szintetikus teszteredmény és ismételhető eljárás új modellút vagy naplócél ellenőrzésére.