> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# مراقبة سجلات systemd باستخدام ClickStack
> مراقبة سجلات systemd وJournald باستخدام ClickStack
export const TrackedLink = ({href, eventName, children, ...rest}) => {
const handleClick = () => {
try {
if (typeof window !== "undefined" && window.galaxy && eventName) {
window.galaxy.track(eventName, {
interaction: "click"
});
}
} catch (e) {}
};
return
{children}
;
};
export const Image = ({img, alt, size}) => {
return
;
};
**باختصار**
اجمع سجلات journal الخاصة بـ systemd واستعرضها بصريًا في ClickStack باستخدام journald receiver في OpenTelemetry Collector. يتضمن ذلك مجموعة بيانات تجريبية ولوحة معلومات جاهزة.
## التكامل مع الأنظمة الحالية
راقب سجلات `journald` في نظام Linux الحالي لديك عبر تشغيل OpenTelemetry Collector باستخدام journald receiver لجمع سجلات النظام وإرسالها إلى ClickStack عبر OTLP.
إذا أردت اختبار هذا التكامل أولًا من دون تعديل إعدادك الحالي، فانتقل إلى [قسم مجموعة البيانات التجريبية](#demo-dataset).
##### المتطلبات الأساسية
* مثيل ClickStack قيد التشغيل
* نظام Linux يعمل بـ systemd (Ubuntu 16.04+، CentOS 7+، Debian 8+)
* تثبيت Docker أو Docker Compose على النظام المراد مراقبته
#### احصل على مفتاح API لـ ClickStack
يرسل OpenTelemetry Collector البيانات إلى نقطة نهاية OTLP الخاصة بـ ClickStack، والتي تتطلب المصادقة.
1. افتح HyperDX على عنوان URL الخاص بـ ClickStack لديك (على سبيل المثال: [http://localhost:8080](http://localhost:8080))
2. أنشئ حسابًا أو سجّل الدخول إذا لزم الأمر
3. انتقل إلى **Team Settings → API Keys**
4. انسخ **مفتاح API للاستيعاب** الخاص بك
5. اضبطه كمتغير بيئة:
```bash theme={null}
export CLICKSTACK_API_KEY=your-api-key-here
```
#### تحقّق من أن سجل systemd قيد التشغيل
تأكد من أن نظامك يستخدم systemd وأن سجلات journal متوفرة:
```bash theme={null}
# تحقق من إصدار systemd
systemctl --version
# اعرض أحدث إدخالات journal
journalctl -n 20
# تحقق من استخدام journal للقرص
journalctl --disk-usage
```
إذا كان تخزين journal في الذاكرة فقط، ففعّل التخزين الدائم:
```bash theme={null}
sudo mkdir -p /var/log/journal
sudo systemd-tmpfiles --create --prefix /var/log/journal
sudo systemctl restart systemd-journald
```
#### أنشئ ملف إعداد لـ OpenTelemetry Collector
أنشئ ملف إعداد لـ OpenTelemetry Collector:
```yaml theme={null}
cat > otel-config.yaml << 'EOF'
receivers:
journald:
directory: /var/log/journal
priority: info
units:
- sshd
- nginx
- docker
- containerd
- systemd
processors:
batch:
timeout: 10s
send_batch_size: 10000
resource:
attributes:
- key: service.name
value: systemd-logs
action: insert
- key: host.name
from_attribute: _HOSTNAME
action: upsert
attributes:
actions:
- key: unit
from_attribute: _SYSTEMD_UNIT
action: upsert
- key: priority
from_attribute: PRIORITY
action: upsert
exporters:
otlphttp:
endpoint: ${CLICKSTACK_ENDPOINT}
headers:
authorization: ${CLICKSTACK_API_KEY}
service:
pipelines:
logs:
receivers: [journald]
processors: [resource, attributes, batch]
exporters: [otlphttp]
EOF
```
#### انشر باستخدام Docker Compose
يتطلب receiver `journald` الملف التنفيذي `journalctl` لقراءة ملفات journal. ولا تتضمن الصورة الرسمية `otel/opentelemetry-collector-contrib` أداة `journalctl` افتراضيًا.
بالنسبة إلى عمليات النشر المعتمدة على الحاويات، يمكنك إما تثبيت OTel Collector مباشرةً على المضيف أو إنشاء image مخصصة تتضمن أدوات systemd. راجع [قسم استكشاف الأخطاء وإصلاحها](#journalctl-not-found) لمزيد من التفاصيل.
يوضح هذا المثال كيفية نشر OTel Collector إلى جانب ClickStack:
```yaml theme={null}
services:
clickstack:
image: clickhouse/clickstack-all-in-one:latest
ports:
- "8080:8080"
- "4317:4317"
- "4318:4318"
networks:
- monitoring
otel-collector:
image: otel/opentelemetry-collector-contrib:0.115.1
depends_on:
- clickstack
environment:
- CLICKSTACK_API_KEY=${CLICKSTACK_API_KEY}
- CLICKSTACK_ENDPOINT=http://clickstack:4318
volumes:
- ./otel-config.yaml:/etc/otelcol/config.yaml:ro
- /var/log/journal:/var/log/journal:ro
- /run/log/journal:/run/log/journal:ro
- /etc/machine-id:/etc/machine-id:ro
command: ["--config=/etc/otelcol/config.yaml"]
networks:
- monitoring
networks:
monitoring:
driver: bridge
```
ابدأ الخدمات:
```bash theme={null}
docker compose up -d
```
#### تحقّق من السجلات في HyperDX
بعد اكتمال الإعداد، سجّل الدخول إلى HyperDX وتأكد من أن السجلات تتدفق:
1. انتقل إلى Search view
2. اضبط source على Logs
3. صفِّ حسب `service.name:systemd-logs`
4. يجب أن ترى إدخالات سجلات منظَّمة تتضمن حقولًا مثل `unit` و`priority` و`MESSAGE` و`_HOSTNAME`
## مجموعة البيانات التجريبية
للمستخدمين الذين يريدون اختبار تكامل سجلات systemd قبل تهيئة أنظمتهم في بيئة الإنتاج، نوفر مجموعة بيانات تجريبية تحتوي على سجلات systemd مُنشأة مسبقًا بأنماط واقعية.
#### تنزيل مجموعة البيانات النموذجية
نزّل ملف السجل النموذجي:
```bash theme={null}
curl -O https://datasets-documentation.s3.eu-west-3.amazonaws.com/clickstack-integrations/systemd/systemd-demo.log
```
#### إنشاء إعدادات collector التجريبية
أنشئ ملف إعدادات للعرض التجريبي:
```bash theme={null}
cat > systemd-demo.yaml << 'EOF'
receivers:
filelog:
include:
- /tmp/systemd-demo/systemd-demo.log
start_at: beginning
operators:
- type: regex_parser
regex: '^(?P\S+) (?P\S+) (?P\S+?)(?:\[(?P\d+)\])?: (?P.*)$'
parse_from: body
parse_to: attributes
- type: time_parser
parse_from: attributes.timestamp
layout: '%Y-%m-%dT%H:%M:%S%z'
- type: add
field: attributes.source
value: "systemd-demo"
service:
pipelines:
logs/systemd-demo:
receivers: [filelog]
processors:
- memory_limiter
- transform
- batch
exporters:
- clickhouse
EOF
```
#### تشغيل ClickStack باستخدام البيانات التجريبية
ابدأ تشغيل ClickStack باستخدام السجلات التجريبية:
```bash theme={null}
docker run -d --name clickstack-demo \
-p 8080:8080 -p 4317:4317 -p 4318:4318 \
-e CUSTOM_OTELCOL_CONFIG_FILE=/etc/otelcol-contrib/custom.config.yaml \
-v "$(pwd)/systemd-demo.yaml:/etc/otelcol-contrib/custom.config.yaml:ro" \
-v "$(pwd)/systemd-demo.log:/tmp/systemd-demo/systemd-demo.log:ro" \
clickhouse/clickstack-all-in-one:latest
```
يستخدم العرض التجريبي receiver `filelog` مع سجلات نصية بدلًا من `journald` لتجنّب الحاجة إلى `journalctl` داخل الحاوية.
#### التحقق من السجلات في HyperDX
بعد تشغيل ClickStack:
1. افتح [HyperDX](http://localhost:8080/) وسجّل الدخول إلى حسابك
2. انتقل إلى واجهة Search واضبط source على `Logs`
3. اضبط النطاق الزمني على **2025-11-14 00:00:00 - 2025-11-17 00:00:00**
**عرض المنطقة الزمنية**
يعرض HyperDX الطوابع الزمنية وفق المنطقة الزمنية المحلية في متصفحك. تمتد البيانات التجريبية عبر **2025-11-15 00:00:00 - 2025-11-16 00:00:00 (UTC)**. ويضمن هذا النطاق الزمني الواسع ظهور السجلات التجريبية بغض النظر عن موقعك.
## لوحات المعلومات والتصورات
لمساعدتك على البدء في مراقبة سجلات systemd باستخدام ClickStack، نوفر تصورات أساسية لبيانات systemd journal.
#### تنزيل إعدادات لوحة المعلومات
#### استيراد لوحة المعلومات الجاهزة مسبقًا
1. افتح HyperDX وانتقل إلى قسم Dashboards
2. انقر على **Import Dashboard** في الزاوية العلوية اليمنى ضمن قائمة النقاط الثلاث
3. ارفع الملف `systemd-logs-dashboard.json` وانقر على **Finish Import**
#### عرض لوحة المعلومات
تتضمن لوحة المعلومات تصورات لـ:
* حجم السجلات بمرور الوقت
* أهم وحدات systemd حسب عدد السجلات
* أحداث مصادقة SSH
* حالات فشل الخدمة
* معدلات الأخطاء
بالنسبة إلى مجموعة البيانات التجريبية، اضبط النطاق الزمني على **2025-11-15 00:00:00 - 2025-11-16 00:00:00 (UTC)** (مع تعديله بحسب منطقتك الزمنية المحلية).
## استكشاف الأخطاء وإصلاحها
### عدم ظهور السجلات في HyperDX
تحقّق مما إذا كانت السجلات تصل إلى ClickHouse:
```bash theme={null}
docker exec clickstack clickhouse-client --query "
SELECT COUNT(*) as log_count
FROM otel_logs
WHERE ServiceName = 'systemd-logs'
"
```
إذا لم تظهر أي نتائج، فتحقّق من سجلات الـcollector:
```bash theme={null}
docker logs otel-collector | grep -i "error\|journald" | tail -20
```
### خطأ عدم العثور على `journalctl`
إذا ظهر لك `exec: "journalctl": executable file not found in $PATH`:
فإن الصورة `otel/opentelemetry-collector-contrib` لا تتضمن `journalctl`. يمكنك أحد الخيارين التاليين:
1. **تثبيت الـ collector على المضيف**:
```bash theme={null}
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.115.0/otelcol-contrib_0.115.0_linux_amd64.tar.gz
tar -xzf otelcol-contrib_0.115.0_linux_amd64.tar.gz
sudo mv otelcol-contrib /usr/local/bin/
otelcol-contrib --config=otel-config.yaml
```
2. **استخدم نهج التصدير النصي** (كما في العرض التوضيحي) مع receiver `filelog` لقراءة ملفات تصدير journald
## الخطوات التالية
* قم بإعداد [التنبيهات](/ar/clickstack/features/alerts) لأحداث النظام الحرجة (تعطل الخدمة، فشل المصادقة، وعمليات الإنهاء بسبب نفاد الذاكرة OOM)
* أنشئ [لوحات معلومات](/ar/clickstack/features/dashboards/overview) إضافية لحالات استخدام محددة (مراقبة أمان SSH، وصحة الخدمة)
* قم بالتصفية حسب وحدات systemd محددة لتقليل الضجيج والتركيز على الخدمات المهمة
## الانتقال إلى بيئة الإنتاج
يستخدم هذا الدليل OpenTelemetry Collector منفصلًا لقراءة سجلات systemd وإرسالها إلى نقطة نهاية OTLP الخاصة بـ ClickStack، وهذا هو النمط الموصى به لبيئات الإنتاج.
بالنسبة إلى بيئات الإنتاج التي تضم عدة مضيفين، ضع في اعتبارك ما يلي:
* نشر collector كمجموعة خفيّات في Kubernetes
* تشغيل collector كخدمة systemd على كل مضيف
* استخدام OpenTelemetry Operator للنشر الآلي
راجع [إدخال البيانات باستخدام OpenTelemetry](/ar/clickstack/ingesting-data/opentelemetry) للاطّلاع على أنماط النشر المخصّصة لبيئات الإنتاج.