SYSTEMD.JOURNAL-FIELDS(7)

الاسم
systemd.journal-fields - حقول دفتر اليومية الخاصة

الوصف

الإدخالات في دفتر اليومية (كما يكتبها systemd-journald.service(8)) تشبه كتلة بيئة عملية UNIX في الصياغة ولكن مع قيم حقول قد تتضمن بيانات ثنائية، ويُسمح بأسماء حقول غير فريدة. بشكل أساسي، قيم الحقول هي نصوص UTF-8 منسقة — يُستخدم الترميز الثنائي فقط عندما يكون التنسيق كنصوص UTF-8 غير منطقي. يمكن للتطبيقات تعريف حقول جديدة بحرية، ولكن بعض الحقول لها معانٍ خاصة، مذكورة أدناه. عادةً، قد تظهر الحقول مرة واحدة فقط لكل إدخال سجل، ولكن هناك استثناءات خاصة: بعض الحقول قد تظهر أكثر من مرة لكل إدخال، وفي هذه الحالة يُذكر ذلك صراحةً أدناه. على الرغم من أن النظام الفرعي للتسجيل لا يفرض قيودًا على الحقول التي تقبل قيمًا غير فريدة، يُوصى بشدة بتجنب الاعتماد على هذا للحقول المذكورة أدناه (باستثناء ما هو مذكور خلاف ذلك) لتجنب عدم التوافق غير الضروري مع التطبيقات الأخرى.

حقول دفتر اليومية للمستخدم

حقول المستخدم هي حقول تُمرر مباشرة من العملاء وتُخزن في دفتر اليومية.

MESSAGE=
    سلسلة الرسالة القابلة للقراءة البشرية لهذا الإدخال. يُفترض أن يكون هذا النص الأساسي المعروض للمستخدم. عادةً لا يُترجم (ولكن قد يُترجم في بعض الحالات)، ولا يُفترض تحليله لاستخراج بيانات وصفية. لتشفير عدة أسطر في إدخال سجل واحد، افصلها بأحرف سطر جديد (رمز ASCII 10)، ولكن قم بتشفيرها كحقل واحد MESSAGE=. لا تُضف قيمًا متعددة من هذا النوع من الحقول إلى نفس الإدخال (انظر أيضًا أعلاه)، لأن التطبيقات المستهلكة لا تتوقع ذلك عمومًا ومن غير المرجح أن تظهر جميع القيم في هذه الحالة.

MESSAGE_ID=
    معرف رسالة 128 بت للتعرف على أنواع معينة من الرسائل، إذا كان ذلك مرغوبًا. يجب أن يحتوي هذا على معرف 128 بت منسق كسلسلة ست عشرية صغيرة، بدون أي شرطات فاصلة أو ما شابه. يُوصى بأن يكون معرفًا متوافقًا مع UUID، ولكن هذا غير مفروض، وقد يُنسق بشكل مختلف. يمكن للمطورين إنشاء معرف جديد لهذا الغرض باستخدام systemd-id128 new.

PRIORITY=
    قيمة أولوية بين 0 ("emerg") و 7 ("debug") منسقة كسلسلة عشرية. هذا الحقل متوافق مع مفهوم الأولوية في syslog.

CODE_FILE=, CODE_LINE=, CODE_FUNC=
    موقع الكود الذي يولد هذه الرسالة، إذا كان معروفًا. يحتوي على اسم ملف المصدر ورقم السطر واسم الدالة.

ERRNO=
    رقم خطأ Unix منخفض المستوى الذي تسبب في هذا الإدخال، إن وجد. يحتوي على القيمة الرقمية لـ errno(3) منسقة كسلسلة عشرية.

    أُضيف في الإصدارة 188.

INVOCATION_ID=, USER_INVOCATION_ID=
    معرف 128 بت عشوائي وفريد يحدد كل دورة تشغيل للوحدة. هذا يختلف عن _SYSTEMD_INVOCATION_ID في أنه يُستخدم فقط للرسائل القادمة من كود systemd (مثل سجلات من مدير النظام/المستخدم أو من العمليات المتفرعة التي تؤدي إعدادًا متعلقًا بـ systemd).

    أُضيف في الإصدار 245.

SYSLOG_FACILITY=, SYSLOG_IDENTIFIER=, SYSLOG_PID=, SYSLOG_TIMESTAMP=
    حقول توافق Syslog تحتوي على التسهيل (منسق كسلسلة عشرية)، وسلسلة المعرف (أي "العلامة")، ومعرف عملية العميل، والطابع الزمني كما هو محدد في مخطط البيانات الأصلي. (لاحظ أن العلامة تُشتق عادةً من متغير glibc program_invocation_short_name، انظر program_invocation_short_name(3).)

    لاحظ أن خدمة دفتر اليومية لا تتحقق من صحة قيم أي حقول منظمة لدفتر اليومية التي لا يسبق اسمها شرطة سفلية، وهذا يشمل أي حقول متعلقة بـ syslog مثل هذه. وبالتالي، من المتوقع أن تقوم التطبيقات التي توفر تسهيلاً أو معرف عملية أو مستوى سجل بذلك بشكل منسق بشكل صحيح، أي كأعداد صحيحة منسقة كأعداد عشرية.

SYSLOG_RAW=
    المحتويات الأصلية لسطر syslog كما وردت في مخطط بيانات syslog. يُدرج هذا الحقل فقط إذا تم تعديل حقل MESSAGE= مقارنة بالحمولة الأصلية أو إذا تعذر تحديد الطابع الزمني بشكل صحيح ولم يُدرج في SYSLOG_TIMESTAMP=. يحدث اقتطاع الرسالة عندما تحتوي الرسالة على مسافات بادئة أو لاحقة (تُزال المسافات البادئة واللاحقة)، أو تحتوي على بايت NUL مضمن (لا يُدرج بايت NUL وأي شيء بعده). وبالتالي، يُخزن سطر syslog الأصلي إما كـ SYSLOG_RAW= أو يمكن إعادة إنشائه بناءً على الأولوية والتسهيل المخزنين، والطابع الزمني، والمعرف، وحمولة الرسالة في MESSAGE=.

    أُضيف في الإصدار 240.

DOCUMENTATION=
    عنوان URL للتوثيق مع معلومات إضافية حول موضوع رسالة السجل. ستتضمن أدوات مثل journalctl رابطًا تشعبيًا إلى عنوان URL محدد بهذه الطريقة في مخرجاتها. يجب أن يكون عنوان URL من نوع "http://" أو "https://" أو "file:/" أو "man:" أو "info:".

    أُضيف في الإصدار 246.

TID=
    معرف الخيط الرقمي (TID) الذي تنشأ منه رسالة السجل.

    أُضيف في الإصدار 247.

UNIT=, USER_UNIT=
    اسم وحدة. يُستخدم من قبل مديري النظام والمستخدم عند تسجيل الدخول حول وحدات محددة.

    عند استخدام --unit=name أو --user-unit=name مع journalctl(1)، سيُولد نمط مطابقة يتضمن "UNIT=name.service" أو "USER_UNIT=name.service".

    أُضيف في الإصدار 251.

حقول دفتر اليومية الموثوقة

الحقول المسبوقة بشرطة سفلية هي حقول موثوقة، أي حقول تُضاف ضمنيًا بواسطة دفتر اليومية ولا يمكن تغييرها بواسطة كود العميل.

_PID=، _UID=، _GID=
    رقم العملية ورقم المستخدم ورقم المجموعة للعملية التي ينشأ منها إدخال دفتر اليومية، مُنسقة كأعداد عشرية. لاحظ أن الإدخالات التي تُحصل عبر "stdout" أو "stderr" للعمليات المتفرعة ستحتوي على بيانات استيثاق صالحة لعملية أصل (التي بدأت الاتصال بـ systemd-journald).

_COMM=، _EXE=، _CMDLINE=
    الاسم ومسار الملف التنفيذي وسطر الأوامر للعملية التي ينشأ منها إدخال دفتر اليومية.

_CAP_EFFECTIVE=
    الصلاحيات الفعالة capabilities(7) للعملية التي ينشأ منها إدخال دفتر اليومية.

    أُضيف في الإصدارة 206.

_AUDIT_SESSION=، _AUDIT_LOGINUID=
    الجلسة ومعرف المستخدم لتسجيل الدخول للعملية التي ينشأ منها إدخال دفتر اليومية، كما تُحفظ بواسطة نظام التدقيق الفرعي للنواة.

_SYSTEMD_CGROUP=، _SYSTEMD_SLICE=، _SYSTEMD_UNIT=، _SYSTEMD_USER_UNIT=، _SYSTEMD_USER_SLICE=، _SYSTEMD_SESSION=، _SYSTEMD_OWNER_UID=
    مسار مجموعة التحكم في التسلسل الهرمي لـ systemd، واسم وحدة الشريحة systemd، واسم وحدة systemd، واسم الوحدة في مدير مستخدم systemd (إن وُجد)، ومعرف جلسة systemd (إن وُجد)، ومعرف المستخدم المالك لوحدة مستخدم systemd أو جلسة systemd (إن وُجد) للعملية التي ينشأ منها إدخال دفتر اليومية.

_SELINUX_CONTEXT=
    سياق الأمان SELinux (الوسم) للعملية التي ينشأ منها إدخال دفتر اليومية.

_SOURCE_REALTIME_TIMESTAMP=
    أقدم طابع زمني موثوق للرسالة، إن وُجد أي طابع معروف يختلف عن وقت استقبال دفتر اليومية. الطابع الزمني هو وقت CLOCK_REALTIME بالميكروثانية، مُنسق كعدد عشري.

_SOURCE_BOOTTIME_TIMESTAMP=
    أقدم طابع زمني موثوق للرسالة في وقت CLOCK_BOOTTIME، بنفس تنسيق _SOURCE_REALTIME_TIMESTAMP=.

    أُضيف في الإصدار 257.

_BOOT_ID=
    معرف إقلاع النواة للإقلاع الذي وُلدت فيه الرسالة، مُنسق كسلسلة ست عشرية 128 بت.

_MACHINE_ID=
    معرف الآلة للمضيف الأصلي، كما هو موصوف في machine-id(5).

_SYSTEMD_INVOCATION_ID=
    معرف الاستدعاء لدورة التشغيل للوحدة التي وُلدت فيها الرسالة، كما هو متاح لعمليات الوحدة في $INVOCATION_ID (انظر systemd.exec(5)).

    أُضيف في الإصدار 233.

_HOSTNAME=
    اسم المضيف للمضيف الأصلي.

_TRANSPORT=
    كيفية استقبال الإدخال بواسطة خدمة دفتر اليومية. وسائل النقل الصالحة هي:

    audit
        لتلك المقروءة من نظام التدقيق الفرعي للنواة

        أُضيف في الإصدارة 227.

    driver
        للرسائل المولدة داخليًا

        أُضيف في الإصدارة 205.

    syslog
        لتلك المستقبلة عبر مقبس syslog المحلي باستخدام بروتوكول syslog

        أُضيف في الإصدارة 205.

    journal
        لتلك المستقبلة عبر بروتوكول دفتر اليومية الأصلي

        أُضيف في الإصدارة 205.

    stdout
        لتلك المقروءة من الإخراج القياسي أو إخراج الخطأ لخدمة

        أُضيف في الإصدارة 205.

    kernel
        لتلك المقروءة من النواة

        أُضيف في الإصدارة 205.

_STREAM_ID=
    ينطبق فقط على سجلات "_TRANSPORT=stdout": يحدد معرفًا عشوائيًا 128 بت مُسندًا إلى اتصال التدفق عند إنشائه لأول مرة. هذا المعرف مفيد لإعادة بناء تدفقات السجل الفردية من سجلات السجل: جميع سجلات السجل التي تحمل نفس معرف التدفق تنشأ من نفس التدفق.

    أُضيف في الإصدارة 235.

_LINE_BREAK=
    ينطبق فقط على سجلات "_TRANSPORT=stdout": يشير إلى أن رسالة السجل في تدفق الإخراج القياسي/الخطأ لم تُنهَ بحرف سطر جديد عادي ("\n"، أي ASCII 10). تحديدًا، عند التعيين، يكون هذا الحقل واحدًا من nul (في حال إنهاء السطر ببايت NUL)، أو line-max (في حال الوصول إلى الحد الأقصى لطول سطر السجل، كما هو مكون مع LineMax= في journald.conf(5))، أو eof (إذا كان هذا هو آخر سجل سجل لتدفق وانتهى التدفق دون حرف سطر جديد نهائي)، أو pid-change (إذا تغيرت العملية التي ولدت إخراج السجل في منتصف سطر). لاحظ أن هذا السجل لا يُولد عند استخدام حرف سطر جديد عادي لتمييز نهاية سطر السجل.

    أُضيف في الإصدارة 235.

_NAMESPACE=
    إذا كان هذا الملف قد كُتب بواسطة نسخة systemd-journald تدير نطاق يوميات ليس المبدئي، فإن هذا الحقل يحتوي على معرف النطاق. انظر systemd-journald.service(8) للتفاصيل حول نطاقات اليوميات.

    أُضيف في الإصدار 245.

_RUNTIME_SCOPE=
    حقل نصي يحدد نطاق وقت التشغيل الذي سُجلت فيه الرسالة. إذا كان "initrd"، فقد عولجت رسالة السجل بينما كان النظام يعمل داخل initrd. إذا كان "system"، فقد وُلدت رسالة السجل بعد أن بدّل النظام التنفيذ إلى نظام الملفات الجذري للمضيف.

    أُضيف في الإصدار 252.

حقول يوميات النواة

حقول النواة هي حقول تُستخدم بواسطة رسائل مصدرها النواة وتُخزّن في اليومية.

_KERNEL_DEVICE=
    اسم جهاز النواة. إذا كان الإدخال مرتبطًا بجهاز كتلة، يحتوي على الرقمين الرئيسي والثانوي لعقدة الجهاز، مفصولين بـ ":" ومسبوقين بـ "b". وبالمثل للأجهزة الحرفية، لكن مسبوقة بـ "c". للأجهزة الشبكية، هذا هو فهرس الواجهة مسبوقًا بـ "n". لجميع الأجهزة الأخرى، هذا هو اسم النظام الفرعي مسبوقًا بـ "+"، متبوعًا بـ ":"، متبوعًا باسم جهاز النواة.

    أُضيف في الإصدارة 189.

_KERNEL_SUBSYSTEM=
    اسم النظام الفرعي للنواة.

    أُضيف في الإصدارة 189.

_UDEV_SYSNAME=
    اسم جهاز النواة كما يظهر في شجرة الأجهزة أسفل /sys/.

    أُضيف في الإصدارة 189.

_UDEV_DEVNODE=
    مسار عقدة الجهاز لهذا الجهاز في /dev/.

    أُضيف في الإصدارة 189.

_UDEV_DEVLINK=
    أسماء روابط رمزية إضافية تشير إلى عقدة الجهاز في /dev/. يُضبط هذا الحقل غالبًا أكثر من مرة لكل إدخال.

    أُضيف في الإصدارة 189.

حقول للتسجيل نيابة عن برنامج مختلف

تُستخدم الحقول في هذا القسم بواسطة البرامج لتحديد أنها تسجل نيابة عن برنامج أو وحدة أخرى.

الحقول المستخدمة بواسطة مساعد نواة التفريغ الأساسي systemd-coredump:

COREDUMP_UNIT=, COREDUMP_USER_UNIT=
    تُستخدم لتعليق الرسائل التي تحتوي على تفريغات أساسية من وحدات النظام والجلسة. انظر coredumpctl(1).

    أُضيف في الإصدارة 198.

قد تُرفق البرامج المميزة (UID 0 حاليًا) OBJECT_PID= برسالة. سيوجه هذا systemd-journald لإرفاق حقول إضافية نيابة عن المتصل:

OBJECT_PID=PID
    PID للبرنامج الذي تتعلق به هذه الرسالة.

    أُضيف في الإصدارة 205.

OBJECT_UID=, OBJECT_GID=, OBJECT_COMM=, OBJECT_EXE=, OBJECT_CMDLINE=, OBJECT_AUDIT_SESSION=, OBJECT_AUDIT_LOGINUID=, OBJECT_SYSTEMD_CGROUP=, OBJECT_SYSTEMD_SESSION=, OBJECT_SYSTEMD_OWNER_UID=, OBJECT_SYSTEMD_UNIT=, OBJECT_SYSTEMD_USER_UNIT=
    هذه حقول إضافية تُضاف آليًا بواسطة systemd-journald. معناها مماثل لـ _UID=, _GID=, _COMM=, _EXE=, _CMDLINE=, _AUDIT_SESSION=, _AUDIT_LOGINUID=, _SYSTEMD_CGROUP=, _SYSTEMD_SESSION=, _SYSTEMD_UNIT=, _SYSTEMD_USER_UNIT=, و _SYSTEMD_OWNER_UID= كما هو موصوف أعلاه، باستثناء أن العملية المحددة بواسطة PID هي الموصوفة، بدلاً من العملية التي سجلت الرسالة.

    أُضيف في الإصدارة 205.

OBJECT_SYSTEMD_INVOCATION_ID=
    حقل إضافي يُضاف آليًا بواسطة systemd-journald. المعنى مماثل في الغالب لـ _SYSTEMD_INVOCATION_ID=، مع الاختلاف الموصوف أعلاه.

    أُضيف في الإصدارة 235.

حقول العناوين

أثناء التسلسل إلى صيغ خارجية، مثل صيغة تصدير اليومية[1] أو صيغة JSON اليومية[2]، تُسلسل عناوين إدخالات اليومية إلى حقول مسبوقة بشرطتين سفليتين. لاحظ أن هذه ليست حقولًا صحيحة عند تخزينها في اليومية بل لبيانات وصفية لعنونة الإدخالات. لا يمكن كتابتها كجزء من إدخالات سجل منظمة عبر استدعاءات مثل sd_journal_send(3). قد لا تُستخدم أيضًا كمطابقات لـ sd_journal_add_match(3).

__CURSOR=
    المؤشر للإدخال. المؤشر هو سلسلة نصية معتمة تصف بشكل فريد موضع إدخال في اليومية وهي محمولة عبر الآلات والمنصات وملفات اليومية.

__REALTIME_TIMESTAMP=
    وقت الساعة الحائطية (CLOCK_REALTIME) عند نقطة الزمن التي استُلم فيها الإدخال بواسطة اليومية، بالميكروثانية منذ الحقبة UTC، منسقًا كرقم عشري. هذا له خصائص مختلفة عن "_SOURCE_REALTIME_TIMESTAMP="، حيث أنه عادةً ما يكون متأخرًا قليلاً لكن أكثر احتمالاً ليكون رتيبًا.

__MONOTONIC_TIMESTAMP=
    الوقت الرتيب (CLOCK_MONOTONIC) عند نقطة الزمن التي استُلم فيها الإدخال بواسطة اليومية بالميكروثانية، منسقًا كرقم عشري. ليكون مفيدًا كعنوان للإدخال، يجب دمج هذا مع معرف الإقلاع في "_BOOT_ID=".

__SEQNUM=، __SEQNUM_ID=
    رقم التسلسل (ومُعرّف رقم التسلسل المرتبط) لهذا الإدخال في دفتر اليوميات في ملف دفتر اليوميات الذي ينشأ منه. انظر sd_journal_get_seqnum(3) للتفاصيل.

    أُضيف في الإصدار 254.

انظر أيضًا

systemd(1)، systemd-journald.service(8)، journalctl(1)، journald.conf(5)، sd-journal(3)، coredumpctl(1)، systemd.directives(7)

ملاحظات

1.  تنسيق تصدير اليوميات
    https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-export-format

2.  تنسيق JSON لليومية
    https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-json-format

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.