18.1 User Feedback Overview
The Feedback facility allows a site administrator to provide job performance information to users at job completion time. When a job completes, the program pointed to by the FEEDBACKPROGRAM parameter is called with a number of command line arguments. The site administrator is responsible for creating a program capable of processing and acting upon the contents of the command line. The command line arguments passed are as follows:
- job id
- user name
- user email
- final job state
- QoS requested
- epoch time job was submitted
- epoch time job started
- epoch time job completed
- job XFactor
- job wallclock limit
- processors requested
- memory requested
- average per task cpu load
- maximum per task cpu load
- average per task memory usage
- maximum per task memory usage
- messages associated with the job
- host list (comma-delimited)
For many sites, the feedback script is useful as a means of letting users know the accuracy of their wallclock limit estimate, as well as the CPU efficiency, and memory usage pattern of their job. The feedback script may be used as a mechanism to do any of the following:
- email users regarding statistics of all completed jobs
- email users only when certain criteria are met (such as "Job 14991 has just completed which requested 128 MB of memory per task. During execution, it used 253 MB of memory per task potentially conflicting with other jobs. Please improve your resource usage estimates in future jobs.")
- update system databases
- take system actions based on job completion statistics
Some of these fields may be set to zero if the underlying OS/resource manager does not support the necessary data collection.
Example 18-1:
FEEDBACKPROGAM /opt/moab/tools/fb.pl