V2/Integrate/Others

Implementing a connector

Senfi monitors and stores time series data from your existing systems. At the moment, Senfi provides two methods of receiving data from your systems:

• MQTT interface. See Publish to MQTT.
• Senfi API

Supported Metric Data Types

Senfi supports the following data types

• Float
• Integer
• Boolean
• String

Float

Only valid JSON Number is accepted.

• 0
• 0.1
• 1.0e+10

Invalid examples:

• 1.0.0
• "1.0"

Integer

Only valid JSON Number is accepted. Decimal values are truncated.

• 0
• -15
• 1e10

Invalid examples:

• Same as Float

Boolean

Only JSON Boolean is accepted.

• true
• false

Invalid examples:

• "true"
• "FALSE"
• 0
• "1"

String

Any valid JSON String is accepted.

Publishing Strategy

You can either choose to publish data to Senfi regularly (eg. every second), or only do so upon a change in the metrics. In practice, it is recommended that you publish regularly. This is so that the system is able to tell when data has stopped coming in.

In addition, you can choose to batch the sending of measurements to Senfi. For example, collect 50 measurements and then publish it in a single message. This may be useful if you have fast changing metrics. However, note that tm_source (see Message Format) should represent when the measurement is sampled and not when it is sent.