LSF_ENABLE_BEAT_SERVICE

Syntax

LSF_ENABLE_BEAT_SERVICE="services ..."

Description

Enables the LSF Beats services (lsfbeat tool).

To use this feature, IBM® Spectrum LSF Explorer must be deployed in your LSF cluster.

The lsfbeat tool integrates energy accounting into LSF. IBM Spectrum LSF Explorer uses Elasticsearch in the collection of the energy data of each host using Beats. LSF bjobs and bhosts can then query the data from IBM Spectrum LSF Explorer and display the job level or host level energy to users.

To enable the lsfbeat energy service, configure LSF_ENABLE_BEAT_SERVICE="energy" in lsf.conf, then run the bctrld restart lim all command to start the lsfbeat service. To query energy data with the bhosts and bjobs commands, configure LSF_QUERY_ES_FUNCTIONS="energy" and LSF_QUERY_ES_SERVERS="ip:port" in lsf.conf.

Valid values

The following extension names are supported:

energy: If the energy function is defined, lim will start the lsfbeat daemon to collect host energy data from IBM Spectrum LSF Explorer Elasticsearch.
all: If the all keyword is defined, all supported lsfbeat services will be enabled.

Default

Not defined

Example

The following example shows the output of bjobs -l with LSF_ENABLE_BEAT_SERVICE="energy":

user1@ibmgpu01-593: bjobs -l

Job <1933>, User <user1>, Project <default>, Status <RUN>, Queue <ex>, Command <
                     sleep 100000>
Thu Nov 16 03:55:14: Submitted from host <ibmgpu01>, CWD </testing/qa4/user1/egy
                     _test/conf>, Exclusive Execution;
Thu Nov 16 03:55:15: Started on <ibmgpu01>, Execution Home </home/user1>, Execut
                     ion CWD </testing/qa4/user1/egy_test/conf>;
Thu Nov 16 04:07:59: Resource usage collected.
                     MEM: 2 Mbytes;  SWAP: 0 Mbytes;  NTHREAD: 4
                     PGID: 3611;  PIDs: 3611 3612 3615

MEMORY USAGE:
MAX MEM: 2 Mbytes;  AVG MEM: 2 Mbytes

ENERGY USAGE:
163209.00 Joule/ 0.0453 kWh

The following example shows the output of bjobs -o with LSF_ENABLE_BEAT_SERVICE="energy":

[user1@ibmgpu01 conf]$ bjobs -o energy 1933
ENERGY
163209.00 Joule

The following example shows the output of bhosts -l with LSF_ENABLE_BEAT_SERVICE="energy":

user2@power1976>$ bhosts -l
HOST  power1976
STATUS           CPUF  JL/U    MAX  NJOBS    RUN  SSUSP  USUSP    RSV DISPATCH_WINDOW
closed_Excl    250.00     -     20      1      1      0      0      0      -

CURRENT LOAD USED FOR SCHEDULING:
                r15s   r1m  r15m    ut    pg    io   ls    it   tmp   swp   mem  slots
Total           0.0   0.0   0.1    1%   0.0    27    3     0 4173M  3.8G 105.9G     19
Reserved        0.0   0.0   0.0    0%   0.0     0    0     0    0M    0M    0M      -


LOAD THRESHOLD USED FOR SCHEDULING:
           r15s   r1m  r15m   ut      pg    io   ls    it    tmp    swp    mem
loadSched   -     -     -     -       -     -    -     -     -      -      -
loadStop    -     -     -     -       -     -    -     -     -      -      -


CONFIGURED AFFINITY CPU LIST: all

ENERGY:
Current Power: 580.00 Watt  Energy Consumed: 4405725.00 Joule/ 1.2238 kWh