← بازگشت به وبلاگ

دسترس‌پذیری API از کشورهای مختلف: ۵ معیار که فقط IP خارجی می‌بیند

نظارت محلی بر API نمی‌تواند آنچه را که کاربران در کشورهای دیگر می‌بینند نشان دهد. ۵ معیار دسترسی را بررسی می‌کنیم که تنها از طریق IP خارجی قابل دستیابی هستند و یک اسکریپت آماده برای جمع‌آوری آن‌ها ارائه می‌دهیم.

📅۲۴ مهر ۱۴۰۵

اگر نظارت بر API شما در یک سرور در یک مرکز داده اجرا شود، فقط بخشی از تصویر را می‌بینید. کاربر از برزیل ممکن است خطای 500 را دریافت کند، در حالی که داشبورد شما در مسکو وضعیت سبز «همه چیز کار می‌کند» را نشان می‌دهد. بیایید بررسی کنیم که کدام 5 معیار دسترسی را نمی‌توان بدون درخواست از طریق یک IP خارجی واقعی از کشور دیگر اندازه‌گیری کرد و چگونه می‌توان این کار را بدون زیرساخت پیچیده انجام داد.

چرا نظارت محلی گمراه‌کننده است

اکثر تیم‌ها نظارت بر API را از طریق UptimeRobot، Pingdom یا اسکریپت cron خود تنظیم می‌کنند که هر دقیقه به نقطه پایانی ضربه می‌زند. مشکل این است که این درخواست‌ها تقریباً همیشه از یک یا دو منطقه می‌آیند — معمولاً از ایالات متحده یا اروپا، جایی که سرورهای خدمات نظارت قرار دارند. اگر مخاطبان شما در هند، برزیل یا جنوب شرقی آسیا هستند، ارائه‌دهندگان محلی ممکن است ترافیک را قطع کنند، نود CDN ممکن است بارگذاری شود و DNS ممکن است به IP قدیمی حل شود.

سناریوی رایج دیگر — geo-blocking در سطح CDN یا WAF (Cloudflare، Akamai). برخی از قوانین امنیتی کل دامنه‌های IP از کشورهای خاص را مسدود می‌کنند و API شما به طور فیزیکی برای بخشی از کاربران در دسترس نیست، در حالی که از IP اداری شما همه چیز به طور ایده‌آل کار می‌کند. این مشکلات را نمی‌توان تشخیص داد اگر فقط از یک نقطه تست کنید.

سناریوی سوم — تعادل بار از طریق Anycast یا CDN-Edge‌های منطقه‌ای. درخواست از آلمان ممکن است به یک نود برسد، در حالی که از سنگاپور به طور کاملاً متفاوتی با نسخه دیگری از کش یا پیکربندی می‌رسد. تفاوت در رفتار API بین مناطق یک نظریه نیست، بلکه چیزی است که تیم‌ها به طور منظم با آن مواجه می‌شوند، به ویژه زمانی که کاربران در سرتاسر جهان توزیع شده‌اند.

5 معیار دسترسی که فقط از طریق IP خارجی قابل مشاهده هستند

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

1. زمان پاسخ (Latency / RTT)

Round-Trip Time — زمان از ارسال درخواست تا دریافت اولین بسته پاسخ. از یک سرور در اروپا، تأخیر تا API شما ممکن است 20 میلی‌ثانیه باشد، در حالی که کاربر از جنوب شرقی آسیا ممکن است 400-600 میلی‌ثانیه منتظر بماند به دلیل فاصله جغرافیایی و تعداد گره‌های میانی (hops). اگر تأخیر را از مناطق مختلف اندازه‌گیری نکنید، به راحتی می‌توانید لحظه‌ای را از دست بدهید که برای بخشی از مخاطبان، سرویس تقریباً غیرقابل استفاده می‌شود — به ویژه برای API‌هایی که به عملیات real-time وابسته هستند: مزایده در تبلیغات، چت‌ها، تراکنش‌های فین‌تک.

2. TTFB (Time To First Byte)

TTFB نشان می‌دهد که سرور چقدر زمان برای پردازش درخواست قبل از شروع ارسال پاسخ صرف می‌کند. این معیار نه تنها به شبکه بستگی دارد، بلکه به اینکه کدام نود CDN یا تعادل بار به منطقه خاص خدمت می‌کند نیز بستگی دارد. گاهی اوقات، سرور Edge در یک کشور پاسخ را کش کرده و آن را در 50 میلی‌ثانیه ارائه می‌دهد، در حالی که در کشور دیگر، درخواست هر بار به سرور اصلی می‌رسد و دوباره پردازش می‌شود، که زمان بیشتری از 800 میلی‌ثانیه و بیشتر را می‌طلبد. تفاوت در TTFB بین مناطق نشانه‌ای مطمئن از مشکلات پیکربندی CDN یا پوشش ناکافی نودهای Edge است.

3. زمان حل DNS

حل DNS یک منبع جداگانه از تأخیر و خطا است که به طور کامل به حل‌کننده محلی کاربر وابسته است. اگر شما GeoDNS را تنظیم کرده‌اید (رکوردهای A مختلف بسته به منطقه درخواست)، خطا در پیکربندی می‌تواند باعث شود که کاربران از یک کشور به مرکز داده‌ای در قاره دیگر حل شوند — با تأخیر بسیار زیاد. این مشکل فقط در هنگام درخواست حل DNS از IP واقعی کشور هدف قابل مشاهده است، تست محلی همیشه به «درست» نسبت به موقعیت جغرافیایی خودتان حل خواهد شد.

4. درصد درخواست‌های موفق (Uptime) بر اساس مناطق

Uptime 99.9% در داشبورد نظارت که از یک نقطه ضربه می‌زند، تضمین نمی‌کند که 99.9% برای کاربران در کشور دیگر باشد. ارائه‌دهندگان محلی ممکن است با پیوند به طور خاص به ارائه‌دهنده میزبانی شما مشکل داشته باشند، به طوری که بخشی از درخواست‌ها از کشور X به دلیل زمان‌گذاری خارج می‌شوند، در حالی که بقیه جهان اصلاً مشکلی را متوجه نمی‌شوند. برای دیدن Uptime واقعی، باید درخواست‌های موفق و ناموفق را به طور جداگانه برای هر منطقه شمارش کنید، نه به صورت تجمیع شده.

5. تفاوت‌ها در محتوا و کدهای وضعیت (geo-blocking و شخصی‌سازی)

پنجمین معیار — نه درباره سرعت، بلکه درباره خود محتوای پاسخ است. API ممکن است برای کشورهای خاص به دلیل قوانین WAF، 403 Forbidden را برگرداند، مجموعه داده‌های محدودتری به دلیل محدودیت‌های مجوز ارائه دهد، یا نسخه دیگری از محتوا را به دلیل آزمایش‌های A/B که به جغرافیا وابسته هستند، نشان دهد. اگر فقط API را از IP خود تست کنید، این تفاوت‌ها کاملاً نادیده خواهند ماند — و دقیقاً همین‌ها معمولاً دلیل شکایات از کاربران در مناطق خاص هستند.

مهم است که درک کنید

همه پنج معیار نیاز به درخواست از IP دارند که واقعاً از طریق شبکه کشور هدف مسیریابی می‌شود. VPN با یک سرور در کشور یا سرور ابری در همان منطقه تصویری تقریبی ارائه می‌دهد، اما نشان نمی‌دهد که سرویس چگونه توسط کاربر نهایی با ارائه‌دهنده خاص و مسیرهای آن به API شما مشاهده می‌شود.

چگونه نظارت از کشورهای مختلف را تنظیم کنیم

منطق تنظیم ساده است: شما یک درخواست HTTP یکسان به API خود از چندین نقطه به طور همزمان ارسال می‌کنید، همه پنج معیار را ثبت کرده و نتایج را مقایسه می‌کنید. به صورت مرحله‌ای اینگونه به نظر می‌رسد:

  1. لیستی از کشورهای اولویت‌دار تهیه کنید — معمولاً این 5 کشور برتر از نظر حجم ترافیک یا درآمد هستند.
  2. برای هر کشور یک نقطه خروج با IP واقعی آن کشور (سرور پروکسی یا سرور فیزیکی) آماده کنید.
  3. یک اسکریپت یا سرویس تنظیم کنید که یک درخواست یکسان را از طریق هر نقطه با فاصله زمانی مشخص (به عنوان مثال، هر 5 دقیقه) ارسال کند.
  4. همه 5 معیار را به طور جداگانه برای هر کشور در پایگاه داده یا سیستم معیارها (Grafana، Prometheus، ClickHouse) ثبت کنید.
  5. هشدارهایی برای انحراف معیارها از سطح پایه تنظیم کنید — به عنوان مثال، اگر تأخیر از کشور خاصی در یک ساعت 3 برابر شد.

نکته کلیدی — دقیقاً بند 2 است. بدون خروج واقعی به کشور مورد نظر، تمام مراحل دیگر بی‌معنا هستند، زیرا معیارها آنچه را که کاربر می‌بیند اندازه‌گیری نمی‌کنند، بلکه آنچه را که سرور نظارت شما می‌بیند اندازه‌گیری می‌کنند.

کدام نوع پروکسی را برای نظارت انتخاب کنیم

برای ایجاد نظارت جغرافیایی توزیع‌شده، معمولاً از سرورهای پروکسی استفاده می‌شود — این ارزان‌تر و سریع‌تر از اجاره سرورهای فیزیکی یا VPS در هر کشور مورد نیاز است. انتخاب نوع پروکسی بستگی به این دارد که دقیقاً چه چیزی را می‌خواهید اندازه‌گیری کنید.

نوع پروکسی کی استفاده کنیم ویژگی‌ها
پروکسی‌های مرکز داده بررسی اولیه دسترسی و تأخیر، زمانی که شبیه‌سازی کاربر واقعی ضروری نیست سرعت بالا، قیمت پایین، اما IP به راحتی به عنوان IP مرکز داده شناسایی می‌شود — برای تست geo-blocking بر اساس ارائه‌دهندگان مناسب نیست
پروکسی‌های مسکونی بررسی اینکه کاربر واقعی با ارائه‌دهنده خانگی چه می‌بیند IP متعلق به ارائه‌دهندگان واقعی در کشور خاص، به طور دقیق‌تر مسیر‌یابی و قوانین WAF را منعکس می‌کند
پروکسی‌های موبایل تست دسترسی API برای برنامه‌های موبایل و ترافیک موبایل IP از شبکه‌های اپراتورهای موبایل، تأخیرها و مسدودیت‌های خاص ترافیک موبایل را نشان می‌دهد

اگر API شما عمدتاً ترافیک وب را از دسکتاپ‌ها و سرورها ارائه می‌دهد، برای ساخت نظارت پایه، پروکسی‌های مرکز داده کافی هستند — آن‌ها سرعت پایدار و تأخیر قابل پیش‌بینی را ارائه می‌دهند. اما اگر می‌خواهید دقیقاً آنچه را که کاربر واقعی با آن مواجه است بررسی کنید — از جمله قوانین geo-blocking که بر اساس ASN ارائه‌دهنده تنظیم شده‌اند — بهتر است از پروکسی‌های مسکونی استفاده کنید، زیرا آن‌ها از طریق شبکه‌های ارائه‌دهندگان اینترنت عادی همان کشور مسیریابی می‌شوند. برای برنامه‌های موبایل و SDK‌هایی که درخواست‌هایی به API ارسال می‌کنند، منطقی است که بررسی از طریق پروکسی‌های موبایل را اضافه کنید، زیرا اپراتورهای موبایل معمولاً از NAT و قوانین مسیریابی خاص خود استفاده می‌کنند که با اینترنت خانگی متفاوت است.

اسکریپت آماده به زبان Python برای جمع‌آوری معیارها

در زیر یک مثال ساده از اسکریپت وجود دارد که درخواست را از طریق پروکسی در کشور مشخص شده ارسال می‌کند و چهار از پنج معیار را جمع‌آوری می‌کند (تفاوت‌های محتوا باید به طور جداگانه مقایسه شوند). این اسکریپت از کتابخانه requests و ماژول socket برای اندازه‌گیری زمان حل DNS استفاده می‌کند.

import time
import socket
import requests

def measure_api(url, proxy, country_label):
    hostname = url.split("//")[1].split("/")[0]

    # 1. زمان حل DNS
    dns_start = time.time()
    try:
        socket.gethostbyname(hostname)
    except socket.gaierror:
        pass
    dns_time = time.time() - dns_start

    proxies = {
        "http": proxy,
        "https": proxy,
    }

    try:
        start = time.time()
        response = requests.get(
            url,
            proxies=proxies,
            timeout=10,
            stream=True
        )
        ttfb = time.time() - start  # TTFB تقریبی

        full_load_time = time.time() - start
        status_code = response.status_code
        success = status_code == 200

        result = {
            "country": country_label,
            "dns_time_ms": round(dns_time * 1000, 2),
            "ttfb_ms": round(ttfb * 1000, 2),
            "total_time_ms": round(full_load_time * 1000, 2),
            "status_code": status_code,
            "success": success,
        }
    except requests.exceptions.RequestException as e:
        result = {
            "country": country_label,
            "dns_time_ms": round(dns_time * 1000, 2),
            "ttfb_ms": None,
            "total_time_ms": None,
            "status_code": None,
            "success": False,
            "error": str(e),
        }

    return result


# مثال استفاده با پروکسی از کشورهای مختلف
endpoints = [
    {"label": "آلمان", "proxy": "http://user:[email protected]:port"},
    {"label": "برزیل", "proxy": "http://user:[email protected]:port"},
    {"label": "سنگاپور", "proxy": "http://user:[email protected]:port"},
]

API_URL = "https://api.yourservice.com/health"

for ep in endpoints:
    data = measure_api(API_URL, ep["proxy"], ep["label"])
    print(data)

برای نسخه تولیدی چنین اسکریپتی، بهتر است ثبت نتایج در پایگاه داده (به عنوان مثال، ClickHouse یا InfluxDB)، تجسم از طریق Grafana و هشدارها از طریق ربات تلگرام یا Slack-webhook را در صورت تجاوز از مقادیر آستانه اضافه کنید. بهتر است اسکریپت را از طریق cron یا برنامه‌ریز وظایف با فاصله 5-15 دقیقه برای هر کشور اجرا کنید.

اگر نیاز به بررسی سریع بدون نوشتن کد دارید، می‌توانید درخواست مشابهی را از طریق cURL با اندازه‌گیری زمان انجام دهید:

curl -x http://user:[email protected]:port \
  -o /dev/null -s -w "DNS: %{time_namelookup}s | TTFB: %{time_starttransfer}s | Total: %{time_total}s | HTTP: %{http_code}\n" \
  https://api.yourservice.com/health

چگونه نتایج را تفسیر کنیم

پس از جمع‌آوری داده‌ها از همه کشورها به مدت حداقل یک هفته، سطح پایه (baseline) برای هر منطقه ایجاد می‌شود. سپس باید به جای اعداد مطلق، به انحرافات از این baseline توجه کنید. اگر تأخیر از برزیل به طور مداوم در سطح 350 میلی‌ثانیه ثابت بماند — این برای جغرافیا طبیعی است و باید هشدار را در صورتی که مقدار به طور ناگهانی به 1500 میلی‌ثانیه افزایش یابد، فعال کنید. به همین ترتیب با uptime: 99.5% برای منطقه‌ای پیچیده با اینترنت ناپایدار ممکن است یک معیار قابل قبول باشد، در حالی که کاهش به 95% — علامت مشکل در طرف ارائه‌دهنده یا CDN است.

توجه ویژه‌ای باید به کدهای وضعیت 403 و 451 داشت — آن‌ها تقریباً همیشه نشان‌دهنده geo-blocking از طرف WAF یا CDN هستند، نه مشکل با خود API. اگر چنین کدهایی فقط از یک کشور خاص و فقط هنگام استفاده از پروکسی از نوع خاصی (به عنوان مثال، مرکز داده) ظاهر شوند، این ممکن است به این معنی باشد که مسدودسازی بر اساس «IP شبیه به مرکز داده» تنظیم شده است، نه بر اساس موقعیت جغرافیایی واقعی — در این صورت تست با پروکسی‌های مسکونی تصویر صادق‌تری ارائه می‌دهد.

سرویس‌های آماده در مقابل راه‌حل‌های سفارشی

اگر نمی‌خواهید اسکریپت خود را نگهداری کنید، در بازار سرویس‌های آماده نظارت مصنوعی با نقاط حضور در کشورهای مختلف وجود دارد: Pingdom، Uptrends، Site24x7، Checkly. آن‌ها شما را از نیاز به تنظیم زیرساخت رها می‌کنند، اما معمولاً به مجموعه‌ای ثابت از مکان‌ها محدود هستند و انعطاف‌پذیری در انتخاب نوع IP (مسکونی، موبایل، مرکز داده) برای تست خاص را نمی‌دهند.

راه‌حل سفارشی مبتنی بر پروکسی کنترل بیشتری را فراهم می‌کند: می‌توانید دقیقاً همان کشورهایی را که برای کسب‌وکار شما مهم هستند، تست کنید، بین انواع IP برای تشخیص مشکلات خاص (به عنوان مثال، geo-blocking بر اساس ASN) سوئیچ کنید و معیارها را به طور مستقیم در سیستم نظارت خود بدون واسطه‌های اضافی ادغام کنید. ترکیب هر دو رویکرد — تعادل معقولی است: سرویس‌های آماده برای نظارت SLA پایه، اسکریپت خود با پروکسی برای تشخیص دقیق مشکلات در مناطق خاص.

نتیجه‌گیری

نظارت محلی از یک نقطه فقط بخشی از حقیقت را درباره دسترسی API نشان می‌دهد. برای دیدن تصویر واقعی، باید تأخیر، TTFB، زمان حل DNS، uptime و تفاوت‌های محتوا را به طور جداگانه برای هر کشور اندازه‌گیری کنید — و این کار را از طریق IP انجام دهید که واقعاً از طریق شبکه منطقه هدف مسیریابی می‌شود. بدون این کار به راحتی می‌توانید مشکلی را از دست بدهید که مانع از استفاده بخشی از کاربران از سرویس می‌شود، در حالی که داشبورد نشان می‌دهد «همه چیز سبز است».

برای ایجاد چنین نظارتی، پروکسی‌های مسکونی بهترین گزینه هستند، اگر مهم است که همان چیزی را ببینید که کاربر واقعی با اینترنت خانگی در کشور خاص می‌بیند. برای بررسی پایه‌ای و سریع‌تر دسترسی، پروکسی‌های مرکز داده مناسب هستند، و برای تشخیص مشکلات خاص در میان کاربران موبایل، باید بررسی از طریق پروکسی‌های موبایل را اضافه کنید. این رویکرد ترکیبی تصویری کامل از اینکه API شما از هر نقطه‌ای در جهان چگونه به نظر می‌رسد، ارائه می‌دهد، نه فقط از سروری که در آن مستقر است.