Software License Metric (SLM) tags

IBM Watson® Machine Learning Accelerator generates entitlement audit logs as IBM Software License Metric Tag (.slmtag) files. IBM License Metric Tool (ILMT) is then used to translate the file and generate License Consumption Reports. Use the information in this section to interpret your .slmtag files.

The .slmtag files can store information up to a maximum file size of 1 MB, after which the file is archived and a new log file is created. A maximum of 10 log files are kept.

Log location

The .slmtag file is located in the $EGO_CONFDIR/kernel/audit directories. Logs are updated hourly.

Log format

The .slmtag files are stored in XML format, with new metric records appended to the end of the file. Following is a sample .slmtag file:

<SchemaVersion>2.1.1</SchemaVersion>
<SoftwareIdentity>
    <PersistentId>807a57c9389c4cbba75d43d8a81379f1</PersistentId>
    <Name>IBM Watson Machine Learning Accelerator</Name>
    <InstanceId>/opt/ibm/spectrumcomputing/dli/1.2.3/dlpd</InstanceId>
</SoftwareIdentity>
<Metric logTime="2019-01-28T13:46:37-04:00">
       <Type>MANAGED_SERVER</Type>
       <SubType></SubType>
       <Value>$MANAGED_SERVER_COUNT</Value>
       <Period>
               <StartTime>2019-01-28T12:46:37-04:00</StartTime>
               <EndTime>2019-01-28T13:46:37-04:00</EndTime>
       </Period>
</Metric>

The Value element for MANAGED_SERVER displays the number of managed servers for hosts in all the resource groups with packages deployed for an application instance or Spark instance group, at the specified time in the EndTime element.

The file grows over time and may be edited to remove older metric elements. Ensure that you retain elements long enough for ILMT scanning; the scanning frequency is determined by the ILMT administrator, but generally it should be sufficient to keep elements for a month.