Лог машины

Каждая команда, выполненная на машине через tTerm, становится строкой в логе этой машины: кто её запустил, когда, чем она закончилась, сколько шла и где. Лог ведёт сам tTerm, и изменить его никто не может. Под командой можно оставить заметку.

Открыть

В боковой панели, в разделе «Заметки» проекта, первая папка – «Логи», с пометкой «ведёт tTerm». В ней лог каждой машины проекта, а рядом с машиной видно, сколько команд на ней выполнено сегодня: «12 сегодня». Щёлкни по машине, и её лог откроется во вкладке «web-01: лог».

Лог показывает по одному дню и открывается на сегодняшнем. Стрелки «Предыдущий день» и «Следующий день» ведут к ближайшему дню, где есть строки. «Сегодня» возвращает к сегодняшнему дню, а «Выбрать день» открывает календарь. Пока лог показывает сегодня, новые строки появляются сами, как только команды завершаются.

Вверху лога в меню ⋯ есть «Копировать как Markdown»: показанный день, его строки и заметки под ними.

Что в строке

Каждая команда – одна строка: время, кто её запустил, сама команда, обрезанная, если она длинная, и сколько под ней заметок. Справа указаны время выполнения, папка, ветка git и терминал. У команды с ошибкой стоит крестик и код возврата: «код 1». Между командами лог отмечает ещё, когда открыли терминал и когда он завершился, а также перенос машины в другой проект: «Машина перенесена тобой из проекта Personal в проект Интернет-магазин».

Щелчок по строке открывает её: команда целиком, её вывод и заметки под ней. Ещё один щелчок её закрывает. От длинного вывода видны первые строки: «Показать все 27 строк» показывает остальное, а «Копировать вывод» копирует его.

Наведи на строку указатель или открой её, и на ней появится ⋯: «Копировать команду» и «Копировать ссылку на эту строку». По ссылке откроется лог за день этой строки, и сама строка будет открыта.

Поиск и фильтры

В ряду под днём «Найти в логе» ищет по всему логу за год: команды, в которых есть все набранные слова, и команды с заметкой, где есть все эти слова. Клавиша / переводит в это поле. Найденное разложено по дням: щелчок по строке открывает её, а «Открыть день» переходит к её дню. Поиск остаётся, пока его не очистишь, а «Назад к дню» возвращает к дню, который был открыт.

Рядом с ним стоят порядок строк и фильтры:

• «Сначала старые» по щелчку становится «Сначала новые», и этот браузер запомнит выбор.
• «Все»: только строки одного человека, который запустил команду или написал под ней заметку.
• «С ошибкой»: только команды, которые завершились с ошибкой.
• «С заметками»: только команды, под которыми есть заметки.
• «Все терминалы»: команды одного терминала. Этот фильтр есть, когда строки из нескольких терминалов.

Когда фильтр включён, у дня написано, сколько команд видно, «2 из 8 команд», а «Сбросить» выключает фильтры. Фильтры работают и для того, что нашлось через «Найти в логе».

Поиск тоже ищет в логах всех твоих машин: начни запрос с l:.

Заметки к команде

Наведи на строку указатель и нажми «Добавить заметку». В терминале у блока команды есть такая же кнопка, с подсказкой «Добавить заметку к этой команде». Где бы ни написать заметку, она видна и под строкой лога, и под блоком в терминале. Enter сохраняет заметку, Shift+Enter начинает новую строку, Esc отменяет.

Заметка остаётся в логе как написана: её не правят и не удаляют, на неё отвечают. «Ответить» под заметками добавляет ответ. У каждой заметки видно, кто её написал и когда, а в ⋯ рядом с ней в логе есть «Копировать текст».

Стереть пароль или токен

Пароль или токен, попавший в команду или в заметку, можно стереть. Сделать это может только владелец проекта или админ. Пока в каждом проекте только ты, и ты его владелец.

1. В логе нажми ⋯ на строке или рядом с заметкой и выбери «Стереть…».

2. В окне, в поле «Причина», напиши, что это было: пароль, токен.

3. Нажми «Стереть».

Слова навсегда пропадут из лога, из ленты терминала, из поиска и из истории строки ввода. Вместе с командой пропадёт и её вывод, а если та же команда запускалась в проекте где-то ещё, она сотрётся и там. На месте слов лог сохранит, кто их стёр, когда и почему: «Стёрто тобой · 09:23 · пароль». В ночных резервных копиях базы они останутся, пока те не удалятся сами, – не дольше двух недель.

Сколько хранится

Строки хранятся год, а заметки уходят вместе со своей строкой. Вывод команд хранится 30 дней: потом твоя строка при наведении показывает «вывод не сохранился». Если удалить машину, её лог больше не откроется.

Лог принадлежит машине. Если перенести её в другой проект, она заберёт лог целиком, со строками до переноса, и их сможет читать каждый, кто в этом проекте. Удаление проекта, из которого машина ушла, ничего из лога не забирает.