Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Insert excerpt
License
License
nameLicensing Information The feature described in this documentation is optional and might not be part of the edition covered by your company's license.
nopaneltrue

Meters are the customer-specific buckets of usage for the different meter types. When a customer opts for a meter type, then the meter needs to be created with the following parameters:

  • Meter Key (for the Meter processor where the usage data is guided)

  • Meter Type ID (for the meter type the usage should be aggregated for)

  • User ID (for the customer)

Meters can be created, retrieved, updated, and deleted using the API, see API Reference.

...

  • Active from - The meter is active from the date time defined in the Active from field in the meter type. If Active from is set to a time before the time of creating the meter, meter creation time then the meter will be activated as soon as it is created. The time is calculated based on the timezone defined in the meter type when the meter type is created int he in the user interface.

  • Active to - The meter is active to the date time defined in the Active to field on the meter type. The time is calculated based on the timezone defined in the meter type when the meter type is created in the user interface.

  • Unit - The unit defined in the meter type This is the unit in which the metered record value will be counted, such as minutes, days, or number of coffee cups for a coffee service.

  • Aggregation type - The meter’s usage is aggregated according to the aggregation defined in the meter type.

  • Reset schedule - The meter follows the Reset schedule defined in the meter type. The period end of the meter is calculated based on the Reset schedule. The timezone defined in meter type is considered when calculating period start and period end, see Flushing Metered Records.
    When the a meter is first created, the its period start is set to when the time of creating the meter creation in the selected timezone and it . This is shown in the Period start field in the Meter Inspector.

When updating meterr, updating a meter, you can update the parameter “deleteOnReset“ is supported. It has a default value of false, but can be set to either true or false, and false is the default value‘true’ or ‘false’. If you set it to true, the meter will be deleted when the current period ends after sending the metered record to downstream functionssystems.

Note!

A meter can be created anytime dynamically at any time using the API once the meter type and a stream with a Meter processor have been created.

...