Bitácoras: ahora creamos automáticamente una bitácora para cada máquina

Por qué

La terminal muestra lo que estás haciendo ahora. Pero en un servidor muchas veces importa otra cosa: quién reinició el servicio anoche, qué se ejecutó justo antes de que todo se cayera, con qué comando se arregló lo mismo el mes pasado. Antes tenías que reconstruirlo a partir de history y de los logs del propio servidor. Ahora tTerm anota cada comando por su cuenta, y nadie puede cambiar ese registro.

Dónde está

La bitácora está entre las notas del proyecto, en la carpeta «Bitácoras» con la marca «por tTerm», y cada máquina tiene la suya. Junto a cada máquina ves cuántos comandos se ejecutaron hoy en ella. La bitácora muestra los días de uno en uno, y las líneas nuevas aparecen solas en cuanto termina un comando.

Qué muestra cada línea

Cada comando ocupa una línea: la hora, quién lo ejecutó, el propio comando, cuánto tardó, el directorio, la rama de git y la terminal. Un comando fallido lleva una cruz y su código de salida. Un clic abre la línea completa: el comando, su salida y sus notas. Entre comandos, la bitácora marca cuándo se abrieron y se cerraron las terminales, y si una terminal finalizó por sí sola, indica por qué.

Notas en los comandos

Puedes dejar una nota debajo de cualquier comando: por qué lo ejecutaste, qué resultado dio, adónde se mudó la configuración. Escríbela en la bitácora o directamente junto al bloque en la terminal, y se verá en ambos sitios. Las notas no se editan ni se borran: se responden. Por eso la bitácora sigue siendo una crónica honesta.

Buscar en todo un año

«Buscar en esta bitácora» abarca todo el año, tanto los comandos como las notas. Los filtros dejan solo los comandos fallidos, los que tienen notas o los de una persona o una terminal. Y la búsqueda con ⌘K ahora también encuentra líneas en las bitácoras de todas tus máquinas.

Si una contraseña se coló en un comando

A veces pasa: un export con un token, o una contraseña escrita directamente en la línea. El propietario del proyecto lo borra con «Censurar…». Las palabras desaparecen de la bitácora, de los bloques de la terminal, de la búsqueda y del historial de la línea de comandos. En su lugar queda constancia de quién las censuró, cuándo y por qué. En las copias nocturnas de la base de datos duran, como mucho, dos semanas más.

Cuánto tiempo se guarda

Las líneas de la bitácora se guardan durante un año, y la salida de los comandos, durante 30 días. La bitácora pertenece a la máquina: si la mueves a otro proyecto, toda la bitácora se va con ella.

Cuando una terminal finaliza por sí sola

Una terminal vive en tTerm Web, no en una pestaña del navegador, pero a veces finaliza sin que hagas nada, por ejemplo cuando sale una versión nueva de tTerm Web. Ahora la pestaña dice por qué ocurrió, y todo lo que se ejecutó queda en la bitácora. El botón «Abrir una terminal nueva» abre otra en el mismo directorio.

En tTerm para Mac, la bitácora llegará con la próxima actualización. Los detalles están en la documentación, en la página «La bitácora de una máquina».