wlmsend(1M)wlmsend(1M)NAMEwlmsend - send metric data to a rendezvous point
SYNOPSIS
wait_time] metric [value]
DESCRIPTION
provides a script interface for sending metric data to the HP-UX WLM
daemon via a FIFO file rendezvous point. The rendezvous point is iden‐
tified by the name of the metric being reported. You can provide a sin‐
gle metric value on the command line or a stream of values separated by
white space on standard input. does not create the rendezvous point;
this is done by However, can be told to wait for the creation of the
rendezvous point through a command-line option.
As an alternative for building data collectors, a C programming lan‐
guage API exists for directly forwarding metric data to the WLM daemon.
See libwlm(3).
OPTIONS
Displays usage information and exits. This option overrides
all other options.
Displays version information and exits. This option overrides
all other options except
Instructs
to wait wait_time seconds for the rendezvous point to be created
before exiting. The default wait_time is 5 seconds.
metric
Indicates that the rendezvous point is named metric. This argu‐
ment is required and must match a metric string specified in a or
statement in the WLM configuration file.
value
Sends metric value to the rendezvous point. This numeric argument
must be the last argument on the command line. If value is not
provided, white space-separated metric values will be taken from
standard input and sent to the rendezvous point. Any unitless
integer or floating-point number is considered a legal metric
value.
RETURN VALUE
returns exit status if no errors occur, or if there are errors.
EXAMPLES
This example shows how to set up the WLM configuration file and to work
together to forward the data to WLM. The example assumes the group has
already been defined.
First, in the configuration file, we define an structure to keep the
metric job_time under 2.0. Also, we set up to receive the job_time met‐
ric values from
# Set up the SLO
slo data_cruncher {
pri = 3;
mincpu = 15;
maxcpu = 25;
entity = PRM group crunch;
goal = metric job_time < 2.0;
}
# Set up wlmrcvdc
tune job_time {
coll_argv = wlmrcvdc;
}
Second, we set up in either a data collector shell script or on the
command line. If the data is coming from a file, say logfile, we can
forward the data to WLM as follows:
tail -f logfile | wlmsend job_time
Alternatively, we can forward exactly one metric value at a time as
follows:
wlmsend job_time value
Be careful of I/O buffering when feeding data to For example,
the following line works as expected:
tail -f logfile | wlmsend job_time
However, adding or other utilities that buffer I/O can result in
data being delayed, or not even sent, to -- depending on when
the buffer is flushed:
tail -f logfile | awk '{print $1}' | wlmsend job_time
Use to verify that your data gets to WLM in a timely fashion.
DEPENDENCIES
depends on to create a rendezvous point and subsequently forward metric
values from the rendezvous point to the WLM daemon. The WLM daemon is
responsible for starting instances of as requested in the structures of
the configuration file. See wlmconf(4). We recommend that data col‐
lection scripts calling run in the workload group.
AUTHOR
was developed by HP.
FEEDBACK
If you would like to comment on the current HP-UX WLM functionality or
make suggestions for future releases, please send email to:
wlmfeedback@rsn.hp.com
SEE ALSOwlmrcvdc(1M), libwlm(3), wlmconf(4), wlm(5)
HP-UX Workload Manager User's Guide (/opt/wlm/share/doc/WLMug.pdf)
"Writing a Better WLM Data Collector" white paper
(/opt/wlm/share/doc/howto/perfmon.html)
HP-UX Workload Manager homepage (http://www.hp.com/go/wlm)
wlmsend(1M)