Checkout Statistics and Details

The Checkout Statistics page is a powerful data mining tool that can be used to find pin-pointed answers about license utilization.

By combining the use of filters and the report by option for the report, you can find information on utilization such as:
  • The utilization of a feature per project
  • The activity of user Bob in the GPS project
  • The activity of user Sue overall
  • The number of checkouts that went to jobs on the fastest compute farm machine
Figure 1. Current Checkout Statistics Report


The report shows checkout and elapsed time statistics and queued/wait time statistics, and provides links to the graphs. The Checkout Statistics Report includes the following columns:
  • Tag: The tag representing the license server.
  • Feature: The license feature name.
  • Count: The number of checkouts.
  • Checkouts/Elapsed: The amount of elapsed time since the feature was checked out.
  • Checkouts/Total: The elapsed time normalized for the number of tokens checked out. This provides a cumulative value for multi-token features.
  • Checkouts/Avg Total: The elapsed time divided by the number of checkouts.
  • Checkouts/Max: The maximum number of checkouts.
  • Queued Count: The elapsed time normalized for the number of queues. The number of times the feature was requested.
  • Queued Total: The elapsed time divided by the number of queues.
  • Queued Avg Wait: The average elapsed time before a queue becomes a checkout.
  • Queued Wait Max: The max elapsed time before a queue becomes a checkout

The report shows checkout and elapsed time statistics, queued/wait time statistics, and provides links to the plot and heatmap pages for visualization of the report. The Details link, location above the report, is used to switch to a detailed report of the actual checkouts used to calculate the statistics.

The Elapsed column indicates the amount of elapsed wall clock time since the feature was checked out. The Total is the Elapsed time figure normalized for the number of tokens checked out. This provides a cumulative value for multi-token features. The Avg column indicates the Elapsed time divided by the number of checkouts.

Reservations that are performed in the license manager configuration are detected and represented as checkouts by a user beginning with "r:". The remainder of the user name matches the target of the reservation, whether it be a user or a group of users. To include the checkouts for reservation users in the report, simply select the option to include reservations.

Checkout Details

Switching to the detailed view reports on the actual checkouts that make up the statistics shown in the statistics view. This view shows most of the information that is normally found in a license manager status command. It can be used to narrow down the results using the same filter methodology utilized in the statistics view.

Figure 2. Checkout Details Report


The Checkout Details Report includes the following columns:
  • Tag: The tag representing the license server.
  • Feature: The license feature name.
  • Version: The version of the license for the checkout feature.
  • User: The user holding the checkout.
  • LDAP: If clicked and configured, the folder icon will show user pre-configured attributes from LDAP such as their phone number, department or location.
  • Email: The mailto link to all users of the feature using the client machine's configured e-mail client.
  • Host: The host on which the job is running.
  • Project: The project assignment for the current checkout.
  • Queued: The elapsed time before the queue request becomes a checkout.
  • OUT: The time the checkout occurred.
  • IN: The time the checkout ended.
  • Handle: The license manager’s handle for the checkout.
  • Tokens: The actual number of licenses.
  • Elapsed: The age of the checkout.
  • Total: The elapsed time normalized for the number of tokens checked out. This provides a cumulative value for multi-token checkout.
  • Origin: Usage data source from lmstat-driven sampling (1) or from parsing debug log (2).
  • Graphs: Icons for generating plots and heatmaps.

The Checkout Details page will also display columns for any custom group types that have been configured. The group that is shown is the group to which the user for that row was a member of at the time the checkout was created.

The Elapsed column indicates the amount of elapsed wall clock time since the feature was checked out. The Total is the Elapsed time figure normalized for the number of tokens checked out. This provides a cumulative value for multi-token features.

Note: You can generate additional columns by going to the Admin page and selecting Groups, and then choosing from the options: Projects, Custom Groups Types and Custom Groups.