rabbitmq

README

RabbitMQ Input Plugin

Reads metrics from RabbitMQ servers via the Management Plugin.

For additional details reference the RabbitMQ Management HTTP Stats.

Configuration:

[[inputs.rabbitmq]]
  ## Management Plugin url. (default: http://localhost:15672)
  # url = "http://localhost:15672"
  ## Tag added to rabbitmq_overview series; deprecated: use tags
  # name = "rmq-server-1"
  ## Credentials
  # username = "guest"
  # password = "guest"

  ## Optional SSL Config
  # ssl_ca = "/etc/telegraf/ca.pem"
  # ssl_cert = "/etc/telegraf/cert.pem"
  # ssl_key = "/etc/telegraf/key.pem"
  ## Use SSL but skip chain & host verification
  # insecure_skip_verify = false

  ## Optional request timeouts
  ##
  ## ResponseHeaderTimeout, if non-zero, specifies the amount of time to wait
  ## for a server's response headers after fully writing the request.
  # header_timeout = "3s"
  ##
  ## client_timeout specifies a time limit for requests made by this client.
  ## Includes connection time, any redirects, and reading the response body.
  # client_timeout = "4s"

  ## A list of nodes to gather as the rabbitmq_node measurement. If not
  ## specified, metrics for all nodes are gathered.
  # nodes = ["rabbit@node1", "rabbit@node2"]

  ## A list of queues to gather as the rabbitmq_queue measurement. If not
  ## specified, metrics for all queues are gathered.
  # queues = ["telegraf"]

  ## A list of exchanges to gather as the rabbitmq_exchange measurement. If not
  ## specified, metrics for all exchanges are gathered.
  # exchanges = ["telegraf"]

  ## Queues to include and exclude. Globs accepted.
  ## Note that an empty array for both will include all queues
  # queue_name_include = []
  # queue_name_exclude = []

Measurements & Fields:

• rabbitmq_overview

  • channels (int, channels)
  • connections (int, connections)
  • consumers (int, consumers)
  • exchanges (int, exchanges)
  • messages (int, messages)
  • messages_acked (int, messages)
  • messages_delivered (int, messages)
  • messages_delivered_get (int, messages)
  • messages_published (int, messages)
  • messages_ready (int, messages)
  • messages_unacked (int, messages)
  • queues (int, queues)
  • clustering_listeners (int, cluster nodes)
  • amqp_listeners (int, amqp nodes up)

• rabbitmq_node

  • disk_free (int, bytes)
  • disk_free_limit (int, bytes)
  • fd_total (int, file descriptors)
  • fd_used (int, file descriptors)
  • mem_limit (int, bytes)
  • mem_used (int, bytes)
  • proc_total (int, erlang processes)
  • proc_used (int, erlang processes)
  • run_queue (int, erlang processes)
  • sockets_total (int, sockets)
  • sockets_used (int, sockets)
  • running (int, node up)

• rabbitmq_queue

  • consumer_utilisation (float, percent)
  • consumers (int, int)
  • idle_since (string, time - e.g., "2006-01-02 15:04:05")
  • memory (int, bytes)
  • message_bytes (int, bytes)
  • message_bytes_persist (int, bytes)
  • message_bytes_ram (int, bytes)
  • message_bytes_ready (int, bytes)
  • message_bytes_unacked (int, bytes)
  • messages (int, count)
  • messages_ack (int, count)
  • messages_ack_rate (float, messages per second)
  • messages_deliver (int, count)
  • messages_deliver_rate (float, messages per second)
  • messages_deliver_get (int, count)
  • messages_deliver_get_rate (float, messages per second)
  • messages_publish (int, count)
  • messages_publish_rate (float, messages per second)
  • messages_ready (int, count)
  • messages_redeliver (int, count)
  • messages_redeliver_rate (float, messages per second)
  • messages_unack (integer, count)

• rabbitmq_exchange

  • messages_publish_in (int, count)
  • messages_publish_out (int, count)

Tags:

• All measurements have the following tags:

  • url

• rabbitmq_overview

  • name

• rabbitmq_node

  • node

• rabbitmq_queue

  • url
  • queue
  • vhost
  • node
  • durable
  • auto_delete

• rabbitmq_exchange

  • url
  • exchange
  • type
  • vhost
  • internal
  • durable
  • auto_delete

Sample Queries:

Message rates for the entire node can be calculated from total message counts. For instance, to get the rate of messages published per minute, use this query:

SELECT NON_NEGATIVE_DERIVATIVE(LAST("messages_published"), 1m) AS messages_published_rate
FROM rabbitmq_overview WHERE time > now() - 10m GROUP BY time(1m)

Example Output:

rabbitmq_queue,url=http://amqp.example.org:15672,queue=telegraf,vhost=influxdb,node=rabbit@amqp.example.org,durable=true,auto_delete=false,host=amqp.example.org messages_deliver_get=0i,messages_publish=329i,messages_publish_rate=0.2,messages_redeliver_rate=0,message_bytes_ready=0i,message_bytes_unacked=0i,messages_deliver=329i,messages_unack=0i,consumers=1i,idle_since="",messages=0i,messages_deliver_rate=0.2,messages_deliver_get_rate=0.2,messages_redeliver=0i,memory=43032i,message_bytes_ram=0i,messages_ack=329i,messages_ready=0i,messages_ack_rate=0.2,consumer_utilisation=1,message_bytes=0i,message_bytes_persist=0i 1493684035000000000
rabbitmq_overview,url=http://amqp.example.org:15672,host=amqp.example.org channels=2i,consumers=1i,exchanges=17i,messages_acked=329i,messages=0i,messages_ready=0i,messages_unacked=0i,connections=2i,queues=1i,messages_delivered=329i,messages_published=329i,clustering_listeners=2i,amqp_listeners=1i 1493684035000000000
rabbitmq_node,url=http://amqp.example.org:15672,node=rabbit@amqp.example.org,host=amqp.example.org fd_total=1024i,fd_used=32i,mem_limit=8363329126i,sockets_total=829i,disk_free=8175935488i,disk_free_limit=50000000i,mem_used=58771080i,proc_total=1048576i,proc_used=267i,run_queue=0i,sockets_used=2i,running=1i 149368403500000000
rabbitmq_exchange,url=http://amqp.example.org:15672,exchange=telegraf,type=fanout,vhost=influxdb,internal=false,durable=true,auto_delete=false,host=amqp.example.org messages_publish_in=2i,messages_publish_out=1i 149368403500000000

Documentation

Index

• Constants
• type Details
• type Exchange
• type Listeners
• type MessageStats
• type Node
• type ObjectTotals
• type OverviewResponse
• type Queue
• type QueueTotals
• type RabbitMQ
  • func (r *RabbitMQ) Description() string
  • func (r *RabbitMQ) Gather(acc tinymonitor.Accumulator) error
  • func (r *RabbitMQ) SampleConfig() string

Constants

const DefaultClientTimeout = 4

const DefaultPassword = "guest"

DefaultPassword will set a default value that corrasponds to the default value used by Rabbitmq

const DefaultResponseHeaderTimeout = 3

Default http timeouts

const DefaultURL = "http://localhost:15672"

DefaultURL will set a default value that corrasponds to the default value used by Rabbitmq

const DefaultUsername = "guest"

DefaultUsername will set a default value that corrasponds to the default value used by Rabbitmq

Types

type Details

type Details struct {
	Rate float64
}

Details ...

type Exchange

type Exchange struct {
	Name         string
	MessageStats `json:"message_stats"`
	Type         string
	Internal     bool
	Vhost        string
	Durable      bool
	AutoDelete   bool `json:"auto_delete"`
}

type Listeners

type Listeners struct {
	Protocol string `json:"protocol"`
}

Listeners ...

type MessageStats

type MessageStats struct {
	Ack               int64
	AckDetails        Details `json:"ack_details"`
	Deliver           int64
	DeliverDetails    Details `json:"deliver_details"`
	DeliverGet        int64   `json:"deliver_get"`
	DeliverGetDetails Details `json:"deliver_get_details"`
	Publish           int64
	PublishDetails    Details `json:"publish_details"`
	Redeliver         int64
	RedeliverDetails  Details `json:"redeliver_details"`
	PublishIn         int64   `json:"publish_in"`
	PublishOut        int64   `json:"publish_out"`
}

MessageStats ...

type Node

type Node struct {
	Name string

	DiskFree      int64 `json:"disk_free"`
	DiskFreeLimit int64 `json:"disk_free_limit"`
	FdTotal       int64 `json:"fd_total"`
	FdUsed        int64 `json:"fd_used"`
	MemLimit      int64 `json:"mem_limit"`
	MemUsed       int64 `json:"mem_used"`
	ProcTotal     int64 `json:"proc_total"`
	ProcUsed      int64 `json:"proc_used"`
	RunQueue      int64 `json:"run_queue"`
	SocketsTotal  int64 `json:"sockets_total"`
	SocketsUsed   int64 `json:"sockets_used"`
	Running       bool  `json:"running"`
}

Node ...

type ObjectTotals

type ObjectTotals struct {
	Channels    int64
	Connections int64
	Consumers   int64
	Exchanges   int64
	Queues      int64
}

ObjectTotals ...

type OverviewResponse

type OverviewResponse struct {
	MessageStats *MessageStats `json:"message_stats"`
	ObjectTotals *ObjectTotals `json:"object_totals"`
	QueueTotals  *QueueTotals  `json:"queue_totals"`
	Listeners    []Listeners   `json:"listeners"`
}

OverviewResponse ...

type Queue

type Queue struct {
	QueueTotals         // just to not repeat the same code
	MessageStats        `json:"message_stats"`
	Memory              int64
	Consumers           int64
	ConsumerUtilisation float64 `json:"consumer_utilisation"`
	Name                string
	Node                string
	Vhost               string
	Durable             bool
	AutoDelete          bool   `json:"auto_delete"`
	IdleSince           string `json:"idle_since"`
}

Queue ...

type QueueTotals

type QueueTotals struct {
	Messages                   int64
	MessagesReady              int64 `json:"messages_ready"`
	MessagesUnacknowledged     int64 `json:"messages_unacknowledged"`
	MessageBytes               int64 `json:"message_bytes"`
	MessageBytesReady          int64 `json:"message_bytes_ready"`
	MessageBytesUnacknowledged int64 `json:"message_bytes_unacknowledged"`
	MessageRAM                 int64 `json:"message_bytes_ram"`
	MessagePersistent          int64 `json:"message_bytes_persistent"`
}

QueueTotals ...

type RabbitMQ

type RabbitMQ struct {
	URL      string
	Name     string
	Username string
	Password string
	// Path to CA file
	SSLCA string `toml:"ssl_ca"`
	// Path to host cert file
	SSLCert string `toml:"ssl_cert"`
	// Path to cert key file
	SSLKey string `toml:"ssl_key"`
	// Use SSL but skip chain & host verification
	InsecureSkipVerify bool

	ResponseHeaderTimeout itscripts.Duration `toml:"header_timeout"`
	ClientTimeout         itscripts.Duration `toml:"client_timeout"`

	Nodes     []string
	Queues    []string
	Exchanges []string

	QueueInclude []string `toml:"queue_name_include"`
	QueueExclude []string `toml:"queue_name_exclude"`

	Client *http.Client
	// contains filtered or unexported fields
}

RabbitMQ defines the configuration necessary for gathering metrics, see the sample config for further details

func (*RabbitMQ) Description

func (r *RabbitMQ) Description() string

Description ...

func (*RabbitMQ) Gather

func (r *RabbitMQ) Gather(acc tinymonitor.Accumulator) error

Gather ...

func (*RabbitMQ) SampleConfig

func (r *RabbitMQ) SampleConfig() string

SampleConfig ...