Scroll to navigation

SYSTEMD-JOURNAL-GATEWAYD.SERVICE(8) systemd-journal-gatewayd.service 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 التالية:

/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=مؤشر[[:رقم_التخطي]:عدد_الإدخالات]

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

حيث مؤشر هو سلسلة مؤشر، منذ و حتى هما طابعان زمنيان (ثوانٍ منذ 1970-01-01 00:00:00 UTC)، رقم_التخطي هو عدد صحيح، عدد_الإدخالات هو عدد صحيح غير مُوقع.

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

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

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

متابعة

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

أُضيف في الإصدارة 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 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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

systemd 257.9