fireboard

README

Fireboard Input Plugin

The fireboard plugin gathers the real time temperature data from fireboard thermometers. In order to use this input plugin, you'll need to sign up to use the Fireboard REST API.

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

# Read real time temps from fireboard.io servers
[[inputs.fireboard]]
  ## Specify auth token for your account
  auth_token = "invalidAuthToken"
  ## You can override the fireboard server URL if necessary
  # url = https://fireboard.io/api/v1/devices.json
  ## You can set a different http_timeout if you need to
  ## You should set a string using an number and time indicator
  ## for example "12s" for 12 seconds.
  # http_timeout = "4s"

auth_token

In lieu of requiring a username and password, this plugin requires an authentication token that you can generate using the Fireboard REST API.

url

While there should be no reason to override the URL, the option is available in case Fireboard changes their site, etc.

http_timeout

If you need to increase the HTTP timeout, you can do so here. You can set this value in seconds. The default value is four (4) seconds.

Metrics

The Fireboard REST API docs have good examples of the data that is available, currently this input only returns the real time temperatures. Temperature values are included if they are less than a minute old.

• fireboard
  • tags:
    • channel
    • scale (Celcius; Fahrenheit)
    • title (name of the Fireboard)
    • uuid (UUID of the Fireboard)
  • fields:
    • temperature (float, unit)

Example Output

This section shows example output in Line Protocol format. You can often use telegraf --input-filter <plugin-name> --test or use the file output to get this information.

fireboard,channel=2,host=patas-mbp,scale=Fahrenheit,title=telegraf-FireBoard,uuid=b55e766c-b308-49b5-93a4-df89fe31efd0 temperature=78.2 1561690040000000000

Documentation

Index

• type Fireboard
  • func NewFireboard() *Fireboard
  • func (r *Fireboard) Gather(acc telegraf.Accumulator) error
  • func (r *Fireboard) Init() error
  • func (*Fireboard) SampleConfig() string
• type RTT

Types

type Fireboard

type Fireboard struct {
	AuthToken   string          `toml:"auth_token"`
	URL         string          `toml:"url"`
	HTTPTimeout config.Duration `toml:"http_timeout"`
	// contains filtered or unexported fields
}

Fireboard gathers statistics from the fireboard.io servers

func NewFireboard

func NewFireboard() *Fireboard

NewFireboard return a new instance of Fireboard with a default http client

func (*Fireboard) Gather

func (r *Fireboard) Gather(acc telegraf.Accumulator) error

Gather Reads stats from all configured servers.

func (*Fireboard) Init

func (r *Fireboard) Init() error

Init the things

func (*Fireboard) SampleConfig

func (*Fireboard) SampleConfig() string

type RTT

type RTT struct {
	Temp       float64 `json:"temp"`
	Channel    int64   `json:"channel"`
	Degreetype int     `json:"degreetype"`
	Created    string  `json:"created"`
}

RTT fireboardStats represents the data that is received from Fireboard