Beobachten

Nachdem eine Anwendungsanfrage abgeschlossen ist, kann ObserveContext die Geschichte dieser Anfrage behalten: welcher Dienst, welche Route, wie lange und die benannten Schritte darin (Anmeldung, SQL prepare, execute, scan, Snapshot-Aufbau, Kodierung). Diesen Speicher prüfst du mit SQL oder mit einem Dashboard. Ein persönliches Dashboard kann auf deinem eigenen Rechner unter 127.0.0.1:8766 laufen, ohne gehostete Seite.

Es ist ein kleiner Speicher auf demselben PocketContext-Server, den die anderen Anwendungen nutzen. Es ist kein Ersatz für Langfuse oder OpenTelemetry, und eine Zeitmessung ist kein Beleg dafür, dass das eigene Ergebnis der Anwendung richtig war.

Wie ein Trace ankommt

sequenceDiagram
  participant You as Du, über eine App-CLI
  participant Wrap as observecontext capture
  participant App as Der Anwendungsserver
  participant Store as ObserveContext

  You->>Wrap: capture -- dealcontext sql "SELECT ..."
  Wrap->>App: der echte Befehl, Tracing ist eingeschaltet
  App-->>Wrap: Ergebnis plus Server-Zeit
  Wrap->>Wrap: eine Operation, die Client und Server zusammenfasst
  Wrap->>Store: hochladen
  Note over Store: Operationen, Traces und Spans bleiben unveränderlich

Andere Anwendungen müssen Tracing einschalten und einen Server-Commit nutzen, der es unterstützt. Beobachten ändert ihre festgelegten Versionen nicht.

SQL-Text wird nur gespeichert, wenn beide Seiten ihn verlangen, und er ist auf 16 KiB begrenzt. Eine SQL-Anweisung kann private Werte enthalten, deshalb sollten ihn nur Personen sehen, die den Trace lesen dürfen. Header, Passwörter, URL-Abfragen, REST-Körper und Ergebniszeilen bleiben draußen.

Wer einen Trace sehen kann

flowchart TD
  user[Gewöhnliche Workspace-Nutzerin oder gewöhnlicher Nutzer]
  own[Die eigenen Operationen und Traces]
  flag[Betreiber setzt can_view_all_traces]
  all[Weiterer Lesezugriff]

  user --> own
  flag --> all

Eine Bereitstellung lässt geprüfte Google-Workspace-Identitäten zu. Du liest deine eigenen Daten und kannst eigene anfügen. Ein Betreiber kann ein weiteres Leserecht vergeben. Das Konto, das einen Trace hochgeladen hat, wird getrennt von dem Benutzer und dem Dienst gespeichert, die der Erzeuger angegeben hat. Ein Trace ist diagnostisches Material. Er ist kein Beweis, dass diese Angaben echt waren.

Gespeicherte Traces laufen in diesem ersten Release nicht automatisch ab.

Was die Zeiten abdecken

Der Server misst Authentifizierung, SQL prepare / execute / scan, die Arbeit am gefilterten Snapshot und die Kodierung des Ergebnisses. Gewöhnliche REST-Aufrufe bekommen eine Gesamtzeit, ohne Aufteilung für jeden Anwendungs-Hook. Der Client-Wrapper ergänzt die HTTP-Zeit, einschließlich des Lesens der Antwort.

Der Prompt eines KI-Assistenten und die vollständige Chat-Sitzung werden nicht erfasst.