LOGGER(1) | Команди користувача | LOGGER(1) |
НАЗВА¶
logger - вписування повідомлень до журналу системи
КОРОТКИЙ ОПИС¶
logger [options] message
ОПИС¶
logger makes entries in the system log.
Якщо вказано необов’язковий аргумент повідомлення, його буде записано до журналу. Якщо аргумент не вказано, і не використано параметр -f, до журналу буде записано дані зі стандартного джерела вхідних даних.
ПАРАМЕТРИ¶
-d, --udp
Додаткові відомості щодо визначення місця з’єднання наведено у описах --server і --socket.
-e, --skip-empty
-f, --file файл
-i
--id[=ідентифікатор]
Зауважте, що в інфраструктурі ведення журналу системи (наприклад, у systemd при очікуванні даних з /dev/log) може бути використано реєстраційні дані локального сокета для перезапису PID, який вказано у повідомленні. logger(1) може встановити для реєстраційних даних таких сокетів вказаний ідентифікатор, але лише якщо у вас є права доступу користувача root, і процес із вказаним PID існує, інакше реєстраційні дані сокета не буде змінено, а проблему буде без додаткових повідомлень проігноровано.
--journald[=файл]
logger --journald <<end MESSAGE_ID=67feb6ffbaf24c5cbec13c008dd72309 MESSAGE=The dogs bark, but the caravan goes on. DOGS=bark CARAVAN=goes on end
logger --journald=entry.txt
Зауважте, що --journald ігноруватиме значення інших параметрів, зокрема пріоритетності. Якщо потрібна пріоритетність, вона має бути у вхідних даних і використовувати поле PRIORITY. Просте виконання journalctl(1) призведе до виведення поля MESSAGE. Скористайтеся journalctl --output json-pretty для перегляду решти полів.
Щоб включити до MESSAGE символи розриву рядків, вкажіть MESSAGE декілька разів. Такий випадок буде оброблено як особливий, інші поля буде збережено як масив у журналі, якщо їх вказано декілька разів.
--msgid ідентифікатор-повідомлення
-n, --server сервер
--no-act
--octet-count
-P, --port порт
-p, --priority пріоритетність
--prio-prefix
Якщо у префіксі не міститься запису можливості, типовою є можливість, яку вказано за допомогою параметра -p. Так само, якщо не вказано префікс, рядок буде записано до журналу з використанням значення пріоритетності, яка задано за допомогою -p.
Цей параметр не впливає на повідомлення командного рядка.
--rfc3164
--rfc5424[=аргумент]
Значення notq придушує структуровані дані щодо якості часу у надісланому повідомленні. Дані щодо якості часу показують, чи синхронізовано локальний годинник, і вказують на максимальне відхилення часової позначки. Якість часу також буде автоматично придушено, якщо вказано параметр --sd-id timeQuality.
Значення notime (яке неявним чином встановлює notq) придушує повну часову позначку відправника у форматі ISO-8601, включно з мікросекундами і часовим поясом.
Значення nohost придушує відомості gethostname(2) у заголовку повідомлення.
Протокол RFC 5424 став типовим для logger, починаючи з версії 2.26.
-s, --stderr
--sd-id назва[@цифри]
logger currently generates the timeQuality standardized element only. RFC 5424 also describes the elements origin (with parameters ip, enterpriseId, software and swVersion) and meta (with parameters sequenceId, sysUpTime and language). These element IDs may be specified without the @digits suffix.
--sd-param назва=значення
logger --rfc5424 --sd-id zoo@123 \
--sd-param tiger="голодний" \
--sd-param zebra="біжить" \
--sd-id manager@123 \
--sd-param onMeeting="yes" \
"це повідомлення"
дає:
<13>1 2015-10-01T14:07:59.168662+02:00 ws kzak - - [timeQuality tzKnown="1" isSynced="1" syncAccuracy="218616"][zoo@123 tiger="hungry" zebra="running"][manager@123 onMeeting="yes"] this is message
-S, --size розмір
Більшість отримувачів приймають повідомлення, розмір яких перевищує 1 КіБ, за будь-яким типом протоколу syslog. Отже, параметр --size стосується logger в усіх випадках (не лише, коли використано --rfc5424).
Зауваження: обмеження розміру повідомлення стосується загального розміру повідомлення, включно із заголовком syslog. Розмір заголовка залежить від вибраних параметрів і довжини назви вузла. Як правило, довжина заголовка не перевищує значення від 50 до 80 символів. При виборі максимального розміру повідомлення важливо переконатися, що на боці отримувача також передбачено підтримку максимального розміру, інакше повідомлення може бути обрізано. Знову ж таки, як правило, розмір повідомлення від двох до чотирьох КіБ має бути задовільним, працездатність усіх інших більших розмірів слід перевіряти.
--socket-errors[=режим]
Типовим режимом є auto. Якщо помилки не увімкнено, обмін втраченими повідомленнями не відбуватиметься, а результатом буде успішний стан виходу при виклику logger(1).
-T, --tcp
Додаткові відомості щодо визначення місця з’єднання наведено у описах --server і --socket.
-t, --tag мітка
-u, --socket сокет
--
-h, --help
-V, --version
СТАН ВИХОДУ¶
Допоміжна програма logger завершує роботу із кодом стану 0 у разі успіху і кодом стану >0, якщо станеться помилка.
МОЖЛИВОСТІ І РІВНІ¶
Коректними назвами можливостей є такі:
auth
authpriv for security information of a sensitive nature
cron
daemon
ftp
kern cannot be generated from userspace process, automatically
converted to user
lpr
mail
news
syslog
user
uucp
local0
to
local7
security
застарілий
синонім auth
Коректними назвами рівнів є такі:
emerg
alert
crit
err
warning
notice
info
debug
panic deprecated synonym for emerg
error deprecated synonym for err
warn deprecated synonym for warning
Опис порядку пріоритетності та призначення цих можливостей і рівнів можна знайти на сторінці підручника щодо syslog(3).
ВІДПОВІДНІСТЬ¶
Команда logger має бути сумісною із стандартом IEEE 1003.2 ("POSIX.2").
ПРИКЛАДИ¶
logger System rebooted
logger -p local0.notice -t HOSTIDM -f /dev/idmc
logger -n loghost.example.com System rebooted
АВТОРИ¶
Початкову версію програми logger було створено Каліфорнійським університетом у 1983-1993 роках, а пізніше переписано Karel Zak <kzak@redhat.com>, Rainer Gerhards <rgerhards@adiscon.com> і Sami Kerola <kerolasa@iki.fi>.
ТАКОЖ ПЕРЕГЛЯНЬТЕ¶
ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ¶
Для звітування щодо вад скористайтеся системою стеження за вадами - <https://github.com/util-linux/util-linux/issues>.
ДОСТУП ДО ПРОГРАМИ¶
Програма logger є частиною пакунка util-linux, який можна отримати з архіву ядра Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.
2025-01-14 | util-linux 2.40.4 |