Plugin_lustre_ost

Date:

1 May 2019

NAME

Plugin_lustre_ost - man page for the LDMS lustre_ost plugin

SYNOPSIS

Within ldmsd_controller or a configuration file:
config name=lustre_ost

DESCRIPTION

With LDMS (Lightweight Distributed Metric Service), plugins for the ldmsd (ldms daemon) are configured via ldmsd_controller or a configuration file.

The lustre_ost plugin provides metric sets for two different schemas: lustre_ost and lustre_ost_job_stats.

The metric sets using schema lustre_ost will have a producer name set to the hostname, and the instance name set to the ost name. The data for these metrics sets come from a combination of the data in /proc/fs/lustre/ost/*/stats and a few other single-value files in /proc/fs/lustre/ost/*/.

The metric sets using schema lustre_ost_job_stats will have a producer name set to the hostname, and the instance name will be set to a combination of the ost name and the job_id string. The data for these metrics sets come from /proc/fs/lustre/ost/*/job_stats.

This plugin currently employs zero configuration. Any user-supplied configuration values will be ignored. Future versions may add configuration options.

This plugin should work with at least Lustre versions 2.8, 2.10, and 2.12.

CONFIGURATION ATTRIBUTE SYNTAX

config
name=<plugin_name> [producer=<name>] [component_id=<u64>]
configuration line
name=<plugin_name>

This MUST be lustre_ost.
producer=<alternate host name>

The default used for producer (if not provided) is the result of gethostname(). The set instance names will be $producer/$ost_name.
component_id=<uint64_t>

Optional (defaults to 0) number of the host where the sampler is running. All sets on a host will have the same value.

BUGS

No known bugs.

EXAMPLES

Within ldmsd_controller or a configuration file:

load name=lustre_ost
config name=lustre_ost
start name=lustre_ost interval=1000000

SEE ALSO

ldmsd(8), ldms_quickstart(7), ldmsd_controller(8), ldms_sampler_base(7)