xrpl::NetworkOPsImp::StateAccounting Class Reference

State accounting records two attributes for each possible server state: 1) Amount of time spent in each state (in microseconds). More...

Collaboration diagram for xrpl::NetworkOPsImp::StateAccounting:

Classes
struct	Counters
struct	CounterData

Public Member Functions
	StateAccounting ()
void	mode (OperatingMode om)
	Record state transition.
void	json (json::Value &obj) const
	Output state counters in JSON format.
CounterData	getCounterData () const

Private Attributes
OperatingMode	mode_ = OperatingMode::DISCONNECTED
std::array< Counters, 5 >	counters_
std::mutex	mutex_
std::chrono::steady_clock::time_point	start_ = std::chrono::steady_clock::now()
std::chrono::steady_clock::time_point const	processStart_ = start_
std::uint64_t	initialSyncUs_ {0}

Static Private Attributes
static std::array< json::StaticString const, 5 > const	kStates

Detailed Description

State accounting records two attributes for each possible server state: 1) Amount of time spent in each state (in microseconds).

This value is updated upon each state transition. 2) Number of transitions to each state.

This data can be polled through server_info and represented by monitoring systems similarly to how bandwidth, CPU, and other counter-based metrics are managed.

State accounting is more accurate than periodic sampling of server state. With periodic sampling, it is very likely that state transitions are missed, and accuracy of time spent in each state is very rough.

Definition at line 208 of file NetworkOPs.cpp.

Constructor & Destructor Documentation

StateAccounting()

xrpl::NetworkOPsImp::StateAccounting::StateAccounting ( )

explicit

Definition at line 227 of file NetworkOPs.cpp.

Member Function Documentation

mode()

void xrpl::NetworkOPsImp::StateAccounting::mode

(

OperatingMode

om

)

Record state transition.

Update duration spent in previous state.

Parameters

om	New state.

Definition at line 4802 of file NetworkOPs.cpp.

json()

void xrpl::NetworkOPsImp::StateAccounting::json

(

json::Value &

obj

)

const

Output state counters in JSON format.

@obj Json object to which to add state accounting data.

Definition at line 4821 of file NetworkOPs.cpp.

getCounterData()

CounterData xrpl::NetworkOPsImp::StateAccounting::getCounterData

(

)

const

Definition at line 258 of file NetworkOPs.cpp.

Member Data Documentation

mode_

OperatingMode xrpl::NetworkOPsImp::StateAccounting::mode_ = OperatingMode::DISCONNECTED

private

Definition at line 218 of file NetworkOPs.cpp.

counters_

std::array<Counters, 5> xrpl::NetworkOPsImp::StateAccounting::counters_

private

Definition at line 219 of file NetworkOPs.cpp.

mutex_

std::mutex xrpl::NetworkOPsImp::StateAccounting::mutex_

mutableprivate

Definition at line 220 of file NetworkOPs.cpp.

start_

std::chrono::steady_clock::time_point xrpl::NetworkOPsImp::StateAccounting::start_ = std::chrono::steady_clock::now()

private

Definition at line 221 of file NetworkOPs.cpp.

processStart_

std::chrono::steady_clock::time_point const xrpl::NetworkOPsImp::StateAccounting::processStart_ = start_

private

Definition at line 222 of file NetworkOPs.cpp.

initialSyncUs_

std::uint64_t xrpl::NetworkOPsImp::StateAccounting::initialSyncUs_ {0}

private

Definition at line 223 of file NetworkOPs.cpp.

kStates

std::array< json::StaticString const, 5 > const xrpl::NetworkOPsImp::StateAccounting::kStates

staticprivate

Initial value:

                                                     = {
{json::StaticString(kStateNames[0]),
 json::StaticString(kStateNames[1]),
 json::StaticString(kStateNames[2]),
 json::StaticString(kStateNames[3]),
 json::StaticString(kStateNames[4])}}

Definition at line 224 of file NetworkOPs.cpp.