Skip to content

Latest commit

 

History

History
96 lines (80 loc) · 2.77 KB

README.md

File metadata and controls

96 lines (80 loc) · 2.77 KB

Module graphite

This module installs and makes basic configs for graphite, with carbon and whisper.

Tested on

RHEL/CentOS 6+
Debian 6+
Ubunutu 10.04 and newer

Requirements

Configure conf files as you need:

templates/opt/graphite/conf/storage-schemas.conf.erb
templates/opt/graphite/webapp/graphite/local_settings.py.erb

Parameters

The descriptions are short and their are more variables to tweak your graphite if needed. For further information take a look at the file templates/opt/graphite/conf/carbon.conf.erb

ParameterDefaultDescription
gr_user its empty The user who runs graphite. If this is empty carbon runs as the user that invokes it.
gr_max_cache_sizeinfLimit the size of the cache to avoid swapping or becoming CPU bound. Use the value "inf" (infinity) for an unlimited cache size.
gr_max_updates_per_second500Limits the number of whisper update_many() calls per second, which effectively means the number of write requests sent to the disk.
gr_max_creates_per_minute50Softly limits the number of whisper files that get created each minute.
gr_line_receiver_interface0.0.0.0Interface the line receiver listens
gr_line_receiver_port2003Port of line receiver
gr_enable_udp_listenerFalseSet this to True to enable the UDP listener.
gr_udp_receiver_interface0.0.0.0Its clear, isnt it?
gr_udp_receiver_port2003Self explaining
gr_pickle_receiver_interface0.0.0.0Pickle is a special receiver who handle tuples of data.
gr_pickle_receiver_port2004Self explaining
gr_use_insecure_unpicklerFalseSet this to True to revert to the old-fashioned insecure unpickler.
gr_cache_query_interface0.0.0.0Interface to send cache queries to.
gr_cache_query_port7002Self explaining.

Sample usage:

Out of the box graphite installation

node "graphite.my.domain" {
	include graphite
}

Tuned graphite installation

# This carbon cache will accept TCP and UDP datas and
# the cachesize is limited to 256mb
node "graphite.my.domain" {
	class {'graphite':
		gr_max_cache_size => 256,
		gr_enable_udp_listener => True
	}
}

Author

written by Daniel Werdermann dwerdermann@web.de