Ceilometer/blueprints/api-v2-improvements

There are a lot of new requests for api features/extensions, so thought it might make sense to put the combined use cases here:

References

• https://wiki.openstack.org/wiki/Ceilometer/blueprints/APIv2
• https://blueprints.launchpad.net/ceilometer/+spec/api-v2-improvement
• https://blueprints.launchpad.net/ceilometer/+spec/meter-post-api
• https://wiki.openstack.org/wiki/Ceilometer/blueprints/api-group-by

Currently supported

1. List the resources (filter by any field)
2. List the available meters (filter by any field)
3. List the Samples (filter by any field)
4. Get Statistics (filter by any field) [max, min, avg, count, total]

From https://blueprints.launchpad.net/ceilometer/+spec/api-v2-improvement

• Give me the maximum usage of a resource that lasted more than 1h
• Give me the use of a resource over a period of time, listing changes by increment of X volume over a period of Y time
• Provide a GROUP BY function
• Provide additional statistical function (Deviation, Median, Variation, Distribution, Slope, etc...) which could be given as multiple results for a given data set collection

From https://wiki.openstack.org/wiki/Ceilometer/blueprints/Ceilometer-api-extensions

Usage Reporting is our primary use case for the proposed API extensions. We would like to use an implementation of the Ceilometer API as the front end for our reporting service. The following requests illustrate the need for this functionality:

• End Customer Usage Reporting
  • Ability to see a summary of my month-to-date (MTD) usage on a Dashboard - this would include one summary per Region with MTD totals for one or more usage metrics for each service
  • Ability to see a graphical and/or tabular summary of my usage per service for a specified month - I can specifiy the interval that the data is displayed at (i.e. per week, day, hour).
  • Ability to further drill down into the usage report to see reports by
    • service characteristics (i.e. compute flavor, application type, operating system type, volume type, ...)
    • location (region and availability zone)
    • instance level (specific instance for the service, i.e. VM, volume, storage container, ...)
• Internal Provider Reporting
  • Ability to generate a monthly report of service usage (all usage by service plus drill down by service and customer characteristics)
  • Ability to generate licensing related reports (number of nodes, VM, tenants running a specified operating system or application type)

From https://wiki.openstack.org/wiki/Ceilometer/blueprints/api-group-by

• I had an instance running for 6h. It started as a m1.tiny flavor during the first 2 hours and then grew up to a m1.large flavor for the next 4 hours. I need to get this two durations so I can bill them with different rates.

From https://blueprints.launchpad.net/ceilometer/+spec/meter-post-api

• Some systems need to send samples to Ceilometer via a REST API.