SYSTEMD-JOURNAL-UPLOAD.SERVICE(8)

الاسم
systemd-journal-upload.service, systemd-journal-upload - إرسال رسائل السجل عبر الشبكة

موجز

systemd-journal-upload.service

/usr/lib/systemd/systemd-journal-upload [خيارات...] [-u/--url=رابط] [مصادر...]

الوصف

يقوم systemd-journal-upload برفع إدخالات السجل إلى الرابط المحدد مع --url=. يقرأ هذا البرنامج إدخالات السجل من ملف سجل واحد أو أكثر، على غرار journalctl(1). ما لم يتم تقييده بأحد الخيارات المحددة أدناه، سيتم رفع جميع إدخالات السجل التي يمكن للمستخدم الذي يعمل به البرنامج الوصول إليها، ثم ينتظر البرنامج ويرسل إدخالات جديدة عند توفرها.

ينقل systemd-journal-upload المحتوى الخام لملف السجل ويستخدم HTTP كبروتوكول نقل.

systemd-journal-upload.service هي خدمة نظام تستخدم systemd-journal-upload لرفع إدخالات السجل إلى خادم. تستخدم التهيئة في journal-upload.conf(5). يجب تحديد خيار URL= على الأقل.

الخيارات

-u, --url=[https://]رابط[:منفذ], --url=[http://]رابط[:منفذ]
    الرفع إلى العنوان المحدد. يمكن لـ URL تحديد اسم المضيف فقط أو كلاً من البروتوكول واسم المضيف. https هو المبدئي. يمكن تحديد رقم المنفذ بعد نقطتين (":")، وإلا سيتم استخدام 19532 بشكل مبدئي.

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

--system، --user
    تقييد الإدخالات المرفوعة إلى إدخالات من خدمات النظام والنواة، أو إلى إدخالات من خدمات المستخدم الحالي. له نفس معنى خيارات --system و --user لـ journalctl(1). إذا لم يتم تحديد أي منهما، يتم رفع جميع الإدخالات القابلة للوصول.

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

-m، --merge
    رفع إدخالات متداخلة من جميع السجلات المتاحة، بما في ذلك الأجهزة الأخرى. له نفس معنى خيار --merge لـ journalctl(1).

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

--namespace=نطاق_الأسماء
    يأخذ سلسلة معرف مساحة اسم السجل كوسيطة. رفع إدخالات من مساحة اسم السجل المحددة NAMESPACE بدلاً من مساحة الاسم المبدئية. له نفس معنى خيار --namespace= لـ journalctl(1).

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

-D، --directory=دليل
    يأخذ مسار دليل كوسيطة. رفع إدخالات من دليل السجل المحدد DIR بدلاً من مسارات السجل المبدئية لوقت التشغيل والنظام. له نفس معنى خيار --directory= لـ journalctl(1).

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

--file=GLOB
    يأخذ نمط ملف كوسيطة. رفع إدخالات من ملفات السجل المحددة المطابقة لـ GLOB بدلاً من مسارات السجل المبدئية لوقت التشغيل والنظام. يمكن تحديده عدة مرات، وفي هذه الحالة سيتم تداخل الملفات بشكل مناسب. له نفس معنى خيار --file= لـ journalctl(1).

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

--cursor=
    رفع إدخالات من الموقع في السجل المحدد بواسطة المؤشر الممرر. له نفس معنى خيار --cursor= لـ journalctl(1).

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

--after-cursor=
    رفع إدخالات من الموقع في السجل بعد الموقع المحدد بواسطة هذا المؤشر. له نفس معنى خيار --after-cursor= لـ journalctl(1).

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

--save-state[=مسار]
    رفع إدخالات من الموقع في السجل بعد الموقع المحدد بواسطة المؤشر المحفوظ في ملف في PATH (/var/lib/systemd/journal-upload/state بشكل مبدئي). بعد رفع إدخال بنجاح، تحديث هذا الملف بمؤشر ذلك الإدخال.

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

--follow[=قيمة منطقية]
    إذا ضبط إلى نعم، فإن systemd-journal-upload ينتظر الإدخال.

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

--key=
    يأخذ مسارًا لملف مفتاح SSL بصيغة PEM، أو -. إذا ضبط -، فسيُعطّل التحقق من استيثاق شهادة العميل. المبدئي هو /etc/ssl/private/journal-upload.pem.

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

--cert=
    يأخذ مسارًا لملف شهادة SSL بصيغة PEM، أو -. إذا ضبط -، فسيُعطّل التحقق من استيثاق شهادة العميل. المبدئي هو /etc/ssl/certs/journal-upload.pem.

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

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

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

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

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

حالة الخروج

عند النجاح، يُعاد 0؛ وبخلاف ذلك يُعاد رمز فشل غير صفري.

أمثلة

مثال 1. إعداد الشهادات للاستيثاق

تُستخدم الشهادات الموقّعة من سلطة موثوقة للتحقق من شرعية الخادم الذي تُرفع إليه الرسائل، والعكس بالعكس، أن العميل موثوق.

يمكن إنشاء مجموعة مناسبة من الشهادات باستخدام openssl. لاحظ، يُوصى باستخدام 2048 بت كحد أدنى لطول المفتاح لأسباب أمنية:

    openssl req -newkey rsa:2048 -days 3650 -x509 -nodes \
          -out ca.pem -keyout ca.key -subj '/CN=Certificate authority/'
    cat >ca.conf <<EOF
    [ ca ]
    default_ca = this
    [ this ]
    new_certs_dir = .
    certificate = ca.pem
    database = ./index
    private_key = ca.key
    serial = ./serial
    default_days = 3650
    default_md = default
    policy = policy_anything
    [ policy_anything ]
    countryName             = optional
    stateOrProvinceName     = optional
    localityName            = optional
    organizationName        = optional
    organizationalUnitName  = optional
    commonName              = supplied
    emailAddress            = optional
    EOF
    touch index
    echo 0001 >serial
    SERVER=server
    CLIENT=client
    openssl req -newkey rsa:2048 -nodes -out $SERVER.csr -keyout $SERVER.key -subj "/CN=$SERVER/"
    openssl ca -batch -config ca.conf -notext -in $SERVER.csr -out $SERVER.pem
    openssl req -newkey rsa:2048 -nodes -out $CLIENT.csr -keyout $CLIENT.key -subj "/CN=$CLIENT/"
    openssl ca -batch -config ca.conf -notext -in $CLIENT.csr -out $CLIENT.pem

يجب تثبيت الملفات المُنشأة ca.pem و server.pem و server.key على الخادم، و ca.pem و client.pem و client.key على العميل. يمكن تحديد موقع هذه الملفات باستخدام TrustedCertificateFile= و ServerCertificateFile= و ServerKeyFile= في /etc/systemd/journal-remote.conf و /etc/systemd/journal-upload.conf على التوالي. يمكن الاستعلام عن المواقع المبدئية باستخدام systemd-journal-remote --help و systemd-journal-upload --help.

انظر أيضًا

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

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

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

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