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

Prev Next

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

时间序列字段

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

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

  • data - 根据时间戳返回为元组数组的指标

  • label - 在标签参数中定义的指标

  • sum - 在给定时间框架内的指标总结

  • units - 指标的测量单位

  • info - 与此数据集相关的信息

数据

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

  • timestamp - 从纪元(1970年1月1日)开始的时间量(以毫秒为单位)

  • metric - 在标签参数中请求的数据

数据参数

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

标签

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

总和

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

单位

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

  • bytes

  • 包

  • 比特

  • 毫秒

  • 百分比

  • 风险分数 - 站点的健康分析,类似于 分析 > 站点 > 连接窗口

  • 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 云的往返时间

  • 健康 - 站点的健康分析,类似于 分析 > 站点 > 连接窗口

  • tunnelAge - DTLS 隧道的年龄(以毫秒为单位),自上次重新连接以来

  • lastMilePacketLoss - 从 Socket 到 Cato 云测量的包丢失,衡量 ISP 最后一英里的性能

  • lastMileLatency - 从 Socket 到 Cato 云测量的延迟,衡量 ISP 最后一英里的性能

桶

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

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

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

  • 默认值 - 10个桶

  • 最小值 - 1个桶,粒度为5秒

  • 最大值 - 1000个桶