Loading...

راهنمای CDN.com.tr

لاگ‌های دسترسی (logpush)

هر درخواستی را که CDN سرو می‌کند به‌صورت JSON Lines فشرده با gzip دریافت کنید و فایل‌ها را از پنل یا با cdnctl دانلود کنید.

لاگ‌های دسترسی (logpush)

هر درخواستی را که CDN سرو می‌کند به‌صورت JSON Lines فشرده با gzip دریافت کنید و فایل‌ها را از پنل یا با cdnctl دانلود کنید.

مسیر در پنل

  1. Management Panel
  2. CDN Accounts
  3. لاگ‌های دسترسی

پیش‌نیازها

  • مالکان و ویراستاران می‌توانند تحویل را روشن یا خاموش کنند؛ همه نقش‌ها می‌توانند فهرست ببینند و دانلود کنند.
  • مسئول داده این لاگ‌ها شما هستید: پیش از روشن کردن تصمیم بگیرید آیا به IP کامل بازدیدکنندگان نیاز دارید.

راهنمای گام‌به‌گام

1

تحویل را روشن کنید

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

  • صفحه لاگ‌های دسترسی را باز کنید.
  • تحویل لاگ را روشن کنید.
  • برای نگه داشتن فقط بخش شبکه، پوشاندن IP را تیک بزنید (IPv4 /24، IPv6 /48).

نتیجه مورد انتظار: در حدود ده دقیقه نخستین فایل‌ها زیر تاریخ امروز دیده می‌شوند.

معادل cdnctl
cdnctl logs status --account $ACCOUNT_UUID
2

یک روز را دانلود کنید

روزها به وقت UTC هستند. هر فایل پنج دقیقه از یک edge را پوشش می‌دهد.

  • روز را در فیلد تاریخ انتخاب کنید.
  • فایل‌ها را تک‌تک از فهرست دانلود کنید یا کل روز را با cdnctl بگیرید.

نتیجه مورد انتظار: فایل‌های آن روز روی سیستم شماست؛ اجرای دوباره pull فقط فایل‌های جدید را می‌آورد.

معادل cdnctl
cdnctl logs list --account $ACCOUNT_UUID --day 2026-09-25
cdnctl logs pull --account $ACCOUNT_UUID --day 2026-09-25 --out ./logs
3

خطوط را بخوانید

یک شیء JSON برای هر درخواست: ts، edge، client_ip، method، scheme، host، uri، protocol، status، bytes، cache (HIT/MISS)، request_time، origin_time، referer، user_agent، country، asn.

  • با هر ابزار لاگی باز و فیلتر کنید، مثلاً jq.
  • آن‌ها را به‌صورت JSON Lines در Elasticsearch، BigQuery یا SIEM خود بارگذاری کنید.

نتیجه مورد انتظار: می‌توانید به «چه بر سر این درخواست آمد» از داده خودتان پاسخ دهید.

معادل cdnctl
zcat ./logs/*.jsonl.gz | jq -r 'select(.status >= 500) | [.ts, .host, .uri, .status] | @tsv'

راستی‌آزمایی

  • لینک دانلود فقط به درون پوشه حساب شما اشاره می‌کند و پس از 15 دقیقه منقضی می‌شود.
  • با پوشاندن فعال، client_ip به .0 (IPv4) یا :: (IPv6) ختم می‌شود.

موارد کاربرد

به داده‌ای در سطح درخواست نیاز دارید که گزارش‌ها نشان نمی‌دهند: درخواست‌های یک بازدیدکننده، کدهای وضعیت یک URL یا لاگ برای SIEM خودتان.

جریان کاری سریع

  1. صفحه لاگ‌های دسترسی حساب را باز کنید.
  2. تحویل را روشن کنید؛ اگر به IP کامل بازدیدکنندگان نیاز ندارید، پوشاندن IP را انتخاب کنید.
  3. حدود ده دقیقه برای نخستین فایل‌ها صبر کنید.
  4. یک روز را از پنل دانلود کنید یا با cdnctl بگیرید.

بررسی‌ها

  • همه edgeهایی که به حساب سرویس می‌دهند برای تحویل لاگ آماده‌اند؛ تا آن زمان کلید غیرفعال می‌ماند.
  • فایل‌های لاگ ذخیره‌شده به‌عنوان فضای ذخیره‌سازی از سهمیه ماهانه کسر می‌شوند (بیشینه ماه).
  • فایل‌ها پس از 30 روز به‌طور خودکار حذف می‌شوند.

صفحات مرتبط

خواندن مصرف پلتفرم

تصویرهای لحظه‌ای مصرف زمان اجرا، پایگاه‌داده، ذخیره‌سازی و کانتینر را بررسی کنید.