server_info (rippled)

server_info 명령은 쿼리 중인 rippled 서버에 대한 다양한 정보를 사람이 읽을 수 있는 버전으로 서버에 요청합니다. 클리오 서버의 경우, 대신 server_info(클리오)를 참조하세요.

요청 형식

요청 형식의 예시입니다:

{
  "id": 1,
  "command": "server_info"
}

이 요청은 매개변수를 받지 않습니다.

응답 형식

성공적인 응답의 예입니다:

{
  "id": 1,
  "result": {
    "info": {
      "build_version": "1.9.4",
      "complete_ledgers": "32570-75801736",
      "hostid": "ARMY",
      "initial_sync_duration_us": "273518294",
      "io_latency_ms": 1,
      "jq_trans_overflow": "2282",
      "last_close": {
        "converge_time_s": 3.002,
        "proposers": 35
      },
      "load_factor": 1,
      "network_id": 0,
      "peer_disconnects": "3194",
      "peer_disconnects_resources": "3",
      "peers": 20,
      "pubkey_node": "n9KKBZvwPZ95rQi4BP3an1MRctTyavYkZiLpQwasmFYTE6RYdeX3",
      "server_state": "full",
      "server_state_duration_us": "69205850392",
      "state_accounting": {
        "connected": {
          "duration_us": "141058919",
          "transitions": "7"
        },
        "disconnected": {
          "duration_us": "514136273",
          "transitions": "3"
        },
        "full": {
          "duration_us": "4360230140761",
          "transitions": "32"
        },
        "syncing": {
          "duration_us": "50606510",
          "transitions": "30"
        },
        "tracking": {
          "duration_us": "40245486",
          "transitions": "34"
        }
      },
      "time": "2022-Nov-16 21:50:22.711679 UTC",
      "uptime": 4360976,
      "validated_ledger": {
        "age": 1,
        "base_fee_xrp": 0.00001,
        "hash": "3147A41F5F013209581FCDCBBB7A87A4F01EF6842963E13B2B14C8565E00A22B",
        "reserve_base_xrp": 10,
        "reserve_inc_xrp": 2,
        "seq": 75801736
      },
      "validation_quorum": 28
    }
  },
  "status": "success",
  "type": "response"
}

응답은 표준 형식을 따르며, 성공적인 결과에는 정보 객체가 유일한 필드로 포함됩니다.

정보 객체에는 다음 필드가 일부 배열되어 있을 수 있습니다:

Field

유형

설명

amendment_blocked

Boolean

build_version

문자열

실행 중인 rippled 서버의 버전 번호입니다.

closed_ledger

객체

(생략 가능) 합의에 의해 검증되지 않은 가장 최근에 폐쇄된 원장에 대한 정보입니다. 가장 최근에 유효성이 검증된 원장을 사용할 수 있는 경우, 응답은 이 필드를 생략하고 대신 validated_ledger를 포함합니다. 멤버 필드는 validated_ledger 필드와 동일합니다.

complete_ledgers

문자열

로컬 rippled가 데이터베이스에 가지고 있는 원장 버전의 시퀀스 번호를 나타내는 문자열 범위 표현식입니다. 24900901-24900984,24901116-24901158과 같이 분리되지 않은 시퀀스일 수 있습니다. 서버에 완전한 원장이 없는 경우(예: 최근에 네트워크와 동기화를 시작한 경우) 이 문자열은 비어 있습니다.

hostid

문자열

관리자 요청 시 rippled 인스턴스를 실행하는 서버의 호스트 이름을 반환하고, 그렇지 않으면 노드 공개키를 기반으로 한 단일 RFC-1751 단어를 반환합니다.

io_latency_ms

숫자

I/O 작업을 기다리는 데 소요된 시간(밀리초)입니다. 이 수치가 매우 낮지 않으면 rippled 서버에 심각한 부하 문제가 있을 가능성이 높습니다.

jq_trans_overflow

문자열 - 숫자

last_close

객체

합의에 도달하는 데 걸린 시간과 참여한 신뢰할 수 있는 검증자 수를 포함해 서버가 마지막으로 원장을 닫은 시간에 대한 정보입니다.

last_close.converge_time_s

숫자

가장 최근에 검증한 원장 버전에서 합의에 도달하는 데 걸린 시간(초)입니다.

last_close.proposers

숫자

가장 최근에 검증한 원장 버전에 대한 합의 프로세스에서 서버가 고려한 신뢰할 수 있는 검증자 수(검증자로 구성된 경우 자신 포함).

load

객체

(관리자만 해당) 서버의 현재 로드 상태에 대한 자세한 정보입니다.

load.job_types

배열

(관리자만 해당) 서버가 수행 중인 다양한 유형의 작업 비율과 각 작업에 소요되는 시간에 대한 정보입니다.

load.threads

숫자

(관리자만 해당) 서버의 기본 작업 풀에 있는 스레드 수입니다.

load_factor

숫자

load_factor_local

숫자

(생략 가능) 이 서버에 대한 로드를 기준으로 한 트랜잭션 비용에 대한 현재 승수입니다.

load_factor_net

숫자

(생략 가능) 나머지 네트워크에서 사용 중인 트랜잭션 비용에 대한 현재 승수 (다른 서버의 보고된 로드 값에서 추정).

load_factor_cluster

숫자

(생략 가능) 이 클러스터 내 서버에 대한 부하를 기준으로 한 트랜잭션 비용의 현재 승수입니다.

load_factor_fee_escalation

숫자

load_factor_fee_queue

숫자

load_factor_server

숫자

peers

숫자

(리포팅 모드 서버에서는 생략) 이 서버가 현재 연결된 다른 rippled 서버의 수입니다.

pubkey_node

문자열

P2P 통신을 위해 이 서버를 확인하는 데 사용되는 공개 키입니다. 이 노드 키 쌍은 서버를 처음 시작할 때 서버가 자동으로 생성합니다. (삭제하면 서버가 새 키 쌍을 생성할 수 있습니다.) 클러스터링에 유용한 [node_seed] 구성 옵션을 사용하여 구성 파일에서 영구값을 설정할 수 있습니다.

pubkey_validator

문자열

(관리자 전용) 이 노드가 원장 유효성 검사에 서명하는 데 사용하는 공개 키입니다. 이 유효성 검사 키 쌍은 [validator_token] 또는 [validation_seed] 구성 필드에서 파생됩니다.

reporting

객체

(리포팅 모드 서버만 해당) 이 서버의 보고 모드별 구성에 대한 정보입니다.

reporting.etl_sources

배열

(리포팅 모드 서버만 해당) 이 리포팅 모드에서 데이터를 검색하는 P2P 모드 서버의 목록입니다. 이 배열의 각 항목은 ETL 소스 객체입니다.

reporting.is_writer

Boolean

(리포팅 모드 서버만 해당) 참이면 이 서버가 외부 데이터베이스에 원장 데이터를 쓰고 있습니다. 거짓이면 다른 보고 모드 서버가 현재 공유 데이터베이스를 채우고 있거나 읽기 전용으로 구성되어 있기 때문에 현재 쓰고 있지 않습니다.

reporting.last_publish_time

문자열

(리포팅 모드 서버만 해당) 이 서버가 마지막으로 구독 스트림에 유효성이 검사된 원장을 게시한 시점을 나타내는 ISO 8601 타임스탬프입니다.

server_state

문자열

서버가 네트워크에 어느 정도 참여하고 있는지를 나타내는 문자열입니다. 자세한 내용은 가능한 서버 상태를 참조하세요.

server_state_duration_us

숫자

state_accounting

객체

state_accounting.*.duration_us

문자열

state_accounting.*.transitions

문자열

time

문자열

uptime

숫자

validated_ledger

객체

(생략 가능) 가장 최근에 완전히 검증된 원장에 대한 정보입니다. 가장 최근에 유효성이 검증된 원장을 사용할 수 없는 경우, 응답은 이 필드를 생략하고 대신 closed_ledger를 포함합니다.

validated_ledger.age

숫자

원장이 폐쇄된 이후 시간(초)입니다.

validated_ledger.base_fee_xrp

숫자

기본 수수료(XRP). 0.00001의 경우 1e-05와 같은 과학적 표기법으로 표시할 수 있습니다.

validated_ledger.hash

문자열

원장의 고유 해시(16진수)입니다.

validated_ledger.reserve_base_xrp

숫자

모든 계정이 준비금으로 보유하는 데 필요한 최소 XRP(드롭이 아님) 수량입니다.

validated_ledger.reserve_inc_xrp

숫자

원장에서 소유하고 있는 각 객체에 대해 계정 준비금에 추가되는 XRP(드롭이 아님) 수량입니다.

validated_ledger.seq

숫자

가장 최근에 유효성이 검증된 원장의 원장 인덱스입니다.

validation_quorum

숫자

원장 버전을 검증하는 데 필요한 신뢰할 수 있는 검증의 최소 횟수입니다. 상황에 따라 서버가 더 많은 유효성 검사를 요구할 수 있습니다.

validator_list_expires

문자열

Note:

closed_ledger 필드가 존재하고 seq 값이 작은 경우(8자리 미만), 이는 rippled가 현재 P2P 네트워크에서 유효성이 검증된 ledger의 사본을 가지고 있지 않음을 나타냅니다. 이는 서버가 아직 동기화 중이라는 의미일 수 있습니다. 일반적으로 네트워크와 동기화하는 데는 연결 속도와 하드웨어 사양에 따라 약 5분 정도 소요됩니다.

ETL 소스 객체

보고 모드 서버에서 etl_sources 필드의 각 멤버는 다음 필드를 가진 객체입니다:

필드

유형

설명

connected

Boolean

true이면 리포팅 모드 서버가 이 P2P 모드 서버에 연결됩니다. false이면 서버가 연결되지 않은 것입니다. 이는 구성이 잘못되었거나 네트워크가 중단되었거나 P2P 모드 서버가 다운되었기 때문일 수 있습니다.

grpc_port

문자열

이 리포팅 모드 서버가 gRPC를 통해 연결하고 원장 데이터를 검색하도록 구성된 P2P 모드 서버의 포트 번호입니다.

ip

문자열

P2P 모드 서버의 IP 주소(IPv4 또는 IPv6)입니다.

last_message_arrival_time

문자열

리포팅 모드 서버가 이 P2P 서버로부터 메시지를 수신한 가장 최근 시간을 나타내는 ISO 8601 타임스탬프입니다.

validated_ledgers_range

문자열

이 P2P 모드 서버가 사용 가능하다고 보고하는 유효성 검사된 원장 버전의 범위로, complete_ledgers와 동일한 형식입니다.

websocket_port

문자열

리포팅 모드에서 직접 제공할 수 없는 웹소켓 요청을 전달하도록 이 보고 모드 서버가 구성되어 있는 P2P 서버의 포트 번호입니다.

발생 가능한 오류

  • 일반적인 오류 유형입니다.

PreviousmanifestNextserver_state

Last updated