JOURNAL-UPLOAD.CONF(5)

الاسم
journal-upload.conf, journal-upload.conf.d - ملفات تهيئة لخدمة رفع السجل

موجز

/etc/systemd/journal-upload.conf

/run/systemd/journal-upload.conf

/usr/lib/systemd/journal-upload.conf

/etc/systemd/journal-upload.conf.d/*.conf

/run/systemd/journal-upload.conf.d/*.conf

/usr/lib/systemd/journal-upload.conf.d/*.conf

الوصف

تُهيئ هذه الملفات معاملات متنوعة لـ systemd-journal-upload.service(8). يُراجع systemd.syntax(7) لوصف عام للصياغة.

أدلة الضبط والأسبقية

يُضبط التشكيل المبدئي أثناء التجميع، لذا لا يلزم التشكيل إلا عند الحاجة للانحراف عن تلك القيم المبدئية. يُحمل ملف التشكيل الرئيس من أحد الأدلة المدرجة حسب ترتيب الأولوية، ويُستخدم أول ملف يُعثر عليه فقط: /etc/systemd/، و /run/systemd/، و /usr/local/lib/systemd/ [1]، و /usr/lib/systemd/. تحتوي نسخة المورد من الملف على مدخلات مُعلقة تظهر القيم المبدئية كدليل للمدير. يمكن أيضًا إنشاء تجاوزات محلية عن طريق إنشاء ملفات تكميلية (drop-ins)، كما هو موضح أدناه. يمكن أيضًا تحرير ملف التشكيل الرئيس لهذا الغرض (أو نسخة في /etc/ إذا كانت مشحونة تحت /usr/)، ومع ذلك يوصى باستخدام الملفات التكميلية للتشكيل المحلي بدلاً من إجراء تعديلات على ملف التشكيل الرئيس.

بالإضافة إلى ملف الإعداد الرئيس، تُقرأ قصاصات الإعداد الإضافية من /usr/lib/systemd/*.conf.d/ و /usr/local/lib/systemd/*.conf.d/ و /etc/systemd/*.conf.d/. لهذه الإضافات أولوية أعلى وتتجاوز ملف الإعداد الرئيس. تُفرز الملفات في الأدلة الفرعية للإعداد *.conf.d/ حسب أسماء ملفاتها بترتيب معجمي، بغض النظر عن الدليل الفرعي الذي توجد فيه. عندما تحدد ملفات متعددة نفس الخيار، بالنسبة للخيارات التي تقبل قيمة واحدة فقط، فإن المدخلة في الملف الأخير في الترتيب هي التي تسود، وبالنسبة للخيارات التي تقبل قائمة من القيم، تُجمع المدخلات كما تظهر في الملفات المرتبة.

عندما تحتاج الحزم إلى تخصيص الضبط، يمكنها تثبيت ملفات تكميلية (drop-ins) تحت /usr/. تُحجز الملفات في /etc/ لمدير النظام المحلي، الذي قد يستخدم هذا المنطق لتخطي ملفات الضبط المثبتة من قبل حزم المورّد. يجب استخدام الملفات التكميلية لتخطي ملفات الحزم التكميلية، بما أن ملف الضبط الرئيس له أسبقية أدنى. ويُوصى ببدء جميع أسماء الملفات في تلك المجلدات الفرعية برقم من خانتين وواصلة، لتبسيط الترتيب. كما يحدد هذا مفهوم أولويات الملفات التكميلية للسماح لموردي أنظمة التشغيل بشحن ملفات تكميلية ضمن نطاق محدد أدنى من النطاق الذي يستخدمه المستخدمون. وهذا من شأنه أن يقلل من خطر تخطي ملفات الحزم التكميلية للملفات التكميلية التي حددها المستخدمون عرضًا. ويُوصى باستخدام النطاق 10-40 للملفات التكميلية في /usr/ والنطاق 60-90 للملفات التكميلية في /etc/ و /run/، للتأكد من أن الملفات التكميلية المحلية والعابرة تأخذ الأولوية على الملفات التكميلية التي يشحنها مورد نظام التشغيل.

لتعطيل ملف تشكيل مقدم من المورد، فإن الطريقة الموصى بها هي وضع وصلة رمزية إلى /dev/null في دليل التشكيل في /etc/، بنفس اسم ملف تشكيل المورد.

الخيارات

تُهيأ جميع الخيارات في القسم [Upload]:

URL=
    عنوان URL لرفع مدخلات السجل إليه. يُراجع وصف الخيار --url= في systemd-journal-upload(8) لوصف القيم الممكنة. لا توجد قيمة مبدئية، لذا يجب أن يكون هذا الخيار أو خيار سطر الأوامر حاضرًا دائمًا لإجراء الرفع.

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

ServerKeyFile=
    مفتاح SSL بتنسيق PEM.

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

ServerCertificateFile=
    شهادة SSL CA بصيغة PEM.

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

TrustedCertificateFile=
    شهادة مَصْدر تصديق (CA) لـ SSL.

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

NetworkTimeoutSec=
    عند فقدان الاتصال الشبكي بالخادم، يُهيئ هذا الخيار وقت الانتظار لاستعادة الاتصال. إذا لم يكن الخادم قابلًا للوصول عبر الشبكة للوقت المُهيأ، يخرج systemd-journal-upload. يأخذ قيمة بالثواني (أو بوحدات زمنية أخرى إذا أُلحقت بـ "ms" أو "min" أو "h" إلخ). للتفاصيل، يُراجع systemd.time(7).

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

Compression=
    يُهيئ خوارزمية الضغط المطبقة على بيانات السجلات قبل الإرسال. يأخذ قائمة مفصولة بمسافات من خوارزميات الضغط، أو "no". الخوارزميات المدعومة هي "zstd" أو "xz" أو "lz4". اختياريًا، يتبع كل خوارزمية نقطتان (":") ومستوى ضغطها، مثلاً "zstd:4". يُتوقع أن يكون مستوى الضغط عددًا صحيحًا موجبًا. عند تحديد "no"، لا تُطبق أي خوارزمية ضغط على البيانات المرسلة. يمكن تحديد هذا الخيار عدة مرات. إذا أُسندت سلسلة فارغة، فتُمسح جميع الإسنادات السابقة. المبدئي غير مُعين، وتُدرج جميع خوارزميات الضغط المدعومة بمستويات ضغطها المبدئية.

    مثال:

        Compression=zstd:4 lz4:2

    حتى عند تمكين الضغط، تُرسل الطلبات الأولية دون ضغط. يصبح فعالاً إما إذا مُكّن "ForceCompression="، أو إذا احتوى رد الخادم على ترويسات "Accept-Encoding" بقائمة خوارزميات ضغط تحتوي على إحدى الخوارزميات المحددة في هذا الخيار.

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

ForceCompression=
    يأخذ قيمة منطقية، يُجبر استخدام الضغط دون تفاوض ترميز المحتوى. المبدئي هو "false".

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

Header=
    يُحدد ترويسة HTTP إضافية تُضاف إلى كل طلب إلى URL. يأخذ زوجًا من اسم الترويسة وقيمتها مفصولين بنقطتين (":")، مثلاً "Name:Value". يمكن أن يحتوي اسم الترويسة على قيم أبجدية رقمية ورموز "_" و "-" إضافية. يمكن تحديد هذا الخيار أكثر من مرة، وفي هذه الحالة تُعين جميع الترويسات المدرجة. إذا أُدرج نفس اسم الترويسة أكثر من مرة، تُدمج جميع قيمه الفريدة بفاصلة. تعيين Header= إلى سلسلة فارغة يمسح جميع الإسنادات السابقة.

    مثال:

        Header=HeaderName: HeaderValue
        Header=HeaderName: NewValue
        Header=HeaderName: HeaderValue

    يُضيف ترويسة "HeaderName" بقيمة "HeaderValue, NewValue" إلى كل طلب HTTP.

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

انظر أيضًا

systemd-journal-upload.service(8), systemd(1), systemd-journald.service(8)

ملاحظات

1.  💣💥🧨💥💥💣 يرجى ملاحظة أن ملفات الضبط تلك يجب أن تكون متوفرة في جميع الأوقات. إذا كان /usr/local/ قسماً منفصلاً، فقد لا يكون متوفراً أثناء بدء التشغيل المبكر، ويجب عدم استخدامه للضبط.

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

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

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