开发文档

server_info

此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
该server_info命令向服务器请求关于streamd正被查询的服务器的各种信息的人类可读版本。 请求格式的示例:
{
  "id": 1,
  "command": "server_info"
}
{
    "method": "server_info",
    "params": [
        {}
    ]
}
#Syntax: server_info
streamd server_info
该请求不包含任何参数。 一个成功回应的例子:
{
  "id": 1,
  "result": {
    "info": {
      "build_version": "0.1.0",
      "complete_ledgers": "2-168922",
      "hostid": "MOS",
      "io_latency_ms": 1,
      "last_close": {
        "converge_time_s": 2.001,
        "proposers": 2
      },
      "load_factor": 1,
      "peers": 2,
      "pubkey_node": "n9KeFY9ZAmhuk2CDdKthcMhcZLhhaBrCFKSNAc1ondhFZNQgfR5e",
      "server_state": "proposing",
      "validated_ledger": {
        "age": 12,
        "base_fee_stm": 1e-05,
        "hash": "5BED1224009D5FC996B41A5E95041286596346D96DD8F6B4DF18DDD4FC65F54C",
        "reserve_base_stm": 1,
        "reserve_inc_stm": 0.1,
        "seq": 168922
      },
      "validation_quorum": 2
    }
  },
  "status": "success",
  "type": "response"
}
200 OK
{
  "result": {
    "info": {
      "build_version": "0.1.0",
      "complete_ledgers": "2-168922",
      "hostid": "MOS",
      "io_latency_ms": 1,
      "last_close": {
        "converge_time_s": 2.001,
        "proposers": 2
      },
      "load_factor": 1,
      "peers": 2,
      "pubkey_node": "n9KeFY9ZAmhuk2CDdKthcMhcZLhhaBrCFKSNAc1ondhFZNQgfR5e",
      "server_state": "proposing",
      "validated_ledger": {
        "age": 12,
        "base_fee_stm": 1e-05,
        "hash": "5BED1224009D5FC996B41A5E95041286596346D96DD8F6B4DF18DDD4FC65F54C",
        "reserve_base_stm": 1,
        "reserve_inc_stm": 0.1,
        "seq": 168922
      },
      "validation_quorum": 2
    }
  },
  "status": "success",
  "type": "response"
}
响应遵循标准格式,成功的结果包含一个info对象作为唯一字段。 该info对象可能具有以下字段:
Field Type Description
build_version String 正在运行的streamd版本的版本号。
closed_ledger Object (可能被省略)最近关闭的分类帐的信息尚未经协商一致确认。如果最近验证的分类账可用,则回复省略此字段并包含validated_ledger。成员字段与validated_ledger字段相同。
complete_ledgers String 范围表达式指示数据库中本地波动的分类帐版本的序列号。例如,这可能是一个不相交的序列24900901-24900984,24901116-24901158。
hostid String 在管理请求上,返回运行该streamd实例的服务器的主机名; 否则,返回一个唯一的四个字母的单词。
io_latency_ms Number 花在等待I / O操作上的时间,以毫秒为单位。如果这个数字不是非常非常低,那么streamd服务器可能有严重的负载问题。
last_close Object 关于上次服务器关闭分类账的信息,包括达成共识所花费的时间以及参与的可信验证人数。
load Object (仅限管理员)有关服务器当前负载状态的详细信息
load.job_types Array (仅限管理员)有关服务器正在执行的不同类型作业的比率以及每个作业花费多少时间的信息。
load.threads Number (仅限管理员)服务器主作业池中的线程数。
load_factor_local Number (可能会被省略)当前乘以该交易成本的乘数,并基于该服务器的负载。
load_factor_net Number (可省略)网络其余部分使用的交易成本的当前乘数(根据其他服务器报告的负载值估算)。
load_factor_cluster Number (可能省略)基于此群集中服务器负载的交易成本的当前乘数。
peers Number streamd这个服务器当前连接了多少个其他服务器。
pubkey_node String 用于验证此服务器以进行对等通信的公钥。该密钥由服务器首次启动时自动生成。(如果删除,服务器可以创建一对新的密钥。)
pubkey_validator String (仅限管理员)此节点用于签署分类帐验证的公钥。
server_state String 指示服务器参与网络的程度的字符串。有关更多信息,请参阅可能的服务器状
state_accounting Object 各种服务器状态的地图,包含有关服务器每次花费的时间的信息。这可以用于跟踪服务器与网络连接的长期健康状况。
state_accounting.*.duration_us String 服务器在此状态下花费的微秒数。(每当服务器转换到另一个状态时都会更新。)
state_accounting.*.transitions Number 服务器转换到此状态的次数。
uptime Number 服务器运行的连续秒数。
validated_ledger Object (可以省略)关于最近一次完全验证的分类帐的信息。如果最近验证的分类账不可用,则回复省略此字段并包含closed_ledger。
validated_ledger.age Number 自分类帐关闭以来的时间,以秒为单位。
validated_ledger.base_fee_stm Number 基本费用,在STM。这可以用科学记数法表示,例如1e-050.00005。
validated_ledger.hash String 分类帐的唯一哈希,如十六进制
validated_ledger.reserve_base_stm Unsigned Integer 每个账户需要保留的最小STM金额(而不是下降)
validated_ledger.reserve_inc_stm Unsigned Integer 为账户在分类帐中拥有的每个对象添加的账户储备额的STM数量(非丢弃)
validated_ledger.seq Number - Ledger Index 最新验证分类账的分类账索引
validation_quorum Number 验证分类帐版本所需的可信验证的最小数目。有些情况可能会导致服务器需要更多验证。
 
注意:如果该closed_ledger字段存在并且seq值较小(少于8位),则表明streamd当前没有来自对等网络的验证分类帐的副本。这可能意味着您的服务器仍在同步。通常,根据连接速度和硬件规格,网络同步需要大约5分钟的时间。
可能的错误:
  • 任何通用错误类型。
THE NEXT CONNECTION

下一次连接,从这里开始。

加入 Stream 社区,一起探索价值互联。

联系我们