How can I setup Peak Usage Logging?

Important: The license server (sesinetd) must be version 18.5.875 or higher (for Houdini 18.5) or 19.0.549 or higher (for Houdini 19.0) in order for peak usage logging to be accurate. Older versions will overreport usage.

The peak license usage log stores the maximum number of concurrent uses of a license token during a time interval. Time intervals are typically set to 1 hour each. You can inspect the contents of this log at any time.

This is a great option to monitor your peak license usage by product type. During a given interval the peak usage and optionally the users who used it are recorded to a binary log file. The log may be exported to less compact different representations such as spreadsheets or databases for analysis.

For detailed information, refer to Peak Usage Logging.

Enable usage logging

Peak license usage is enabled by default in the sesinetd.ini file, with the option to log every hour:

usageInterval=hour

This will log the peak number of licenses used in the hour. To keep the log file compact, if no one has used the license in the interval then nothing is logged for that license.

To modify the various options for the license server sesinetd, edit or create the sesinetd.ini file.

Mac

/Library/Preferences/sesinetd/sesinetd.ini

Windows

C:\Windows\system32\sesinetd.ini

Linux

/usr/lib/sesi/sesinetd.ini

There are additional intervals you may specify such as minute, 5-minute, 30-minute, 4-hour, 12-hour and day.

For example:

To log every 5 minutes without user information:

usageInterval=5-minute

To log every minute with user information:

usageInterval=minute
includeUser=true

The includeUsers option logs who used the license within the time interval. By default only the peak usage for each license is logged without user information.

Make sure to choose the interval correctly as the smaller the interval the larger the log file and the longer the export will take.

Running sesinetd --print-options will show if peak usage logging has been enabled, the interval used and location of the log file.

An example on Linux:

 /usr/lib/sesi/sesinetd --print-options

 == Usage ==
 Peak Usage Enabled: true
 Usage Interval: hour
 Send usage interval: -1
 Include Users: false
 Usage File: '/usr/lib/sesi/sesinetd_peak_usage.bin'
 Usage Log URL: ''

The usage log file

The peak usage information is logged to a binary file.
There is a log file parser that is shipped with Houdini. The parser will allow the data to be exported to different representations.

The default location is in the license path with the name sesinetd_peak_usage.bin.

The peakUsageFile option specifies the custom location for the log file.

Mac default path:

/Library/Preferences/sesi/sesinetd_peak_usage.bin

Windows default path:

C:\Windows\keys\sesinetd_peak_usage.bin

Linux default path:

/usr/lib/sesi/sesinetd_peak_usage.bin

Using the log file parser

Using hython, run $HFS/houdini/python.10libs/parsepeakuserlog.py for how to use the script. $HFS is the installation location of Houdini.

The xlsxwriter module is needed if you would like to use the xlsx export type.

For automatic time zone support, or to use the --time-zone option, you will need to install the ptyz Python module.
It will always show the times in the non-daylight savings time.

An example:

hython $HFS/houdini/python3.10libs/parsepeakuserlog.py /usr/lib/sesi/sesinetd_peak_usage.bin --group-by=hour