مانیتورینگ متریک‌های دامنه

قابلیت Metric Exporter برای ساده کردن فرآیند جمع‌آوری و تجزیه و تحلیل داده‌های دامنه‌ طراحی شده است و به شما کمک می‌کند با استفاده از روشی سریع و کارآمد اطلاعاتی کاربردی از عملکرد، رفتار و خطاهای دامنه‌ی خود به‌دست آورید. این ابزار به‌طور خودکار با پردازش لاگ‌های شما، متریک‌های مختلفی را تولید می‌کند که می‌توانید با استفاده از آن‌ها در برنامه‌هایی نظیر Grafana ،Prometheus و Splunk نمودارها و گزارش‌های متنوعی بسازید. فرمت ارسالی این داده‌ها Plain Text است.

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

متریک‌های ارسالی

با استفاده از قابلیت مانیتورینگ متریک‌های دامنه می‌توانید Upstream Error Metrics ،DNS Metrics ،HTTP Access Metrics و Event Metrics دامنه‌هایتان را دریافت کنید.

متریک‌های Access

متریک‌های Access	توضیح	نوع	برچسب
http_top_requests_ip	۱۰ IP با بیش‌ترین تعداد درخواست	Counter	hostname: نام میزبان ip: آی‌پی کاربر
http_top_requests_server_code	۱۰ Server Code با بیش‌ترین تعداد درخواست	Counter	hostname: نام میزبان server_code: شماره سرور CDN
http_top_requests_asn	۱۰ ASN با بیش‌ترین تعداد درخواست	Counter	hostname: نام میزبان asn: شماره asnای که از آن به سرور اصلی درخواست ارسال شده
http_requests_total	مجموع تعداد درخواست‌ها	Counter	hostname: نام میزبان method: متد HTTP درخواست content_type: نوع محتوای ارسالی درخواست status: کد وضعیت HTTP دریافتی از CDN
http_bytes_sent_total	مجموع تعداد بایت‌های ارسال‌شده در پاسخ‌های HTTP	Counter	hostname: نام میزبان method: متد HTTP درخواست content_type: نوع محتوای ارسالی درخواست
http_bytes_received_total	مجموع تعداد بایت‌های دریافت‌شده در درخواست‌های HTTP	Counter	hostname: نام میزبان method: متد HTTP درخواست content_type: نوع محتوای ارسالی درخواست
http_cache_hit_rate	نسبت Cache Hit به کل درخواست‌ها	Gauge	hostname: نام میزبان cache: وضعیت کش که می‌تواند مقادیر Hit ،Miss، ‌Bypass و Updating را داشته باشد
http_server_port_usage	تعداد دفعات استفاده از پورت‌های سرور	Gauge	hostname: نام میزبان server_port: پورت سرور اصلی که درخواست‌ها به آن می‌رسد
http_request_latest_upstream_time	مدت زمان پردازش آخرین درخواست از Upstream (میلی‌ثانیه)	Gauge	hostname: نام میزبان
http_requests_country_total	تعداد درخواست‌ها به‌تفکیک کشور	Counter	hostname: نام میزبان country: نام کشوری که درخواست از آن به سرور اصلی رسیده

متریک‌های DNS

متریک‌های DNS	توضیح	نوع	برچسب
dns_record_popularity	نرخ درخواست بر اساس نوع رکورد	Counter	hostname: نام میزبان type: نوع رکورد DNS مانند A ،AAAA و ...
dns_response_code_count	تعداد کدهای وضعیت DNS	Counter	hostname: نام میزبان response_code: کدهای وضعیت DNS
dns_top_query_count_by_asn	۱۰ ASN با بیش‌ترین کوئری (در بازه زمانی ریست می‌شود)	Counter	hostname: نام میزبان asn: شماره asnای که درخواست از آن ارسال شده
dns_query_count_by_country	مجموع درخواست‌های DNS بر اساس کشور	Counter	hostname: نام میزبان country: نام کشوری که درخواست از آن ارسال شده
dns_query_count_by_record	مجموع درخواست‌های DNS بر اساس نوع رکورد	Counter	hostname: نام میزبان record: نوع رکورد DNS مانند A ،AAAA و ...

متریک‌های Upstream Error

متریک‌های Upstream Error	توضیح	نوع	برچسب
per_pop_site_error_count	تعداد خطاها به ازای پاپ‌سایت‌های CDN	Counter	hostname: نام میزبان pop: نام پاپ‌سایت CDN
per_upstream_address_error_count	تعداد خطاها به ازای Upstreamها	Counter	hostname: نام میزبان upstream_ip: آی‌پی سرور اصلی که خطا از آن دریافت شده
per_domain_name_error_count	تعداد خطاها به ازای نام دامنه	Counter	hostname: نام میزبان domain_name: نام دامنه‌ای که خطا از آن دریافت شده
per_uri_top_error_count	۱۰ URI با بیش‌ترین خطا (در بازه زمانی ریست می‌شود)	Counter	hostname: نام میزبان uri: مسیری که خطا از آن دریافت شده

متریک‌های Event

متریک‌های Event	توضیح	نوع	برچسب
top_request_tlsfingerprint	۱۰ JA3 Fingerprint با بیش‌ترین درخواست HTTP	Counter	hostname: نام میزبان tls_figerprint: مقدار Fingerprint ای که از کاربر به سرور اصلی ارسال می‌شود
rate_limit_rule_matched_count	تعداد درخواست‌های تطبیق‌داده‌شده با قوانین Rate Limit	Counter	hostname: نام میزبان rlimit_matched: شناسه‌ی قانون Rate Limitای که تطبیق‌داده شده
rate_limit_action_count	تعداد اکشن‌های Rate Limit که روی درخواست‌ها اعمال شدند	Counter	hostname: نام میزبان rlimit_action: نوع عملکرد Rate Limit مانند Block, Allow, Challenge, Ignore
firewall_rule_matched_count	تعداد درخواست‌های تطبیق‌داده‌شده با قوانین فایروال	Counter	hostname: نام میزبان firewall_matched: شناسه قانون فایروالی که تطبیق داده شده
firewall_action_count	تعداد اکشن‌های فایروال که روی درخواست‌ها اعمال شدند	Counter	hostname: نام میزبان firewall_action: نوع عملکرد فایروال مانند Allow, Bypass, Deny و Challenge
pagerule_matched_count	تعداد درخواست‌های تطبیق‌داده‌شده با قوانین صفحات	Counter	hostname: نام میزبان pagerule_matched: شناسه قانون صفحه‌ای که تطبیق داده شده
ddos_challenge_action_count	تعداد اکشن‌های چالش‌های DDoS که روی درخواست‌ها اعمال شدند	Counter	hostname: نام میزبان ddos_challenge_action: نوع عملکرد مقابله با DDoS مانند Ignored, Passed, Issued, Preflight
ddos_challenge_decision_count	تعداد تصمیم‌های نهایی چالش‌های DDoS	Counter	hostname: نام میزبان ddos_challenge_decision: نوع تصمیم مانند Ignored, Passed, Issued, Preflight
waf_rule_matched_count	تعداد درخواست‌های تطبیق‌داده‌شده با قوانین WAF	Counter	hostname: نام میزبان waf_rule_matched: شناسه قانون WAFای که تطبیق داده شده

مدیریت مانیتورینگ متریک‌های دامنه در پنل

از پنل کاربری آروان وارد بخش «شبکه توزیع محتوا» شوید و «مانیتورینگ متریک‌های دامنه‌» را انتخاب کنید.

روی دکمه‌ی «مانیتورینگ جدید» کلیک کنید.

در این صفحه، دامنه‌ای که می‌خواهید متریک‌های آن را دریافت کنید، نوع لاگ و بازه‌ی جمع‌آوری را انتخاب و روی دکمه‌ی «ذخیره» کلیک کنید.

از این پس می‌توانید مانیتورینگ‌ها را فعال یا غیرفعال کنید، آن‌ها را ویرایش و مدیریت و یا حذف کنید.

مدیریت مانیتورینگ متریک‌های دامنه با API

برای کار با APIهای قابلیت مانیتورینگ متریک‌های دامنه می‌توانید از مستندات API این قابلیت استفاده کنید. پیش از استفاده از API باید در پنل کاربری یک کلید دسترسی بسازید. این کار را می‌توانید با ایجاد و دریافت کلید دسترسی و سپس ایجاد قانون دسترسی با حداقل سطح "بیننده شبکه توزیع محتوا" انجام دهید.

کلید دسترسی‌ای را که در این مرحله دریافت می‌کنید در جایی امن ذخیره کنید.

ایجاد مانیتورینگ متریک دامنه با API

برای ایجاد مانیتورینگ متریک دامنه از طریق API می‌توانید از نمونه درخواست زیر استفاده کنید:

• درخواست API ایجاد متریک اکسپورتر

curl --location 'https://napi.arvancloud.ir/cdn/4.0/domains/[domain]/metric-exporters' \
--header 'Content-Type: application/json' \
--header 'Authorization:[apikey]' \
--data '{"name": "hello", "type": "access", "interval": 10,  "status": true }'

توجه داشته باشید که باید به‌جای [domain] و [apikey] نام دامنه و کلید API خود را قرار دهید.

دریافت لیست مانیتورینگ‌های متریک دامنه

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

• درخواست API لیست مانیتورینگ متریک دامنه

curl --location 'https://napi.arvancloud.ir/cdn/4.0/metric-exporters' \
--header 'Authorization:[apikey]'

توجه داشته باشید که باید به‌جای [apikey] کلید API خود را قرار دهید.

پاسخ این درخواست به‌شکل زیر خواهد بود:

"data": [
    {
        "id": "string",
        "type": "string",
        "interval": 0,
        "name": "string",
        "status": true
    }
],

نمایش یک مانیتورینگ متریک دامنه

برای دریافت جزییات یک مانیتورینگ متریک دامنه از طریق API می‌توانید از نمونه درخواست زیر استفاده کنید:

• درخواست API نمایش مانیتورینگ متریک دامنه

curl \
--location 'https://napi.arvancloud.ir/cdn/4.0/domains/[domain]/metric-exporters/[metricExporterId]' \
--header 'Authorization:[apikey]'

توجه داشته باشید که باید به‌جای [domain] و [apikey] نام دامنه و کلید API خود را قرار دهید. هم‌چنین پارامتر [metricExporterId] را می‌توانید از فیلد id در خروجی لیست مانیتورینگ‌های متریک دامنه بردارید.

ویرایش یک مانیتورینگ متریک دامنه

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

• درخواست API ویرایش مانیتورینگ متریک دامنه

curl --location --request PUT 'https://napi.arvancloud.ir/cdn/4.0/domains/[domain]/metric-exporters/[metricExporterId]' \
--header 'Authorization:[apikey]' \
--header 'Content-Type: application/json' \
--data '{"name": "hello",  "type": "access",  "interval": 10,  "status": true}'

توجه داشته باشید که باید به‌جای [domain] و [apikey] نام دامنه و کلید API خود را قرار دهید. هم‌چنین پارامتر [metricExporterId] را می‌توانید از فیلد id در خروجی لیست مانیتورینگ‌های متریک دامنه بردارید.

حذف یک مانیتورینگ متریک دامنه

برای حذف یک مانیتورینگ متریک دامنه از طریق API می‌توانید از نمونه درخواست زیر استفاده کنید:

• درخواست API حذف مانیتورینگ متریک دامنه

curl --location --request DELETE 'https://napi.arvancloud.ir/cdn/4.0/domains/[domain]/metric-exporters/[metricExporterId]' \
--header 'Authorization:[apikey]'

توجه داشته باشید که باید به‌جای [domain] و [apikey] نام دامنه و کلید API خود را قرار دهید. هم‌چنین پارامتر [metricExporterId] را می‌توانید از فیلد id در خروجی لیست مانیتورینگ‌های متریک دامنه بردارید.