server_info

[ソース]

server_infoコマンドは、問い合わせ中のrippledサーバーについての各種情報を、人間が読めるフォーマットでサーバーに要求します。

要求フォーマット

要求フォーマットの例:

{
  "id": 1,
  "command": "server_info"
}
{
    "method": "server_info",
    "params": [
        {}
    ]
}
#Syntax: server_info
rippled server_info

試してみる

要求にパラメーターは何も含まれません。

応答フォーマット

処理が成功した応答の例:

{
  "id": 1,
  "status": "success",
  "type": "response",
  "result": {
    "info": {
      "build_version": "0.30.1-rc3",
      "complete_ledgers": "18611104-18614732",
      "hostid": "trace",
      "io_latency_ms": 1,
      "last_close": {
        "converge_time_s": 4.003,
        "proposers": 5
      },
      "load": {
        "job_types": [
          {
            "job_type": "untrustedProposal",
            "per_second": 2
          },
          {
            "in_progress": 1,
            "job_type": "clientCommand"
          },
          {
            "job_type": "transaction",
            "per_second": 4
          },
          {
            "job_type": "batch",
            "per_second": 3
          },
          {
            "job_type": "writeObjects",
            "per_second": 2
          },
          {
            "job_type": "trustedProposal",
            "per_second": 1
          },
          {
            "job_type": "peerCommand",
            "per_second": 108
          },
          {
            "job_type": "diskAccess",
            "per_second": 1
          },
          {
            "job_type": "processTransaction",
            "per_second": 4
          },
          {
            "job_type": "WriteNode",
            "per_second": 63
          }
        ],
        "threads": 6
      },
      "load_factor": 1000,
      "load_factor_net": 1000,
      "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": "166972201508",
          "transitions": 1853
        },
        "syncing": {
          "duration_us": "6249156726",
          "transitions": 1854
        },
        "tracking": {
          "duration_us": "13035222",
          "transitions": 1854
        }
      },
      "uptime": 173379,
      "validated_ledger": {
        "age": 3,
        "base_fee_xrp": 0.00001,
        "hash": "04F7CF4EACC57140C8088F6BFDC8A824BB3ED5717C3DAA6642101F9FB446226C",
        "reserve_base_xrp": 20,
        "reserve_inc_xrp": 5,
        "seq": 18614732
      },
      "validation_quorum": 4,
      "validator_list_expires" : "2017-Oct-12 16:06:36"
    }
  }
}
200 OK
{
   "result" : {
      "info" : {
         "build_version" : "0.33.0-hf1",
         "complete_ledgers" : "24900901-24900984,24901116-24901158",
         "hostid" : "trace",
         "io_latency_ms" : 1,
         "last_close" : {
            "converge_time_s" : 2.001,
            "proposers" : 5
         },
         "load" : {
            "job_types" : [
               {
                  "in_progress" : 1,
                  "job_type" : "clientCommand"
               },
               {
                  "job_type" : "transaction",
                  "per_second" : 6
               },
               {
                  "job_type" : "batch",
                  "per_second" : 6
               },
               {
                  "in_progress" : 1,
                  "job_type" : "advanceLedger"
               },
               {
                  "job_type" : "trustedValidation",
                  "per_second" : 1
               },
               {
                  "avg_time" : 77,
                  "job_type" : "writeObjects",
                  "over_target" : true,
                  "peak_time" : 2990,
                  "per_second" : 2
               },
               {
                  "job_type" : "trustedProposal",
                  "per_second" : 2
               },
               {
                  "job_type" : "peerCommand",
                  "per_second" : 205
               },
               {
                  "avg_time" : 771,
                  "job_type" : "diskAccess",
                  "over_target" : true,
                  "peak_time" : 1934
               },
               {
                  "job_type" : "processTransaction",
                  "per_second" : 6
               },
               {
                  "job_type" : "SyncReadNode",
                  "per_second" : 4
               },
               {
                  "job_type" : "WriteNode",
                  "per_second" : 235
               }
            ],
            "threads" : 6
         },
         "load_factor" : 4.765625,
         "load_factor_local" : 4.765625,
         "peers" : 10,
         "pubkey_node" : "n9McNsnzzXQPbg96PEUrrQ6z3wrvgtU4M7c97tncMpSoDzaQvPar",
         "pubkey_validator" : "n9KM73uq5BM3Fc6cxG3k5TruvbLc8Ffq17JZBmWC4uP4csL4rFST",
         "published_ledger" : 24901158,
         "server_state" : "proposing",
         "server_state_duration_us": 708078257,
         "state_accounting" : {
            "connected" : {
               "duration_us" : "854824665",
               "transitions" : 2
            },
            "disconnected" : {
               "duration_us" : "2183055",
               "transitions" : 1
            },
            "full" : {
               "duration_us" : "944104343",
               "transitions" : 2
            },
            "syncing" : {
               "duration_us" : "9233178",
               "transitions" : 1
            },
            "tracking" : {
               "duration_us" : "0",
               "transitions" : 2
            }
         },
         "uptime" : 1792,
         "validated_ledger" : {
            "age" : 1,
            "base_fee_xrp" : 1e-05,
            "hash" : "D2C122281EB72E64D19B9654A8D3D0FC4207373D3FE5D91AE516685A58874621",
            "reserve_base_xrp" : 20,
            "reserve_inc_xrp" : 5,
            "seq" : 24901185
         },
         "validation_quorum" : 4,
         "validator_list_expires" : "2017-Oct-12 16:06:36"
      },
      "status" : "success"
   }
}

応答は標準フォーマットに従い、結果が正常な場合infoオブジェクトが唯一のフィールドとして含まれます。

infoオブジェクトには、以下のフィールドがいくつか配置される場合があります。

Field 説明
amendment_blocked ブール値 (省略される場合があります)trueの場合、このサーバーはAmendment blockedの状態です。サーバーがAmendment blockedの状態でない場合、このフィールドは応答から省略されます。新規: rippled 0.80.0
build_version 文字列 実行中のrippledバージョンのバージョン番号。
closed_ledger オブジェクト (省略される場合があります)コンセンサスによってまだ検証されていない、最も最近更新を閉鎖したレジャーについての情報。最新の検証済みレジャーが使用可能な場合、このフィールドは応答で省略され、代わりにvalidated_ledgerが含まれます。メンバーフィールドはvalidated_ledgerフィールドと同じです。
complete_ledgers 文字列 ローカルrippledがデータベース内に有するレジャーのバージョンのシーケンス番号の範囲を示す表現。例えば、24900901-24900984,24901116-24901158のように、互いに素なシーケンスの場合があります。サーバーに完全なレジャーがない場合(例えば、ネットワークとの同期を始めたばかりの場合)、文字列emptyになります。
hostid 文字列 admin要求の場合、rippledインスタンスを実行するサーバーのホスト名が返されます。それ以外の要求の場合、一意の4文字の単語が返されます。
io_latency_ms 数値 I/O処理の待ち時間(ミリ秒単位)。この数値がそれほど低くない場合、rippledサーバーは深刻な負荷の問題を抱えている可能性があります。
last_close オブジェクト サーバーが最後にレジャーを閉鎖したときの情報。これには、コンセンサスの取得に要した時間や、参加した信頼できるバリデータ(検証者)の数が含まれます。
load オブジェクト (管理者のみ) サーバーの現在の負荷状態についての詳細な情報。
load.job_types 配列 (管理者のみ) サーバーが実行している各種ジョブのレートや、各ジョブにかかる時間についての情報。
load.threads 数値 (管理者のみ) サーバーの主要なジョブプール内のスレッドの数。
load_factor 数値 サーバーが現在施行中の、負荷スケーリングされたオープンレジャートランザクションコストを、基本トランザクションコストに適用される乗数として示したもの。例えば、負荷係数1000でリファレンストランザクションコストがXRP 10 dropである場合、負荷スケーリングされたトランザクションコストは10,000 drop(0.01 XRP)です。負荷係数は、個々のサーバーの負荷係数の最高値、クラスターの負荷係数、オープンレジャーコスト、ネットワーク全体の負荷係数によって決まります。更新: rippled 0.33.0
load_factor_local 数値 (省略される場合があります)このサーバーに対する負荷に基づく、トランザクションコストに適用される現在の乗数。
load_factor_net 数値 (省略される場合があります)ネットワークのその他の部分で使用されている、トランザクションコストに適用される現在の乗数(他のサーバーから報告された負荷値から推定します)。
load_factor_cluster 数値 (省略される場合があります)このクラスター内のサーバーに対する負荷に基づく、トランザクションコストに適用される現在の乗数。
load_factor_fee_escalation 数値 (省略される場合があります)オープンレジャーに入るために取引が支払う必要があるトランザクションコストに適用される現在の乗数。新規: rippled 0.32.0
load_factor_fee_queue 数値 (省略される場合があります)キューが一杯になっている場合に、キューに入るために取引が支払う必要があるトランザクションコストに適用される現在の乗数。新規: rippled 0.32.0
load_factor_server 数値 (省略される場合があります)サーバーが実施中の負荷係数。オープンレジャーコストは含まれません。新規: rippled 0.33.0
peers 数値 このサーバーが現在接続している、他のrippledサーバーの数。
pubkey_node 文字列 ピアツーピア通信の中でこのサーバーを検証するために使用する公開鍵。この_ノードのキーペア_は、サーバーを初めて起動すると自動的に生成されます。(削除された場合、サーバーは新たなキーペアを作成できます。)構成ファイルにて[node_seed]設定オプションを使用すると、永続値を設定できます。これはクラスター化に便利です。
pubkey_validator 文字列 (管理者のみ) このノードがレジャーの検証の署名に使用する公開鍵。この_検証キーペア_は、[validator_token]または[validation_seed]設定フィールドにて生成されます。
server_state 文字列 サーバーのネットワークへの参加の度合いを示す文字列。詳細は、考えられるサーバーの状態を参照してください。
server_state_duration_us 数値 サーバーが現在の状態になってから経過したマイクロ秒数。新規: rippled 1.2.0
state_accounting オブジェクト 各種サーバー状態のマップと、サーバーが各状態に費やした時間についての情報。これは、サーバーのネットワーク接続について長期的な健全性を追跡するのに便利です。新規: rippled 0.30.1
state_accounting.*.duration_us 文字列 サーバーがこの状態になってから費やしたマイクロ秒数。(サーバーが別の状態に移行するたびに更新されます。)新規: rippled 0.30.1
state_accounting.*.transitions 数値 サーバーがこの状態に移行した回数。新規: rippled 0.30.1
uptime 数値 サーバーが連続して稼働している秒数。新規: rippled 0.30.1
validated_ledger オブジェクト (省略される場合があります)完全に検証された最新のレジャーについての情報。最新の検証済みレジャーが使用できない場合、このフィールドは応答にて省略され、代わりにclosed_ledgerが含まれます。
validated_ledger.age 数値 レジャーの閉鎖以降の秒数。
validated_ledger.base_fee_xrp 数値 XRP単位の基本手数料。0.00005の場合は、1e-05などの科学的記数法で表すことができます。
validated_ledger.hash 文字列 16進数で表された、レジャーの一意のハッシュ
validated_ledger.reserve_base_xrp 符号なし整数 すべてのアカウントで準備金として保有しておく必要があるXRPの最少額(drop数ではありません)
validated_ledger.reserve_inc_xrp 符号なし整数 アカウントがレジャー内に保有するオブジェクトごとのアカウント準備金に追加するXRP額(drop数ではありません)
validated_ledger.seq 数値 - レジャーインデックス 最新の検証済みレジャーのレジャーインデックス
validation_quorum 数値 レジャーバージョンの検証に、最低限必要となる信頼できる検証の数。場合によっては、サーバーがさらに検証を要求する場合があります。
validator_list_expires 文字列 (管理者のみ) 現在のバリデータリストの有効期限が切れるタイミングを人間が読み取れる時間でを表示、または、サーバーが発行済みのバリデータリストをロードしていない場合は文字列unknown、サーバーが静的なバリデータリストを使用する場合は文字列neverのいずれかを表示します。新規: rippled 0.80.1

注記: closed_ledgerフィールドがあり、seqの値が小さい(8桁未満)場合、rippledには現在、ピアツーピアネットワークから取得した検証済みレジャーのコピーがないことを表しています。これは、サーバーが現在も同期中である可能性を示しています。接続速度とハードウェア仕様にもよりますが、通常はネットワークとの同期に約5分かかります。

考えられるエラー