Function install_counter

Function install_counter_type

hpx::performance_counters::install_counter_type — Install a new generic performance counter type in a way, which will uninstall it automatically during shutdown.

Synopsis

// In header: <hpx/performance_counters/manage_counter_type.hpp>


counter_status 
install_counter_type(std::string const & name, counter_type type, 
                     std::string const & helptext, 
                     std::function< create_counter_func > const & create_counter, 
                     std::function< discover_counters_func > const & discover_counters, 
                     boost::uint32_t version = HPX_PERFORMANCE_COUNTER_V1, 
                     std::string const & uom = "", error_code & ec = throws);

Description

The function install_counter_type will register a new generic counter type based on the provided counter_type_info. The counter type will be automatically unregistered during system shutdown.

	Note
	As long as ec is not pre-initialized to hpx::throws this function doesn't throw but returns the result code using the parameter ec. Otherwise it throws an instance of `hpx::exception`.

	Note
	The counter type registry is a locality based service. You will have to register each counter type on every locality where a corresponding performance counter will be created.

Parameters:

`create_counter`	[in] The function which will be called to create a new instance of this counter type.
`discover_counters`	[in] The function will be called to discover counter instances which can be created.
`ec`	[in,out] this represents the error status on exit, if this is pre-initialized to hpx::throws the function will throw on error instead.
`helptext`	[in] A longer descriptive text shown to the user to explain the nature of the counters created from this type.
`name`	[in] The global virtual name of the counter type. This name is expected to have the format /objectname/countername.
`type`	[in] The type of the counters of this counter_type.
`uom`	[in] The unit of measure of the counter type (default: "")
`version`	[in] The version of the counter type. This is currently expected to be set to HPX_PERFORMANCE_COUNTER_V1.

Returns:

If successful, this function returns status_valid_data, otherwise it will either throw an exception or return an error_code from the enum counter_status (also, see note related to parameter ec).