Tracks load and resource consumption. More...

#include <ResourceManager.h>

Inheritance diagram for xrpl::resource::Manager:

[legend]

Collaboration diagram for xrpl::resource::Manager:

[legend]

Public Member Functions
	~Manager () override=0
virtual Consumer	newInboundEndpoint (beast::ip::Endpoint const &address)=0
	Create a new endpoint keyed by inbound IP address or the forwarded IP if proxied.
virtual Consumer	newInboundEndpoint (beast::ip::Endpoint const &address, bool const proxy, std::string_view forwardedFor)=0
virtual Consumer	newOutboundEndpoint (beast::ip::Endpoint const &address)=0
	Create a new endpoint keyed by outbound IP address and port.
virtual Consumer	newUnlimitedEndpoint (beast::ip::Endpoint const &address)=0
	Create a new unlimited endpoint keyed by forwarded IP.
virtual Gossip	exportConsumers ()=0
	Extract packaged consumer information for export.
virtual json::Value	getJson ()=0
	Extract consumer information for reporting.
virtual json::Value	getJson (int threshold)=0
virtual void	importConsumers (std::string const &origin, Gossip const &gossip)=0
	Import packaged consumer information.
std::string const &	name () const
	Returns the name of this source.
void	add (Source &source)
	Add a child source.
template<class Derived>
Derived *	add (Derived *child)
	Add a child source by pointer.
void	remove (Source &child)
	Remove a child source from this Source.
void	removeAll ()
	Remove all child sources from this Source.
void	writeOne (PropertyStream &stream)
	Write only this Source to the stream.
void	write (PropertyStream &stream)
	write this source and all its children recursively to the stream.
void	write (PropertyStream &stream, std::string const &path)
	Parse the path and write the corresponding Source and optional children.
std::pair< Source *, bool >	find (std::string path)
	Parse the dot-delimited Source path and return the result.
Source *	findOneDeep (std::string const &name)
PropertyStream::Source *	findPath (std::string path)
PropertyStream::Source *	findOne (std::string const &name)
virtual void	onWrite (Map &)
	Subclass override.

Static Public Member Functions
static bool	peelLeadingSlash (std::string *path)
static bool	peelTrailingSlashstar (std::string *path)
static std::string	peelName (std::string *path)

Protected Member Functions
	Manager ()

Private Attributes
std::string const	name_
std::recursive_mutex	lock_
Item	item_
Source *	parent_ {nullptr}
List< Item >	children_

Detailed Description

Tracks load and resource consumption.

Definition at line 22 of file ResourceManager.h.

Constructor & Destructor Documentation

◆ Manager()

xrpl::resource::Manager::Manager ( )

protected

Definition at line 153 of file ResourceManager.cpp.

◆ ~Manager()

xrpl::resource::Manager::~Manager ( )

overridepure virtualdefault

Member Function Documentation

◆ newInboundEndpoint() [1/2]

virtual Consumer xrpl::resource::Manager::newInboundEndpoint ( beast::ip::Endpoint const & address )

pure virtual

Create a new endpoint keyed by inbound IP address or the forwarded IP if proxied.

Implemented in xrpl::resource::ManagerImp.

◆ newInboundEndpoint() [2/2]

virtual Consumer xrpl::resource::Manager::newInboundEndpoint	(	beast::ip::Endpoint const &	address,
		bool const	proxy,
		std::string_view	forwardedFor )

pure virtual

Implemented in xrpl::resource::ManagerImp.

◆ newOutboundEndpoint()

virtual Consumer xrpl::resource::Manager::newOutboundEndpoint ( beast::ip::Endpoint const & address )

pure virtual

Create a new endpoint keyed by outbound IP address and port.

Implemented in xrpl::resource::ManagerImp.

◆ newUnlimitedEndpoint()

virtual Consumer xrpl::resource::Manager::newUnlimitedEndpoint ( beast::ip::Endpoint const & address )

pure virtual

Create a new unlimited endpoint keyed by forwarded IP.

Implemented in xrpl::resource::ManagerImp.

◆ exportConsumers()

virtual Gossip xrpl::resource::Manager::exportConsumers ( )

pure virtual

Extract packaged consumer information for export.

Implemented in xrpl::resource::ManagerImp.

◆ getJson() [1/2]

virtual json::Value xrpl::resource::Manager::getJson ( )

pure virtual

Extract consumer information for reporting.

Implemented in xrpl::resource::ManagerImp.

◆ getJson() [2/2]

virtual json::Value xrpl::resource::Manager::getJson ( int threshold )

pure virtual

Implemented in xrpl::resource::ManagerImp.

◆ importConsumers()

virtual void xrpl::resource::Manager::importConsumers	(	std::string const &	origin,
		Gossip const &	gossip )

pure virtual

Import packaged consumer information.

Parameters

origin An identifier that unique labels the origin.

Implemented in xrpl::resource::ManagerImp.

◆ name()

std::string const & beast::PropertyStream::Source::name ( ) const

nodiscardinherited

Returns the name of this source.

Definition at line 168 of file beast_PropertyStream.cpp.

◆ add() [1/2]

void beast::PropertyStream::Source::add ( Source & source )

inherited

Add a child source.

Definition at line 174 of file beast_PropertyStream.cpp.

◆ add() [2/2]

template<class Derived>

Derived * beast::PropertyStream::Source::add ( Derived * child )

inherited

Add a child source by pointer.

The source pointer is returned so it can be used in ctor-initializers.

Definition at line 349 of file PropertyStream.h.

◆ remove()

void beast::PropertyStream::Source::remove ( Source & child )

inherited

Remove a child source from this Source.

Definition at line 185 of file beast_PropertyStream.cpp.

◆ removeAll()

void beast::PropertyStream::Source::removeAll ( )

inherited

Remove all child sources from this Source.

Definition at line 196 of file beast_PropertyStream.cpp.

◆ writeOne()

void beast::PropertyStream::Source::writeOne ( PropertyStream & stream )

inherited

Write only this Source to the stream.

Definition at line 209 of file beast_PropertyStream.cpp.

◆ write() [1/2]

void beast::PropertyStream::Source::write ( PropertyStream & stream )

inherited

write this source and all its children recursively to the stream.

Definition at line 216 of file beast_PropertyStream.cpp.

◆ write() [2/2]

void beast::PropertyStream::Source::write	(	PropertyStream &	stream,
		std::string const &	path )

inherited

Parse the path and write the corresponding Source and optional children.

If the source is found, it is written. If the wildcard character '*' exists as the last character in the path, then all the children are written recursively.

Definition at line 228 of file beast_PropertyStream.cpp.

◆ find()

std::pair< PropertyStream::Source *, bool > beast::PropertyStream::Source::find ( std::string path )

inherited

Parse the dot-delimited Source path and return the result.

The first value will be a pointer to the Source object corresponding to the given path. If no Source object exists, then the first value will be nullptr and the second value will be undefined. The second value is a boolean indicating whether or not the path string specifies the wildcard character '*' as the last character.

print statement examples "parent.child" prints child and all of its children "parent.child." start at the parent and print down to child "parent.grandchild" prints nothing- grandchild not direct descendent "parent.grandchild." starts at the parent and prints down to grandchild "parent.grandchild.*" starts at parent, print through grandchild children

Definition at line 246 of file beast_PropertyStream.cpp.

◆ findOneDeep()

PropertyStream::Source * beast::PropertyStream::Source::findOneDeep ( std::string const & name )

inherited

Definition at line 317 of file beast_PropertyStream.cpp.

◆ findPath()

PropertyStream::Source * beast::PropertyStream::Source::findPath ( std::string path )

inherited

Definition at line 334 of file beast_PropertyStream.cpp.

◆ findOne()

PropertyStream::Source * beast::PropertyStream::Source::findOne ( std::string const & name )

inherited

Definition at line 352 of file beast_PropertyStream.cpp.

◆ peelLeadingSlash()

bool beast::PropertyStream::Source::peelLeadingSlash ( std::string * path )

staticinherited

Definition at line 266 of file beast_PropertyStream.cpp.

◆ peelTrailingSlashstar()

bool beast::PropertyStream::Source::peelTrailingSlashstar ( std::string * path )

staticinherited

Definition at line 277 of file beast_PropertyStream.cpp.

◆ peelName()

std::string beast::PropertyStream::Source::peelName ( std::string * path )

staticinherited

Definition at line 293 of file beast_PropertyStream.cpp.

◆ onWrite()

void beast::PropertyStream::Source::onWrite ( Map & )

virtualinherited

Subclass override.

The default version does nothing.

Reimplemented in xrpl::ApplicationImp, xrpl::LedgerCleanerImp, xrpl::OverlayImpl, xrpl::peer_finder::ManagerImp, and xrpl::resource::ManagerImp.

Definition at line 364 of file beast_PropertyStream.cpp.

Member Data Documentation

◆ name_

std::string const beast::PropertyStream::Source::name_

privateinherited

Definition at line 317 of file PropertyStream.h.

◆ lock_

std::recursive_mutex beast::PropertyStream::Source::lock_

privateinherited

Definition at line 318 of file PropertyStream.h.

◆ item_

Item beast::PropertyStream::Source::item_

privateinherited

Definition at line 319 of file PropertyStream.h.

◆ parent_

Source* beast::PropertyStream::Source::parent_ {nullptr}

privateinherited

Definition at line 320 of file PropertyStream.h.

◆ children_

List<Item> beast::PropertyStream::Source::children_

privateinherited

Definition at line 321 of file PropertyStream.h.

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Manager()

◆ ~Manager()

Member Function Documentation

◆ newInboundEndpoint() [1/2]

◆ newInboundEndpoint() [2/2]

◆ newOutboundEndpoint()

◆ newUnlimitedEndpoint()

◆ exportConsumers()

◆ getJson() [1/2]

◆ getJson() [2/2]

◆ importConsumers()

◆ name()

◆ add() [1/2]

◆ add() [2/2]

◆ remove()

◆ removeAll()

◆ writeOne()

◆ write() [1/2]

◆ write() [2/2]

◆ find()

◆ findOneDeep()

◆ findPath()

◆ findOne()

◆ peelLeadingSlash()

◆ peelTrailingSlashstar()

◆ peelName()

◆ onWrite()

Member Data Documentation

◆ name_

◆ lock_

◆ item_

◆ parent_

◆ children_