Custom Input Source

telem.input.custom (func: fun(): { [string]: number })
telem.input.custom (func: fun(): Metric, Metric?, ...)

This adapter wraps a user-provided function for custom input implementations. Need to read a specific file? Query a network of mining turtles? Generate random numbers? Anything is possible!

Usage

Internally, the provided function is wrapped in a MetricCollection constructor, so anything that works with a MetricCollection constructor should work as a return value.

local telem = require 'telem'

local backplane = telem.backplane()
  :addInput('custom_short', telem.input.custom(function ()
    return {
      custom_short_1 = 929,
      custom_short_2 = 424.2
    }
  end))
  :addInput('custom_long', telem.input.custom(function ()
    return
      telem.metric('custom_long_1', 456),
      telem.metric('custom_long_2', 503.123),
      telem.metric({
        name = 'custom_long_detail',
        value = math.random(),
        unit = 'randoms',
        source = 'lua:math.random'
      })
  end))
  :cycleEvery(1)()

This appends the following metrics to the backplane:

Name	Value	Unit	Adapter	Source
custom_short_1	929		custom_short
custom_short_2	424.2		custom_short
custom_long_1	456		custom_long
custom_long_2	503.123		custom_long
custom_long_detail	0.41373943296609	randoms	custom_long	lua:math.random