Logs: Wir legen jetzt für jede Maschine automatisch ein Log an

Warum

Das Terminal zeigt, was du gerade tust. Auf einem Server zählt aber oft etwas anderes: wer gestern Abend den Dienst neu gestartet hat, was lief, kurz bevor alles abstürzte, welcher Befehl letzten Monat dasselbe Problem gelöst hat. Bisher musstest du dir das aus history und den Logdateien des Servers zusammensuchen. Jetzt zeichnet tTerm jeden Befehl selbst auf, und niemand kann diese Aufzeichnung ändern.

Wo du es findest

Das Log findest du bei den Notizen des Projekts im Ordner „Logs“ mit dem Vermerk „von tTerm“, und jede Maschine hat ihr eigenes. Neben jeder Maschine siehst du, wie viele Befehle heute auf ihr liefen. Das Log zeigt jeweils einen Tag, und neue Zeilen erscheinen darin von selbst, sobald ein Befehl beendet ist.

Was eine Zeile zeigt

Jeder Befehl steht in einer Zeile: die Uhrzeit, wer ihn ausgeführt hat, der Befehl selbst, wie lange er lief, das Verzeichnis, der Git-Branch und das Terminal. Ein fehlgeschlagener Befehl bekommt ein Kreuz und seinen Exit-Code. Ein Klick öffnet die ganze Zeile mit dem Befehl, seiner Ausgabe und seinen Notizen. Zwischen den Befehlen hält das Log fest, wann Terminals geöffnet und geschlossen wurden. Wenn ein Terminal von selbst geendet hat, nennt das Log auch den Grund.

Notizen zu Befehlen

Unter jedem Befehl kannst du eine Notiz hinterlassen: warum du ihn ausgeführt hast, was dabei herauskam, wohin die Konfiguration umgezogen ist. Schreib sie im Log oder direkt am Block im Terminal, sichtbar ist sie an beiden Stellen. Notizen bearbeitet oder löscht man nicht, man antwortet auf sie. Deshalb bleibt das Log eine ehrliche Chronik.

Ein ganzes Jahr durchsuchen

Mit „In diesem Log suchen“ durchsuchst du das ganze Jahr, Befehle wie Notizen. Mit Filtern siehst du nur fehlgeschlagene Befehle, nur Befehle mit Notizen oder nur die einer Person oder eines Terminals. Und die Suche mit ⌘K findet jetzt auch Zeilen in den Logs all deiner Maschinen.

Wenn ein Passwort in einen Befehl geraten ist

Das kommt vor: ein export mit einem Token oder ein Passwort direkt in der Zeile. Der Eigentümer des Projekts entfernt es mit „Schwärzen …“. Die Wörter verschwinden aus dem Log, aus den Blöcken des Terminals, aus der Suche und aus dem Verlauf der Eingabezeile. An ihrer Stelle steht, wer sie wann und warum geschwärzt hat. In den nächtlichen Kopien der Datenbank bleiben sie noch höchstens zwei Wochen erhalten.

Wie lange es aufbewahrt wird

Logzeilen werden ein Jahr lang aufbewahrt, die Ausgabe der Befehle 30 Tage lang. Das Log gehört zur Maschine: Verschiebst du sie in ein anderes Projekt, zieht das ganze Log mit.

Wenn ein Terminal von selbst endet

Ein Terminal lebt in tTerm Web, nicht in einem Browser-Tab, aber manchmal endet es ohne dein Zutun, zum Beispiel wenn eine neue Version von tTerm Web erscheint. Jetzt zeigt der Tab, warum das passiert ist, und alles, was gelaufen ist, bleibt im Log. Mit dem Button „Neues Terminal öffnen“ startest du ein neues im selben Verzeichnis.

In tTerm für Mac kommt das Log mit dem nächsten Update. Die Details stehen in der Dokumentation, auf der Seite „Das Log einer Maschine“.