此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
该
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分钟的时间。
- 任何通用错误类型。
