控制台概览
FourA 控制台用于管理 API 密钥和 proxy 用户、运行测试 request、监控性能、处理账单以及配置账户。本页面将介绍主要概览界面及侧边栏各版块。
访问控制台
请在 foura.ai/dashboard 登录。你需要一个 FourA 账户:若尚未注册,请在此注册。
两款产品,共用界面
概览、指标和活动页面均提供一个 Product 切换项,包含两个选项:
| Product | 统计内容 | 单位 |
|---|---|---|
| API | 发送到 /api/single、/api/proxy、/api/browser 和 /api/auto 的 request |
Request 和 credit |
| Proxy | 本地工具通过 proxy.foura.ai 建立的 tunnel |
Tunnel 和 byte |
Tunnel 负责传输客户端发送的任何内容,CONNECT 内部传输的均为你自己的加密流量。因此 Proxy 视图仅统计 tunnel 和 byte,不统计 request 或 credit。产品详细信息请参阅 Proxy Port。
切换项始终处于两者之一,系统会在多次访问间记住该选择,且 URL 地址中会包含 #overview/proxy、#metrics/proxy 或 #activity/proxy。粘贴这些链接即可直接打开对应产品的页面。
请勿将 Proxy 产品与 Proxy Finder endpoint 标签混淆。Proxy Finder 是 POST /api/proxy/,属于 API 的四个 endpoint 之一。Proxy 产品则是 proxy port。
概览页面,API 产品
登录后的落地页会显示所选时间段的核心指标。页面每 60 秒自动刷新一次,标题旁的刷新按钮会显示倒计时并支持立即刷新。
发送首个 Request 之前
在首个 request 到达前,API 视图会显示示例数据,各面板和图表均带有 Sample 标签,并置于 This is sample data. 横幅下方。横幅提供两个操作步骤:Create API key(生成新密钥并附带测试命令)和 Open Playground(用于发送 request)。在手机或平板电脑上,由于无法运行命令行,步骤会引导你前往 Playground。首个真实 request 到达后,将永久替换示例数据。
Proxy 视图配有独立的 No traffic yet. 横幅,包含 Create proxy user 和 Open Proxy,该横幅会持续显示,直到某个 proxy 用户产生流量或收到首个真实 API request 为止。关闭其中任一横幅会同时隐藏两者。
概览卡片
顶部包含六个面板:
| 面板 | 展示内容 |
|---|---|
| Concurrency | 当前同时运行的 request 数量,以及所选周期内的平均值和最大值 |
| Requests | 总调用次数,其后依次为 Single、Proxy、Browser 和 Auto,下方标注各自占总量的比例。一次 Auto 调用仅在 Auto 下计入一次。 |
| Auto attempts | 始终显示,若 Auto 在所选周期内未运行任何内容则为零。展示 Auto 调用背后实际发起的 Single、Proxy 和 Browser 请求,以及每次 Auto 调用的尝试次数。它们绝不计入 requests 或成功率,其 credit 包含在 Auto 的 credit 内。它们计入您的 Single、Proxy 和 Browser 速率与并发限制。 |
| Credits | 数值代表已计费 credit,下方为已消耗 credit,包括总量以及每个产品(含 Auto)的数据 |
| Bytes | 传输的数据量:In 是您发送的数据,Out 是返回的数据,Premium 是通过高级出口传输的那部分流量,无论该出口是否成功交付页面。Premium 已包含在上述两项总量中,绝不会重复累加。 |
| Response Time | 所选周期内的平均值、最小值和最大值 |
已计费与已消耗是不同的数值。 只有成功的 request 才会计费,因此计费是您实际支付的部分。已消耗涵盖所有结果,因为失败的 request 仍会占用 proxy 或 browser。混淆这两者往往会导致同一账户在两个页面上看起来数据不一致。请参阅 Request Outcomes 了解计费的具体结果。
Requests 和 Credits 面板将四个 endpoint 标记为 Single、Proxy、Browser 和 Auto。上方 Endpoints 过滤行中将 Proxy 称为 Proxy Finder,两者是同一概念:POST /api/proxy/。
四者相加并不总是等于总数。极少数调用不属于其中任何一类,它们计入总数但不会归入任何特定 endpoint。
时间线图表
面板下方提供六张时间线图表,绘制 request 数量、credit 消耗、结果细分、响应时间、带宽和并发数据。每张图表的头部都有一个切换开关,可在图表与底层数据表之间切换。
概览页面,Proxy 产品
将 Product 切换为 Proxy,同一页面将以隧道维度展示数据。包含四个面板:
| 面板 | 展示内容 |
|---|---|
| Tunnels at Once | 同一时刻打开的隧道数。Current 涵盖过去数秒并每五秒刷新一次;Avg 和 Max 涵盖所选周期。您的套餐会在所有 proxy 用户之间对该指标进行总额限制。 |
| Tunnels | Success 和 Failed,下方标注各自占总量的比例。Failed 涵盖所有其他结果,并在 Outcome 行中具体指明。 |
| Traffic | In 是工具发送的数据,Out 是返回的数据,Premium 是通过高级网络离开的部分,已计入总量内部而非额外累加。 |
| Setup Time | 仅针对成功隧道,交付隧道前的平均、最小和最大等待时间。这是发送首字节前的等待时长,并非隧道背后网站的响应速度。 |
下方显示五个时间线图表:Tunnel Timeline、Outcome Timeline、Setup Time Timeline、Traffic Timeline 和 Tunnels at Once Timeline。每个图表都提供与 API 图表相同的图表或表格切换开关。
当某个 Outcome 胶囊处于选中状态时,三个面板及其时间线图表会变暗,原因在于该结果下不存在对应数值。Tunnels at Once 在任何结果下都会变暗,其图表带有 Not filterable 徽标。Setup Time 和 Traffic 在失败结果下变暗,其图表带有 Success only 徽标,因为失败的隧道从未完成交付,也没有传输任何内容。
时间范围与粒度
Period 表示回溯查看的时间跨度。提供八个胶囊选项及 Custom:
| 胶囊 | 时间窗口 |
|---|---|
| 30M | 最近 30 分钟 |
| 3H | 最近 3 小时 |
| 12H | 最近 12 小时 |
| 24H | 最近 24 小时 |
| 7D | 最近 7 天 |
| 30D | 最近 30 天 |
| 90D | 最近 90 天 |
| 1Y | 最近 12 个月 |
Custom 会打开一个包含四个预设项(This month、Last month、Last 6 months 和 All time)以及 From 和 To 日期对的对话框。日期范围截止到所选日期的结束时间,绝不会超过当前时刻。
Detail 表示每个柱子的时间跨度:按分钟、每 5 分钟、每 30 分钟、按小时、每 6 小时、按天、按周或按月。默认值为 Auto,它会选择仍能在图表上保留至少 15 个柱子的最粗步长,因此一年的数据会显示为一个趋势形态,而不是 365 根细线。Auto 选项会标明其所选的步长。
Period 和 Detail 适用于两款产品。
如果 Detail 步长回溯的时间超出了 FourA 保留该分辨率的范围,该选项会置灰而非隐藏:
| 分辨率 | 回溯时长 |
|---|---|
| 按请求 | 7 天 |
| 5 分钟 | 30 天 |
| 按小时 | 12 个月 |
| 按天 | 全部历史记录 |
选择超出某一级别允许的时间范围时,更精细的选项会置灰。Auto 绝不会选择置灰的选项,因此图表绝不会因为数据被聚合而变为空白。
筛选条件
筛选条件支持叠加组合,Period 和 Detail 与它们并列显示。
| 筛选条件 | 产品 | 说明 |
|---|---|---|
| Product | 两者 | API 或 Proxy |
| Endpoints | API | 限定至单个 endpoint:Single、Proxy Finder、Browser 或 Auto。一次 Auto 调用按 Auto 计为一次;其底层梯度机制发起的 Single、Proxy 和 Browser 请求会在 Auto attempts 面板中按名称展示,绝不会计为独立请求。 |
| Outcome | 两者 | 隔离单个类别。API 提供全部 7 种;Proxy 产品提供隧道可能终止的 5 种状态。 |
| Owner | 两者 | 全部、Personal 或你的某个组织。仅当你属于至少一个组织时显示。 |
| Key | API | 限制为单个 API key |
| Proxy user | Proxy | 限制为单个 proxy 用户 |
API 侧的 Concurrency 面板和图表不支持 Endpoints 或 Outcome 筛选条件。当任一筛选条件启用时,两者都会变暗,图表头部也会显示相应提示。
Owner 筛选条件
Owner 下拉菜单用于明确“当前正在查看谁的流量”。它提供 Everything、Personal 以及你所属的每个组织的条目,且 Metrics、Activity、API Keys 和 Proxy 上的对应筛选会同步此选择,确保各页面数据完全一致。
Usage & Limits 与 Billing 刻意不提供该选项。它们解答的是“哪些项目计入我的账单”,具体包括你的个人 key、proxy 用户,以及你名下组织的对应资源。详见 Organizations。
侧边栏分区
包含 11 个页面和一个 Docs 链接,划分为四组:Dashboard、Tools、Access 与 Account。
Dashboard:Overview、Metrics、Activity
这三个页面用于展示“发生了什么”。三者均支持 Product 切换。
Overview 是上方展示的页面,始终是登录后的起始页。
Metrics 包含 Usage 面板:API 维度支持按 API key、客户端 IP 或域名分组细分,Proxy 维度支持按 proxy 用户、目标、出口国家、客户端 IP 或结果分组,分页表格上方展示了整个周期的统计卡片。详见 Metrics 指南。
Activity 显示最近一小时的流量。打开页面时自动加载,点击刷新按钮可获取最新记录。在 API 维度,每行对应一个 request:包含方法、目标域名、状态、结果、耗时、传输大小和 credits。在 Proxy 维度,每行对应一个 tunnel:包含 proxy 用户、目标、出口、结果、建立耗时、持续时间、字节数和客户端 IP。详见 Activity Log。
Tools:Playground、Extension、Docs
无需编写代码,即可使用真实 API key 测试实时 request。选择 Auto、Single、Proxy 或 Browser,设置 URL,调整标志与超时时间,然后点击 Send 即可。支持将常用配置保存为预设,也可从 History 中重放最近 20 次运行记录。
测试产生的用量会计入 key 的配额,与生产环境调用完全一致。详见 Playground 指南。
Extension(标记为 Beta)是下载 FourA Chrome 扩展的入口。其弹出窗口可让 Chrome 流量经由你的某个 proxy 用户代理,DevTools 中的 FourA 标签页可将页面发出的任意 request 转为现成的 API 调用。详见 Chrome Extension。
Docs 会在新标签页中打开本文档,当前所在的控制台页面保持不变。
侧边栏顶部的主题按钮可在系统设置、浅色和深色之间循环切换。该配置在 foura.ai 和文档之间通用,在任意站点所选的主题都会同步到控制台。
Access:API Keys、Proxy
API Keys 用于创建、查看和管理应用程序调用 API 时所用的 key。Key 使用 pk_live_ 前缀。详见 管理 API Keys。
Proxy 用于创建 proxy 用户并为任何支持 proxy URL 的客户端复制连接字符串。通过该端口建立的隧道和流量与 API 一样计入您的套餐用量。请参阅 Proxy 用户 和 Proxy 端口 参考文档。
账户:组织、用量与限制、账单、设置
组织允许在单一所有者下与团队成员共享 API key 和 proxy 用户。通过邮箱添加成员、设置角色,并在需要时移交组织所有权。使用组织凭据产生的用量将计入组织所有者的套餐。请参阅 组织。
用量与限制展示您的套餐信息、本计费周期的已用量以及适用的各项配额,并提供按 key、按 endpoint 和按 proxy 用户的明细统计。请参阅 用量与限制。
账单用于管理订阅、购买额外额度或流量、维护支付方式与发票,并展示本期已用额度、流量以及高级流量相对于套餐上限的情况。请参阅 账单与订阅。
设置包含您的显示名称、密码、活跃会话和已连接的登录方式。控制台不支持修改邮箱,如需更改请联系支持团队。
实用提示
- 编写代码前请先使用 Playground。如果不确定新目标站点需要哪种引擎,请先选择 Auto 让系统自动匹配。
- 在额度卡片中对比计费量与实际消耗量。如果两者差距过大,说明该 endpoint 失败率较高,尝试报告会标明具体原因。
- 在 Proxy 产品中,结果时间线中出现的大量 Rate Limited 属于您的套餐配额限制,并非目标站点拒绝请求。指标中的结果视图会标明具体触发了哪项限制。
- 妥善保管您的 API key 和 proxy 用户。若怀疑凭据泄露,请立即禁用。