openMetrics PMDA (OpenMetrics PMDA)
CONFIGURATION SOURCES
As it runs, pmdaopenmetrics
periodically recursively scans the
$PCP_PMDAS_DIR/openmetrics/config.d
directory (or the directory
specified with the -c
option), looking for source URL files
(*.url) and executable scripts or binaries. Any files that do
not have the .url
suffix or are not executable, are ignored -
this allows documentation files such as "README" and non-
executable "common" script function definitions to be present
without being considered as config files.
A remote server does not have to be up or stay running - the PMDA
tolerates remote URLs that may come and go over time. The PMDA
will relay data and metadata when/if they are available, and will
return errors when/if they are down. PCP metric IDs, internal
and external instance domain identifiers are persisted and will
be restored when individual metric sources become available
and/or when the PMDA is restarted. In addition, the PMDA checks
directory modification times and will rescan for new or changed
configuration files dynamically. It is not necessary to restart
the PMDA when adding, removing or changing configuration files.