2026-07-31T12:59:41.699Z
Cloudflare Beobachtbarkeit MCP: Beweisen Sie ein Null-Log-Ergebnis
Audit Cloudflare Workers Log Scope, Sammlung, Aufbewahrung, Probenahme und eine bekannte Kontrollanforderung, bevor Nullreihen als gesund behandelt werden.
Eine leere Antwort vom Cloudflare Observability MCP Server ist kein Beweis dafür, dass ein Arbeitnehmer gesund ist. Es ist Beweis dafür, dass eine Abfrage keine Zeilen zurückgab. Bevor Sie das in ein Urteil verwandeln, beweisen Sie, dass die Abfrage das beabsichtigte Cloudflare Konto, Worker, Zeitfenster, Protokollkonfiguration und Feldset verwendet hatund dass der gleiche Umfang eine bekannte Kontrollanrufung abrufen kann. Die vernünftige Standardregel ist streng: ein gefiltertes Nullreihenresultat healthy empty nur dann bezeichnen, wenn Workers Logs und Invokationslogs aktiviert sind, die Kopfsamplingrate 1 ist, das Fenster ist im Speicher, die Feldentdeckung erfolgreich, die Abfrage wird abgeschlossen und eine breitere Abfrage findet eine bekannte Invokation im gleichen Konto, Worker und Fenster. Fehlt eine Quittung, halten Sie den Zustand unbekannt oder verweisen Sie den spezifischen Konfigurationsfehler. Dies ist wichtig, weil der Remote MCP Austausch erfolgreich sein kann, während die Beweislage unvollständig ist. Das Protokollergebnis antwortet hat das Werkzeug zurückgegeben? Der Betreiber muss noch beantworten hat diese Abfrage die Ereignisse abgedeckt, die für diese Entscheidung erforderlich sind? Eine erfolgreiche MCP Anfrage kann immer noch ein Beweisversagen sein Cloudflare listet einen verwalteten Observability Server für das Debuggen von Anwendungsprotokollen und analysen auf. Das aktuelle Cloudflare MCP Serverkatalog bietet seinen Remote Endpunkt, sagt, dass neue Verbindungen Streamable HTTP verwenden und erklärt, dass die Berechtigung über Cloudflare OAuth verwaltet wird. Die Arbeiter Beobachtbarkeit MCP Repository dokumentiert drei Werkzeuge: query worker observability Abfragen Arbeitsprotokolle und Messwerte; observability keys entdeckt Metadaten, Arbeitsspezifische Felder und benutzerdefinierte Felder; observability values findet für ein ausgewähltes Feld verfügbare Werte. Diese Werkzeuge reichen aus, um viele Vorfälle zu untersuchen, aber ihre Erfolgsumfelder beweisen keine Abdeckung. Das Repository sagt auch, dass jede Anfrage frische, angeforderte Berechtigung und Konto Kontext bekommt. Daher darf man nicht davon ausgehen, dass, weil der vorherige Antrag das richtige Konto verwendet hat, der nächste Antrag dies notwendigerweise getan hat. Erfassen Sie eine nicht geheime Konto und Arbeiterreferenz bei jeder Anfrage. Es gibt mehrere Möglichkeiten, ein überzeugendes, leeres Ergebnis zu erzielen: 1. OAuth ausgefüllt, aber das ausgewählte Konto ist nicht das Produktionskonto. 2. Der Filter "Arbeiter Name" oder "Umgebung" löst sich auf Nichts aus. 3. Das Arbeitsprotokoll ist für diesen Einsatz deaktiviert. 4. Die Anrufprotokolle sind ausdrücklich deaktiviert. 5. Die Kopfproben haben die Anrufung ausgesagt, die Sie erwartet haben. 6. Das gewünschte Fenster ist älter als die gespeicherten Daten. 7. Der Filter verwendet ein Feld oder einen Wert, der im aktuellen Schema nicht vorhanden ist. 8. Das gefilterte Ergebnis ist wirklich leer. Nur der letzte Staat unterstützt no matching incident, und selbst dann nur für den begrenzten Umfang und das Fenster. Die Zusammenlegung der Liste in success verwirklicht die genauen Beweise, die ein Betreiber benötigt. Beweisen Sie den Datensatz vor der Interpretation des Filters Beginnen Sie mit der Sammlung, nicht mit der Vorfallfrage. Der aktuelle Arbeiter Logs Dokumentation von Cloudflare sagt, dass ein Arbeiter die Beobachtbarkeit haben muss, um in die Arbeitsprotokolle zu schreiben. Es dokumentiert auch eine separate invocation logs = false Einstellung. Ein Arbeiter kann daher erfolgreich laufen, wenn der Anrufnachweis, den Sie von der Prüfung erwarten, absichtlich nicht vorhanden ist. Die Probenahme ist eine weitere harte Grenze. head sampling rate reicht von 0 bis zu 1 ; bei 0.01 wird nur eine von hundert Anfragen protokolliert. Eine Fehleranfrage mit Nullreihen über Probendaten kann für die Trendschätzung nützlich sein, kann jedoch keine bekannte Anforderung deterministisch beseitigen. In derselben Dokumentation wird festgestellt, dass der Dienst eine Stichprobe von 1% anwenden kann, wenn ein Konto seine tägliche Loggrenze überschreitet. Erfassen Sie die wirksame Stichprobenpolitik, nicht nur die beabsichtigte Konfiguration. Die Aufbewahrung macht ein altes Fenster unerkennbar. Das festgelegte Höchstbetrag beträgt drei Tage bei Workers Free und sieben Tage bei Workers Paid. Wenn ein Vorfallfenster vor der Aufbewahrungsgrenze endet, wird er window expired eingestuft. Die Erweiterung oder Umformulierung der Abfrage kann keine Daten wiederherstellen, die nicht mehr gespeichert sind. Verwenden Sie diesen Befehl für jede Untersuchung: 1. Pin scope. Erfassen Sie unsichtbare, nicht geheime Referenzen für das autorisierte Konto, den Arbeitnehmer und die Umgebung. Speichern Sie kein OAuth Token, bitten Sie nicht nach URL, Log Körper oder Kunden Identifikator in der Gesundheitsbestätigung. 2. Check collection. Confirm Workers Logs ist für die bereitgestellte Umgebung aktiviert und ob Invokationslogs aktiviert sind. 3. Record Abdeckungsgrenzwerte. Erfassen Sie die wirksame Probenahme der Kopf, die Aufbewahrungstage und die angeforderten Start /Endzeitstempel. 4. Discover vor dem Filtern. Verwenden Sie observability keys , um zu bestätigen, dass die erforderlichen Felder vorhanden sind, dann observability values , um zu bestätigen, dass der Worker oder Umgebungswert vorhanden ist. Dies verhindert, dass ein falsch geschriebenes oder veraltetes Feld wie ein sauberes Ergebnis aussieht. 5. Run eine Kontrollfrage. Abfrage breit genug, um eine bekannte Invocation innerhalb des gleichen Kontos, Worker und Fenster zu finden. Verwenden Sie einen lokal gehaltenen Hash Anforderungsmarker, wenn Sie eine Korrelation benötigen; never upload the raw marker to a monitoring record. 6. Run der Zwischenfilter. Erst nachdem die Steuerung angezeigt ist, sollte ein Fehlerfilter mit null Reihen als Kandidat für healthy empty angesehen werden. Eine Kompaktquittung kann die Entscheidung aufbewahren, ohne den Inhalt des Protokolls zu bewahren: Der Konto und die Referenzen sind Korrelationsschlüssel, nicht geheime Identifikatoren. Die Quittung schließt absichtlich Hinweise, Log Nachrichten, Überschriften, Anfrage URLs, Tool Argumente und OAuth Material aus. Die Route 9 zeigt statt eines grünen Ergebnisses Das zu überprüfende Artefakt, das diesem Artikel begleitet, enthält neun Inhaltsfreie Fälle. Seine Vorrangsregel ist absichtlich konservativ: Staat Beweise Aktion des Betreibers needs auth Der Remote Server ist nicht autorisiert Route zum Kontoinhaber; Kennzeichnen Sie den Arbeitnehmer nicht unerreichbar scope unresolved Konto oder Referenz fehlt Lösen Sie genau das Konto, die Bereitstellung und die Umgebung collection disabled Arbeiter Logs oder Aufruflogs sind ausgeschaltet Entscheidung darüber, ob die Sammlung und Umverteilung ermöglicht werden soll window expired Das Fenster ist früher als die gespeicherten Daten Markieren Sie das historische Urteil nicht verfügbar query failed Schema Entdeckung, Zeitstempel oder Abfrage Ausführung ist ungültig Reparieren Sie die Abfrage vor der Auslegung der Zeilenzahl sampled unknown Nullreihen mit Kopfproben unter 1 Abwesenheit als nicht deterministisch zu betrachten coverage unknown 0 Zeilen und die bekannte Kontrollanrufung fehlt Untersuchen Sie den Umfang, den Filter, die Einnahme oder die Verspätung der Sammlung incident found Die gefilterte Abfrage gibt eine oder mehrere entsprechende Zeilen zurück Untersuchen Sie die zurückgegebenen Beweise healthy empty Null gefilterte Zeilen plus vollständige Abdeckung und eine gefundene Steuerung Schalten Sie nur diesen Filter, den Bereich und das Zeitfenster frei Der Klassifizierer prüft die Voraussetzungen, bevor er filteredRows betrachtet. Diese Reihenfolge verhindert das häufigste falsche Grün: Sie sehen Null und stoppen, bevor Sie fragen, ob es einen gültigen Datensatz gibt, den Sie suchen können. Führen Sie das Gerät lokal aus: Die neun Geräte produzierten in jedem Staat einen Fall und alle drei Tests bestanden: Der falsche Teil ist einfach. Nehmen Sie das gesunde leere Gerät und entfernen Sie die Kontrollbestätigung: Sein Zustand wird coverage unknown . Abnahme der Probenahme von 1 auf 0.1 : es wird sampled unknown . Fügen Sie drei gefilterte Zeilen hinzu: es wird incident found . Die Anzahl der Zeilen hat erst dann Bedeutung, wenn der Beweisweg festgelegt ist. Ein verifiziertes leeres Protokollfenster ist immer noch kein Agent Ergebnis healthy empty ist absichtlich eng. Es bedeutet, dass der ausgewählte Cloudflare Workers Logfilter keine entsprechenden Zeilen in einem geschlossenen Fenster zurückgab. Es bedeutet nicht, dass der Arbeiter die richtige Antwort erhielt, ein nachgelaufenes Schreiben einmal ausgeführt wurde, ein geplanter Job sein Artefakt geliefert hat oder die breitere Agentenaufgabe des Nutzers erfolgreich war. Cloudflares Überblick über die Beobachtbarkeit der Arbeitnehmer trennt Logs, Spuren, Metriken, Analysen und exportierte Telemetrie. Jede Oberfläche beantwortet eine andere Frage. Ein sauberer Fehlerfilter kann mit einem falschen Geschäftsergebnis koexistieren. Ein erfolgreiches Anrufprotokoll kann mit einem fehlenden Bestimmungsprotokoll koexistieren. Eine bekannte Kontrollanfrage kann die Abdeckung der Abfrage beweisen, während sie nichts über einen unabhängigen Warteschlangverbraucher sagt. Fügen Sie einen Ergebnisbeweis außerhalb der Log Abfrage hinzu, wenn der Vorfall einen benutzersichtlichen Effekt beinhaltet: ein Dateihash, eine Datenbankversion, eine öffentliche Antwort, eine Reihenankündigung oder eine andere deterministische Bestimmungsprüfung. Wenn die Wirkung möglicherweise aufgetreten ist, aber die Quittung fehlt, versuchen Sie nicht automatisch an einer Nebenwirkungsgrenze erneut. Versöhnen Sie sich zuerst. Es gibt auch Privatsphärebegrenzungen. Eine Kontrollsonde sollte synthetisch, begrenzt und leicht zu identifizieren sein, ohne ein Geheimnis in Logs zu platzieren. Die Gesundheitsbestätigung sollte Hashes und Zustände aufbewahren, nicht Körper anfordern. Cloudflare dokumentiert, dass übergroße Logs gekürzt werden können; eine aktuelle Zeile ist kein Beweis dafür, dass jedes erwartete Feld überlebt hat. Überprüfen Sie die $cloudflare.truncated Grenze, wenn die Diagnose vom Protokollgehalt abhängt. Der Cloudflare Observability MCP Server ist als Arbeit im Gange dokumentiert, so dass Werkzeugnamen und verhalten sich ändern können. Wiederholen Sie die Feldentdeckung, stecken Sie das Beweisdatum in Vorfallberichten und behandeln Sie veraltete Werkzeugannahmen als Abfrageversagen und nicht als gesundes Ergebnis. Sidewisp befindet sich derzeit in einer privaten Vorschauphase. Die Produktionsüberwachungsadapter und die Wiederherstellungssysteme werden im Allgemeinen nicht versandt. Die Methode hier ist ein lokales Betriebsmuster, nicht eine Behauptung, dass Sidewisp derzeit mit Cloudflare Konten verbindet, Live Workers abfragt oder Vorfälle beheben. Die nützliche Regel ist kleiner: Vermarkten Sie niemals Zero Zeilen auf healthy, bis ein bekanntes Ereignis beweist, dass der genaue Datensatz, der Umfang, das Fenster und die Sammelungsrichtlinie in der Lage waren, Beweise zurückzugeben. Das verwandelt eine MCP Antwort in eine überprüfbare Entscheidung, ohne vorzugeben, dass die Logs allein das Ergebnis beweisen.