adctk.ldms_publisher.LDMSSystemMessagePublisher Class Reference

Publish data via file to ldms_message_publish once via process recreated at each call. More...

Inheritance diagram for adctk.ldms_publisher.LDMSSystemMessagePublisher:

Collaboration diagram for adctk.ldms_publisher.LDMSSystemMessagePublisher:

Public Member Functions
	__init__ (self)
int	config (self, **kwargs)
	Configure the plugin with the options given.
Public Member Functions inherited from adctk.ldms_publisher.LDMSPipeMessagePublisher
int	initialize (self)
	Set up any resources needed for reuse in publish().
	publish (self, builder.Builder b)
	finalize (self)
	Clean up any resources set up in initialize (files, pipes, etc).
Public Member Functions inherited from adctk.publisher.Publisher
str	name (self)
	Get the name which a factory or error message should use.
str	version (self)
dict[str, str]	get_option_defaults (self)
None	pause (self)
	Cause publish calls to be ignored until resume is called.
None	resume (self)
	Cancel an prior calls to pause.
int	publish_str (self, str json_string)
int	publish_obj (self, obj)

Public Attributes
	defaults
	dir_
	port
	auth
	tag
	host
Public Attributes inherited from adctk.ldms_publisher.LDMSPipeMessagePublisher
	plugin_prefix
	defaults
	prog
	port
	auth
	tag
	host
	timeout
	mode
	state
Public Attributes inherited from adctk.publisher.Publisher
	defaults
	plugin_prefix
	paused
	state
	mode

Protected Member Functions
int	_post (self, str msg)
Protected Member Functions inherited from adctk.publisher.Publisher
str	_get (self, dict[str, str] opts, str field)
bool	_get_bool (self, dict[str, str] opts, str field)

Static Protected Attributes
str	_name = "ldms-system-message"
str	_version = "1.0.0"
Static Protected Attributes inherited from adctk.ldms_publisher.LDMSPipeMessagePublisher
str	_name = "ldms-pipe-message"
str	_version = "1.0.0"
Static Protected Attributes inherited from adctk.publisher.Publisher
str	_name = "unknown"
str	_version = "0.0.0"

Additional Inherited Members
Static Public Member Functions inherited from adctk.publisher.Publisher
tuple[float]	get_timeout_defaults ()
	Get the adc server connect and response timeouts defined in the environment ADC_SERVER_CONNECT_TIMEOUT and ADC_SERVER_POST_TIMEOUT as a tuple or default values if not defined.
str	get_url_default ()
	Get the alleged adc server url base from environment ADC_SERVER_URL or the default if it is not present.
str	get_port_default ()
	Get the adc server port number to use if it is properly defined in the environment ADC_SERVER_PORT or the default if it is not.
Static Public Attributes inherited from adctk.publisher.Publisher
	API_VERSION = adc_version.AdcVersion()._dict()

Detailed Description

Publish data via file to ldms_message_publish once via process recreated at each call.

Environment Variables

• ADC_LDMS_MESSAGE_PUBLISH_PLUGIN_PROG
• ADC_LDMS_MESSAGE_PUBLISH_PLUGIN_TAG
• ADC_LDMS_MESSAGE_PUBLISH_PLUGIN_AUTH
• ADC_LDMS_MESSAGE_PUBLISH_PLUGIN_PORT
• ADC_LDMS_MESSAGE_PUBLISH_PLUGIN_HOST
• ADC_LDMS_MESSAGE_PUBLISH_PLUGIN_TIMEOUT

Constructor & Destructor Documentation

__init__()

adctk.ldms_publisher.LDMSSystemMessagePublisher.__init__

(

self

)

Reimplemented from adctk.ldms_publisher.LDMSPipeMessagePublisher.

    def __init__(self):
        super().__init__()
        self.defaults = _defaults_system_message
        self.dir_: str = None
 

Member Function Documentation

_post()

int adctk.ldms_publisher.LDMSSystemMessagePublisher._post (   self, str   msg  )

protected

Reimplemented from adctk.ldms_publisher.LDMSPipeMessagePublisher.

    def _post(self, msg:str ) ->int:
        if not self.dir_:
            self.initialize()
        f = None
        try:
            f, filepath = tempfile.mkstemp( prefix="adctk-json-system-message-msg-", dir=self.dir_ )
            f.write(msg)
            f.close()
            cmd = [self.prog,
                   "-t", "json",
                   "-x", "sock",
                   "-p", self.port,
                   "-a", self.auth,
                   "-m", self.tag,
                   "-h", self.host,
                   "-f", filepath
                   ]
            log.logger.info("LDMSSystem-publisher command: %s", cmd)
            with subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE) as process:
                stdout, stderr = process.communicate(timeout=self.timeout)
                output_string = stdout.decode("utf-8")
                error_string = stderr.decode("utf-8")
                log.logger.debug("Output: %s", output_string)
                log.logger.debug("Error: (may be empty): %s", error_string)
                ret = process.wait()
                if ret != 0:
                    log.logger.warning("LDMSSystem-publisher: publish process failed "\
                        "with error: %s", ret)
        except subprocess.TimeoutExpired:
            log.logger.warning("LDMSSystem-publisher: timeout expired")
        if f:
            os.unlink(filepath)
        return ret

config()

int adctk.ldms_publisher.LDMSSystemMessagePublisher.config	(		self,
		**	kwargs
	)

Configure the plugin with the options given.

For plugin QQQ, Environment variables ADC_QQQ_PLUGIN_<key> will override the plugin default for any key not defined in kwargs. Here QQQ is plugin.name().upper(). Generic options:

Parameters

kwargs	If env_prefix is included in kwargs, replaces plugin environment variables with those which are prefixed using env_prefix.
env_prefix	Typically, env_prefix is set to "PPP_ADC_QQQ_PLUGIN_" if application PPP wants to override the defaults of adctk plugin QQQ. Here QQQ is plugin.name().upper(). If no prefixed version of the variable is present, the plugin default is used. kwargs takes precedence over environment variables. Plugin defaults are used if not overridden by kwargs or an environment variable.

Returns

int non-zero if configuration cannot be completed using the arguments, environment, and default.

Reimplemented from adctk.ldms_publisher.LDMSPipeMessagePublisher.

    def config(self, **kwargs) -> int:
        self.dir_ = self._get(kwargs, "DIRECTORY")
        return super().config(**kwargs)
 

Member Data Documentation

_name

str adctk.ldms_publisher.LDMSSystemMessagePublisher._name = "ldms-system-message"

staticprotected

_version

str adctk.ldms_publisher.LDMSSystemMessagePublisher._version = "1.0.0"

staticprotected

auth

adctk.ldms_publisher.LDMSSystemMessagePublisher.auth

defaults

adctk.ldms_publisher.LDMSSystemMessagePublisher.defaults

dir_

adctk.ldms_publisher.LDMSSystemMessagePublisher.dir_

host

adctk.ldms_publisher.LDMSSystemMessagePublisher.host

port

adctk.ldms_publisher.LDMSSystemMessagePublisher.port

tag

adctk.ldms_publisher.LDMSSystemMessagePublisher.tag

---

The documentation for this class was generated from the following file:

• src/adctk/ldms_publisher.py