Loading...

السجلات والتحليلات

ما هو Logpush؟ سجلات وصول CDN في أنظمتك

حين يخدم CDN موقعك، لا يصل معظم الطلبات إلى خادمك، ولا تصله أسطر سجلاتها. تُعيدها إليك خدمة تسليم السجلات، التي تُسمّى غالبًا Logpush: يكتب CDN سطرًا لكل طلب على الحافة ويسلّمك الملفات جاهزة لأدوات السجلات أو SIEM أو أرشيفك. يشرح هذا الدليل ما تحصل عليه، وما يحويه سطر السجل، وكيف تعمل الخدمة على cdn.com.tr.

قراءة 8 دقائق متوسط آخر تحديث

ما هو Logpush؟ سجلات وصول CDN في أنظمتك

لماذا لم تعد سجلات أصلك القصة كاملة

قبل CDN كان خادم الويب يرى كل طلب ويكتبه في سجل الوصول. بعد CDN تجيب الحافة بنفسها عن الطلبات المخزّنة مؤقتًا، وغالبًا عن معظمها، فلا يرى خادمك إلا ما اضطر إلى خدمته: إخفاقات الكاش والصفحات غير القابلة للتخزين وطلبات API. وتصل هذه الطلبات هي الأخرى من عناوين الحافة، ما لم تستعد عنوان الزائر من ترويسة، كما يبيّن دليل عنوان IP الحقيقي للزائر.

السجل الكامل لمن طلب ماذا صار الآن على الحافة. وتسليم السجلات يرسل لك هذا السجل: كل طلب، سواء أصاب الكاش أم أخطأه، مع عنوان الزائر والتوقيت وحالة الكاش.

ماذا يمنحك تسليم السجلات

إجابات عن أسئلة محددة. ماذا حدث لهذا الطلب بالذات؟ أي العناوين نزّلت هذا الملف؟ متى بدأت أخطاء 5xx، وعلى أي عناوين URL؟ التقارير تلخّص؛ والسجلات تجيب.

الأمان والتحقيقات. يربط SIEM بين سجلات الحافة وسجلات تطبيقك وجدار الحماية وتسجيل الدخول، فتتتبّع هجومًا أو كاشطًا (scraper) أو رابطًا مسرّبًا على مدى أيام.

تحليلاتك الخاصة. حمّل الأسطر في مستودع بيانات وابنِ التقارير التي يحتاجها عملك، بحسب الدولة أو الشبكة أو الجهاز أو نوع المحتوى.

سجل تتحكم به. الملفات ملكك: احتفظ بها المدة التي تتطلبها سياساتك، في النظام الذي تستخدمه أصلًا.

تشريح سطر السجل

تكتب خدمات تسليم السجلات عادةً بصيغة JSON Lines: كائن JSON كامل في كل سطر، وسطر لكل طلب، مضغوط بـ gzip. تتدفق هذه الصيغة وتُقسَّم وتُلحَق بسلاسة، وتقرؤها كل أدوات السجلات. على cdn.com.tr يحمل السطر هذه الحقول:

متى وأين: ts (الوقت بصيغة ISO 8601 مع الإزاحة)، وedge وedge_port (عنوان الحافة ومنفذها اللذان اتصل بهما الزائر).

من: client_ip وclient_port (عنوان الزائر ومنفذ المصدر)، وcountry، وasn (شبكة الزائر)، وuser_agent وreferer.

ماذا: method وscheme وhost وuri وprotocol.

كيف جرى: status، وbytes (بايتات المحتوى المرسلة)، وcache (HIT وMISS وحالات الكاش الأخرى)، وrequest_time (الثواني التي قضتها الحافة في الطلب) وorigin_time (الثواني التي استغرقها أصلك، و- عند إصابة الكاش).

منفذ المصدر أهم مما يبدو. في شبكات الجوال وخلف CGNAT يتشارك زوار كثيرون عنوانًا عامًا واحدًا؛ ولا يدلّ على اتصال بعينه إلا العنوان والمنفذ والوقت معًا.

طلب واحد، سطر واحد (مقسوم هنا لسهولة القراءة)

{"ts":"2026-11-20T11:03:07+00:00","edge":"203.0.113.10","edge_port":"443",
 "client_ip":"198.51.100.7","client_port":"53114","method":"GET","scheme":"https",
 "host":"www.example.com","uri":"/products/42","protocol":"HTTP/2.0",
 "status":200,"bytes":18342,"cache":"HIT","request_time":0.004,"origin_time":"-",
 "referer":"https://www.example.com/","user_agent":"Mozilla/5.0 ...",
 "country":"TR","asn":64500}

Logpush على cdn.com.tr

سجلات الوصول مفتاح في صفحة سجلات الوصول بحساب CDN الخاص بك، ومفتاح واحد يغطي كل نطاق يخدمه الحساب عبر الحافة. مع تفعيل التسليم تجمع كل حافة طلباتك وترفع ملف JSON Lines مضغوطًا بـ gzip كل خمس دقائق؛ وتظهر الملفات الأولى خلال نحو عشر دقائق.

تُجمَّع الملفات بحسب اليوم (UTC)، ويغطي كل ملف خمس دقائق من حافة واحدة. نزّل ملفات مفردة أو يومًا كاملًا من اللوحة، أو اعمل من سطر الأوامر: cdnctl logs pull يجلب يومًا، وعند تشغيله ثانية لا يجلب إلا الملفات الجديدة؛ وcdnctl logs grep ينزّل ملفات نافذة زمنية محددة فقط ويرشّحها على حاسوبك بحسب IP ورمز الحالة والمسار وغيرها. تشير روابط التنزيل إلى مجلد حسابك وحده وتنتهي صلاحيتها بعد 15 دقيقة. يفعّل التسليم ويعطّله المالكون والمحررون؛ ويستطيع كل دور في الفريق عرض الملفات وتنزيلها.

تُحفظ الملفات 30 يومًا ثم تُحذف تلقائيًا. وللحصول على سجل أطول، اسحبها إلى أرشيفك وفق جدول، كما هو موضح أدناه. ويتضمن دليل سجلات الوصول كل الخطوات.

إخفاء IP

تحتوي سجلات الوصول على بيانات شخصية: قد يحدّد عنوان IP للزائر شخصًا، وأنت بصفتك مالك الموقع مسؤول المعالجة (data controller) عن هذه السجلات. قرّر قبل تفعيل التسليم هل تحتاج إلى العناوين كاملة.

مع تفعيل إخفاء IP تكتب الحافة الجزء الشبكي فقط من كل عنوان: يحتفظ عنوان IPv4 بثمانياته الثلاث الأولى (198.51.100.0، أي /24) ويحتفظ عنوان IPv6 بمجموعاته الثلاث الأولى (/48). وهذا يكفي لإحصاءات الدولة والشبكة وإساءة الاستخدام، ويُبعد الزوار الأفراد عن ملفاتك، بينما يظل منفذ المصدر يميّز الاتصالات بعضها من بعض. وحين تحتاج إلى العناوين كاملة، للتحقيقات أو لواجب حفظ السجلات، اترك الإخفاء معطلًا وقيّد من يستطيع قراءة الملفات.

إيصال السجلات إلى SIEM أو الأرشيف

اعدّ نافذة الثلاثين يومًا مخزنًا مؤقتًا للتسليم، وتخزينك أنت هو السجل. كل ما يلزم مهمة مجدولة تسحب الملفات الجديدة، ولأن cdnctl logs pull لا ينزّل إلا الملفات التي لا تملكها بعد، فتشغيله كل ساعة يكاد لا يكلّف شيئًا.

ومن هناك أرسل الملفات إلى حيث تنتمي: إلى Elasticsearch أو OpenSearch عبر Filebeat أو Logstash، أو إلى BigQuery أو ClickHouse بصيغة JSON، أو إلى مدخل الملفات في SIEM، أو إلى تخزين الكائنات مع قاعدة دورة حياة للاحتفاظ الطويل. وللحصول على أرشيف يكشف العبث، سجّل مجموع تحقق (checksum) لكل ملف أو وقّعه عند وصوله.

اسحب الملفات الجديدة كل ساعة ثم استعلم عنها

# crontab: ملفات اليوم الجديدة كل ساعة، وآخر ملفات الأمس بعد منتصف الليل (أيام UTC)
ACCOUNT_UUID=your-account-uuid
0 * * * *  cdnctl logs pull --account $ACCOUNT_UUID --out /var/log/cdn
20 0 * * * cdnctl logs pull --account $ACCOUNT_UUID --day $(date -u -d yesterday +\%F) --out /var/log/cdn

# أخطاء 5xx مع الوقت والمضيف وعنوان URL
zcat /var/log/cdn/*.jsonl.gz | jq -r 'select(.status >= 500) | [.ts, .host, .uri, .status] | @tsv'

# شبكة واحدة في نافذة زمنية، مباشرة من سطر الأوامر
cdnctl logs grep --account $ACCOUNT_UUID --from "2026-11-20 14:00" --to "2026-11-20 15:00" --ip 198.51.100.0/24 --format table

من يقرأ سجلات الحافة

فرق الأمان

طلبات الحافة في SIEM إلى جانب أحداث جدار الحماية وتسجيل الدخول، فيمكن تتبّع الهجوم منذ أول فحص استكشافي.

الدعم وتصحيح الأخطاء

الحالة والكاش والتوقيت الدقيقة للطلب الذي يشتكي منه العميل، في ثوانٍ.

الأرشفة والتدقيق

سجل كامل للطلبات في تخزينك الخاص، يُحفظ المدة التي تتطلبها سياساتك.

كيفية الإعداد

أدلة خطوة بخطوة في مركز المساعدة:

الأسئلة الشائعة حول Logpush

ما الفرق بين Logpush وتقارير التحليلات؟

تجمّع التقارير الطلبات والنطاق الترددي ونسبة الكاش عبر الزمن. أما السجلات فتحتفظ بكل طلب بحقوله الخاصة، فتجيب عن أسئلة لم يتوقعها أي تقرير، وتُبقي البيانات في أنظمتك.

ما سرعة وصول السجلات؟

ترفع كل حافة ملفًا كل خمس دقائق. بعد تفعيل التسليم تظهر الملفات الأولى خلال نحو عشر دقائق.

كم تُحفظ ملفات السجلات؟

ثلاثين يومًا، ثم تُحذف تلقائيًا. اسحبها إلى تخزينك الخاص وفق جدول لتحتفظ بسجل أطول؛ وcdnctl logs pull لا يجلب إلا الملفات الجديدة، فالتشغيل المتكرر زهيد الكلفة.

أي منطقة زمنية تستخدمها الملفات؟

تُجمَّع الملفات بحسب يوم UTC. ويحمل كل سطر طابعه الزمني بصيغة ISO 8601 مع الإزاحة، فتستطيع أدواتك تحويله إلى أي منطقة زمنية.

هل أستطيع إبعاد عناوين IP الكاملة للزوار عن الملفات؟

نعم. مع تفعيل إخفاء IP تحتفظ عناوين IPv4 بشبكتها /24 وعناوين IPv6 بشبكتها /48، فلا تحتوي الملفات على عناوين كاملة للزوار.

أي نطاقات يغطيها Logpush؟

كل نطاق يخدمه حساب CDN الخاص بك عبر الحافة. مفتاح واحد على الحساب يغطيها جميعًا، إصابات الكاش وإخفاقاته على حد سواء.