SYSTEMD-JOURNAL-REMOTE.SERVICE(8)

الاسم
systemd-journal-remote.service, systemd-journal-remote.socket, systemd-journal-remote - استقبال رسائل السجل عبر الشبكة

موجز

systemd-journal-remote.service

systemd-journal-remote.socket

/usr/lib/systemd/systemd-journal-remote [OPTIONS...] [-o/--output=DIR|FILE] [SOURCES...]

الوصف

systemd-journal-remote هو أمر لاستقبال أحداث السجل المسلسلة وتخزينها في ملفات السجل. تيارات الإدخال تكون بتنسيق تنسيق تصدير السجل[1]، أي مثل المخرجات من journalctl --output=export. للنقل عبر الشبكة، يُحمل هذا التيار المسلسل عادة عبر اتصال HTTPS.

systemd-journal-remote.service هي خدمة نظام تستخدم systemd-journal-remote للاستماع للاتصالات. يقوم systemd-journal-remote.socket بتكوين عنوان الشبكة الذي يستمع عليه systemd-journal-remote.service. مبدئيًا، هذا هو المنفذ 19532. يمكن تكوين الاتصالات المقبولة وكيفية تخزين البيانات المستلمة عبر ملف التكوين journal-remote.conf(5).

المصادر

يمكن أن تكون المصادر إما "نشطة" (يطلب systemd-journal-remote ويسحب البيانات)، أو "سلبية" (ينتظر systemd-journal-remote اتصالًا ثم يستقبل أحداثًا مدفوعة من الجانب الآخر).

يمكن لـ systemd-journal-remote قراءة أكثر من تيار حدث في وقت واحد. سيتم تداخلها في ملف المخرجات. في حالة الاتصالات "النشطة"، كل "مصدر" هو تيار واحد، وفي حالة الاتصالات "السلبية"، يمكن أن يؤدي كل اتصال إلى تيار منفصل. يمكن تكوين المقابس في وضع "قبول" (أي اتصال واحد فقط)، أو وضع "استماع" (أي اتصالات متعددة، كل منها يؤدي إلى تيار).

عند عدم وجود اتصالات أخرى، ولا يمكن إنشاء المزيد (لا توجد مقابس استماع)، فإن systemd-journal-remote سيخرج.

يمكن تحديد المصادر النشطة بالطرق التالية:

[SOURCES]
    عند إعطاء - كوسيط موضعي، ستُقرأ الأحداث من الإدخال القياسي. سيتم معالجة الوسائط الموضعية الأخرى كأسماء ملفات لفتحها والقراءة منها.

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

--url=ADDRESS
    مع الخيار --url=ADDRESS، سيتم استرجاع الأحداث باستخدام HTTP من ADDRESS. يجب أن يشير عنوان URL هذا إلى جذر مثيل systemd-journal-gatewayd(8) عن بُعد، على سبيل المثال http://some.host:19531/ أو https://some.host:19531/.

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

--getter='PROG [OPTIONS]'
    برنامج لاستدعائه لاسترجاع البيانات. يجب إنشاء تيار حدث السجل على المخرجات القياسية.

    أمثلة:

        --getter='curl "-HAccept: application/vnd.fdo.journal" https://some.host:19531/'

        --getter='wget --header="Accept: application/vnd.fdo.journal" -O- https://some.host:19531/'

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

يمكن تحديد المصادر السلبية بالطرق التالية:

--listen-raw=ADDRESS
    يجب أن يكون ADDRESS عنوانًا مناسبًا لـ ListenStream= (راجع systemd.socket(5)). سيستمع systemd-journal-remote على هذا المقبس للاتصالات. يُتوقع أن يكون كل اتصال دفقًا من أحداث السجل.

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

--listen-http=ADDRESS, --listen-https=ADDRESS
    يجب أن يكون ADDRESS إما عددًا صحيحًا سالبًا، وفي هذه الحالة يُفسر على أنه رقم واصف الملف (المنفي)، أو عنوانًا مناسبًا لـ ListenStream= (راجع systemd.socket(5)). في الحالة الأولى، يستمع الخادم على المنفذ 19532 مبدئيًا، ويجب توريث واصف الملف المطابق عبر $LISTEN_FDS/$LISTEN_PID. في الحالة الثانية، يُنشأ خادم HTTP أو HTTPS على هذا المنفذ، لـ --listen-http= و --listen-https= على التوالي. حاليًا، تُدعم فقط طلبات POST إلى /upload مع "Content-Type: application/vnd.fdo.journal".

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

$LISTEN_FDS
    يدعم systemd-journal-remote بروتوكول $LISTEN_FDS/$LISTEN_PID. تتصرف المقابس المفتوحة الموروثة عبر تنشيط المقبس مثل تلك المفتوحة مع --listen-raw= الموصوف أعلاه، ما لم تُحدد كوسيطة في --listen-http=-n أو --listen-https=-n أعلاه. في الحالة الأخيرة، يُنشأ خادم HTTP أو HTTPS باستخدام هذا الواصف ويجب أن تتم الاتصالات عبر بروتوكول HTTP.

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

--key=
    يأخذ مسارًا لملف مفتاح سري SSL بتنسيق PEM. المبدئي هو /etc/ssl/private/journal-remote.pem. يمكن استخدام هذا الخيار مع --listen-https=. إذا أشار المسار إلى مقبس دفق AF_UNIX في نظام الملفات، يُنشأ اتصال به ويُقرأ المفتاح منه.

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

--cert=
    يأخذ مسارًا لملف شهادة SSL بتنسيق PEM. المبدئي هو /etc/ssl/certs/journal-remote.pem. يمكن استخدام هذا الخيار مع --listen-https=. إذا أشار المسار إلى مقبس دفق AF_UNIX في نظام الملفات، يُنشأ اتصال به وتُقرأ الشهادة منه.

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

--trust=
    يأخذ مسارًا لملف شهادة SSL CA بتنسيق PEM، أو all. إذا ضُبط all، فسيُعطل فحص الشهادة. المبدئي هو /etc/ssl/ca/trusted.pem. يمكن استخدام هذا الخيار مع --listen-https=. إذا أشار المسار إلى مقبس دفق AF_UNIX في نظام الملفات، يُنشأ اتصال به وتُقرأ الشهادة منه.

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

--gnutls-log=
    يأخذ قائمة مفصولة بفواصل لفئات تسجيل gnutls. يمكن استخدام هذا الخيار مع --listen-http= أو --listen-https=.

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

المصارف

يمكن تحديد موقع سجل المخرجات باستخدام -o أو --output=.

-o FILE, --output=FILE
    سيكتب إلى ملف السجل هذا. يجب أن ينتهي اسم الملف بـ .journal. سيُنشأ الملف إذا لم يكن موجودًا. إذا لزم الأمر (امتلاء ملف السجل أو تلفه)، سيُعاد تسمية الملف باتباع قواعد journald العادية وسيُنشأ ملف سجل جديد مكانه.

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

-o DIR, --output=DIR
    سينشئ ملفات سجل داخل الدليل DIR. يجب أن يكون الدليل موجودًا. إذا لزم الأمر (تجاوز ملفات السجل للحجم، أو تلفها)، ستُدور ملفات السجل باتباع قواعد journald العادية. ستُنشأ أسماء الملفات داخل DIR باستخدام القواعد الموصوفة أدناه.

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

إذا لم يُستخدم --output=، فسيُستخدم دليل المخرجات /var/log/journal/remote/. في حال عدم تحديد ملف المخرجات، ستنشأ ملفات السجل داخل الدليل المحدد. ستُسمى الملفات remote-hostname.journal، حيث يكون الجزء hostname هو اسم المضيف المُفلتر لنقطة نهاية المصدر للاتصال، أو العنوان الرقمي إذا تعذر تحديد اسم المضيف.

في حالة إعطاء مصادر "نشطة" بواسطة الوسائط الموضعية أو خيار --getter=، يجب دائمًا إعطاء اسم ملف المخرجات صراحةً.

الخيارات

الخيارات التالية مفهومة:

--split-mode
    أحد none أو host. للأول، يُستخدم ملف سجل مخرجات واحد فقط. للأخير، يُستخدم ملف مخرجات منفصل، بناءً على اسم المضيف لنقطة النهاية الأخرى للاتصال.

    في حالة إعطاء مصادر "نشطة" بواسطة الوسائط الموضعية أو خيار --getter=، يجب دائمًا إعطاء اسم ملف المخرجات صراحةً ويُسمح فقط بـ none.

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

--compress [BOOL]
    إذا ضُبط هذا على "yes" فسيتم ضغط البيانات في السجل باستخدام XZ. المبدئي هو "yes".

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

--seal [BOOL]
    إذا ضُبط هذا على "yes" فسيتم توقيع البيانات في السجل دوريًا باستخدام الختم الآمن الأمامي. المبدئي هو "no".

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

--max-use=، --keep-free=، --max-file-size=، --max-files=
    تتجاوز هذه الخيارات الإعدادات المقابلة من ملف التشكيل (انظر journal-remote.conf(5)). انظر تلك الصفحة لوصف هذه الخيارات.

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

-h، --help
    اطبع نص مساعدة قصير واخرج.

--version
    اطبع سلسلة إصدار قصيرة واخرج.

أمثلة

انسخ أحداث السجل المحلي إلى دليل سجل مختلف:

    journalctl -o export | systemd-journal-remote -o /tmp/dir/foo.journal -

استرجع جميع الأحداث المتاحة من مثيل systemd-journal-gatewayd(8) عن بُعد وخزّنها في /var/log/journal/remote/remote-some.host.journal:

    systemd-journal-remote --url http://some.host:19531/

استرجع أحداث الإقلاع الحالية وانتظر أحداثًا جديدة من مثيل systemd-journal-gatewayd(8) عن بُعد، وخزّنها في /var/log/journal/remote/remote-some.host.journal:

    systemd-journal-remote --url http://some.host:19531/entries?boot&follow

انظر أيضًا

journal-remote.conf(5), journalctl(1), systemd-journal-gatewayd.service(8), systemd-journal-upload.service(8), systemd-journald.service(8)

ملاحظات

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

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

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

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