Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

When you double-click the Meter processor function, the Meter dialog opens. This dialog consists of three different parts;

  • The Configuration tab, where you configure the processor

  • The Inspect tab where you can see details about the meter types and meters associated with the Meter processor along with their current values, see Inspect Meter Types and Meters

  • A preview section showing what the input and output data looks like.

Meter-processor-config.png

In the Meter key field above the settings in the Configuration tab, an automatically created Meter key will be displayed. This key is unique for each Meter processor, and is one of the parameters used when creating meters using the APIs, see API Reference, and next to the field is a copy.png Copy button that you can use to copy the key when creating meters.

Note!

If you import a stream with a Meter processor which is a duplicate of an existing stream, a new Meter key willl be generated to ensure they are unique.

The Configuration tab contains the following settings:

Guiding Rules

The Meter Processor must have at least one guiding rule configured. You can add additional guiding rules by clicking the add-guiding-rule button at the bottom of the configuration screen. The maximum number of guiding rules is 10. Each guiding rule contains the following settings.

Setting

Description

Guiding rule

Name

Enter an intuitive name for the guiding rule in this field.

Condition setting

Select if you want to define customized conditions for the rule or not by selecting either No conditon or Custom condition.

If you select No condition, nothing more is required, but if you select Custom condition, a new section called Condition n will appear that you can expand and enter any conditions you want to be met for the usage to be counted:

condition2.png

Each condition is configured with three settings:

  • Field - In this drop-down-list you select a field in the usage data that you want to base the counting on. You can either select an existing field or create a new field by entering a new field in the Add Field field and clicking on the + button.

  • Type of field - Select the field type in this drop-down-list; string, number, or boolean

  • Value - Enter the field value that you want to be matched for usage counting.

For example:

Field: location
Type: string
Value: Bahamas

The name of the condition will now be converted to show your configuration which will make it easier to see the configured condition even after collapsing it.

You can configure additional conditions by clicking on the add-condition.png button at the bottom of this section. If you have more than one condition, you can select to have either AND as a separator or OR, but not a combination of the two.

Category to match

Select which category you want to count usage for in this drop-down.

The Meter Processor is referring to categories instead of individual Meter Types which provides you with the possibility to add, remove, or update Meter Types whithout having to update the configuration of the Meter Processor.

All existing categories configured in Meter Types will be displayed, see Creating Meter Types.

Group by

Group by n

If you want to group the usage based on a specific field, for example region, click on the Group by n drop-down.

group-by.png

In this drop-down-list you can select the field(s) you want to group the usage by. You can either select an existing field or create a new field by entering a new field in the Add Field field and clicking on the + button. The maximum number of fields you can add for each Group by n section is 5.

You can enter several Group by n sections by clicking on the Add group by button. The maximum number of Group by n sections is 5.

Other operations

If you want to perform other operations, you can click on the Add operation button to display a section for defining operations that you want to be made:

operations.png

Operation

Select which type of operation you want to perform:

  • Carry first - Will pick the value of the stated field from the first record where it occurs.

  • Carry last - Will pick the value of the stated field from the last record where it occurs.

Field

Select the field you want to perform the Carry first or Carry last operation on.

You can either select an existing field or create a new field by entering a new field in the Add Field field and clicking on the + button.

Flush By

The Flush by setting determines when flush happens, that is when the aggregated output data records are sent to downstream systems. You have two options;

  • Period end - If you select this option, all meters will be flushed according to the Reset schedule defined for each meter type, see Creating Meter Types.
    If the meters are flushed by Period end, the periodStart is initially set to the creation time of each meter, and the periodEnd is calculated based on the Reset schedule of the respective meter type.

    To move the meters to their next period when meters are flushed, the periodEnd becomes the new periodStart, and a new periodEnd is calculated based on the meter type Reset schedule.

  • Stream execution - If you select this option, all meters will be flushed and reset at the end of stream execution, see Execution of Usage Metering Streams for further information about stream execution considerations.
    If the meters are flushed by Stream execution, the periodEnd of the flushed meter is set to the time of the flush. The periodStart of the meter in the stream is also set to the time of the flush, and the periodEnd is calculated using the meter type Reset schedule.

Preview

Click on the preview.png to see a preview of the Input and Output data in the left part of the Meter dialog.

You can select to view the data in the following formats:

  • Input data: Table, tree

  • Output data: Table, tree, log

  • No labels