server_state
server_stateコマンドは、サーバーに対しrippledサーバーの現在の状態に関するさまざまな機械可読の情報を問い合わせます。応答はserver_infoメソッドの場合とほぼ同じですが、読み取りやすい単位ではなく処理しやすい単位を使用します。（たとえば、XRP値は科学的記数法や10進数値の代わりに整数のdrop数で示され、時刻は秒単位ではなくミリ秒単位で示されます。）
要求フォーマット
要求フォーマットの例:
{
"id": 2,
"command": "server_state"
}
{
"method": "server_state",
"params": [
{}
]
}
#Syntax: server_state
rippled server_state
要求はパラメーターをとりません。
応答フォーマット
処理が成功した応答の例:
{
"id": 2,
"status": "success",
"type": "response",
"result": {
"state": {
"build_version": "0.30.1-rc3",
"complete_ledgers": "18611104-18615049",
"io_latency_ms": 1,
"last_close": {
"converge_time": 3003,
"proposers": 5
},
"load": {
"job_types": [
{
"job_type": "untrustedProposal",
"peak_time": 1,
"per_second": 3
},
{
"in_progress": 1,
"job_type": "clientCommand"
},
{
"avg_time": 12,
"job_type": "writeObjects",
"peak_time": 345,
"per_second": 2
},
{
"job_type": "trustedProposal",
"per_second": 1
},
{
"job_type": "peerCommand",
"per_second": 64
},
{
"avg_time": 33,
"job_type": "diskAccess",
"peak_time": 526
},
{
"job_type": "WriteNode",
"per_second": 55
}
],
"threads": 6
},
"load_base": 256,
"load_factor": 256000,
"peers": 10,
"pubkey_node": "n94UE1ukbq6pfZY9j54sv2A1UrEeHZXLbns3xK5CzU9NbNREytaa",
"pubkey_validator": "n9KM73uq5BM3Fc6cxG3k5TruvbLc8Ffq17JZBmWC4uP4csL4rFST",
"server_state": "proposing",
"server_state_duration_us": 92762334,
"state_accounting": {
"connected": {
"duration_us": "150510079",
"transitions": 1
},
"disconnected": {
"duration_us": "1827731",
"transitions": 1
},
"full": {
"duration_us": "168295542987",
"transitions": 1865
},
"syncing": {
"duration_us": "6294237352",
"transitions": 1866
},
"tracking": {
"duration_us": "13035524",
"transitions": 1866
}
},
"uptime": 174748,
"validated_ledger": {
"base_fee": 10,
"close_time": 507693650,
"hash": "FEB17B15FB64E3AF8D371E6AAFCFD8B92775BB80AB953803BD73EA8EC75ECA34",
"reserve_base": 20000000,
"reserve_inc": 5000000,
"seq": 18615049
},
"validation_quorum": 4,
"validator_list_expires": 561139596
}
}
}
200 OK
{
"result" : {
"state" : {
"build_version" : "0.30.1-rc3",
"complete_ledgers" : "18611104-18615037",
"io_latency_ms" : 1,
"last_close" : {
"converge_time" : 2001,
"proposers" : 5
},
"load" : {
"job_types" : [
{
"job_type" : "untrustedProposal",
"per_second" : 2
},
{
"in_progress" : 1,
"job_type" : "clientCommand"
},
{
"job_type" : "writeObjects",
"per_second" : 2
},
{
"avg_time" : 2,
"job_type" : "acceptLedger",
"peak_time" : 6
},
{
"job_type" : "trustedProposal",
"per_second" : 1
},
{
"job_type" : "peerCommand",
"per_second" : 80
},
{
"job_type" : "diskAccess",
"per_second" : 1
},
{
"job_type" : "WriteNode",
"per_second" : 91
}
],
"threads" : 6
},
"load_base" : 256,
"load_factor" : 256000,
"peers" : 10,
"pubkey_node" : "n94UE1ukbq6pfZY9j54sv2A1UrEeHZXLbns3xK5CzU9NbNREytaa",
"pubkey_validator" : "n9KM73uq5BM3Fc6cxG3k5TruvbLc8Ffq17JZBmWC4uP4csL4rFST",
"server_state" : "proposing",
"server_state_duration_us": 708078257,
"state_accounting" : {
"connected" : {
"duration_us" : "150510079",
"transitions" : 1
},
"disconnected" : {
"duration_us" : "1827731",
"transitions" : 1
},
"full" : {
"duration_us" : "168241260112",
"transitions" : 1865
},
"syncing" : {
"duration_us" : "6294237352",
"transitions" : 1866
},
"tracking" : {
"duration_us" : "13035524",
"transitions" : 1866
}
},
"uptime" : 174693,
"validated_ledger" : {
"base_fee" : 10,
"close_time" : 507693592,
"hash" : "1C26209AE593C7EB5123363B3152D86514845FBD42CC6B05111D57F62D02B113",
"reserve_base" : 20000000,
"reserve_inc" : 5000000,
"seq" : 18615037
},
"validation_quorum" : 4,
"validator_list_expires" : 561139596
},
"status" : "success"
}
}
応答は標準フォーマットに従っており、正常に完了した場合は、結果に唯一のフィールドとしてstateオブジェクトが含まれています。
stateオブジェクトには、以下のフィールドが含まれています。
Field |
型 | 説明 |
|---|---|---|
amendment_blocked |
ブール値 | （省略される場合があります）trueの場合、このサーバーはAmendment blockedの状態です。サーバーがAmendment blockedではない場合、応答ではこのフィールドが省略されます。 |
build_version |
文字列 | 実行中のrippledバージョンのバージョン番号。 |
complete_ledgers |
文字列 | ローカルのrippledがデータベース内に有するレジャーバージョンのシーケンス番号の範囲を示す表現。例えば、「2500-5000,32570-7695432」のように互いに素なシーケンスの場合があります。サーバーに完全なレジャーがない場合（例えば、ネットワークとの同期を始めたばかりの場合）、文字列emptyになります。 |
closed_ledger |
オブジェクト | （省略される場合があります）コンセンサスによって検証されていない、最新の閉鎖済みレジャーに関する情報。最新の検証済みレジャーが使用可能な場合、応答ではこのフィールドは省略され、代わりにvalidated_ledgerが含まれます。メンバーフィールドはvalidated_ledgerフィールドと同じです。 |
io_latency_ms |
数値 | I/O処理の待機に費やされた時間数（ミリ秒単位）。この数値が極端に低くない場合、rippledサーバーでは深刻な負荷の問題が発生している可能性があります。 |
load |
オブジェクト | （管理者専用） サーバーの現在の負荷状態についての詳細な情報。 |
load.job_types |
配列 | （管理者専用） サーバーが実行している各種ジョブのレートや、各ジョブに要する時間についての情報。 |
load.threads |
数値 | （管理者専用） サーバーの主要なジョブプール内のスレッド数。 |
load_base |
整数 | トランザクションコストの計算で使用されるサーバー負荷のベースライン量です。load_factorがload_baseと同等の場合、基本トランザクションコストのみが適用されます。load_factorがload_baseよりも大きい場合、トランザクションコストにそれらの値の比率が乗算されます。たとえばload_factorがload_baseの2倍である場合、トランザクションコストは2倍になります。 |
load_factor |
数値 | サーバーが現在適用している負荷係数。トランザクションコストの乗数は、この値とload_baseの比率によって決まります。負荷係数は、個別サーバーの最も高い負荷係数、クラスターの負荷係数、オープンレジャーコスト、およびネットワーク全体の負荷係数によって決定します。 |
load_factor_fee_escalation |
整数 | （省略される場合があります）オープンレジャーに入るときにトランザクションコストに適用される現在の乗数（手数料レベル）。 |
load_factor_fee_queue |
整数 | （省略される場合があります）キューが一杯になっている場合に、キューへ入るときにトランザクションコストに適用される現在の乗数（手数料レベル）。 |
load_factor_fee_reference |
整数 | （省略される場合があります）負荷スケーリングのないトランザクションコスト（手数料レベル）。 |
load_factor_server |
数値 | （省略される場合があります）サーバーが適用している負荷係数。オープンレジャーコストは含まれません。 |
peers |
数値 | このサーバーが現在接続している他のrippledサーバーの数。 |
pubkey_node |
文字列 | ピアツーピア通信のためにこのサーバーを検証する際に使用される公開鍵。サーバーを初めて起動すると、サーバーにより ノードキーペア が自動的に生成されます。（キーペアが削除されている場合、サーバーは新しいキーペアを作成できます。）[node_seed]構成オプションを使用して構成ファイルの永続値を設定できます。これはクラスター化で便利です。 |
pubkey_validator |
文字列 | （管理者専用） このノードがレジャー検証の署名に使用する公開鍵。検証キーペア は、[validator_token]構成フィールドまたは[validation_seed]構成フィールドから生成されます。 |
server_state |
文字列 | サーバーのネットワークへの参加度を示す文字列。詳細は、考えられるサーバーの状態を参照してください。 |
server_state_duration_us |
数値 | サーバーが現在の状態になってから経過した連続マイクロ秒数。 |
state_accounting |
オブジェクト | 各種サーバー状態のマップと、サーバーが各状態に費やした時間についての情報。これは、サーバーのネットワーク接続性の健全性を長期的に追跡するのに便利です。 |
state_accounting.*.duration_us |
文字列 | サーバーがこの状態になってから経過したマイクロ秒数。（サーバーが別の状態に移行するたびに更新されます。） |
state_accounting.*.transitions |
数値 | サーバーがこの状態に移行した回数。 |
uptime |
数値 | サーバーが連続稼働している秒数。 |
validated_ledger |
オブジェクト | （省略される場合があります）完全に検証された最新のレジャーについての情報。最新の検証済みレジャーが使用できない場合、このフィールドは応答で省略され、代わりにclosed_ledgerが含まれます。 |
validated_ledger.base_fee |
符号なし整数 | ネットワークへのトランザクション伝達にかかる基本手数料（XRPのdrop数）。 |
validated_ledger.close_time |
数値 | レジャーが閉鎖された時刻（Rippleエポック以降の経過秒数） |
validated_ledger.hash |
文字列 | 当該レジャーバージョンの一意のハッシュ（16進数） |
validated_ledger.reserve_base |
符号なし整数 | すべてのアカウントで準備金として保有する必要がある最小額（XRPのdrop数） |
validated_ledger.reserve_inc |
符号なし整数 | アカウントがレジャー内に保有する各アイテムのアカウント準備金に追加する額（XRPのdrop数）。 |
validated_ledger.seq |
符号なし整数 | このレジャーの一意のシーケンス番号 |
validation_quorum |
数値 | 1つのレジャーバージョンの検証に最低限必要となる信頼できる検証の数。状況によっては、サーバーがさらに検証を要求する場合があります。 |
validator_list_expires |
数値 | （管理者専用） 現在のバリデータリストが期限切れになる時点（Rippleエポック以降の経過秒数）。サーバーが発行済みのバリデータリストをロードしていない場合は0。 |
考えられるエラー
- 汎用エラータイプのすべて。