telegraf/plugins/outputs/mqtt
Paweł Kraszewski 0084138bc6 Add option to set retain flag on messages in mqtt output (#4892) 2019-02-11 17:22:31 -08:00
..
README.md Add option to set retain flag on messages in mqtt output (#4892) 2019-02-11 17:22:31 -08:00
mqtt.go Add option to set retain flag on messages in mqtt output (#4892) 2019-02-11 17:22:31 -08:00
mqtt_test.go Add Serializer plugins, and 'file' output plugin 2016-02-12 14:13:49 -07:00

README.md

MQTT Producer Output Plugin

This plugin writes to a MQTT Broker acting as a mqtt Producer.

[[outputs.mqtt]]
  ## URLs of mqtt brokers
  servers = ["localhost:1883"]

  ## topic for producer messages
  topic_prefix = "telegraf"

  ## QoS policy for messages
  ##   0 = at most once
  ##   1 = at least once
  ##   2 = exactly once
  qos = 2

  ## username and password to connect MQTT server.
  # username = "telegraf"
  # password = "metricsmetricsmetricsmetrics"

  ## client ID, if not set a random ID is generated
  # client_id = ""

  ## Timeout for write operations. default: 5s
  # timeout = "5s"

  ## Optional TLS Config
  # tls_ca = "/etc/telegraf/ca.pem"
  # tls_cert = "/etc/telegraf/cert.pem"
  # tls_key = "/etc/telegraf/key.pem"
  ## Use TLS but skip chain & host verification
  # insecure_skip_verify = false
  
  ## When true, metrics will be sent in one MQTT message per flush.  Otherwise,
  ## metrics are written one metric per MQTT message.
  # batch = false
  
  ## When true, metric will have RETAIN flag set, making broker cache entries until someone
  ## actually reads it
  # retain = flase

  ## Data format to output.
  # data_format = "influx"

Required parameters:

  • servers: List of strings, this is for speaking to a cluster of mqtt brokers. On each flush interval, Telegraf will randomly choose one of the urls to write to. Each URL should just include host and port e.g. -> ["{host}:{port}","{host2}:{port2}"]
  • topic_prefix: The mqtt topic prefix to publish to. MQTT outputs send metrics to this topic format "<topic_prefix>///" ( ex: prefix/web01.example.com/mem)
  • qos: The mqtt QoS policy for sending messages. See https://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.0.0/com.ibm.mq.dev.doc/q029090_.htm for details.

Optional parameters:

  • username: The username to connect MQTT server.
  • password: The password to connect MQTT server.
  • client_id: The unique client id to connect MQTT server. If this paramater is not set then a random ID is generated.
  • timeout: Timeout for write operations. default: 5s
  • tls_ca: TLS CA
  • tls_cert: TLS CERT
  • tls_key: TLS key
  • insecure_skip_verify: Use TLS but skip chain & host verification (default: false)
  • retain: Set retain flag when publishing, instructing server to cache metric until someone reads it (default: false)
  • data_format: About Telegraf data formats