nsq_consumer

README

NSQ Consumer Input Plugin

The NSQ consumer plugin polls a specified NSQD topic and adds messages to InfluxDB. This plugin allows a message to be in any of the supported data_format types.

Configuration

# Read metrics from NSQD topic(s)
[[inputs.nsq_consumer]]
  ## Server option still works but is deprecated, we just prepend it to the nsqd array.
  # server = "localhost:4150"
  ## An array representing the NSQD TCP HTTP Endpoints
  nsqd = ["localhost:4150"]
  ## An array representing the NSQLookupd HTTP Endpoints
  nsqlookupd = ["localhost:4161"]
  topic = "telegraf"
  channel = "consumer"
  max_in_flight = 100

  ## Data format to consume.
  ## Each data format has its own unique set of configuration options, read
  ## more about them here:
  ## https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_INPUT.md
  data_format = "influx"

Testing

The nsq_consumer_test mocks out the interaction with NSQD. It requires no outside dependencies.

Documentation

Index

• type NSQConsumer
  • func (n *NSQConsumer) Description() string
  • func (n *NSQConsumer) Gather(acc telegraf.Accumulator) error
  • func (n *NSQConsumer) SampleConfig() string
  • func (n *NSQConsumer) SetParser(parser parsers.Parser)
  • func (n *NSQConsumer) Start(acc telegraf.Accumulator) error
  • func (n *NSQConsumer) Stop()

Types

type NSQConsumer

type NSQConsumer struct {
	Server      string
	Nsqd        []string
	Nsqlookupd  []string
	Topic       string
	Channel     string
	MaxInFlight int
	// contains filtered or unexported fields
}

NSQConsumer represents the configuration of the plugin

func (*NSQConsumer) Description

func (n *NSQConsumer) Description() string

Description prints description string

func (*NSQConsumer) Gather

func (n *NSQConsumer) Gather(acc telegraf.Accumulator) error

Gather is a noop

func (*NSQConsumer) SampleConfig

func (n *NSQConsumer) SampleConfig() string

SampleConfig returns config values for generating a sample configuration file

func (*NSQConsumer) SetParser

func (n *NSQConsumer) SetParser(parser parsers.Parser)

SetParser takes the data_format from the config and finds the right parser for that format

func (*NSQConsumer) Start

func (n *NSQConsumer) Start(acc telegraf.Accumulator) error

Start pulls data from nsq

func (*NSQConsumer) Stop

func (n *NSQConsumer) Stop()

Stop processing messages