Skip to main content
client.apps.network 仅适用于 Web 应用。每个方法都以应用 ID 作为第一个参数。

时间窗口

analytics、errors、logs 和 performance 接受 start 和 end,每个都是 ISO 8601 字符串或 datetime。naive(不带时区的)datetime 被视为本地时间,并转换为 UTC。一个窗口最长 7 天,且 start 会被限制为不早于应用的创建日期。无效的窗口会返回 400 INVALID_TIME_RANGE。
结果以 5 分钟为单位进行缓存。这四个方法的缓存未命中共享每个账户每 60 秒 20 次请求的限制:超出后返回 429 RATE_LIMITED。

分析

network.analytics(app_id, start, end, **filters) 返回流量总计和细分数据。对于没有流量的窗口返回 None。
细分维度包括 countries、devices、os、browsers、protocols、methods、paths、referers、providers、ips、status_codes、bots 和 content_types。每个分组都有 type、visits、requests 和 bytes。

过滤器

过滤器以关键字参数传入,会缩小每个细分维度的范围。每个过滤器接受其对应细分维度中确切的 type 值:
无效的过滤器会返回 400 INVALID_FILTER。设置为 None 或 '' 的过滤器不会被发送。

错误

network.errors(app_id, start, end, include_4xx=False) 返回该窗口内的 5xx 响应,设置 include_4xx=True(仅限关键字参数)时还包括 4xx。对于空窗口返回 None。

请求日志

network.logs(app_id, start, end) 返回单个请求,包含客户端、请求和响应的详细信息。适用于 Pro 和 Enterprise 套餐(否则返回 403 UPGRADE_REQUIRED)。

性能

network.performance(app_id, start, end) 返回边缘和源站的延迟百分位数(p50、p95、p99,单位为毫秒),按国家、按位置以及最慢的路径分别统计。对于空窗口返回 None。适用于 Pro 和 Enterprise 套餐。

DNS

network.dns(app_id) 返回你的自定义域名所需的 DNS 记录及其状态。没有自定义域名时返回 400 NO_CUSTOM_DOMAIN。

自定义域名

network.set_domain(app_id, domain) 绑定一个自定义域名(Standard 及以上套餐)。传入 "@" 即可移除。

清除缓存

network.purge_cache(app_id) 清除应用的边缘缓存。每 60 秒最多清除一次(429 KEEP_CALM)。

分析方法的错误