Retrieve license usage logs from an on-prem server license


The Altair License Manager logs all usage data with a transactional logging system as long as the server is running. By default, the system produces only anonymous usage logs used for reporting information back to Altair according to the standard Altair license agreement. All the transactional data logged by the system will be stored at the data directory, located at the installation directory of the ALM. This article is valid only for on-premises server licenses, if your company has a license Managed on Altair One, you should check the Retrieve Usage Logs from a Managed License article instead.

The level of logging can be anonymous or detailed and the type of output  is controlled by the value of ALUS_LOG_LEVEL in the alus.conf configuration file that will be located at the installation directory of the Altair License Manager.

Values:

0  -  No logging.

1  -  Anonymous logs only.

2  -  Anonymous and detailed logs.

These anonymous logs are sent to Altair for usage reporting. If detailed logging is enabled, a second set of transaction logs is also produced, keeping the private data in a legible format. These are NOT sent to Altair, and are stored in a separate directory named detailed.

Retrieving usage logs

In order to retrieve the logs to analyze license usage, head to the .../data directory and retreive the logs from the following directories according to the information you need.

/pending - Location of anonymous log files pending transmission to Altair. Log files remain here until the URT runs.

/processing - Location of the current open and in use logs by the server.

/detailed - Location of the detailed log files that have been closed and rotated by the server.

/sent - Location of the zipped log files that have alredy been reported. This location stores this data until removed by user.

Note: To conserve space on the license server, you should routinely cleanup the files in the .../data/sent and the .../data/detailed directories.

 Each individual log file will be named according to the date when it logged the usage data in the following format YYYYMMDD.log. Once you have retrieved the usage logs you would like to analyze, you can follow the instructions on how to run the Transactional Log Parser in order to process the log files to generate a consolidated .csv file containing all the usage data.