License reporting in License Manager - AWS License Manager

License reporting in License Manager

Using AWS License Manager you can track the history of your license configurations by scheduling periodic snap shots of your license usage. By setting up usage reports (formerly called report generators) License Manager will automatically upload reports of your license configurations to an S3 bucket based on your specifications. You can set up multiple usage reports to effectively track configurations of different license types in your environment.

Note

AWS License Manager does not store your reports. License Manager reports are published directly to your S3 bucket. Once you delete a usage report, reports are no longer published to your S3 bucket.

Creating a usage report

When you create a usage report you specify a license configuration type for License Manager to track, a frequency interval that defines how often to generate reports, and a report type. All reports are generated in CSV format and published to an S3 bucket. A usage report can produce one or more of following report types.

License configuration report

This report type contains information on the number of consumed licenses and details about license configuration. The tracked license configuration type is listed with details such as the license count, license rules, and the distribution of licenses across different resource types.

Resource report

This report type gives you details about your tracked resources and their license consumption. Each tracked resource using the specified license configuration type is listed with details such as the license ID, the status of the resource, and the AWS account ID that owns the resource.

To create a usage report

  1. Open the License Manager console at https://console.aws.amazon.com/license-manager/.

  2. From the navigation panel choose Reports. Then, from the Create usage report pane define the parameters for the report:

    1. Enter a Name and optional Description for your generator.

    2. Select a license configuration type from the drop down list. This is the type of license that the usage report will be generating data on.

    3. Choose the report types to generate.

    4. Choose the frequency by which License Manager will publish the reports, you can choose Once every day, Once every week or Once every month.

    5. (Optional) Add Tags to track the usage report resource.

  3. Select Create usage report.

A new usage report will begin publishing reports within 60 minutes or less.

If you do not already have an S3 bucket associated with your account, License Manager will create a new Amazon S3 bucket in your account when you create a usage report. If you have previously enabled Cross-account inventory search reports will be sent to the S3 bucket created by License Manager when Cross-account inventory search was enabled.

Reports are stored in your bucket with the following Amazon S3URI pattern:

s3://aws-license-manager-service-*/Reports/report-generator-name/year/months/day/report-id.csv

Editing your usage reports

You can view and make changes to your usage reports from the License Manager console at any time. The usage reports table lists all the usage reports created for your account, from the table you can get an overview of your different reports, pivot to the Amazon S3 bucket associated with your usage reports, and view the status of report generation.

To edit a usage report

  1. Open the License Manager console at https://console.aws.amazon.com/license-manager/.

  2. From the navigation panel choose Reports.

  3. Choose the usage report you want to edit from the table, then select View details.

  4. Select Edit to make changes to the report generator.

  5. Make the desired changes to your usage report then choose Save changes.

An updated usage report will generate a new report within an hour.

Note

Changing the name of your usage report will send future reports to a new folder in your License Manager S3 bucket reflecting the new name.

Deleting a usage report

Deleting a usage report stops the generation of new reports, however, your Amazon S3 bucket and all your previous reports are not affected.

Note

You will be unable to delete a license configuration from your account if it has a usage report associated. You must first delete that report generator.

To edit a usage report

  1. Open the License Manager console at https://console.aws.amazon.com/license-manager/.

  2. From the navigation panel choose Reports.

  3. Choose the usage report you want to edit from the table, then select View details.

  4. Select Delete. This action permanently deletes the report generator.