跳转到内容

计费与定价行为

Hina 的 billing/pricing 用于展示节点流量配额、公开价格标签、到期时间和相关告警。它不会主动限速或断开 Agent;超额与到期状态主要用于展示、筛选和告警。

每个节点可以配置一个流量配额、计费模式和重置日。

字段说明
配额当前计费周期内允许使用的流量。0 表示不限量,也不会参与配额告警。
计费模式决定 usedBytes 如何计算:sum 为下载 + 上传,rx 只看下载,tx 只看上传,max 取下载和上传中的较大值。
重置日取值 1..31,按 UTC 日期计算当前计费周期。

计费周期使用 UTC 日期边界,而不是站点时区。公开页面和管理页面展示的当前周期流量都基于同一套 UTC 周期计算。

重置日表示每月哪一天开始新的计费周期。例如重置日为 15 时,4 月 15 日 UTC 起进入新周期。

如果某个月没有配置的日期,Hina 会把该月的有效重置点视为下个月 1 日 UTC。例如:

  • 重置日为 31 时,2 月没有 31 日;3 月 1 日 UTC 会成为有效重置点。
  • 重置日为 30 时,非闰年 2 月没有 30 日;3 月 1 日 UTC 会成为有效重置点。

因此,建议生产环境优先使用 1..28 作为重置日;只有确实需要按月末语义展示时,再使用 29..31

Pricing 信息包含货币、金额、计费周期和到期时间,主要用于公开页面展示价格标签,以及驱动到期提醒告警。

支持的计费周期:

周期自动续期步长
monthly1 个月
quarterly3 个月
semiannual6 个月
annual1 年
biennial2 年
triennial3 年
lifetime不自动续期

到期时间为空时,节点不会被视为即将到期。lifetime 周期不会被自动续期。

服务端会每小时检查一次已过期的非 lifetime 节点,并按计费周期把到期时间推进到未来。

自动续期只处理最近 72 小时 内上报过数据的节点。长时间离线的节点不会被自动续期,直到它重新上报后才会重新进入检查范围。

按月推进到期时间时,如果目标月份没有原日期,会钳制到目标月份最后一天。例如 1 月 31 日按月续期到 2 月时,会变成 2 月最后一天。

quota_exceeded 告警使用当前计费周期内的 usedBytes / quotaBytes 计算百分比。只有配额大于 0 的节点会参与评估。

告警条件是严格大于阈值,而不是大于等于。例如:

  • 阈值为 80:使用量超过 80% 时触发。
  • 阈值为 100:正好 100% 不触发,超过 100% 才触发。

更多告警生命周期、触发延迟和恢复通知行为见 告警