LDMS 3.x Plugins

This website contains archival information. For updates, see https://github.com/ovis-hpc/ovis-wiki/wiki

You can list the stores and samplers and usage hints for your LDMS 3.4 installation with (typically)

 /usr/bin/ldms_list_plugins.sh

This will list the compiled and installed plugins and their options for use in the LDMS configuration language. This may include experimental plugins. Generally, production plugins will have a man page, for example to understand the meminfo plugin, try

 man Plugin_meminfo

Unfortunately, the man pages may not be installed on your system or they may not yet be complete. If anything in the table below provokes a question, please send it to the ovis-help mailing list described elsewhere.

Migration note: LDMS v4 will introduce ldms-plugins.sh with better functionality.

Production Sampler Plugins

Below is a summary of the plugins that can be considered production quality in release 3.4.4 for commodity Linux environments.

namemetric set content
dstatmemory and other statistics from LDMSD itself
edacmemory error checking from /sys/devices/system/edac metrics
jobidCurrently running job id and user (requires loose cooperation from queuing system, e.g. slurm)
lnet_stats/proc/sys/lnet/stats metrics, particularly memory
lustre2_clientLustre client metrics
meminfo/proc/meminfo values
procinterruptsinterrupt counters (very large datasets on many-core machines)
procnetdev/proc/net tcp interface device counters (excludes rdma traffic/errors)
procnfsnfs v3 client statistics (calls, bytes)
procstat/proc/stat counters (includes cpu tick)
sysclassibinfiniband counters and rates (includes rdma traffic/errors)
vmstat/proc/vmstat counters

Production Store Plugins

nameoutput formatnotes
store_csvCSV filesrequires the size of metric sets of a given name (schema) be identical across all nodes.
store_flatfile1-metric filesnarrow CSV file per metric with timestamp and source columns. Tolerates conflicting schema definitions.
strore_rabbitv3AMQP messagesfeeds all metrics to single AMQP broker via librabbitmq 0.8. (multiple routing keys)
strore_rabbitkwAMQP messagesfeeds all metrics to single AMQP broker via librabbitmq 0.8. (single routing key)

Vendor Specific

Below is a summary of the plugins that can be considered production quality in release 3.4.4 for CLE6

aries_mmr/nic_mmr/rtr_mmrCray XC aries network counters
cray_system_samplerwide variety of Cray XE/XC metrics
kgnilndkernel-space sampler for network data

These also work on appropriate platforms

cray_power_sampler ?
msr_interlagosAMD CPU event counters

Testing/Tutorial

all_example(tutorial/testing)
array_examplearrays (tutorial/testing)
clockticker (tutorial/testing)
fptransfloating point transmission test sets (testing)
generic_sampler(tutorial/testing)
syntheticgenerates synthetic waveform data sets (testing)

Experimental

hfclockhigh frequency clock
perfeventProcess perf event counters
power_samplerPower API 1
raplPAPI counters
spapiPAPI counters
switchxinfiniband switch port data
test_sampler ?
timer_base ?
tsampler ?
store_sosScalable Object Store storage prototype

Other

All other plugins should be considered unsupported.