Scroll to navigation

LOGGER(1) Корисничке наредбе LOGGER(1)

НАЗИВ

logger - уноси поруке у дневник система

УВОД

logger [опције] порука

ОПИС

logger прави уносе у дневник система.

Када је опционални аргумент поруке присутан, записује се у дневник. Ако није присутан, а ни опција -f није дата, записује се стандардни улаз.

ОПЦИЈЕ

-d, --udp

Користи датаграме (UDP) само. По основи веза се покушава са прикључником системског дневника дефинисаном у /etc/services, који је често 514.

Видите такође --server и --socket да наведе где ће се повезати.

-e, --skip-empty

Занемарује празне редове приликом обраде датотека. Празан ред је дефинисан као ред без знакова. Стога се ред који се састоји само од размака НЕ ​​сматра празним. Знајте да када је наведена опција --prio-prefix, предност није део реда. Дакле, празан ред у овом режиму је ред који нема знакова после префикса предности (нпр. <13>).

-f, --file датотека

Записује у дневник садржај наведене датотеке. Ова опција се не може комбиновати са поруком линије наредби.

-i

Бележи ПИД процеса logger са сваким редом.

--id[=ид]

Записује у дневник ПИД процеса logger са сваким редом. Када је опционални аргумент ид наведен, тада се он користи уместо ПИД-а наредбе logger. Коришћење --id=$$ (PPID) се препоручује у скриптама које шаљу неколико порука.

Знајте да инфраструктура бележења система (на пример systemd када ослушкује на /dev/log) може да прати уверења локалне прикључнице да би пребрисала ПИД наведен у поруци. logger(1) може да подеси та уверења прикључнице на дати ид, али само ако имате администраторска овлашћења и постоји процес са наведеним ПИД-ом, иначе се уверења прикључнице не мењају и проблем се тихо занемарује.

--journald[=датотека]

Пише унос дневника systemd-а. Унос се чита из дате датотеке, када је наведена, у супротном са стандардног улаза. Сваки ред мора почети пољем које је прихваћено од journald-а; видите systemd.journal-fields(7) за више о томе. Коришћење поља „ИД_ПОРУКЕ“ је уопштено добра замисао, јер олакшава налажење уноса. Примери:

logger --journald <<end
ИД_ПОРУКЕ=67feb6ffbaf24c5cbec13c008dd72309
ПОРУКА=Пси лају, али караван пролази.
ПСИ=лају
КАРАВАН=пролази
end

logger --journald=унос.txt

Приметите да ће --journald занемарити вредности других опција, као што је предност. Ако је предност потребна мора бити у улазу, и користите поље ПРЕДНОСТ. Једноставно извршавање journalctl(1) ће приказати поље ПОРУКА. Користите journalctl --output json-pretty да видите остала поља.

Да бисте укључили нове редове у ПОРУЦИ, наведите ПОРУКУ неколико пута. Ово се сматра као посебан случај, друга поља ће бити сачувана као низ у дневнику ако се појаве више пута.

--msgid ид-поруке

Поставља поље „RFC 5424 <https://tools.ietf.org/html/rfc5424> MSGID“. Знајте да знак размака није допуштен унутар msgid. Ова поција се користи само ако је и --rfc5424 наведено; у супротном, тихо се занемарује.

-n, --server сервер

Пише на наведеном удаљеном серверу системског дневника уместо на прикључници системског дневника. Осим ако је наведено --udp или --tcp, logger ће прво покушати да користи UDP, а ако ово не успе покушава се са TCP везом.

--no-act

Доводи до тога да се уради све осим писања поруке дневника у системски дневник и уклањања везе или дневника. Ова опција се може користити заједно са --stderr у сврхе тестирања.

--octet-count

Користи „RFC 6587 <https://tools.ietf.org/html/rfc6587>“ методу уоквиравања бројања октета за слање порука. Када се ова опција не користи, основно је без уоквиравање на UDP-у, а RFC6587 нетранспарентно уоквиривање (познато и као пуњење октетом) на TCP-у.

-P, --port прикључник

Користи наведени прикључник. Када ова опција није наведена, прикључник подразумева syslog за „udp“ и syslog-conn за „tcp“ везе.

-p, --priority предност

Уноси поруку у дневник са наведеном предношћу. Предност се може навести бројевно или као пар објекат.ниво. На пример, -p local3.info бележи поруку као информативну у објекту „local3*. Основно је user.notice.

--prio-prefix

Тражи префикс системског дневника у сваком реду прочитаном са стандардног улаза. Тај префикс је децимални број унутар угласте заграде који кодира и објекат и ниво. Број је конструисан множењем објекта са 8 и затим додавањем нивоа. На пример, local0.info, значи да објекат=16 и ниво=6, постаје <134>.

Ако префикс не садржи објекат, објекат се подразумева на оно што је наведено опцијом -p. Слично томе, ако префикс није достављен, ред се бележи коришћењем предности дате са -p.

Ова опција не утиче на поруку линије наредби.

--rfc3164

Користи RFC 3164 <https://tools.ietf.org/html/rfc3164> BSD протокол системског дневника да пошаље поруке удаљеном серверу.

--rfc5424[=без]

Користи „RFC 5424 <https://tools.ietf.org/html/rfc5424> протокол системског дневника за слање порука удаљеном серверу. Опциони аргумент без може бити зарезом раздвојен списак следећих вредности: notq, notime, nohost.

Вредност notq потискује структурисане податке временског квалитета из послате поруке. Информација временског квалитета показује да ли је локални сат усаглашен плус највећи број микросекунди за које временска ознака може бити искључена. Квалитет времена се такође самостално потискује када је --sd-id timeQuality наведено.

Вредност notime (која подразумева notq) потискује читаву временску ознаку која је у ISO-8601 формату, укључујући микросекунде и временску зону.

Вредност nohost потискује gethostname(2) информације из заглавља поруке.

RFC 5424 протокол је био основни logger од издања 2.26.

-s, --stderr

Исписује поруку на стандардној грешци као и у дневник система.

--sd-id name[@цифре]

Наводи ИД елемента структурисаних података за заглавље RFC 5424 поруке. Опција треба да се користи пре --sd-param за увођење новог елемента. Број елемената структурисаних података је неограничен. ИД (назив плус по могућству @цифре) разликује величину слова и јединствено одређује врсту и сврху елемента. Исти ИД не сме да постоји више од једном у поруци. Део @цифре је захтеван за нестандардизоване ИД-ове које дефинише корисник.

logger тренутно ствара само timeQuality стандардизован елемент. RFC 5424 такође описује порекло елемената (са параметрима ip, enterpriseId, software и swVersion) и мета (са параметарима sequenceId, sysUpTime и language). Ови ИД-ови елемента могу бити наведени без суфикса @цифре.

--sd-param назив=вредност

Наводи параметар елемента структурираних података, пар назива и вредности. Опција мора да се користи после --sd-id и може се навести више пута за исти елемент. Знајте да су знаци наводника око вредности захтевани и морају бити измењени на линији наредби.


logger --rfc5424 --sd-id зоо@123 \
--sd-param тигар="гладан" \
--sd-param зебра="трчи" \
--sd-id менаџер@123 \
--sd-param наСастанку="да" \
"ово је порука"

даје:

<13>1 2015-10-01T14:07:59.168662+02:00 ws kzak - - [timeQuality tzKnown="1" isSynced="1" syncAccuracy="218616"][зоо@123 тигар="гладан" зебра="трчи"][менаџер@123 наСастанку="да"] ово је порука

-S, --size величина

Поставља највећу дозвољену величину поруке на величину. Основно је 1KiB знакова, што је ограничење традиционално коришћено и наведено у RFC 3164. Са RFC 5424, ово ограничење је постало прилагодљивије. Добра претпоставка је та да RFC 5424 примаоци могу у најмању руку да обраде 4KiB поруке.

Већина примаоца прихвата поруке веће од 1KiB преко сваке врсте протокола системског дневника. Као таква, опција --size утиче на logger-а у свим случајевима (не само када се користи --rfc5424).

Напомена: ограничење величине поруке ограничава укупну величину поруке, укључујући заглавље системског дневника. Величине заглавља варирају у зависности од изабраних опција и дужине назива домаћина. Као правило, заглавља обично нису дужа од 50 до 80 знакова. Приликом одабира највеће величине поруке, важно је осигурати да и прималац исто тако подржава највећу величину, у супротном поруке могу постати скраћене. Опет, као правило величина поруке од 2 до 4 KiB треба уопштено да буде у реду, док све веће треба да се провере да ли раде.

--socket-errors[=режим]

Исписује грешке о везама Јуникс прикључнице. режим може бити вредност off, on, или auto. Када је режим auto, logger ће открити да ли је почетни процес systemd(1), и ако је таква претпоставка начињена, /dev/log се може користити раније у време подизања система. Недостатак _/dev/log_код других система неће довести до грешака које су истоветне са порукама које користе openlog(3) системски позив. logger(1) пре издања 2.26 је користио openlog(3), и стога није могао да открије губитак порука послатих Јуникс прикључницама.

Основни режим је auto. Када грешке нису укључене о изгубљеним порукама се не изјављује и резултираће успешним излазним стањем logger(1) призивања.

-T, --tcp

Користи само ток (TCP). По основи веза се покушава са прикључником syslog-conn дефинисаном у /etc/services, који је често 601.

Видите такође --server и --socket да наведе где ће се повезати.

-t, --tag ознака

Означава да сваки ред буде прибележен са наведеном ознаком. Основна ознака је име корисника пријављеног на терминалу (или име корисника засновано на ефективном ИД-у корисника).

-u, --socket прикључница

Пише на наведену прикључницу уместо на прикључницу дневника система.

--

Завршава списак аргумената. Ово омогућава да порука започне цртицом (-).

-h, --help

Приказује текст помоћи и излази.

-V, --version

Исписује издање и излази.

ИЗЛАЗНО СТАЊЕ

Помагало logger излази 0 при успеху, и >0 ако дође до грешке.

ОБЈЕКТИ И НИВОИ

Исправни називи објекта су:

auth
authpriv за безбедносне информације осетљиве природе
cron

daemon
ftp
kern не може се створити из процеса корисничког простора, аутоматски се претвара у user

lpr
mail
news
syslog
user
uucp
local0
to
local7
security застарели синоним за auth

Исправни називи нивоа су:

emerg
alert
crit
err
warning
notice
info
debug
panic застарели синоним за emerg
error застарели синоним за err
warn застарели синоним за warning

За редослед предности и намераване сврхе ових објеката и нивоа, видите syslog(3).

У СКАЛДУ СА

Наредба logger је очекивана да буде сагласна са IEEE Std 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>.

ПОГЛЕДАЈТЕ ТАКОЂЕ

journalctl(1), syslog(3), systemd.journal-fields(7)

ПРИЈАВЉИВАЊЕ ГРЕШАКА

За пријављивање грешака, користите пратиоца грешака на <https://github.com/util-linux/util-linux/issues>.

ДОСТУПНОСТ

Наредба logger је део пакета „util-linux“ који се може преузети са Архиве Линукс кернела <https://www.kernel.org/pub/linux/utils/util-linux/>.

2023-07-24 util-linux 2.39.1