| LOGGER(1) | أوامر المستخدم | LOGGER(1) |
الاسم
logger - أدخِل رسائل في سجل النظام
موجز
logger [خيارات] رسالة
الوصف
تنشئ أداة logger مدخلات في سجل النظام.
عند وجود معطى رسالة الاختياري، فإنه يُكتب في السجل. إذا لم يكن موجودًا، ولم يُعطَ الخيار -f أيضًا، فسيُسجل الدخل القياسي.
الخيارات
-d، --udp
انظر أيضًا --server و --socket لتحديد مكان الاتصال.
-e، --skip-empty
-f، --file ملف
-i
--id[=معرف]
لاحظ أن بنية تسجيل النظام (على سبيل المثال systemd عند الإنصات على /dev/log) قد تتبع بيانات اعتماد المقابس المحلية لتجاوز معرف العملية (PID) المحدد في الرسالة. يستطيع logger(1) ضبط بيانات اعتماد تلك المقابس على المعرف المعطى، ولكن فقط إذا كنت تملك صلاحيات الجذر وكانت العملية ذات المعرف المحدد موجودة، وإلا فلن تُعدل بيانات اعتماد المقبس وسيُتجاهل المشكل بصمت.
--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). إذا كانت الأولوية مطلوبة، فيجب أن تكون ضمن الدخل وباستخدام حقل 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.
لا يؤثر هذا الخيار على رسالة سطر الأوامر. صُمم هذا الخيار رئيسياً لحالات الاستخدام التي يُستخدم فيها logger في أنبوب (مثل: daemon | logger --prio-prefix) لقراءة رسائل متعددة بأولويات مختلفة.
--rfc3164
--rfc5424[=without]
تعمل قيمة notq على حجب البيانات المهيكلة لجودة الوقت من الرسالة المرسلة. تُظهر معلومات جودة الوقت ما إذا كانت الساعة المحلية متزامنة بالإضافة إلى أقصى عدد من الميكروثانية التي قد ينحرف عنها الطابع الزمني. تُحجب جودة الوقت آلياً أيضاً عند تحديد --sd-id timeQuality.
تعمل قيمة notime (التي تتضمن notq) على حجب الطابع الزمني الكامل للمرسل الذي يكون بتنسيق ISO-8601، بما في ذلك الميكروثانية والمنطقة الزمنية.
تعمل قيمة nohost على حجب معلومات gethostname(2) من ترويسة الرسالة.
أصبح ميفاق RFC 5424 هو المبدئي لأداة logger منذ الإصدار 2.26.
-s، --stderr
--sd-id اسم[@خانات]
تولد أداة logger حالياً عنصر timeQuality القياسي فقط. تصف مواصفة RFC 5424 أيضاً العناصر origin (مع المعاملات ip و enterpriseId و software و swVersion) والعنصر meta (مع المعاملات sequenceId و sysUpTime و language). يمكن تحديد معرفات هذه العناصر دون لاحقة @خانات.
--sd-param اسم=قيمة
logger --rfc5424 --sd-id zoo@123 \
--sd-param tiger="hungry" \
--sd-param zebra="running" \
--sd-id manager@123 \
--sd-param onMeeting="yes" \
"this is message"
ينتج:
<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 حجم
تقبل معظم أجهزة الاستقبال رسائل أكبر من 1KiB عبر أي نوع من ميفاقات syslog. وعلى هذا النحو، يؤثر خيار --size على logger في جميع الحالات (ليس فقط عند استخدام --rfc5424).
ملاحظة: حد حجم الرسالة يحدد الحجم الإجمالي للرسالة، بما في ذلك ترويسة syslog. تختلف أحجام الترويسة اعتمادًا على الخيارات المحددة وطول اسم المضيف. كقاعدة عامة، لا تزيد الترويسات عادةً عن 50 إلى 80 محرفًا. عند اختيار الحد الأقصى لحجم الرسالة، من المهم التأكد من أن المستقبل يدعم الحجم الأقصى أيضًا، وإلا فقد تُبتر الرسائل. ومرة أخرى، كقاعدة عامة، يجب أن يكون حجم الرسالة من 2 إلى 4 KiB مقبولًا بشكل عام، بينما يجب التحقق من عمل أي حجم أكبر من ذلك.
--socket-errors وضع
عندما لا تُفعل الأخطاء، لن يتم الإبلاغ عن الرسائل المفقودة وستؤدي إلى حالة خروج ناجحة لأداة logger(1).
-T، --tcp
انظر أيضًا --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
إلى
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 رُسّخ النظام
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 التي يمكن تنزيلها من أرشيف نواة لينكس https://www.kernel.org/pub/linux/utils/util-linux/.
| 2026-05-18 | util-linux 2.42.1 |