Журналы¶

Доступны следующие журналы:

Журналы экземпляров Storage. Они записываются в директорию /app/logs.
Журналы экземпляров Scheduler. Каждый экземпляр scheduler запускается как сервис systemd.

Эти журналы можно посмотреть с помощью journalctl, например:
```
journalctl | grep scheduler
```
Либо с помощью systemctl, например:
```
# пример для AstraLinux, под пользователем tarantool
export XDG_RUNTIME_DIR=/run/user/$(id -u)
systemctl --user status tarantool_column_store-scheduler@tcs-scheduler-01
```
Системные журналы. Подробнее о взаимодействии с этими журналами см. ниже.
Журналы событий аудита. Подробнее о взаимодействии с этими журналами см. ниже.

Журналы событий аудита¶

В журнал событий аудита попадают события для экземпляров Scheduler и Storage с тегом tcs-audit.

События аудита записываются при включенной аутентификации. Они могут записываться, в зависимости от конфигурации, как в syslog, так и в файл. Конфигурация производится отдельно для экземпляров Storage и Scheduler:

audit_log:
  level: trace
  writer:
    type: syslog

Параметр level указывает уровень событий, которые должны быть записаны в журнал. Параметр может принимать следующие значения:

trace, наиболее детальный уровень записи, часто чрезвычайно подробная информация.
debug, запись информации с низким приоритетом;
info, запись полезной информации;
warn, запись информации о потенциально опасных событиях;
error, запись информации о серьезных ошибках.

Параметр writer указывает на то, куда будут сохраняться события: в журнал Syslog (type: syslog) или в файл (type: file).

При сохранении в файл необходимо указать также директорию и префикс имени файла:

audit_log:
  level: trace
  writer:
    type: file
    directory: ./logs/
    filename_prefix: audit_log

При конфигурации type: file события аудита хранятся на диске в указанной директории, где каждый час создается новый файл с именем вида audit_log.2025-09-08-11.jsonl.

При конфигурации type: syslog записи можно посмотреть с помощью journalctl, например:

journalctl -t tcs-audit

Записи доступны в формате json. Пример записей:

{"timestamp":"2025-09-01T11:31:45.708258Z","level":"INFO","user":"tcs","stmt_name":"query","args":"1","target":"audit"}
{"timestamp":"2025-09-01T11:31:45.708775Z","level":"INFO","user":"tcs","table_ref":"datafusion.public.attributes","target":"audit"}
{"timestamp":"2025-09-01T11:37:00.070271Z","level":"INFO","message":"record insert","user":"test_user","table_ref":"test","target":"audit"}
{"timestamp":"2025-09-01T11:37:42.926327Z","level":"INFO","message":"prepared execution","user":"tcs","stmt_name":"query","args":"1","target":"audit"}
{"timestamp":"2025-09-01T11:37:42.926595Z","level":"INFO","message":"table_scan","user":"tcs","table_ref":"datafusion.public.attributes","target":"audit"}

В таблице ниже перечислены события, соответствующее им значение параметра level («уровень») и краткое описание:

Событие	Уровень	Описание
auth_ok	DEBUG	Успешная аутентификация пользователя
auth_fail	ERROR	Ошибка аутентификации
table_scan	DEBUG	Запрос записей из таблицы
table_truncate	INFO	Очистить табдицу
table_insert	DEBUG	Вставка записей в таблицу
record_update	DEBUG	Обновление записи в таблице
record_delete	DEBUG	Удаление записи в таблице
create_table	INFO	Создание таблицы
alter_table	INFO	Изменение таблицы
remove_table	INFO	Удаление таблицы
prepared_execution	DEBUG	Выполнение подготовленного запроса (prepared statement)
create_prepared	INFO	Создание подготовленного запроса (prepared statement)
get_prepared	INFO	Запрос подготовленного запроса (prepared statement)
get_all_prepared	INFO	Запрос всех подготовленных запросов (prepared statement)
clear_prepared	INFO	Очистка всех подготовленных запросов (prepared statement)
drop_prepared	INFO	Удаление подготовленного запроса (prepared statement)
create_view	INFO	Создание представления (view)
drop_view	INFO	Удаление представления (view)
get_view	INFO	Запрос представления (view)
clear_view	INFO	Очистка всех представлений (view)
create_sequence	INFO	Создание последовательности (sequence)
drop_sequence	INFO	Удаление последовательности (sequence)
get_all_sequence	INFO	Запрос всех последовательностей (sequence)

Примечание

Если audit_log на экземпляре не сконфигурирован или выставлен в null, то журнал событий аудита для этого экземпляра будет отключен.

Системные журналы¶

Системные журналы экземпляров Scheduler и Storage могут записываться, в зависимости от конфигурации, в stdout, в syslog или в файл. При необходимости можно включить и настроить все виды записи одновременно. Конфигурация производится:

на корневом уровне конфигурации Scheduler;
в конфигурации ролей Tarantool для Storage.

Пример конфигурации:

log:
  - target: stdout
    level: ERROR
  - target: syslog
    protocol: unix
    path: /dev/log
    level: DEBUG
  - target: file
    level: ERROR
    format: compact
    path: errors.log

Параметр target указывает место записи событий: стандартный вывод (target: stdout), журнал Syslog (target: syslog), или файл (target: file).

Для каждого места записи можно определить параметры level и format.

Параметр level указывает уровень событий, которые должны быть записаны в журнал. Параметр не чувствителен к регистру и может принимать следующие значения:

TRACE, наиболее детальный уровень записи, часто чрезвычайно подробная информация.
DEBUG, запись информации с низким приоритетом;
INFO, запись полезной информации, значение по умолчанию;
WARN, запись информации о потенциально опасных событиях;
ERROR, запись информации о серьезных ошибках.

Параметр format указывает формат, в котором будут сохраняться события:

plain, значение по умолчанию;
compact;
json.

Для журнала Syslog (target: syslog) дополнительно необходимо указать тип протокола (protocol):

udp;
tcp;
unix. При выборе этого протокола также необходимо указать путь к файлу Unix-сокета при помощи параметра path.

Для записи событий в файл (target: file) необходимо указать путь к файлу для записи при помощи параметра path.

Если не указывать секцию log на экземпляре, то для него система будет вести себя эквивалентно настройке:

log:
  - target: stdout

ВАЖНО: после любого изменения настроек системных журналов на Storage или Scheduler требуется перезапустить этот экземпляр для применения изменений.

Version:

Журналы¶

Журналы событий аудита¶

Системные журналы¶