Befehlsprotokoll
Jede Aktion einer CLI-Maschine hinterlässt eine Spur in ihrem Protokoll: Aktivierung, Hostliste, Ausführung, Snippet, MCP-Tool, Bestätigung, Rotation, Abmeldung, Widerruf. Sie können es unter Einstellungen › CLI-Maschinen lesen, indem Sie die Maschine öffnen, und auf https://app.konsolity.com/cli-machines.
Start und Ende
Bei einer Ausführung schreibt die CLI eine Zeile, bevor sie den Befehl startet, und eine zweite am Ende, mit dem Exit-Code und der Dauer. Schlägt das Schreiben des Starts fehl (Netz ausgefallen, Server nicht erreichbar), wird der Befehl nicht ausgeführt: Nichts läuft ohne Spur.
Der Server schreibt selbst die Ereignisse, die ihn betreffen: Aktivierung, Token-Rotation, Widerruf, Bestätigungen, Ablehnungen wegen des Bereichs.
Inhalt einer Zeile
- Wann: Datum und Uhrzeit;
- Welches Tool:
hosts,run,snippet,sessions,mcp:<tool>,serve:<tool>,login,rotate,logout; - Welcher Host: seine Bezeichnung;
- Welcher Befehl: sein Text, auf 4.000 Zeichen begrenzt;
- Entscheidung: erlaubt (mit der Regel, die es erlaubt hat), verweigert, bestätigt oder bei der Bestätigung abgelehnt;
- Exit-Code und Dauer der Ausführung;
- die CLI-Sitzung und gegebenenfalls die Bestätigungsanfrage.
Was das Protokoll nicht enthält
Nie die Ausgabe des Befehls. Nie ein Passwort, einen Schlüssel, ein Token oder einen Maschinenschlüssel.
Aufbewahrung
Die Zeilen werden im Ruhezustand verschlüsselt und 90 Tage aufbewahrt, dann gelöscht. Der Widerruf einer Maschine löscht ihr Protokoll nicht: Es bleibt bis zum Ende der 90 Tage verfügbar.
Filter
Filtern Sie nach Maschine (auf der Seite der Maschinen), nach Zeitraum (von, bis) und nach Entscheidung (erlaubt, abgelehnt, bestätigt, nicht bestätigt): Die neuesten Zeilen erscheinen zuerst, „Ältere Zeilen“ lädt den Rest. Der Export verwendet dieselben Filter.
Export
Exportieren erzeugt eine CSV-Datei (Tabellenkalkulation, englische Spaltenköpfe) oder eine JSON-Datei (Tools, Archivierung) für den gewählten Zeitraum. Bewahren Sie einen monatlichen Export auf, wenn Sie eine Spur über 90 Tage hinaus benötigen.
Bewährte Vorgehensweisen
- Gehen Sie das Protokoll nach dem Erweitern eines Bereichs durch: Ablehnungen zeigen, was versucht wurde.
- Eine wiederholte Ablehnung eines legitimen Befehls deutet auf eine fehlende Regel hin; eine unerwartete Ablehnung auf eine Anfrage, der Sie nachgehen sollten.
- Eine Startzeile ohne Endzeile kennzeichnet einen unterbrochenen Befehl (Widerruf, Sitzungsende, Ausfall).