Difference between revisions of "Computed measurement"

From Senfi Docs
Jump to: navigation, search
Line 11: Line 11:
 
The first thing to do when designing a computed measurement is to decide what are the '''inputs''' and what to '''output'''. A computed measurement can specify multiple measurements as input. Metrics and tags in those measurement will then be available to the function that is responsible for generating the output.
 
The first thing to do when designing a computed measurement is to decide what are the '''inputs''' and what to '''output'''. A computed measurement can specify multiple measurements as input. Metrics and tags in those measurement will then be available to the function that is responsible for generating the output.
  
 +
  ... what are valid inputs ...
 +
  ... what is a valid output ...
  
 
=== Implementation ===
 
=== Implementation ===
Line 17: Line 19:
  
 
=== Testing ===
 
=== Testing ===
 +
  ... how to test ...
 +
  ... limitations of the test environment ...
  
 
=== Execution ===
 
=== Execution ===
 +
  ... describe when the compute function will be run. ...
 +
  ... describe caveats when using multiple measurements - eg. measurement 1 and measurement 2 can come in at different times, and compute will be called twice ...
 +
 +
=== Examples ===
 +
==== Example 1 ====
 +
  ... give a trivial example ...
 +
 +
==== Example 2 ====
 +
  ... give a more complex example ...

Revision as of 15:14, 6 September 2019

This page describes computed measurement in detail.

Overview

As described here, computed measurement is a type of data that is generated from other data sources.

 ... describe in detailed ...
 ... include a diagram to describe the parts that the developer needs to know ...
 ... describe the lifecycle of those parts ...

Design

The first thing to do when designing a computed measurement is to decide what are the inputs and what to output. A computed measurement can specify multiple measurements as input. Metrics and tags in those measurement will then be available to the function that is responsible for generating the output.

  ... what are valid inputs ...
  ... what is a valid output ...

Implementation

 ... describe what functions the developer must override, and what is the expected behaviour of those functions ...
 ... JH feedback that it is unclear that you must output a valid measurement. he thought he has to always output something, like NULL during initial invocation ...

Testing

 ... how to test ...
 ... limitations of the test environment ...

Execution

 ... describe when the compute function will be run. ...
 ... describe caveats when using multiple measurements - eg. measurement 1 and measurement 2 can come in at different times, and compute will be called twice ...

Examples

Example 1

 ... give a trivial example ...

Example 2

 ... give a more complex example ...