Журналы¶

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

Журналы экземпляров 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, то журнал событий аудита для этого экземпляра будет отключен.

Версия:

Журналы¶

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