--- title: "卡托 API - 账户指标 > 时间序列" slug: "cato-api-accountmetrics-timeseries" updated: 2026-07-30T03:23:18Z published: 2026-07-30T03:23:18Z canonical: "knowledge.catonetworks.com/cato-api-accountmetrics-timeseries" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # 卡托 API - 账户指标 > 时间序列 根据查询中指定的时间范围(桶)显示账户的指标。 包括历史和接近实时的统计数据和指标。 这些数据类似于每个站点的 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分钟。 有关桶参数和粒度字段的更多信息,请参见[与账号指标 > 粒度一起工作](/v1/docs/working-with-accountmetrics-granularity)。 以下是查询中使用桶参数的详细信息: - 默认值 - **10**个桶 - 最小值 - 1个桶,粒度为5秒 - 最大值 - **1000**个桶