如何使用 getRecentPerformanceSamples

​

常见用例

• 网络健康监控： 跟踪交易处理率和槽生产，以评估整体网络健康状况并识别潜在的拥堵或减速。
• 性能分析： 分析历史性能数据，以了解网络在不同条件下的行为。
• 仪表盘展示： 在监控仪表盘上显示关键性能指标（KPI），如每秒交易数（TPS）和每分钟槽数。
• 容量规划： 观察网络负载趋势，以为应用程序或基础设施的扩展决策提供信息。

​

请求参数

1. limit (usize, 可选):
   • 要返回的最近性能样本的数量。
   • 最大值：720（代表大约 12 小时的数据，因为样本每 60 秒采集一次）。
   • 如果省略，RPC 节点将返回默认数量的样本（具体默认值可能因 RPC 提供商而异）。

​

响应结构

• slot (u64): 记录此性能样本的槽号。
• numTransactions (u64): 在此 slot 之前的 samplePeriodSecs 内处理的交易总数（包括投票和非投票交易）。
• numSlots (u64): 在此 slot 之前的 samplePeriodSecs 内处理的槽数。
• samplePeriodSecs (u16): 采集此样本的持续时间（以秒为单位，通常为 60）。
• numNonVoteTransactions (u64): 在此 samplePeriodSecs 期间处理的非共识投票交易的数量。

​

示例

​

1. 获取最近 5 个性能样本

# Replace <api-key> with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getRecentPerformanceSamples",
    "params": [5]
  }'

​

2. 获取默认数量的性能样本

# Replace <api-key> with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getRecentPerformanceSamples"
  }'

​

开发者提示

• 采样间隔： 样本通常每 60 秒采集一次，但这只是一个近似值。响应中的samplePeriodSecs字段指示每个样本的实际持续时间。
• 历史数据限制： 最大limit为 720 个样本，提供大约 12 小时的历史数据窗口。对于长期性能分析，需要外部数据记录和聚合。
• 投票与非投票交易： numTransactions包括所有交易，而numNonVoteTransactions专门统计那些不属于共识投票过程的交易。后者通常是用户驱动网络活动的更好指标。
• 节点变异性： 具体数据可能会因不同 RPC 节点的同步状态和在采样时对网络的本地视图而略有不同。