Content of the audit snapshot
Audit snapshot is a record of license metric utilization in your enterprise over a period of time. It is generated on the All Metrics report and its derivatives. It is downloaded to your computer as the audit_snapshot_date_time.zip file that contains a number of other files.
- General files that contain the metadata of the snapshot, the summary of the actions and comments related to the software classification, overview of part numbers, an inventory of software that has been installed during the reported period, and the audit controls.
- Files with license metric utilization that contain information about the license utilization of your IBM products over time.
|audit_attachment.extension||Optional. A file that was attached during the creation of the snapshot. The file is listed in the checksums.txt file.|
|audit_comment.txt||Optional. Comments that were added during the creation of the snapshot. The file is listed in the checksums.txt file.|
|audit_snapshot_summary.csv||Summary of all software products that were installed in your environment during the period
for which the snapshot is generated and which are charged. The file contains information about:
|audit_trails.csv||The file contains the following information.
|bundling_definitions.csv||The file contains the following information.
|checksums.txt||Checksums that are used to verify whether any files from the audit snapshot
were tampered with.
To verify the report files on Linux, run the following command:
To verify the report files on Windows, run the following command:
|data_condition.txt||The file contains the following information.
|part_numbers.csv||Part numbers that are listed in the software catalog for software products included in any of the CSV report files.|
|pub_key.pem||Public key file that can be used to verify the signature.rsa file against the checksums.txt file.|
|signature.rsa||A digital signature that can be used to verify whether the
checksums.txt file was tampered with. To verify the file, you can use OpenSSL.
To verify the checksums.txt file on Linux, run the following command:
To verify the checksums.txt file on Windows, run the following command:
Files with license metric utilization
The following files are included in an audit snapshot and contain license utilization data of your IBM products. An audit snapshot can contain each of these files, or can be limited.
The content of the audit snapshot reflects the report view from which it is generated. If you apply filters on the All Metrics report or its derivatives, the audit snapshot is limited to the filtered data only. For example, if you filter the report to show only a specific metric type, such as PVU subcapacity, audit snapshot only contains the pvu_sub_capacity.csv file. In this case, files with other metrics are not included. Notice, that there is one exception from this rule. When you filter the report to show FlexPoint bundles or Cloud Paks, the audit snapshot reports the license utilization of the entire bundles or paks as well as the license utilization of their underlying components. The products_daily_<start_date>_<end_date>_<LMT_server_FQDN>.csv file is always generated, regardless of the filters.
|cloud_paks.csv||The file contains the following information.
|flexpoints.csv||The file contains the following information.
|install_instances.csv||The files contain the following information.
|The file contains daily values of license metric utilization for products that
were visible on the All Metrics report when the audit snapshot was generated. It provides a separate
entry for every unique license offering (product and license metric record from the All Metrics
report) for each day of the reporting period.
The purpose of this file is to allow for consolidating data from License Metric Tool and License Service to obtain overall license consumption across containerized and not-containerized environments. For more information about consolidating the data, see: Tracking license usage in a multicluster environment.
To ensure seamless consolidation of data, names of the columns in the file are not translated.