Creating a custom chart

Edit online

Using the IBM Spectrum LSF Explorer Database Schema, it is easy to create a new chart to suit your needs.

About this task

The following example is to create a new chart showing the Number of Jobs by User or Queue.

Procedure

  1. Open a web browser and access IBM Spectrum LSF Explorer Server by entering the IP address and port number of the Server.

    The default port number is 8080.

    For example, if your IBM Spectrum LSF Explorer Server IP address is 198.51.100.0, enter in your web browser as the URL:
     http://198.51.100.0:8080
  2. Select Charts on the left and click the New button.
  3. Enter a name for your chart, for example "Number of Jobs by Queue".
  4. Select a data source for your chart data.

    The data sources are automatically created at installation by the installer and are defined in EXPLORER_SERVER_TOP/lsfsuite/ext/explorer/server/config/config.json, where EXPLORER_SERVER_TOP is the top-level installation directory on the IBM Spectrum LSF Explorer server.

  5. Select an Index. In this instance, select "lsf_events", which contains all the information for LSF jobs in all job states.
  6. Select the Dimensions "queue_name" and "user_name".

    The queue name dimension allows you to view jobs by queue. The user name dimension allows you to view jobs by user.

  7. Modify the Name in the chart to be used as a label for each Dimension (for example, Queue Name and User Name) and select Add for each.
  8. Select the "job_id" Measure and "Count" Aggregation to get the number of jobs. Modify the Name in the chart to be used as a label for the Measure (for example, Number of Jobs) and select Add.
  9. Under Filters, select:
    • user_name with Multiple Selection Selection Type and the Display Name "User Name".
    • queue_name with Multiple Selection Selection Type and the Display Name "Queue Name".
    • job_status with Multiple Selection Selection Type and the Display Name "Job Status".
    • end_time with Single Selection Selection Type and the Display Name "Time Range" and Relative Time of past 7 days.
  10. Click Next to see a preview of your chart.
  11. Select a Chart Type to best display your data.

    Examine the preview of your chart to make sure it meets your requirements and return to the previous screen to make any modifications.

  12. When you are satisfied with your new chart, select a Category where your chart will be stored.
  13. Click Save.

    Your new chart is now available under the chosen Category in the Charts section of IBM Spectrum LSF Explorer.