Cloudflare AI Gateway Protokollierung sollte bei den benötigten Nachweisen und den nicht aufzubewahrenden Inhalten beginnen. Ein Dashboard macht Anfragen sichtbar, schafft aber möglicherweise einen neuen Speicher für Prompts, Antworten und Metadaten. Die richtige Einstellung hängt von Betriebszweck und aktuellem Protokollierungsvertrag des Kontos ab.
Stellen Sie zuerst fest, ob das Gateway dem aktuellen Workers-Logs-Modell oder Legacy Logs folgt. Konfigurieren Sie Erfassung und Nutzdatenspeicherung bewusst. Testen Sie den tatsächlichen Anfragepfad mit synthetischen Markierungen und prüfen Sie entstandene Einträge. Behalten Sie gegebenenfalls nützliche Betriebsmetadaten, ohne aus abgeschalteten Nutzdaten auf Löschung in sämtlichen anderen Systemen zu schließen.
Denken Sie an einen Supportassistenten mit Kundenkorrespondenz im Prompt. Entwickler müssen Anbieterfehler untersuchen und Nutzung zuordnen. Dafür brauchen sie nicht zwingend die ganze Korrespondenz in einem allgemeinen Diagnosespeicher. Das ist eine Konfigurations- und Nachweisfrage, kein Grund, Beobachtbarkeit aufzugeben.
Dieser Leitfaden beschreibt einen vorgeschlagenen Betriebsaufbau. Er bietet keine rechtliche Konformitätsbescheinigung und setzt keine gleichen Preise, Aufbewahrungs- oder Exportregeln für alle Konten voraus.
Cloudflare AI Gateway Protokollierung hängt von der Berechtigung ab
Die aktuelle AI-Gateway-Protokollierungsdokumentation unterscheidet Kunden nach Erstellung ihres ersten Gateways. Ab dem 24. September 2026 erstmals erstellte Gateways folgen Workers-Logs-Preisen und Aufbewahrung; frühere Kunden nutzen Legacy Logs. Prüfen Sie diese Zuordnung für das konkrete Konto.
Übernehmen Sie keine Aufbewahrungsfrist oder Protokollfreimenge aus älteren Artikeln für jede Bereitstellung. Erfassen Sie geltendes Dienstmodell, gewählte Einstellungen und Prüfdatum. Prüfen Sie erneut bei Konto- oder Architekturänderungen.
Dieselbe Dokumentation trennt Erfassung eines ganzen Eintrags von der Speicherung seiner Anfrage- und Antwortnutzdaten. Das ermöglicht präzisere Diskussion als ein bloßes Ein- oder Ausschalten der Protokollierung.
| Entscheidung | Zu klärende Frage |
|---|---|
| Protokollierungsmodell | Welcher aktuelle oder alte Vertrag gilt? |
| Gesamteintrag | Soll für diese Anfrageklasse ein Diagnosenachweis entstehen? |
| Nutzdatenspeicherung | Müssen Prompt und Antwort aufbewahrt werden? |
| Zugriff | Wer darf Einträge prüfen oder exportieren? |
| Aufbewahrung | Wann verfallen primäre und exportierte Kopien? |
Zuerst die Störungsfragen definieren
Schreiben Sie Betreiberfragen auf. Welche Arbeitslast scheiterte? Welcher Anbieter- und Modellweg wurde verwendet? Wiederholte die Anwendung? Kam eine Antwort vor Ende der Benutzerwartezeit? Ist die Zielaufgabe ungeklärt?
Viele Fragen lassen sich mit begrenzten Metadaten und Anwendungsoperationsreferenzen beantworten, nicht immer mit vollständigen Prompts. Umgekehrt kann eine Inhaltsqualitätsprüfung eine ausdrücklich kontrollierte Stichprobe benötigen, die allgemeine Metadaten nicht erklären.
Trennen Sie die Zwecke. Routinediagnosen der Supportanwendung folgen einer Erfassungsregel, genehmigte Untersuchungen einem anderen geprüften Nachweisverfahren. Behalten Sie nicht jeden Kundentext für immer, weil er irgendwann bei einer Fehlerreproduktion helfen könnte.
Unser bestehender AI-Gateway-Leitfaden behandelt Proxy- und Kostenkontrollrolle. Hier geht es um tatsächlich vorhandene Nachweise und den Beleg der gewählten Erfassung.
Gesamteintrag und Nutzdaten getrennt steuern
Cloudflare dokumentiert cf-aig-collect-log für Gesamteinträge und cf-aig-collect-log-payload für Anfrage- und Antwortnutzdaten. Die Nutzdatensteuerung mit false kann Metadaten ohne Rohinhalte behalten; deaktivierte Gesamteinträge unterdrücken auch Metadaten. Lesen Sie die aktuelle Headerbedeutung vor Anwendung.
Dies ist eine beispielhafte Headerregel, keine vollständige Anfrage und kein Nachweis des bereitgestellten Ergebnisses:
1cf-aig-collect-log-payload: false
Wenden Sie Regeln in einer vertrauenswürdigen Anwendungskomponente an. Ein nicht vertrauenswürdiger Aufrufer darf Unternehmensnachweise nicht durch beliebige Gatewaysteuerheader verändern. Definieren Sie weitergeleitete, gesetzte und entfernte Header.
Leiten Sie Vorgaben nicht aus einer erfolgreichen Anfrage ab. Prüfen Sie Gatewayeinstellung und Anfrageüberschreibung getrennt. Eine auf dem Hauptmodellweg funktionierende Konfiguration kann bei Fallback oder anderem Client anders wirken.
Die wirksame Regel dokumentieren
Versionieren Sie die anwendungsseitige Konfiguration und erfassen Sie relevante Gatewayeinstellungen. Beschreiben Sie Anfrageklassen mit Nutzdaten, nur Metadaten oder vollständig unterdrückter Erfassung.
Bei einer weiteren Modellintegration gehört ihr Protokollierungspfad in die Prüfung. Sonst sammeln sich Routen mit verschiedener Aufbewahrung an, während das Team an eine globale Regel glaubt.
Metadaten dürfen nicht zu weiteren Nutzdaten werden
Undurchsichtige Aufgaben- und Anfragereferenzen verbinden Gatewaybelege mit Anwendungsnachweisen. Eine Supportfallkennung kann zur Quellenlokalisierung unter bestehenden Rechten genügen. Betreff oder Kunden-E-Mail als Metadaten zu kopieren kann den Ausschluss von Promptinhalten unterlaufen.
Definieren Sie ein erlaubtes Metadatenschema. Prüfen Sie Werte ebenso wie Feldnamen. Ein Feld label kann persönliche oder vertrauliche Inhalte tragen, wenn die Anwendung Benutzertext einfüllt.
| Metadatenwahl | Betriebszweck | Prüfpunkt |
|---|---|---|
| Undurchsichtige Arbeitslastkennung | Nutzung einer Funktion zuordnen | Keine Kundeninhalte einbetten |
| Operationsreferenz | Störung mit Aufgabenstatus verbinden | Zugriff auf verknüpften Nachweis bleibt kontrolliert |
| Konfigurationsrevision | Wirksame Route reproduzieren | Keine Geheimnisse im Wert |
| Fehlerkategorie | Bearbeitbare Probleme gruppieren | Keine rohen Ausnahmen mit Quellinhalten |
Halten Sie Anwendungs- und Gatewayreferenzen für Untersuchungen ausreichend konsistent. Betreiber sollten Fehler verfolgen können, ohne ganze Prompts zwischen Werkzeugen zu kopieren oder jedem Entwickler Kundensystemzugriff zu geben.
Erfassung mit synthetischen Markierungen prüfen
Senden Sie eine nicht sensible Testanfrage mit unverwechselbarer Markierung. Prüfen Sie das geltende Protokollziel und das Auftreten in Nutzdaten, Metadaten, Exporten oder zugehörigen Anwendungsprotokollen nach der vorgesehenen Regel.
Testen Sie normale Antwort, Anbieterfehler und gegebenenfalls Fallback. Fehlerbehandlung kopiert Anfrageinhalte häufig außerhalb des normalen Erfassungspfads in Diagnosefelder.
| Test | Erwarteter Nachweis bei reinen Metadaten |
|---|---|
| Normale Inferenz | Brauchbare Metadaten ohne synthetische Inhaltsmarkierung |
| Anbieterfehler | Fehlerkategorie und Referenz ohne kopierte Nutzdaten |
| Anwendungswiederholung | Versuche zuordenbar, keine Inhaltsduplikate in Beschriftungen |
| Unberechtigte Gatewayanfrage | Ablehnung nach Gatewayzugriffsregeln |
| Export oder Protokollziel | Vereinbarte Inhalts- und Aufbewahrungsregel bleibt gültig |
Cloudflares Dokumentation authentifizierter Gateways ist die Referenz für diese Zugriffskontrolle. Prüfen Sie tatsächliche Zugangsdaten und Route, statt aus Protokolleinstellungen auch Endpunktschutz abzuleiten.
Exporte und andere Speicher einbeziehen
Gateway-Nutzdatenunterdrückung beweist keine fehlende Speicherung bei Anwendung, Modellanbieter oder Beobachtungsdienst. Zeichnen Sie den tatsächlichen Datenweg und prüfen Sie jeden Speicher nach eigenem Vertrag.
Dokumentieren Sie bei Exporten Leseberechtigte und Ablauf der Kopien. Löschung bei einem Dienst belegt nicht die Entfernung früherer Exporte. Das Betriebshandbuch sollte Nachweisverantwortung je System benennen.
Prüfen Sie auch Ablaufspuren, Ausnahmeverfolgung und Supportscreenshots. Ein korrekt eingerichtetes Gateway verhindert nicht, dass das Team Kundenprompts in einem breiter sichtbaren Ticket ablegt.
Verwenden Sie synthetische Fälle für regelmäßige Regressionstests. Sind echte Inhalte zur Fehleruntersuchung nötig, definieren Sie konkreten Erfassungszweck und kontrollierten Zugriff, statt die allgemeine Regel undokumentiert zu ändern.
Nützliche Nachweise und Pflege budgetieren
Umsetzung umfasst Datenwegprüfung, Einbindung der Anfrageregeln, Metadatenschema, Zugriffsaufbau und Verifikation. Laufende Kosten hängen von Protokollierungsmodell, Menge und nachgelagerten Speichern ab. Prüfen Sie aktuelle Kontotarife vor Schätzungen.
Fordern Sie ein GBP-Angebot mit Gatewaymodell und lieferbaren Tests. Eine reine Konfigurationsaufgabe unterscheidet sich vom Umbau der Anwendungsprotokollierung über mehrere Modellrouten und Exportziele.
Die Übergabe sollte wirksame Regeln, Verantwortung, synthetische Ergebnisse und Untersuchungsverfahren bei fehlenden Nachweisen enthalten. Nennen Sie Änderungen mit erneuter Prüfpflicht, besonders weitere Clients, Routen oder Protokollziele.
Wir können die Grenze in einem begrenzten KI-Integrationspiloten untersuchen. Fordern Sie eine Gateway-Protokollierungsprüfung an , mit Kontozuordnung, Modellrouten, aktuellen Zielen und Störungsfragen. So bleibt Beobachtbarkeit nützlich, ohne Inhalte nur wegen möglicher Standardeinstellungen zu sammeln.
Häufig gestellte Fragen
Nutzen alle AI-Gateway-Konten dasselbe Protokollierungsmodell? Nein. Die aktuelle Dokumentation unterscheidet Kunden mit erstem Gateway ab dem 24. September 2026 von früheren Kunden. Prüfen Sie Workers Logs oder Legacy Logs vor Preis- und Aufbewahrungsannahmen.
Können wir Metadaten ohne Prompt- und Antwortinhalte behalten? Die dokumentierte Nutzdatenerfassung erlaubt bei passender Konfiguration reine Metadateneinträge. Prüfen Sie wirksame Gateway- und Anfrageregeln sowie Testergebnisse im tatsächlichen Ziel.
Was unterscheidet die beiden Erfassungsheader? Die Gesamteintragssteuerung bestimmt die Erfassung des Eintrags. Die Nutzdatensteuerung regelt Rohinhalte von Anfrage und Antwort bei möglichen verbleibenden Metadaten. Abschalten des Gesamteintrags entfernt auch Metadaten; wählen Sie nach Nachweisbedarf.
Bedeutet Nutzdatenunterdrückung, dass kein Dienst Daten speichert? Nein. Anwendungsprotokolle, Anbieter, Exporte und Beobachtungswerkzeuge haben eigene Verträge und Verhaltensweisen. Prüfen Sie den gesamten Datenweg statt einer Gatewayeinstellung als allgemeiner Aufbewahrungsgarantie.
Wie testen wir ohne Kundendaten? Nutzen Sie synthetische Markierungen in nicht sensiblen Anfragen und prüfen Sie Nachweise und Exporte. Berücksichtigen Sie normale Ergebnisse, Fehler, Wiederholungen und Fallback. Metadaten dürfen die Markierung auch nicht indirekt enthalten.
Dürfen Clients ihre Protokollierungsregel wählen? Nur bei bewusst gewährter Befugnis. Setzen Sie Organisationsregeln in einer vertrauenswürdigen Serverkomponente und definieren Sie angenommene oder überschriebene Steuerheader. Gewöhnliche Aufrufer dürfen Nachweisregeln nicht unbemerkt ändern.
Was sollte eine Prüfung liefern? Geltenden Vertrag, Speicherorte, wirksame Erfassung, Zugriffsverantwortliche und Aufbewahrungsentscheidungen. Ergänzen Sie synthetische Ergebnisse und ein wiederholbares Prüfverfahren für neue Modellrouten oder Protokollziele.