Versions Compared

Old Version 1

changes.mady.by.user Jenni Wallin

Saved on

compared with

New Version 2

changes.mady.by.user Jenni Wallin

Saved on

Key

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


Excerpt

The kpi objects describe how metrics are linked to dimensions and threshold levels.

You may configure kpi objects to perform additional calculations based on metrics, e g ratios or sums of ratios.

The following JSON schema describes the data format of the kpi object type:


The kpi object type has the following properties:

PropertyDescription
node

node must contain an array of strings that constitutes a path to a node in a tree object. The first value in the array must match name of a tree object, the subsequent values must match the name of the descendant nodes in the tree object.

immediateAlarm

When immediateAlarm is set to false, exceeded threshold levels will be indicated in a KPIOutput UDR at the end of a period. The UDR field outputType will be set 0. This is the default behavior.

When immediateAlarm is set to true, a KPIOutput UDR with outputType 1 will be generated at the time of detection. Exceeded threshold levels will also be indicated in the output that is generated at the end of the period. Immediate alarm data are sent by Spark to the Kafka topic kpi-alarm.

windowSize

The incoming data is sorted into time periods based on the timestamp value of the KDR UDRs. The KPIs are calculated and generated according to these periods.

windowSize defines the length of the periods in same time unit as the KDR timestamp.

A flooring algorithm is applied to timestamps in order to select the start time of a period:

period start = kdr.timestamp - (kdr.timestamp mod windowSize)

Note
titleNote!

When the value of aggregated-output is false, kpi objects in your service model may have different window sizes. However, when the value of aggregated-output is true, all kpi objects in the model must have the same window size.


threshold

threshold may contain the name of a threshold object.

expr

expr must contain an arithmetic expression based on metric objects. You can use the expression to calculate e g ratios or sums of ratios.

Info
titleExample - Expressions

"Plain" metric:  

"expr": "AvgLength"

Ratio:

"expr": "TotalAttempts/TotalSuccessful"

Sum of Ratios:

"expr": "(Type1Attempts/Type1Successful)+(Type2Attempts/Type2Successful)"

In case of division by zero, the value of the output of the expression will be positive infinity, negative infinity, or NaN (Not a Number) as defined in the JVM specification.


Info
titleExample - JSON Representation


Code Block
languagetext
themeEclipse
"kpi": {
     "Region.AL": {
       "node": [
         "tree1",
         "Region"
       ],
       "windowSize": 60,
       "threshold": "Region.AL",
       "expr": "AvgLength"
     }
 }