Loading...

لاگ و تحلیل

Logpush چیست؟ لاگ‌های دسترسی CDN در سیستم‌های خودتان

وقتی یک CDN سایت شما را سرو می‌کند، بیشتر درخواست‌ها هرگز به سرور شما نمی‌رسند و خط لاگ آن‌ها هم نمی‌رسد. تحویل لاگ، که اغلب Logpush نامیده می‌شود، آن‌ها را برمی‌گرداند: CDN برای هر درخواست روی edge یک خط می‌نویسد و فایل‌ها را آمادهٔ ابزارهای لاگ، SIEM یا آرشیو شما تحویل می‌دهد. این راهنما توضیح می‌دهد چه چیزی به دست می‌آورید، یک خط لاگ چه دارد و روی cdn.com.tr چگونه کار می‌کند.

8 دقیقه مطالعه متوسط به‌روزرسانی

Logpush چیست؟ لاگ‌های دسترسی CDN در سیستم‌های خودتان

چرا لاگ‌های مبدأ دیگر همهٔ ماجرا نیستند

پیش از CDN، وب‌سرور شما هر درخواست را می‌دید و در access log خود می‌نوشت. بعد از CDN، edge خودش درخواست‌های کش‌شده را پاسخ می‌دهد، که اغلب بیشتر درخواست‌ها هستند، و سرور شما فقط آنچه را باید سرو می‌کرد می‌بیند: cache missها، صفحه‌های غیرقابل‌کش، فراخوانی‌های API. این درخواست‌ها هم از آدرس edge می‌آیند، مگر اینکه آدرس بازدیدکننده را از یک سرآیند بازیابی کنید، همان‌طور که راهنمای IP واقعی بازدیدکننده نشان می‌دهد.

سابقهٔ کامل اینکه چه کسی چه چیزی خواسته اکنون روی edge است. تحویل لاگ آن سابقه را برای شما می‌فرستد: هر درخواست، hit یا miss، با آدرس بازدیدکننده، زمان‌بندی و وضعیت کش.

تحویل لاگ چه چیزی به شما می‌دهد

پاسخ پرسش‌های مشخص. برای این یک درخواست چه اتفاقی افتاد؟ کدام آدرس‌ها این فایل را دانلود کرده‌اند؟ خطاهای 5xx از چه زمانی شروع شد و روی کدام URLها؟ گزارش‌ها خلاصه می‌کنند؛ لاگ‌ها پاسخ می‌دهند.

امنیت و بررسی رخدادها. یک SIEM لاگ‌های edge را با لاگ‌های برنامه، فایروال و ورود شما تطبیق می‌دهد، تا بتوانید یک حمله، یک scraper یا یک لینک لو رفته را در طول چند روز دنبال کنید.

تحلیل‌های خودتان. خطوط را در یک data warehouse بارگذاری کنید و گزارش‌هایی را که کسب‌وکارتان لازم دارد بسازید، بر اساس کشور، شبکه، دستگاه یا نوع محتوا.

سابقه‌ای که در کنترل شماست. فایل‌ها مال شماست: هر مدتی که سیاست‌هایتان می‌خواهد، در سیستمی که از قبل استفاده می‌کنید نگهشان دارید.

کالبدشکافی یک خط لاگ

سرویس‌های تحویل لاگ معمولاً JSON Lines می‌نویسند: در هر خط یک شیء JSON کامل، یک خط برای هر درخواست، با فشرده‌سازی gzip. این قالب به‌خوبی stream می‌شود، تقسیم می‌شود و به آن می‌توان افزود، و همهٔ ابزارهای لاگ آن را می‌خوانند. در cdn.com.tr یک خط این فیلدها را دارد:

چه زمانی و کجا: ts (زمان، ISO 8601 با offset)، edge و edge_port (آدرس و پورت edgeای که بازدیدکننده به آن وصل شده است).

چه کسی: client_ip و client_port (آدرس بازدیدکننده و پورت مبدأ)، country، asn (شبکهٔ بازدیدکننده)، user_agent و referer.

چه چیزی: method، scheme، host، uri و protocol.

چگونه گذشت: status، bytes (بایت‌های بدنهٔ ارسال‌شده)، cache (HIT، MISS و سایر وضعیت‌های کش)، request_time (ثانیه‌هایی که edge صرف درخواست کرد) و origin_time (ثانیه‌هایی که مبدأ شما طول کشید، - در cache hit).

پورت مبدأ مهم‌تر از آنچه به نظر می‌رسد است. در شبکه‌های موبایل و پشت carrier-grade NAT، بازدیدکنندگان بسیاری یک آدرس عمومی را به اشتراک می‌گذارند؛ فقط آدرس، پورت و زمان با هم به یک اتصال اشاره می‌کنند.

یک درخواست، یک خط (برای خواندن شکسته شده است)

{"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 شماست و یک کلید همهٔ دامنه‌هایی را که حساب از طریق edge سرو می‌کند پوشش می‌دهد. با روشن بودن تحویل، هر edge درخواست‌های شما را جمع می‌کند و هر پنج دقیقه یک فایل JSON Lines فشرده با gzip آپلود می‌کند؛ نخستین فایل‌ها حدود ده دقیقه بعد ظاهر می‌شوند.

فایل‌ها بر اساس روز (UTC) گروه‌بندی می‌شوند و هر کدام پنج دقیقه از یک edge را پوشش می‌دهد. فایل‌ها را تکی یا به‌صورت یک روز کامل از پنل دانلود کنید، یا از خط فرمان کار کنید: cdnctl logs pull یک روز را می‌گیرد و با اجرای دوباره فقط فایل‌های جدید را؛ cdnctl logs grep فقط فایل‌های یک بازهٔ زمانی را دانلود می‌کند و روی کامپیوتر شما بر اساس IP، کد وضعیت، مسیر و موارد دیگر فیلتر می‌کند. لینک‌های دانلود فقط به داخل پوشهٔ خود حساب شما اشاره می‌کنند و پس از 15 دقیقه منقضی می‌شوند. مالکان و ویرایشگران تحویل را روشن و خاموش می‌کنند؛ همهٔ نقش‌های تیم می‌توانند فهرست بگیرند و دانلود کنند.

فایل‌ها 30 روز نگه داشته می‌شوند و بعد خودکار حذف می‌شوند. برای سابقهٔ طولانی‌تر، آن‌ها را مطابق نمونهٔ پایین به‌صورت زمان‌بندی‌شده به آرشیو خودتان منتقل کنید. راهنمای لاگ‌های دسترسی همهٔ مراحل را دارد.

پنهان‌سازی IP

لاگ‌های دسترسی داده‌های شخصی دارند: آدرس IP یک بازدیدکننده می‌تواند یک فرد را مشخص کند، و شما به‌عنوان صاحب سایت، کنترل‌کنندهٔ داده برای این لاگ‌ها هستید. پیش از روشن کردن تحویل تصمیم بگیرید که آدرس‌های کامل لازم‌تان است یا نه.

با روشن بودن پوشاندن IP بازدیدکنندگان، edge فقط بخش شبکهٔ هر آدرس را می‌نویسد: آدرس IPv4 سه octet نخست خود را نگه می‌دارد (198.51.100.0، یعنی /24) و آدرس IPv6 سه گروه نخست را (/48). این برای آمار کشور، شبکه و سوءاستفاده کافی است و بازدیدکنندگان منفرد را از فایل‌های شما بیرون نگه می‌دارد، در حالی که پورت مبدأ همچنان اتصال‌ها را از هم جدا می‌کند. وقتی برای بررسی رخدادها یا یک تعهد نگه‌داری سوابق به آدرس‌های کامل نیاز دارید، پنهان‌سازی را خاموش بگذارید و دسترسی خواندن فایل‌ها را محدود کنید.

رساندن لاگ‌ها به SIEM یا آرشیو

بازهٔ 30 روزه را بافر تحویل و فضای ذخیرهٔ خودتان را سابقهٔ اصلی بدانید. یک کار زمان‌بندی‌شده که فایل‌های جدید را می‌گیرد همهٔ آن چیزی است که لازم دارید، و چون cdnctl logs pull فقط فایل‌هایی را دانلود می‌کند که هنوز ندارید، اجرای آن هر ساعت تقریباً هزینه‌ای ندارد.

از آن‌جا فایل‌ها را به هر جا که تعلق دارند بفرستید: به Elasticsearch یا OpenSearch با Filebeat یا Logstash، به BigQuery یا ClickHouse به‌صورت JSON، به ورودی فایل SIEM خود، یا به object storage با یک قاعدهٔ lifecycle برای نگه‌داری بلندمدت. برای آرشیوی که دستکاری در آن قابل تشخیص باشد، هنگام رسیدن هر فایل یک checksum از آن ثبت کنید یا آن را امضا کنید.

فایل‌های جدید را هر ساعت بگیرید، سپس کوئری بزنید

# crontab: today's new files every hour, yesterday's last files after midnight (UTC days)
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 errors with time, host and URL
zcat /var/log/cdn/*.jsonl.gz | jq -r 'select(.status >= 500) | [.ts, .host, .uri, .status] | @tsv'

# one network in a time window, straight from the CLI
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

چه کسانی لاگ‌های edge را می‌خوانند

تیم‌های امنیت

درخواست‌های edge در SIEM کنار رویدادهای فایروال و ورود، تا یک حمله را از نخستین کاوش دنبال کرد.

پشتیبانی و عیب‌یابی

وضعیت دقیق، حالت کش و زمان‌بندی درخواستی که مشتری از آن شکایت دارد، در چند ثانیه.

آرشیو و ممیزی

سابقهٔ کامل درخواست‌ها در فضای ذخیرهٔ خودتان، به هر مدتی که سیاست‌هایتان می‌خواهد.

نحوه راه‌اندازی

راهنماهای گام‌به‌گام در مرکز راهنما:

پرسش‌های پرتکرار دربارهٔ Logpush

تفاوت Logpush با گزارش‌های تحلیلی چیست؟

گزارش‌ها درخواست‌ها، پهنای باند و نسبت کش را در طول زمان تجمیع می‌کنند. لاگ‌ها هر درخواست را با فیلدهای خودش نگه می‌دارند، پس می‌توانید به پرسش‌هایی پاسخ بدهید که هیچ گزارشی پیش‌بینی نکرده بود و داده را در سیستم‌های خودتان نگه دارید.

لاگ‌ها با چه سرعتی می‌رسند؟

هر edge هر پنج دقیقه یک فایل آپلود می‌کند. پس از روشن کردن تحویل، نخستین فایل‌ها حدود ده دقیقه بعد ظاهر می‌شوند.

فایل‌های لاگ چه مدت نگه داشته می‌شوند؟

سی روز، سپس خودکار حذف می‌شوند. برای سابقهٔ طولانی‌تر، آن‌ها را به‌صورت زمان‌بندی‌شده به فضای ذخیرهٔ خودتان منتقل کنید؛ cdnctl logs pull فقط فایل‌های جدید را می‌گیرد، پس اجرای مکرر ارزان است.

فایل‌ها از کدام منطقهٔ زمانی استفاده می‌کنند؟

فایل‌ها بر اساس روز UTC گروه‌بندی می‌شوند. هر خط زمان خودش را به‌صورت ISO 8601 همراه با offset دارد، پس ابزارهای شما می‌توانند آن را به هر منطقهٔ زمانی تبدیل کنند.

آیا می‌توانم IP کامل بازدیدکنندگان را از فایل‌ها دور نگه دارم؟

بله. با روشن بودن پنهان‌سازی IP، آدرس‌های IPv4 شبکهٔ /24 خود را نگه می‌دارند و آدرس‌های IPv6 شبکهٔ /48، پس فایل‌ها هیچ آدرس کامل بازدیدکننده‌ای ندارند.

Logpush کدام دامنه‌ها را پوشش می‌دهد؟

هر دامنه‌ای که حساب CDN شما از طریق edge سرو می‌کند. یک کلید روی حساب همه را پوشش می‌دهد، cache hit و miss به یک اندازه.