SYSTEMD-JOURNAL-GATEWAYD.SERVICE(8)

الاسم
systemd-journal-gatewayd.service، systemd-journal-gatewayd.socket، systemd-journal-gatewayd - خادم HTTP لأحداث دفتر اليومية

موجز

systemd-journal-gatewayd.service

systemd-journal-gatewayd.socket

/usr/lib/systemd/systemd-journal-gatewayd [خيارات...]

الوصف

يخدم systemd-journal-gatewayd أحداث دفتر اليومية عبر الشبكة. يجب على العملاء الاتصال باستخدام HTTP. يستمع الخادم على المنفذ 19531 مبدئيًا. إذا تم تحديد --cert=، يتوقع الخادم اتصالات HTTPS.

يبدأ البرنامج بواسطة systemd(1) ويتوقع استقبال مقبس واحد. استخدم systemctl start systemd-journal-gatewayd.socket لبدء الخدمة، و systemctl enable systemd-journal-gatewayd.socket لبدئها آليًا عند الإقلاع.

الخيارات

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

--cert=
    حدد المسار إلى ملف أو مقبس دفق AF_UNIX لقراءة شهادة الخادم منه. يجب أن تكون الشهادة بتنسيق PEM. يحول هذا الخيار systemd-journal-gatewayd إلى وضع HTTPS ويجب استخدامه مع --key=.

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

--key=
    حدد المسار إلى ملف أو مقبس دفق AF_UNIX لقراءة مفتاح الخادم السري المطابق للشهادة المحددة مع --cert= منه. يجب أن يكون المفتاح بتنسيق PEM.

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

--trust=
    حدد المسار إلى ملف أو مقبس دفق AF_UNIX لقراءة شهادة CA منه. يجب أن تكون الشهادة بتنسيق PEM.

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

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

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

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

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

-D دليل، --directory=دليل
    يأخذ مسار دليل كوسيطة. إذا تم تحديده، سيخدم systemd-journal-gatewayd دليل دفتر اليومية المحدد DIR بدلاً من مسارات دفتر اليومية المبدئية لوقت التشغيل والنظام.

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

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

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

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

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

عناوين URL المدعومة

يتم التعرف على عناوين URL التالية:

/boots
    يعيد استجابة json-seq (RFC 7464) تحتوي على كائنات JSON، كل منها يحتوي على رقم الإقلاع، معرفه، والطوابع الزمنية للرسالة الأولى والأخيرة. تُعاد عمليات الإقلاع بدءًا بأحدث إقلاع أولاً وتستخدم نفس المخطط مثل journalctl --list-boots --output json.

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

/browse
    تصفح تفاعلي.

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

/entries[?option1&option2=value...]
    استرداد الأحداث بتنسيقات متنوعة.

    يحدد الجزء Accept: من رأس HTTP التنسيق. القيم المدعومة موصوفة أدناه.

    يحدد الجزء Range: من رأس HTTP نطاق الأحداث المُعادة. القيم المدعومة موصوفة أدناه.

    يمكن استخدام وسائط GET لتعديل الأحداث المُعادة. الوسائط المدعومة موصوفة أدناه.

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

/machine
    إعادة بنية JSON تصف الجهاز.

    مثال:

        { "machine_id" : "8cf7ed9d451ea194b77a9f118f3dc446",
          "boot_id" : "3d3c9efaf556496a9b04259ee35df7f7",
          "hostname" : "fedora",
          "os_pretty_name" : "Fedora 19 (Rawhide)",
          "virtualization" : "kvm",
          ...}

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

/fields/FIELD_NAME
    إعادة قائمة بقيم هذا الحقل الموجودة في السجلات.

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

رأس ACCEPT

Accept: format

التنسيقات المعترف بها:

text/plain
    المبدئي. مخرجات نصية عادية شبيهة بـ syslog، سطر واحد لكل إدخال دفتر يومية (مثل journalctl --output short).

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

application/json
    تُنسق الإدخالات كهياكل بيانات JSON، واحدة لكل سطر (مثل journalctl --output json). انظر تنسيق JSON لدفتر اليومية[1] لمزيد من المعلومات.

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

text/event-stream
    تُنسق الإدخالات كهياكل بيانات JSON، ملفوفة بتنسيق مناسب لـ أحداث مرسلة من الخادم[2] (مثل journalctl --output json-sse).

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

application/vnd.fdo.journal
    تُسلسل الإدخالات إلى تيار ثنائي (لكنه نصي في الغالب) مناسب للنسخ الاحتياطي والنقل عبر الشبكة (مثل journalctl --output export). انظر تنسيق تصدير دفتر اليومية[3] لمزيد من المعلومات.

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

رأس RANGE

Range: entries=[cursor][[:num_skip]:[num_entries]]

Range: realtime=[since]:[until][[:num_skip]:num_entries]

حيث cursor هو سلسلة مؤشر، المبدئي هو الإدخال الأول، since و until هما طابعان زمنيان (ثوانٍ منذ 1970-01-01 00:00:00 UTC)، num_skip هو عدد صحيح، num_entries هو عدد صحيح غير موقع.

النطاق المبدئي هو جميع الأحداث المتاحة.

إذا كان num_skip سالبًا ولم يُعطَ cursor، فسيكون الإدخال الأخير هو النقطة المرجعية.

مُعاملات GET لعنوان URL

يمكن استخدام المُعاملات التالية كجزء من عنوان URL:

متابعة
    انتظار الأحداث الجديدة (مثل journalctl --follow، عدد الأحداث المُرجعة غير محدود، ما لم يُحدد num_entries في ترويسة Range).

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

منفصل
    اختبار أن المؤشر المُحدد يشير إلى إدخال في السجل. يُرجع هذا الإدخال فقط.

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

boot
    تقييد الأحداث بالإقلاع الحالي للنظام (مثل journalctl -b).

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

KEY=مطابقة
    مطابقة حقول السجل. انظر systemd.journal-fields(7).

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

أمثلة

استرداد الأحداث من هذا الإقلاع من السجل المحلي بتنسيق تصدير السجل[3]:

    curl --silent -H'Accept: application/vnd.fdo.journal' \
           'http://localhost:19531/entries?boot'

الاستماع لتفريغات النواة:

    curl 'http://localhost:19531/entries?follow&MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1'

انظر أيضًا

systemd(1), journalctl(1), systemd.journal-fields(7), systemd-journald.service(8), systemd-journal-remote.service(8), systemd-journal-upload.service(8)

ملاحظات

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

2.  الأحداث المرسلة من الخادم
    https://developer.mozilla.org/en-US/docs/Server-sent_events/Using_server-sent_events

3.  تنسيق تصدير اليوميات
    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.