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:
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.
There are additional intervals you may specify such as minute, 5-minute, 30-minute, 4-hour, 12-hour and day.
To log every 5 minutes without user information:
To log every minute with user information:
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:
Windows default path:
Linux default path:
Using the log file parser
Using hython, run $HFS/houdini/python3.9libs/parsepeakuserlog.py for how to use the script. $HFS is the installation location of Houdini.
xlsxwritermodule is needed if you would like to use the xlsx export type.
For automatic time zone support, or to use the
--time-zoneoption, you will need to install the
It will always show the times in the non-daylight savings time.
hython $HFS/houdini/python3.9libs/parsepeakuserlog.py /usr/lib/sesi/sesinetd_peak_usage.bin --group-by=hour