Development on the Cloud

When you have an application or service which is ready to send metering data, you can follow the steps below.

1. Create a Service Instance

In order to create the service you need to run the following commands:

cf marketplace
cf create-service metering standard <myservice>, where <myservice> is the name of your service. The service name has to be unique for your space.
With this step three empty plans will be created.

2. Bind the Service to Your Application

Execute:

cf bind-service <myapp> <myservice>, where <myapp> is the name of your application.

To update your environment and enable your app to access the service instance, execute:

cf restart <myapp>

3. Edit your metering plans in the dashboard

The dashboard shows the metering plan for the resource provider application that is bound to the service instance. The metering plan has a sample Measure and a sample Metric.

Navigate to the metering plan to maintain the Measures and Metrics of the metering plan.
On the Measures tab, the application developer can add/edit/delete the Measures for the metering plan.
On the Metrics tab, the application developer can add/edit/delete the Metrics for the metering plan.
Navigate to a metric to maintain the details of the metric and its relevant functions - meter, accumulate, aggregate, and summarize.

4. Submit Your Usage

In order to submit a usage document, use the insert method, described in the API doc with the URL of the Usage Event Collector. You can see the structure of the data which is to be sent through a Usage Document here. See Submitting Usage.