卡托 API - 账户指标 > 时间序列

根据查询中指定的时间范围(桶)显示账户的指标。 包括历史和接近实时的统计数据和指标。 这些数据类似于每个站点的 Cato 管理应用程序中的站点连接性窗口。

时间序列字段

时间序列字段显示 AccountMetrics 数据的时间框架,以及它如何根据时间桶显示。

这些是账户指标字段可以返回的查询详细信息:

  • data - 根据时间戳返回为元组数组的指标
  • label - 在标签参数中定义的指标
  • sum - 在给定时间框架内的指标总结
  • units - 指标的测量单位
  • info - 与此数据集相关的信息

数据

数据字段是一个元组数组,每个元组包含两个值:[时间戳,指标]。

  • timestamp - 自 epoch(1.1.1970)以毫秒为单位的时间数量
  • metric - 在标签参数中请求的数据

数据参数

  • perSecond - 一个布尔值。 当设置为true时,数据被标准化为每秒单位(除以粒度)。 例如,如果数据在6秒内返回24字节,则显示为每秒4字节。

标签

标签字段显示在时间序列 > 标签参数中定义的值。

总和

总和字段显示查询时间框架内的值总结。

单位

单位字段显示这些指标的测量单位:

  • 字节
  • 比特
  • 毫秒
  • 百分比
  • score - 站点的健康分析,类似于 分析 > 站点 > 连接窗口
  • count - 此单位的出现次数
  • 秒 - 对于以秒为单位测量的指标,如 tunnelAge,记录秒数

信息

信息字段显示有关此数据集的信息,例如:站点ID、Socket 和接口。

时间序列参数

时间序列参数允许您为查询定义标签和桶。

  • 标签 - 一个枚举数组,定义查询的指标
  • 桶 - 定义查询时间长度的桶数量

标签

标签参数是一个数组,用于定义查询返回的指标。 例如,以字节为单位的上行和下行流量。

注意:返回的标签数据会显示该时间桶的指标。

这些是该参数的选项:

  • bytesUpstream - 上行流量的总字节(从 Cato 云到站点)
  • bytesDownstream - 下行流量的总字节(从 Cato 云到站点)
  • bytesUpstreamMax - 上行吞吐量的最大值(字节) - 当时间桶最小值为5时,bytesUpstreamMax 等同于 bytesUpstream
  • bytesDownstreamMax - 下行带宽的最大允许带宽(字节) - 当时间桶最小值为5时,bytesDownstreamMax 等同于 bytesDownstream
  • packetsUpstream - 总上行数据包
  • packetsDownstream - 总下行数据包
  • lostUpstream - 上行流量丢失的数据包数量
  • lostDownstream - 下行流量丢失的数据包数量
  • lostUpstreamPcnt - 上行流量丢失数据包的百分比
  • lostDownstreamPcnt - 下行流量丢失数据包的百分比
  • packetsDiscardedDownstream - 下行流量丢弃的数据包总数
  • packetsDiscardedUpstream - 上行流量丢弃的数据包总数
  • jitterUpstream - 上行流量的抖动(数据包之间的时间延迟差异,以毫秒(ms)为单位)
  • jitterDownstream - 下行流量的抖动(数据包之间的时间延迟差异,以毫秒(ms)为单位)
  • bytesTotal - 上行和下行流量的总字节数
  • rtt - 从站点到 Cato 云的往返时间
  • health - 站点的健康分析,类似于 分析 > 站点 > 连接窗口
  • tunnelAge - DTLS 隧道的年龄(以毫秒为单位),自上次重新连接以来
  • lastMilePacketLoss - 从 Socket 到 Cato 云测量的包丢失,衡量 ISP 最后一英里的性能
  • lastMileLatency - 从 Socket 到 Cato 云测量的延迟,衡量 ISP 最后一英里的性能

参数定义了查询的时间间隔的桶数量(由 timeFrame 参数定义)。 例如,24小时的时间间隔和48个桶意味着每个桶的时间长度为30分钟。

有关桶参数和粒度字段的更多信息,请参见与账号指标 > 粒度一起工作

以下是查询中使用桶参数的详细信息:

  • 默认值 - 10个桶
  • 最小值 - 1个桶,粒度为5秒
  • 最大值 - 1000个桶

这篇文章有帮助吗?

0 人中有 0 人觉得有帮助

0 条评论