server_state
server_state 명령은 rippled 서버의 현재 상태에 대해 기계가 읽을 수 있는 다양한 정보를 서버에 요청합니다. 응답은 server_info 메소드와 거의 동일하지만 읽기 쉬운 단위 대신 처리하기 쉬운 단위를 사용합니다. (예를 들어, XRP 값은 과학적 표기법이나 십진수 값 대신 정수 방울로 제공되며, 시간은 초 대신 밀리초로 제공됩니다.)
요청 형식
요청 형식의 예시입니다:
{
"id": 2,
"command": "server_state"
}요청은 매개변수를 받지 않습니다.
응답 형식
성공적인 응답의 예입니다:
{
"id": 1,
"result": {
"state": {
"build_version": "1.7.2",
"complete_ledgers": "64572720-65887201",
"io_latency_ms": 1,
"jq_trans_overflow": "0",
"last_close": {
"converge_time": 3005,
"proposers": 41
},
"load_base": 256,
"load_factor": 256,
"load_factor_fee_escalation": 256,
"load_factor_fee_queue": 256,
"load_factor_fee_reference": 256,
"load_factor_server": 256,
"peer_disconnects": "365006",
"peer_disconnects_resources": "336",
"peers": 216,
"pubkey_node": "n9MozjnGB3tpULewtTsVtuudg5JqYFyV3QFdAtVLzJaxHcBaxuXD",
"server_state": "full",
"server_state_duration_us": "3588969453592",
"state_accounting": {
"connected": {
"duration_us": "301410595",
"transitions": "2"
},
"disconnected": {
"duration_us": "1207534",
"transitions": "2"
},
"full": {
"duration_us": "3589171798767",
"transitions": "2"
},
"syncing": {
"duration_us": "6182323",
"transitions": "2"
},
"tracking": {
"duration_us": "43",
"transitions": "2"
}
},
"time": "2021-Aug-24 20:44:43.466048 UTC",
"uptime": 3589480,
"validated_ledger": {
"base_fee": 10,
"close_time": 683153081,
"hash": "B52AC3876412A152FE9C0442801E685D148D05448D0238587DBA256330A98FD3",
"reserve_base": 20000000,
"reserve_inc": 5000000,
"seq": 65887201
},
"validation_quorum": 33
}
},
"status": "success",
"type": "response"
}응답은 표준 형식을 따르며, 상태 객체가 유일한 필드로 포함된 성공적인 결과입니다.
상태 객체에는 다음과 같은 필드가 배열되어 있을 수 있습니다:
Field
유형
설명
amendment_blocked
Boolean
(생략 가능) 참이면 이 서버는 수정이 차단된 서버입니다. 서버가 수정이 차단되지 않은 경우 응답은 이 필드를 생략합니다.
build_version
문자열
실행 중인 rippled 버전의 버전 번호입니다.
complete_ledgers
문자열
로컬 리ripple가 데이터베이스에 가지고 있는 원장 버전의 시퀀스 번호를 나타내는 범위 표현식입니다. "2500-5000,32570-7695432"와 같이 분리되지 않은 시퀀스일 수 있습니다. 서버에 완전한 원장이 없는 경우(예: 최근에 네트워크와 동기화를 시작한 경우) 이 문자열은 비어 있습니다.
closed_ledger
객체
(생략 가능) 합의에 의해 검증되지 않은 가장 최근에 닫힌 원장에 대한 정보입니다. 가장 최근에 유효성이 검증된 원장을 사용할 수 있는 경우, 응답은 이 필드를 생략하고 대신 validated_ledger를 포함합니다. 멤버 필드는 validated_ledger 필드와 동일합니다.
io_latency_ms
숫자
I/O 작업을 기다리는 데 소요된 시간(밀리초)입니다. 이 수치가 매우 낮지 않으면 rippled 서버에 심각한 부하 문제가 있을 수 있습니다.
jq_trans_overflow
문자열 - 숫자
이 서버가 한 번에 250개 이상의 트랜잭션을 처리하기 위해 대기 중인 횟수입니다. 숫자가 크면 서버가 XRP 레저 네트워크의 트랜잭션 부하를 처리할 수 없다는 의미일 수 있습니다. 미래 대비 서버 사양에 대한 자세한 권장 사항은 용량 계획을 참조하세요.
last_close
객체
합의에 도달하는 데 걸린 시간, 참여한 신뢰할 수 있는 검증자 수 등 서버가 마지막으로 원장을 닫은 시간에 대한 정보입니다.
last_close.converge_time
숫자
가장 최근에 검증한 원장 버전에서 합의에 도달하는 데 걸린 시간(밀리초)입니다.
last_close.proposers
숫자
가장 최근에 검증한 원장 버전에 대한 합의 프로세스에서 서버가 고려한 신뢰할 수 있는 검증자(검증자로 구성된 경우 자신 포함) 수입니다.
load
객체
(관리자 전용) 서버의 현재 로드 상태에 대한 자세한 정보입니다.
load.job_types
배열
(관리자 전용) 서버가 수행 중인 다양한 유형의 작업 비율과 각 작업에 소요되는 시간에 대한 정보입니다.
load.threads
숫자
(관리자 전용) 서버의 기본 작업 풀에 있는 스레드 수입니다.
load_base
정수
트랜잭션 비용 계산에 사용되는 기준 서버 부하량입니다. load_factor가 load_base와 같으면 기본 트랜잭션 비용만 적용됩니다. load_factor가 load_base보다 크면 트랜잭션 비용에 두 값의 비율을 곱합니다. 예를 들어 load_factor가 load_base의 두 배이면 트랜잭션 비용이 두 배가 됩니다.
load_factor
숫자
서버가 현재 적용 중인 로드 팩터입니다. 이 값과 load_base 사이의 비율에 따라 트랜잭션 비용의 배수가 결정됩니다. 로드 팩터는 개별 서버의 로드 팩터, 클러스터의 로드 팩터, 공개 원장 비용, 전체 네트워크의 로드 팩터 중 가장 높은 값에 의해 결정됩니다.
load_factor_fee_escalation
숫자
수수료 수준에서 오픈 원장에 진입하기 위한 트랜잭션 비용에 대한 현재 승수입니다. 
load_factor_fee_queue
숫자
(생략될 수 있음) 대기열이 꽉 찼을 때 대기열에 들어가기 위한 트랜잭션 비용의 현재 승수(수수료 수준)입니다.
load_factor_fee_reference
숫자
로드 스케일링이 없는 트랜잭션 비용(수수료 수준).
load_factor_server
숫자
(생략 가능) 서버가 적용하는 부하율로, 공개 원장 비용은 포함하지 않습니다.
peers
숫자
(리포팅 모드 서버에서는 생략) 이 서버가 현재 연결되어 있는 다른 리플 서버의 수입니다.
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
문자열
(리포팅 모드 서버만 해당) 이 서버가 P2P 모드 소스에서 새 유효성 검사된 원장을 마지막으로 본 시간을 나타내는 ISO 8601 타임스탬프입니다.
server_state
문자열
서버가 네트워크에 어느 정도 참여하고 있는지를 나타내는 문자열입니다. 자세한 내용은 가능한 서버 상태를 참조하세요.
server_state_duration_us
숫자
서버가 현재 상태에 있었던 연속 마이크로초 수입니다.
state_accounting
객체
서버가 각 상태에서 보낸 시간에 대한 정보가 포함된 다양한 서버 상태의 맵입니다. 서버의 네트워크 연결 상태를 장기적으로 추적하는 데 유용할 수 있습니다.
state_accounting.*.duration_us
문자열
서버가 이 상태에서 보낸 시간(마이크로초)입니다. (서버가 다른 상태로 전환될 때마다 업데이트됩니다.)
state_accounting.*.transitions
문자열
서버가 이 상태로 변경된 횟수입니다.
time
문자열
서버의 시계에 따른 UTC 기준 현재 시간입니다.
uptime
숫자
서버가 작동한 연속 시간(초) 수입니다.
validated_ledger
객체
(생략 가능) 가장 최근에 완전히 검증된 원장에 대한 정보입니다. 가장 최근에 유효성이 검증된 원장을 사용할 수 없는 경우, 응답은 이 필드를 생략하고 대신 closed_ledger를 포함합니다.
validated_ledger.base_fee
숫자
트랜잭션을 네트워크에 전파하는 데 드는 기본 수수료(XRP 단위)입니다.
validated_ledger.hash
문자열
이 원장 버전의 고유 해시(16진수)입니다.
validated_ledger.reserve_inc
숫자
가장 최근에 유효성이 검사된 원장 버전을 기준으로 계정이 소유한 각 항목에 대한 소유자 예치금입니다.
validated_ledger.seq
숫자
가장 최근에 유효성을 검사한 원장 버전의 원장 인덱스입니다.
validation_quorum
숫자
원장 버전을 검증하는 데 필요한 신뢰할 수 있는 최소 검증 횟수입니다. 상황에 따라 서버에서 더 많은 유효성 검사를 요구할 수 있습니다.
validator_list_expires
숫자
(관리자 전용) 현재 검증자 목록이 만료될 때, Ripple 에포크 이후 초 단위로, 서버가 아직 게시된 검증자 목록을 로드하지 않은 경우 0입니다.
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
문자열
리포팅 모드에서 직접 제공할 수 없는 WebSocket 요청을 전달하도록 이 보고 모드 서버가 구성되어 있는 P2P 서버의 포트 번호입니다.
발생 가능한 오류
일반적인 오류 유형입니다.
Last updated