استضف Superlog ذاتياً لفرز السجلات بالذكاء الاصطناعي
شغّل Superlog على VPS خاص بك عبر Docker Compose، وتعرّف إلى بصمته الحقيقية: Postgres وClickHouse وOTel وأربع خدمات Node دون أي إصدارات موسومة.
ما الذي يثبّته Superlog فعلياً عند استضافته ذاتياً
لاستضافة Superlog ذاتياً، تستنسخ المستودع، وتشغّل Postgres وClickHouse وجامع OpenTelemetry باستخدام Docker Compose، وتنفّذ عملية ترحيل واحدة لقاعدة البيانات، ثم تبدأ أربع خدمات Node من المصدر. ترسل تطبيقاتك traces وlogs وmetrics وفق بروتوكول OTLP (OpenTelemetry) إلى منفذ الاستقبال، ويعرّف Superlog بصمتها، ويجمع المتكررة منها في incident واحد، ثم يسجّل المشغّل الافتراضي للمجتمع ملخصاً محلياً للـincident. يستغرق التثبيت فترة بعد الظهر. أما البصمة التشغيلية والحدود الفعلية، فهما الجزءان اللذان يستحقان القراءة قبل البدء.
Superlog مرخّص بموجب Apache 2.0، ويوجد في github.com/superloglabs/superlog. في 13 October 2026، لديه نحو 1.5k نجمة، وحوالي 490 عملية commit على main، ولا يملك أي release tags على الإطلاق. ثبّت commit بنفسك بدلاً من تشغيل أي إصدار كان موجوداً على main في صباح اليوم الذي استنسخت فيه المستودع.
ما الذي يجيب عنه Superlog ولا تجيب عنه Uptime Kuma وLangfuse
تبدو أدوات المراقبة المستضافة ذاتياً متشابهة من الخارج. لكنها ليست كذلك، واختيار الأداة الخاطئة يستهلك خادماً من دون فائدة.
- تختبر Uptime Kuma نقاط النهاية من الخارج وتجيب عن سؤال واحد: هل الخدمة متاحة؟
- تراقب Zabbix المضيفات والخدمات على Ubuntu 24.04، مع تتبّع CPU والذاكرة والقرص وحالة الخدمة وفق العتبات التي تحددها.
- تتتبّع Langfuse استدعاءات LLM، وتسجّل prompt والنموذج والرموز المميزة ووقت الاستجابة والتكلفة لكل استدعاء.
- يحوّل Superlog بيانات القياس التي تُصدرها خدماتك العادية بالفعل إلى حوادث عند تكرار حالات الفشل.
يجيب Superlog عن سؤال مختلف: ما الذي تعطل، وما سبب التعطل؟ لا يفرض افتراضات على استدعاءات LLM، ولا يختبر خدمتك من الخارج. يستقبل OTLP من الشيفرة المعتادة لتطبيقك، ويضع agent في خطوة الفرز الأولي، وهي أول عملية ينفذها مسؤول المناوبة على أي حال.
الفرق المهم عند حساب ميزانية VPS هو التخزين. يتضمن Superlog مخزناً عمودياً، لأن بيانات القياس تُكتب مرة واحدة ثم تُستعلم وفق نطاق زمني عبر ملايين الصفوف. هذا هو الغرض من ClickHouse، وليس من Postgres. يبقى Postgres جزءاً من المكدس، ويخزّن البيانات العلائقية الصغيرة: المشاريع والمستخدمين والحوادث ومفاتيح الإدخال.
ما الذي يشغّله docker compose up -d فعلياً؟
ثلاثة containers، ولا واحد منها هو Superlog. يفاجئ هذا الأمر من يتوقع تثبيتاً يتم بأمر واحد.
postgres:16، منشور على منفذ المضيف 5434clickhouse/clickhouse-server:26.1، على المنفذ 8123 لـ HTTP والمنفذ 9000 للبروتوكول الأصليotel/opentelemetry-collector-contrib:0.150.1، على المنفذ 4317 لـ gRPC والمنفذ 4318 لـ OTLP عبر HTTP
تعمل تطبيقات Superlog على المضيف، انطلاقاً من المصدر، ويبدأ تشغيلها pnpm dev. لا يوجد ملف compose مخصص للبيئات الإنتاجية في المستودع حتى 13 October 2026، لذلك يتطلب التثبيت طويل الأمد وحدات systemd تنشئها بنفسك، أو استخدام ملفات Dockerfile الخاصة بكل تطبيق والمضمّنة في شجرة المستودع. تحتوي تطبيقات api وworker وproxy كل منها على سكربت start لتغليفه داخل وحدة. أما تطبيق web فلا يحتوي عليه: فهو تطبيق Vite، لذلك تبنيه باستخدام سكربت build، ثم تقدّم ناتجه كملفات ثابتة عبر nginx أو Caddy، أو تشغّل سكربت preview، وهو vite preview.
احتفظ في ذهنك بمسار الطلب الذي يسلكه، لأن كل فشل أدناه يعني انقطاع إحدى حلقاته. يرسل تطبيقك OTLP إلى proxy الاستقبال الخاص بـ Superlog. يصادق proxy على الطلب باستخدام مفتاح الإدخال الخاص بك، ويضيف إليه project id، ثم يمرره إلى collector. يزيل collector أي سمات superlog.* حاول العميل تعيينها، ويضيف superlog.project_id من الترويسة التي وفّرها proxy، ثم يجمع البيانات على دفعات ويكتبها إلى ClickHouse. يقرأ تطبيق web وواجهة API بيانات القياس عن بُعد من ClickHouse، ويقرآن كل البيانات الأخرى من Postgres.
إزالة هذه السمة إجراء حقيقي للتحكم في تعدد المستأجرين، وليست إجراءً شكلياً. من دونها، يمكن لأي شخص يملك مفتاح إدخال صالحاً تعيين superlog.project_id بنفسه والكتابة في بيانات مشروع آخر.
ما الحجم المطلوب لـ VPS؟
خطّط لاستخدام 4 vCPU و8 GB من RAM و40 GB من SSD لتثبيت عقدة واحدة عند انخفاض حجم الإدخال. هذا حدّ تخطيطي أدنى، وليس قياساً فعلياً. لذلك استخدمه كنقطة بداية، ثم قارنه بحجم حركة الشبكة لديك.
تتوزع الذاكرة على أربعة أماكن. صُمّم ClickHouse للعمل على أجهزة تحتوي على قدر كبير من RAM، وتفترض إعداداته الافتراضية ذلك. أما Postgres 16 فاحتياجه محدود هنا، لأنه يخزّن البيانات الوصفية بدلاً من بيانات القياس عن بُعد. ويحتاج collector إلى قدر محدود من الذاكرة أيضاً. تتضمن عمليات Node الأربع خادم تطوير Vite وثلاث عمليات tsx watch. قِس استهلاكها للذاكرة على جهازك.
القرص هو المشكلة الأقل وضوحاً. يؤدي pnpm install في هذا المستودع الأحادي إلى تنزيل AWS SDK وعميل ClickHouse وOpenTelemetry SDK وسلسلة أدوات React قبل إدخال أي span. ثم يزداد حجم ClickHouse مع حركة الشبكة لديك. قِس الأمرين معاً:
df -h /
free -m
docker stats --no-stream
docker compose exec clickhouse clickhouse-client --database superlog --query "SELECT table, formatReadableSize(sum(bytes_on_disk)) AS size FROM system.parts WHERE active AND database = 'superlog' GROUP BY table ORDER BY sum(bytes_on_disk) DESC"الحمل الذي يسبب المشكلة هو الارتفاع المفاجئ: قد يؤدي نشر معيب واحد إلى إنتاج آلاف الأخطاء المتطابقة في الدقيقة. يجمع fingerprinting هذه الأخطاء في حادثة واحدة للقارئ، لكن ClickHouse يكتب كل صف منها في الخلفية.
أنت تحدد مدة الاحتفاظ. ينشئ ClickHouse exporter الخاص بـ collector الجداول، وotel_traces وotel_logs وجدولاً واحداً لكل نوع من أنواع المقاييس. ولا يطبّق مدة time to live إلا إذا ضبطت الإعدادات في infra/collector/config.yaml قيمة لها. لا تنتهي صلاحية أي بيانات تلقائياً. لذلك قد يؤدي شهر نشط إلى امتلاء القرص ما لم تخطط لذلك.
التثبيت من commit محدد
git clone https://github.com/superloglabs/superlog.git
cd superlog
git tag -l
git log -1 --format='%H %cs %s'git tag -l الذي لا يطبع شيئاً هو النتيجة المتوقعة اعتباراً من 13 October 2026. اختر commit الذي اختبرته والتزم به:
git checkout 0d3a6c8bb63eda3493e6ba0003e7c2a70750bc1eبعد ذلك، toolchain:
node -v
corepack enable
corepack prepare pnpm@9.12.0 --activate
pnpm -vيعرّف package.json engines.node على أنه >=20.0.0، وpackageManager على أنه pnpm@9.12.0. لا يوقف إصدار Node غير المتوافق التثبيت تلقائياً؛ إذ يعتمد فرض توافق المحرك على الإعدادات، ويحتوي pnpm 9.12.0 على مسار تحذير عندما يكون engineStrict معطّلاً. حزمة nodejs في أرشيف Ubuntu 24.04 أقدم من 20، لذلك ثبّت Node 20 أو إصداراً أحدث من NodeSource أو باستخدام nvm. يحتوي المستودع على .nvmrc، لذلك يختار nvm use الإصدار المقصود إذا كان nvm مثبتاً لديك.
pnpm install
docker compose up -d
docker compose psانتظر فحوصات الصحة بدلاً من اعتبار up -d دليلاً على أن الخدمة أصبحت جاهزة. يعرّف كل من Postgres وClickHouse فحصاً في ملف compose:
curl -sS http://127.0.0.1:8123/ping
pg_isready -h 127.0.0.1 -p 5434 -U postgresيستجيب ClickHouse على Ok.، ويستجيب pg_isready على accepting connections. يعني رفض الاتصال على 8123 أن الحاوية لا تزال قيد التشغيل أو أنها توقفت. يوضح docker compose logs clickhouse أي الاحتمالين حدث، بينما يعرض docker inspect $(docker compose ps -q clickhouse) | grep -i oomkilled قيمة true عندما يقتل kernel العملية بسبب نفاد الذاكرة. يشير ذلك إلى أن الخادم أصغر من المطلوب، لا إلى وجود خطأ في إعداداتك.
ثم نفّذ migration وشغّل التطبيقات:
pnpm --filter @superlog/db db:migrate
pnpm devانتبه إلى المنفذ: 5434 وليس 5432. ينشر ملف compose Postgres على المنفذ 5434 كي لا يتعارض مع Postgres مثبت مسبقاً على المضيف، وتتطابق ملفات .env.example الخاصة بالتطبيق مع ذلك عبر DATABASE_URL=postgres://postgres:postgres@localhost:5434/superlog. إذا وجّهت migration إلى 5432 على خادم يشغّل Postgres مسبقاً، فقد تحصل على اتصال مرفوض أو، وهو الأسوأ، قد تُطبَّق migration على قاعدة البيانات الخطأ.
يشغّل pnpm dev الأمر turbo run dev، الذي يبدأ script dev لكل تطبيق عبر Turborepo، بما في ذلك api وweb وworker وproxy، مع دمج مخرجاتها في طرفية واحدة. يسرد Procfile في المستودع العمليات الأربع نفسها، ويوجّه مخرجات كل عملية أيضاً إلى tmp/logs/. شغّله باستخدام Procfile runner مثل overmind أو foreman بدلاً من pnpm dev إذا أردت أن يكون tail -f tmp/logs/proxy.log المكان الذي تراقب فيه ingest. يضع README تطبيق الويب على http://localhost:5173، وواجهة API على http://localhost:4100، ونقطة استقبال OTLP على http://localhost:4101.
تحقق مما استمع فعلياً على المنفذ قبل أن توجّه أي شيء إليه:
ss -lntp | grep -E '4000|4100|4101|5173'
curl -sS http://127.0.0.1:4101/healthسيصبح ذلك مهماً لاحقاً. يقرأ proxy منفذه الخاص من متغير البيئة PORT، ويستخدم 4000 كقيمة احتياطية عندما يكون PORT غير مضبوط. كما يضبط apps/proxy/.env.example الذي يحمّله أيضاً PORT=4000، رغم أن README يسرد نقطة الاستقبال على 4101، وقد تم التحقق من الأمرين في 13 October 2026. استخدم المنفذ الذي يعرضه ss. تستخدم الأمثلة أدناه 4101، لذلك استبدله بـ4000 إذا كان ذلك هو المنفذ الذي استمع فعلياً. لا تضبط وحدة systemd التي تكتبها بنفسك أي قيمة ما لم تضع فيها PORT. لذلك يفشل exporter الموجّه إلى 4101 إذا كان proxy يستمع على 4000، ويظهر الخطأ على شكل اتصال مرفوض من دون إشارة أخرى توضّح السبب.
أرسل أثراً واحداً، وأنشئ خطأً واحداً، وشاهد حادثة واحدة
أنشئ مشروعاً في تطبيق الويب وانسخ مفتاح الإدخال الخاص به. تصادق نقطة الإدخال على كل طلب باستخدام ذلك المفتاح، لذلك لا تصل بيانات القياس المرسلة من دونه إلى ClickHouse.
وجّه أي OpenTelemetry SDK إلى نقطة الإدخال باستخدام متغيرات البيئة القياسية:
export OTEL_SERVICE_NAME=checkout-api
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4101
export OTEL_EXPORTER_OTLP_HEADERS='x-api-key=YOUR_INGEST_KEY'تقرأ نقطة الإدخال المفتاح من الترويسة x-api-key، وتقبل أيضاً authorization: bearer YOUR_INGEST_KEY إذا كان إعداد المصدّر بهذه الطريقة أسهل. وتخدم مسارات OTLP القياسية الثلاثة، /v1/traces و/v1/logs و/v1/metrics، بالإضافة إلى /health.
توجد نقطة شائعة يجب الانتباه إليها. OTEL_EXPORTER_OTLP_ENDPOINT هو عنوان URL أساسي، ويضيف SDK مسار الإشارة إليه. أما المتغيرات الخاصة بإشارة معينة، مثل OTEL_EXPORTER_OTLP_TRACES_ENDPOINT، فتُستخدم كما هي، من دون إضافة أي مسار. إذا ضبطت المتغير الخاص بالإشارة على http://127.0.0.1:4101، فستُرسل كل عملية تصدير إلى /، وهذا ليس مساراً، لذلك لا تصل أي بيانات، ويسجّل SDK فشل التصدير بينما يبدو تطبيقك سليماً.
بالنسبة إلى خدمة Node، يكفي مسار عدم استخدام الشيفرة لإثبات عمل خط المعالجة:
npm install @opentelemetry/api @opentelemetry/auto-instrumentations-node
node --require @opentelemetry/auto-instrumentations-node/register server.jsوالآن عطّل شيئاً عمداً. يكفي استخدام أي مسار يطرح خطأً:
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3000/boomافحص نقاط العبور بالترتيب، لأن أول فجوة توضح أي نقطة فشلت:
tail -n 50 tmp/logs/proxy.log
docker compose exec clickhouse clickhouse-client --database superlog --query 'SELECT count() FROM otel_traces'يشير ارتفاع العدد في otel_traces مع بقاء تطبيق الويب فارغاً إلى عدم تطابق المشروع، لذا تحقّق من المشروع المرتبط بمفتاح الإدخال. ويشير ثبات العدد مع وجود نشاط في سجل الوكيل العكسي إلى مشكلة في المجمّع أو في الكتابة إلى ClickHouse، لذا اقرأ docker compose logs collector. أما غياب النشاط تماماً في سجل الوكيل العكسي فيعني أن المصدّر لم يصل إلى نقطة الإدخال: المنفذ خطأ، أو المسار خطأ، أو جرى رفض المفتاح.
تصل هذه الإخفاقات المتكررة في تطبيق الويب على شكل حادثة واحدة، لا كسجل واحد لكل طلب. ينشئ Superlog بصمات للإشارات الواردة ويجمع الإشارات المتطابقة، وهذا هو الفرق بين صندوق وارد يحتوي على 4,000 خطأ متطابق وصفحة تحتوي على خطأ واحد. ويسجّل مشغّل الوكيل المجتمعي الافتراضي بعد ذلك ملخصاً محلياً للحادثة الخاصة بهذه المجموعة.
يتطلب التحقيق المدعوم بنموذج إعداد مزوّد نموذج ومشغّل وكيل متوافق؛ أما المشغّل المجتمعي الافتراضي فيسجّل ملخصاً محلياً. خذ أسماء هذه المتغيرات من ملف .env.example داخل مجلد كل تطبيق في النسخة التي ثبّتَّها، لا من أي شرح خارجي، لأن هذه الأسماء تتغير مع main. وينطبق الأمر نفسه على تكاملَي GitHub وSentry، إذ يحتوي كل منهما على مستندات الإعداد الخاصة به في docs/github-app-setup.md وdocs/sentry-app-setup.md، مع توثيق حمولات webhook في docs/webhooks.md.
اجعل نقطة استقبال البيانات خاصة، واجعل الوكيل للقراءة فقط
ينشر Docker منافذ الحاويات على 0.0.0.0 افتراضياً، وتتجاوز هذه المنافذ المنشورة ufw. يوجّه Docker حركة الحاويات في جدول `nat، لذلك تُحوَّل الحزمة المتجهة إلى منفذ منشور قبل أن تصل إلى سلسلتي INPUT وOUTPUT حيث توجد قواعد ufw، ولا يحصل ufw على فرصة للتعامل معها. على VPS ذي عنوان IP عام، يضع ملف Compose كما يأتي مع الحزمة خدمة ClickHouse HTTP على المنفذ 8123 وPostgres على المنفذ 5434، ويمكن للإنترنت الوصول إليهما. بيانات الاعتماد في هذا الملف هي القيم الافتراضية للتطوير: مستخدم ClickHouse هو default مع كلمة مرور فارغة، وPostgres يستخدم postgres` اسماً للمستخدم وكلمة المرور معاً.
اربط هذه المنافذ بواجهة loopback. يأخذ كل منفذ منشور في ملف Compose جانب المضيف من متغير بيئة، لذلك يكفي إنشاء ملف `.env` في جذر المستودع:
POSTGRES_HOST_PORT=127.0.0.1:5434
CLICKHOUSE_HTTP_HOST_PORT=127.0.0.1:8123
CLICKHOUSE_TCP_HOST_PORT=127.0.0.1:9000
COLLECTOR_GRPC_HOST_PORT=127.0.0.1:4317
COLLECTOR_HTTP_HOST_PORT=127.0.0.1:4318تحقق من النتيجة قبل الوثوق بها، ثم أعد إنشاء الحاويات:
docker compose config
docker compose up -d
ss -lntp | grep -E '5434|8123|9000|4317|4318'يطبع `docker compose config الملف بعد حل القيم، بحيث يمكنك قراءة 127.0.0.1:5434:5432 بدلاً من التخمين. يجب أن يعرض ss بعد ذلك 127.0.0.1:5434، وألا يعرض 0.0.0.0:5434 مطلقاً. يكفي إعادة تعريف ports في ملف override الخاص بـCompose للإبقاء على الربطين عندما يختلف عنوان IP للمضيف؛ إذ يدعم Compose 2.24.4 والإصدارات الأحدث استخدام ports: !override` لاستبدال القائمة.
تحتاج نقطة استقبال البيانات إلى العناية نفسها. تنتقل مفتاح ingest في ترويسة، لذلك يحتاج إلى TLS (أمان طبقة النقل) أمامه: أنهِ TLS في nginx أو Caddy قبل الـproxy، أو أبقِ ingest داخل شبكة خاصة أو نفق WireGuard. تطبيق الويب على المنفذ 5173 هو خادم تطوير Vite، ولا ينبغي أن يكون متاحاً للإنترنت إطلاقاً.
ثم يأتي الوكيل نفسه. تتمثل فكرة Superlog في أن الوكيل يحقق في المشكلة ويقترح إصلاحاً، والكلمة المهمة هي «يقترح». أبقِ صلاحياته للقراءة فقط في مواجهة الإنتاج إلى أن تراقب عمله في عدة حوادث حقيقية. لا يستطيع GitHub App للقراءة فقط دفع فرع إصلاح أو فتح pull requests؛ إذ يتطلب دليل الإعداد صلاحيات الكتابة إلى Contents وPull requests لهذا المسار، إضافة إلى صلاحية الكتابة إلى Issues لإضافة التعليقات. الوكيل الذي يقرأ بيانات المراقبة ويكتب patch مفيد. أما الوكيل الذي يستطيع إعادة تشغيل خدماتك فيمثل مستوى مختلفاً من المخاطر، ويجب أن يكون ذلك قراراً تتخذه عمداً، لا إعداداً افتراضياً ترثه. تستحق التكلفة القدر نفسه من الانتباه عند إعداد runner يعتمد على نموذج: ضع ميزانية لإنفاق الوكيل على VPS قبل توجيهه إلى نظام إنتاج كثير الضوضاء، واحتفظ بـسجل لما نفذه الوكيل فعلياً حتى يكون لأي pull request مفاجئ مسار تدقيق موثق.
الأعطال التي ستواجهها، والعبارات التي تسميها
- يشير
ERR_PNPM_UNSUPPORTED_ENGINEأثناءpnpm installإلى أن أحد متطلبات المحرك غير متوافق. يتحقق pnpm 9.12.0 من متطلبات Node وpnpm معاً؛ اقرأ الإصدارين المطلوب والحالي في رسالة الخطأ، ثم تحقّق منnode -vوpnpm -v. - يشير
ECONNREFUSED 127.0.0.1:5434أثناء الترحيل إلى أن مكدس compose لا يعمل، أو أنDATABASE_URLيحدد المنفذ الخطأ. - تحقّق من عمليات إعادة تشغيل ClickHouse باستخدام
docker compose logs clickhouse، ثم تحقّق من الحاوية لمعرفة ما إذا كانOOMKilledهوtrue. - إذا أبلغ exporter عن نجاح العملية بينما ظل تطبيق الويب فارغاً، فعادةً يعني ذلك أن البيانات أُرسلت مباشرةً إلى collector على المنفذ 4318، متجاوزةً إسناد المشروع الذي ينفذه الـproxy.
- يعني رفض الاتصال على 4101 عادةً أن الـproxy يستمع على 4000، وهو المنفذ الاحتياطي في شفرته والمنفذ الذي يحدده
.env.example. عيّنPORTصراحةً في ملف الوحدة أو في.envالخاص بالتطبيق. - يعني ظهور
docker compose psمع0.0.0.0:8123أن عمليات الربط على loopback غير مفعّلة. شغّلdocker compose configواقرأ المنافذ التي جرى حلّها.
Flawless وHyperProbe وموقع Superlog بينهما
هذه الفئة جديدة، وتختلف الأدوات في حدود ما يُسمح للوكيل بالوصول إليه. يعرض مستودع Flawless الآن CISRE، وهي منصة AI SRE (هندسة موثوقية المواقع) لبنية Kubernetes التحتية والبنية التحتية السحابية، بموجب ترخيص PolyForm Noncommercial. يضع HyperProbe probes داخل عملية قيد التشغيل لالتقاط حالة المتغيرات، ويعرض هذه الحالة على مساعد عبر MCP (بروتوكول سياق النموذج). كما يوثّق تشغيله ذاتياً باستخدام Docker Compose ومفتاح ترخيص.
يقع Superlog بينهما. فهو يدير خط المعالجة من طرف إلى طرف، بدءاً من استقبال OTLP وحتى تخزين البيانات في ClickHouse، ويضع الوكيل في خطوة الفرز الأولي بدلاً من خطوة الإصلاح. ولهذا التصميم تحديداً، فإن تشغيله ذاتياً قرار يتعلق بالبنية التحتية، وليس مجرد حاوية تنساها بعد تشغيلها. عند تشغيل Superlog، فأنت تشغّل مخزناً عمودياً، ويحتاج ذلك إلى العناية نفسها التي تحتاج إليها أي قاعدة بيانات أخرى تملكها.
FAQ
ما مقدار RAM الذي يحتاج إليه Superlog المستضاف ذاتياً؟
خطّط لاستخدام 8 GB من RAM و4 vCPU و40 GB من مساحة القرص لعقدة واحدة عند انخفاض حجم البيانات الواردة. تتكوّن الحزمة من Postgres وClickHouse وجامع OpenTelemetry وأربع عمليات Node، ويحتاج ClickHouse إلى هامش من الموارد. قِس أرقامك الفعلية باستخدام docker stats --no-stream وfree -m بدلاً من الاعتماد على أي رقم منشور، بما في ذلك هذا الرقم.
إلى أي منفذ أوجّه مُصدِّر OTLP؟
إلى وكيل استقبال Superlog، الذي يحدّد README تشغيله على http://localhost:4101. يوفّر الوكيل /v1/traces و/v1/logs و/v1/metrics، ويصادق باستخدام مفتاح الإدخال الخاص بمشروعك، المأخوذ من الرأس x-api-key أو من الرأس authorization: bearer. المنفذ 4318 هو منفذ جامع OpenTelemetry الموجود أسفل الوكيل، ويؤدي التصدير إليه مباشرةً إلى تجاوز الوكيل، وهو المكوّن الذي يضيف معرّف مشروعك إلى البيانات. يعود الوكيل إلى المنفذ 4000 عندما يكون PORT غير مضبوط، كما يضبط .env.example المنفذ 4000 أيضاً؛ لذلك شغّل ss -lntp وتحقّق من المنفذ الذي استمع إليه قبل افتراض استخدام 4101.
هل يحل Superlog محل Uptime Kuma أو Zabbix؟
لا. يجيب Uptime Kuma عمّا إذا كانت نقطة نهاية تستجيب من خارج شبكتك، ويراقب Zabbix مقاييس المضيف والخدمات وفق الحدود التي تحددها. يستهلك Superlog التتبعات والسجلات والمقاييس التي تصدرها تطبيقاتك، ويجمع حالات الفشل المتكررة في حوادث. أبقِ مسباراً خارجياً لقياس الجهوزية إلى جانبه، لأن المسبار الذي يعمل في مكان آخر سيظل يبلّغ عندما يتعطل الخادم الذي يستضيف مسار بيانات التليمتري لديك.
هل يمكن لوكيل Superlog تغيير أنظمة الإنتاج لدي؟
فقط وفق الصلاحيات التي تمنحها له. يسجّل المشغّل المجتمعي الافتراضي ملخصاً محلياً للحادثة؛ أما بيئات تشغيل التحقيق الأخرى فتعتمد على المشغّل الذي تهيئه. اجعل بيانات اعتماد الإنتاج مقيّدة بصلاحية القراءة؛ إذ يتطلب فتح pull requests صلاحيات كتابة منفصلة في GitHub للفروع وطلبات الدمج. تعامل مع منح صلاحية الكتابة إلى الإنتاج باعتباره قراراً منفصلاً ومدروساً، لأن الوكيل القادر على إعادة تشغيل الخدمات يمثل التزاماً أكبر بكثير من وكيل يقرأ بيانات التليمتري وينشئ تصحيحاً للمراجعة.
هل ينبغي تثبيت commit أم تتبّع main؟
ثبّت commit. لم تكن هناك وسوم إصدار في المستودع حتى 13 October 2026. سجّل SHA الذي اختبرته، وانشر ذلك الإصدار، واقرأ diff قبل الانتقال إلى إصدار أحدث. git log --oneline <old-sha>..main هي المراجعة، وتُعد ملفات .env.example الخاصة بكل تطبيق أول مكان ينبغي البحث فيه عن المتغيرات المطلوبة حديثاً بعد أي تحديث.