• Home
/
• Working in m3ter - User Guides
/
• Usage Data: Meters

Creating Global Meters

This topic explains how to create Global Meters to collect usage data that you want to use to set up usage-based pricing across multiple Products:

• Any Aggregations that target a Global Meter also become Global and can be used to to price Plans for any Product.

• Global Meters can also be used to collect user data you require to serve other business purposes.

To create a Global Meter:

1. Select Usage>Meters. The Meters page opens and lists Meters by Product for All Products together with any Global Meters.

2. Under Global select Create Meter.

• Alternatively, you can select Create Meter at top-right of the page.

The Create page opens:

• Note: For Product, (Global) is pre-selected.

3. Enter the Meter details:

• Name. Descriptive name for the Meter.

• Code. Unique identifier for the Meter in the m3ter system. You will need this Code as a unique id when submitting API calls, such as a call to update a Meter.

  • Notes:

    • When you've entered a Name and clicked in the Code field, a Code is automatically entered based on the Name. You can then edit the auto-generated Code as required.

    • The Code string has a maximum length of 80 characters and must not contain non-printable or whitespace characters (except space), and cannot start/end with whitespace.

4. Add the Data Fields you need to collect usage data. For example, a field to collect data on the volume of files stored on your service:

• Name. Descriptive name for the field.

• Code. Unique Identifier for field. You will need this Code as a unique id when submitting API calls, such as a call to submit measurements for this field.

  • Notes:

    • When you've entered a Name and clicked in the Code field, a Code is automatically entered based on the Name. You can then edit the auto-generated Code as required.

    • The Code string has a maximum length of 80 characters and can only contain letters, numbers, underscore, and the dollar character, and must not start with a number. The same applies to the Code used for any Derived Fields you add to a Meter - see Step 6 below.

• Category. Defines what type of usage data you want to collect using this field. Select a Measure field type for this example.

• Unit. Defines the unit of measure, which is GiBy for this example

5. Add any required Derived Fields or Custom Fields to the Meter:

• For more on Derived Fields, see the following topic.

• For more on Custom Fields, see Adding and Editing Custom Fields. We strongly recommend reviewing Working with Custom Fields before you create and use Custom Fields.

6. Select Create. The Meter Details page opens:

7. If you want to create an Aggregation that targets one of the Meter's Data Fields or Derived Fields, then select Create Aggregation for that field:

• You are taken directly to the Aggregations>Create page where the Product is pre-selected for (Global) and the Meter and Target field under Meter Settings are also pre-selected.

• When you complete the Aggregations>Create workflow, you are returned to the Meter Details page.

• For more details, see Creating Global Aggregations.

8. If you want to edit a Meter's details, select the Edit button, make your changes, and click Update.

9. If you want to remove a Meter, return to the Meters page and select the Delete button for the Meter:

A confirmation popup opens.

10. Select Yes to confirm the delete action.

Next: Derived Fields for Meters - Examples and Syntax

Additional Support