log

log находит или открывает журнал, читает ограниченное начало или конец файла и фильтрует строки, не загружая растущий лог целиком в память.

ДиагностикаВерсия 1.2.2Стабильная
lil-terminal

Обзор

Используйте log для точечной диагностики: найдите нужный файл, выберите первые или последние строки и при необходимости отфильтруйте буквальный текст. Команда журнал не изменяет.

Сначала сузить журнал

Рабочие журналы постоянно растут и обычно содержат гораздо больше данных, чем нужно для одной диагностики. log удерживает задачу небольшой: найти файл, взять ограниченный фрагмент и применить фильтр. На виртуальном хостинге это быстрее и безопаснее, чем открывать большой журнал в редакторе.

Синтаксис

lil-terminal
log [file] [options]

Справочник

log

показать последние 10 строк самого нового найденного лога

log <file>

показать последние 10 строк выбранного файла лога

-h

показать первые строки вместо последних

-n <lines>

задать число выводимых строк от 1 до 50000

-g <text>

показать только строки, содержащие <text>

-i

искать <text> без учёта регистра

-l

показать найденные файлы логов

Поиск логов

Автопоиск узнаёт типовые имена error_log, error.log, debug.log, app.log, access.log и laravel.log в небольшом наборе ближайших каталогов. log -l использует общую структурированную таблицу: путь получает широкую левую колонку, а время изменения и размер аккуратно выравниваются справа.

Чтение и фильтрация

По умолчанию читается хвост файла. -h переключает чтение на начало, -n задаёт число возвращаемых строк, -g оставляет строки с буквальным фрагментом текста, а -i делает этот фильтр нечувствительным к регистру. Большие файлы читаются потоково, а объём вывода ограничен ради отзывчивости браузера.

Безопасность

log никогда не изменяет выбранный файл. Двоичные файлы отклоняются, а каждый путь по-прежнему проходит через обычный механизм разрешения путей lil-terminal.

Интерактивный пример из `/sandbox/`

Запускайте подготовленные примеры прямо на странице. Результат заранее сформирован и показывается в браузере; команды терминала на сервере не выполняются.

Найти журналы и прочитать короткий хвост

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Пакет Base

Установить полный пакет с локальной справкой и всеми опубликованными режимами.

install log
Пакет Minimum

Установить сокращённый пакет без локальной справки; help <cmd> -i открывает актуальную серверную справку.

install log -m
Точная публичная версия

Установить именно эту опубликованную версию.

install log -v 1.2.2
Проверить или обновить

Поручить upgrade проверить совместимость и заменить установленный блок только при необходимости.

upgrade log
Удалить модуль

Удалить блок расширения, не затрагивая ядро и остальные модули.

install log -u

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

Найти журналы и прочитать короткий хвост
cd \sandbox | log -l | log logs/app.log -n 2
2026-08-08 20:53:40    219 B    ~/logs/errors.log
2026-08-07 12:00:00     96 B    ~/logs/app.log

2026-08-07 12:00:02 INFO request completed
2026-08-07 12:00:03 DEBUG cache hit
Показать последние 10 строк выбранного файла лога
log sandbox/logs/app.log
File: sandbox/logs/app.log

2026-01-01T00:00:00Z INFO sandbox initialized
2026-01-01T00:00:01Z DEBUG sample event completed
Показать первые строки вместо последних
log sandbox/logs/app.log -h
File: sandbox/logs/app.log

2026-01-01T00:00:00Z INFO sandbox initialized
2026-01-01T00:00:01Z DEBUG sample event completed
Задать число выводимых строк от 1 до 50000
log sandbox/logs/app.log -n 1
File: sandbox/logs/app.log

2026-01-01T00:00:01Z DEBUG sample event completed
Показать только строки, содержащие <text>
log sandbox/logs/app.log -g DEBUG
File: sandbox/logs/app.log
Filter: DEBUG

2026-01-01T00:00:01Z DEBUG sample event completed
Искать <text> без учёта регистра
log sandbox/logs/app.log -g debug -i
File: sandbox/logs/app.log
Filter: debug

2026-01-01T00:00:01Z DEBUG sample event completed
Показать найденные файлы логов
log -l
sandbox/logs/errors.log              2026-08-08 16:20:57  219 B
sandbox/logs/app.log                 2026-08-04 23:53:00   96 B
Обработать отсутствующий журнал
log sandbox/logs/missing.log
Файл журнала не найден

Файл из примера: sandbox/logs/app.log

Пример использует файл или каталог из защищённой учебной папки /sandbox/.

2026-01-01T00:00:00Z INFO sandbox initialized
2026-01-01T00:00:01Z DEBUG sample event completed

Связанная документация

Какие требования к серверу? →Почему ограничены большие файлы и объём вывода? →

Текущая публичная версия

v1.2.22026-08-10

Единый список журналов

log -l выводит слева дату, размер и затем путь, а флаги собраны компактной группой.

# История версий