Skip to content

SourcesNative

Brian L. Troutwine edited this page Dec 14, 2017 · 2 revisions

The native source is the preferred method for clients which want precise control over the interpretation of their metrics or intend to ship metrics at a high rate. The native source is defined by the native protocol, discussed at length here. There is no interpretive step for the native protocol as it and cernan's internal model are the same. Cernan requires that each encoded payload be sent over TCP. The payload must be length prefixed, the length being an unsigned, network-ordered 32 bit integer. Please see the the above encoding definition for more details.

Configuration

The native source configuration options are as follows:

  • enabled :: whether the source is enabled [default: true]
  • ip :: IP address to bind to [default: 0.0.0.0]
  • port :: the port for the source to listen on [default: 1972]
  • forwards :: the filters and/or sinks to forward into

You may have more than one native source.

The forward concept is described in detail here.

Example

[sources]
  [sources.native.primary]
  ip = "127.0.0.1"
  port = 1972

  [sources.native.primary]
  ip = "127.0.0.1"
  port = 1981