Working in Meter Details

When you've created a Meter, you can open the Meter details page which is designed to help you perform common Meter management and operational tasks:

Reviewing Meter Details

You can use the Meter details page to review and manage the Meter set up.

To review Meter details:

1. Select Metering. The Meters page opens and lists Meters by Product for All products together with any Global Meters.

2. Search for or filter by Product the Meter you want to review.

3. Select the hotlink text of the Meter:

The Meter details page opens:

On this panel, you can:

  • Read-off the Meter's Name and Code.

  • Use the hotlink text to open directly the details of the Product the Meter belongs to. Note that if you've opened the details of a Global Meter, this will be shown under Product.

  • Read-off the Meter's ID and Copy this to your clipboard.

  • Check the audit data to see who Created and who Last modified the Meter.

  • Review the Data fields that have been added to the Meter. These are listed as two types:

    • Measure data fields.

    • Dimension data fields.

  • Review any Derived fields added to the Meter. Note that you can expand a Derived field to review it's calculation:

  • If you intend to upload a a CSV formatted file for usage data measurements ingest for the Meter, use the Download CSV template button to obtain a file you can use for this purpose. See the following section for further details.

Submitting and Checking Usage Data Measurements

A Submit measurements panel is made available on Meter details pages. This is designed to facilitate the various ways you can submit usage data measurements into the m3ter platform for the specific Meter:

Ingest API

The default selection under Submit measurements is Ingest API:

This option is designed to help you use the Submit measurements call for the m3ter Ingest API:

  • The Submission URL is shown for the call with your Organization ID used, and you can Copy this to your clipboard.

  • Five tabs are available for Meter-specific code samples to use for the call, and you can Copy the version you prefer to use:

    • JSON

    • cURL

    • JavaScript

    • Python

    • Java

  • If you are using this method to submit usage data measurements, please see Getting Started with API Calls for additional guidance.

File Upload API

Under Submit measurements, select File upload API:

This option is designed to help you use the m3ter File Upload Service API to upload a usage data measurements data file to the platform:

  • You can drag and drop a JSON file here containing an array of usage data measurements for ingest.

  • Please review the File Upload Service API topic if you want to use this method.

Upload CSV

Under Submit measurements, select Upload CSV:

This option is designed to help you use upload a CSV formatted file for Meter usage data measurements ingest:

Submit usage data

Under Submit measurements, select Submit usage data:

This option is designed to help you submit individual usage data measurements for the Meter and a selected Account, Timestamp, and optional End Timestamp:

  • You can use a default Simple view and enter values for Meter Data fields or switch to an Advanced format and edit the JSON payload of usage measurements.

  • Please review Submitting Test Usage Data if you want to use this method.

Checking Usage Data Submissions

If you scroll further down the Meter details page, you can use the Activity panel to check usage data measurement submissions made in the past hour for the Meter:

Reviewing Meter Metadata

On the Meter metadata panel on Meter details pages you can review:

Custom fields. Any Custom fields created for the Meter are listed, and you can Copy the String or Number value of a Custom Field to your clipboard:

  • If the fields have been created only at Organizational-level, then these values will be shown:

  • If the fields have also been created for an individual Meter, then the values configured for those created at Organizational-level are struck out indicating clearly that the individual Meter values will be used:

External mappings. Any External mappings set up for the Meter are listed:

  • The external System and Table mapped is shown - such as NetSuite - Item in the above example.

  • The external entity ID mapped to is also shown, and you can Copy this to your clipboard.

  • You can commence the workflow to Create external mapping for the Meter directly - see Creating and Managing External Mappings for Accounts for an example.

Next: Derived Fields for Meters - Examples and Syntax



Additional Support

Login to the Support portal for additional help and to send questions to our Support team.