Note: Please go to docs.rightscale.com to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > Guides > Dashboard Users Guide > Report > Customer Usage > Actions > ISV Customer Usage Report

ISV Customer Usage Report

Objective

To create a ISV Customer Usage report.  This report is typically downloaded in CSV format to your local hard drive, but can optionally be displayed to the screen as well.  This report can be run using a daily or monthly timeframe.

 

Table of Contents

Prerequisites

  • 'admin' User Role privilege
  • The RightScale account must be enabled to display the Customer Usage Report.  Please contact your RightScale Sales Account Manager for access.

Overview

If you are an ISV Partner, you can publish and share ServerTemplates. The Customer Usage Report is similar to the ServerTemplate Usage Report except instead of showing usage data within a single RightScale account, the Customer Usage Report shows the monthly usage data of your published ServerTemplates by all RightScale users.

Use this monthly metering data to generate reports (by customer) for billing purposes. You may sort usage data by Instance Size, ServerTemplate, AccountGroup, and Account. You may view data within the Dashboard or download it to a CSV file.  Additional report parameter information is as follows:

  • Time:
    • Select Day or Month
      • If by month, a drop down assists in selecting the correct month of the year
      • If by day, a menu pop-up assists in selecting the correct day.  The current day is not defaulted, but is surrounded by a dotted line.  
  • Action:  Download or Overview
    • Download - Download a CSV file to your local hard drive.
      • Filename convention:  isv_customer_report_MM######.csv (where MM is the month)
      • Output fields:
        • Account Group
        • ServerTemplate
        • Account - As seen on Settings -> Account Settings -> Info tab
        • Account Organization - As seen on Settings -> Account Settings -> Info tab
        • Account Owner - As seen on Settings -> Account Settings -> Info tab
        • Instance - Unique Instance ID
        • Instance Size
        • Instance Start - Date/time stamp when the Instance went active
        • Instance End - Date/time stamp when the Instance went inactive (blank if its still running/active)
        • Non Usage - List of subscribers that you (the publisher) has shared the ServerTemplates with, but they have not used them in the selected month.
        • Subscriber - Set to 1 if it has been shared explicitly through a Account Group.  Otherwise 0.
        • Lodgement Type - Lodgment typically billed  by Cloud provider for, such as instance usage or volume usage
        • Lodgement Start - Date/Time stamp for lodgement start
        • Lodgement End - Date/Time stamp for lodgement end
        • Instance Hours
        • Max Disk Volume Size
        • Disk Volume Hours
        • Custom Unit - See Creating Custom Metering Reports for more informaiton
        • Custom Metric - See Creating Custom Metering Reports for more informaiton
    • Overview - Displays directly to the screen.  Depending on whether you run the report by Instance, ServerTemplate or Publisher, the output fields will differ.
      • by Instance - The following fields are displayed:  Instance Size, Server Hours, Servers Launched, Disk Volume Hours, Max Disk Volume Size
      • by ServerTemplate - The following fields are displayed:  ServerTemplate, Publisher, Instance Size, Server Hours, Servers Launched, Disk Volume Hours, Max Disk Volume Size
      • by Account Group - Account Group, Instance Size, Server Hours, Servers Launched, Disk Volume Hours, Max Disk Volume Size, and Non Usage Record information (shared, but not used)
      • by Account - Owner (organization), Account Group, Instance Size, Server Hours, Servers Launched, Disk Volume Hours, Max DIsk Volume and Non Usage Record information (shared, but not used)
      • NoteUnderlined fields indicate they are sortable.  (Select to sort table output by that field.)

Lineage Metadata

The RightScale Cloud Management Platform can continue to report metering information even when a ServerTemplate is imported from the MultiCloud Marketplace, cloned and customized.  This is beneficial for ISVs who wish to receive income based on continued metering of their ServerTemplate.  This scenario is best explained by an example:

  1. A RightScale partner publishes a new ServerTemplate (A)
  2. A RightScale customer imports, clones and modifies ServerTemplate (A)... it is now ServerTemplate (B)
  3. Some time later the same customer publishes (or republishes) ServerTemplate (B) to their 'other accounts' using the Account Group facility (formerly Sharing Groups)
  4. The customer's 'other accounts' imports ServerTemplate (B), clones and modifies it, etc.

Prior to the November 2010 release in this scenario the lineage would have been broken and the initial publisher would not possess the ability to receive payment for their work. However, now the the lineage is tracked.  Important:  At Step #2 in the above process there is a warning message that makes it very clear the publisher of the original ServerTemplate (A) will continue to track the ServerTemplate's lineage.  In summary, all users can publish things to the MultiCloud Marketplace. If you don't have publishing capabilities for your account then you can only publish publicy, not to Account Groups and hence you can't receive payment for your work. 

Steps

Navigation

  • Navigate to: Reports -> Customer Usage

Select Report Parameter criteria

  • Select the time (year and month) from the drop-down menu
  • Select Overview to display on the screen or Download to save a CSV file
    • If Overview, select by Instance, ServerTemplate, Account Group or Account, depending on the needed report data

Submit the report

  • Select the Submit action button when ready

Post Tutorial Steps

  • If the definition of any fields are unclear use the field information in the Overview section above to help interpret your report
  • Consider running and archiving this report as part of your monthly best practices
You must to post a comment.
Last modified
22:50, 16 May 2013

Tags

Classifications

This page has no classifications.

Announcements

None


© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.