Created
November 26, 2012 13:43
-
-
Save ajohnstone/4148245 to your computer and use it in GitHub Desktop.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
[cache] | |
# Configure carbon directories. | |
# | |
# OS environment variables can be used to tell carbon where graphite is | |
# installed, where to read configuration from and where to write data. | |
# | |
# GRAPHITE_ROOT - Root directory of the graphite installation. | |
# Defaults to ../ | |
# GRAPHITE_CONF_DIR - Configuration directory (where this file lives). | |
# Defaults to $GRAPHITE_ROOT/conf/ | |
# GRAPHITE_STORAGE_DIR - Storage directory for whipser/rrd/log/pid files. | |
# Defaults to $GRAPHITE_ROOT/storage/ | |
# | |
# To change other directory paths, add settings to this file. The following | |
# configuration variables are available with these default values: | |
# | |
# STORAGE_DIR = $GRAPHITE_STORAGE_DIR | |
# LOCAL_DATA_DIR = STORAGE_DIR/whisper/ | |
# WHITELISTS_DIR = STORAGE_DIR/lists/ | |
# CONF_DIR = STORAGE_DIR/conf/ | |
# LOG_DIR = STORAGE_DIR/log/ | |
# PID_DIR = STORAGE_DIR/ | |
# | |
# For FHS style directory structures, use: | |
# | |
# STORAGE_DIR = /var/lib/carbon/ | |
# CONF_DIR = /etc/carbon/ | |
# LOG_DIR = /var/log/carbon/ | |
# PID_DIR = /var/run/ | |
# | |
#LOCAL_DATA_DIR = /opt/graphite/storage/whisper/ | |
# Specify the user to drop privileges to | |
# If this is blank carbon runs as the user that invokes it | |
# This user must have write access to the local data directory | |
USER = | |
# Limit the size of the cache to avoid swapping or becoming CPU bound. | |
# Sorts and serving cache queries gets more expensive as the cache grows. | |
# Use the value "inf" (infinity) for an unlimited cache size. | |
MAX_CACHE_SIZE = inf | |
# Limits the number of whisper update_many() calls per second, which effectively | |
# means the number of write requests sent to the disk. This is intended to | |
# prevent over-utilizing the disk and thus starving the rest of the system. | |
# When the rate of required updates exceeds this, then carbon's caching will | |
# take effect and increase the overall throughput accordingly. | |
MAX_UPDATES_PER_SECOND = 500 | |
# Softly limits the number of whisper files that get created each minute. | |
# Setting this value low (like at 50) is a good way to ensure your graphite | |
# system will not be adversely impacted when a bunch of new metrics are | |
# sent to it. The trade off is that it will take much longer for those metrics' | |
# database files to all get created and thus longer until the data becomes usable. | |
# Setting this value high (like "inf" for infinity) will cause graphite to create | |
# the files quickly but at the risk of slowing I/O down considerably for a while. | |
MAX_CREATES_PER_MINUTE = 100 | |
LINE_RECEIVER_INTERFACE = 0.0.0.0 | |
LINE_RECEIVER_PORT = 2003 | |
# Set this to True to enable the UDP listener. By default this is off | |
# because it is very common to run multiple carbon daemons and managing | |
# another (rarely used) port for every carbon instance is not fun. | |
ENABLE_UDP_LISTENER = False | |
UDP_RECEIVER_INTERFACE = 0.0.0.0 | |
UDP_RECEIVER_PORT = 2003 | |
PICKLE_RECEIVER_INTERFACE = 0.0.0.0 | |
PICKLE_RECEIVER_PORT = 2004 | |
# Per security concerns outlined in Bug #817247 the pickle receiver | |
# will use a more secure and slightly less efficient unpickler. | |
# Set this to True to revert to the old-fashioned insecure unpickler. | |
USE_INSECURE_UNPICKLER = False | |
CACHE_QUERY_INTERFACE = 0.0.0.0 | |
CACHE_QUERY_PORT = 7002 | |
# Set this to False to drop datapoints received after the cache | |
# reaches MAX_CACHE_SIZE. If this is True (the default) then sockets | |
# over which metrics are received will temporarily stop accepting | |
# data until the cache size falls below 95% MAX_CACHE_SIZE. | |
USE_FLOW_CONTROL = True | |
# By default, carbon-cache will log every whisper update. This can be excessive and | |
# degrade performance if logging on the same volume as the whisper data is stored. | |
LOG_UPDATES = False | |
# On some systems it is desirable for whisper to write synchronously. | |
# Set this option to True if you'd like to try this. Basically it will | |
# shift the onus of buffering writes from the kernel into carbon's cache. | |
WHISPER_AUTOFLUSH = False | |
# By default new Whisper files are created pre-allocated with the data region | |
# filled with zeros to prevent fragmentation and speed up contiguous reads and | |
# writes (which are common). Enabling this option will cause Whisper to create | |
# the file sparsely instead. Enabling this option may allow a large increase of | |
# MAX_CREATES_PER_MINUTE but may have longer term performance implications | |
# depending on the underlying storage configuration. | |
# WHISPER_SPARSE_CREATE = False | |
# Enabling this option will cause Whisper to lock each Whisper file it writes | |
# to with an exclusive lock (LOCK_EX, see: man 2 flock). This is useful when | |
# multiple carbon-cache daemons are writing to the same files | |
WHISPER_LOCK_WRITES = True | |
# Set this to True to enable whitelisting and blacklisting of metrics in | |
# CONF_DIR/whitelist and CONF_DIR/blacklist. If the whitelist is missing or | |
# empty, all metrics will pass through | |
USE_WHITELIST = True | |
# By default, carbon itself will log statistics (such as a count, | |
# metricsReceived) with the top level prefix of 'carbon' at an interval of 60 | |
# seconds. Set CARBON_METRIC_INTERVAL to 0 to disable instrumentation | |
# CARBON_METRIC_PREFIX = carbon | |
# CARBON_METRIC_INTERVAL = 60 | |
# Enable AMQP if you want to receve metrics using an amqp broker | |
# ENABLE_AMQP = False | |
# Verbose means a line will be logged for every metric received | |
# useful for testing | |
# AMQP_VERBOSE = False | |
# AMQP_HOST = localhost | |
# AMQP_PORT = 5672 | |
# AMQP_VHOST = / | |
# AMQP_USER = guest | |
# AMQP_PASSWORD = guest | |
# AMQP_EXCHANGE = graphite | |
# AMQP_METRIC_NAME_IN_BODY = False | |
# The manhole interface allows you to SSH into the carbon daemon | |
# and get a python interpreter. BE CAREFUL WITH THIS! If you do | |
# something like time.sleep() in the interpreter, the whole process | |
# will sleep! This is *extremely* helpful in debugging, assuming | |
# you are familiar with the code. If you are not, please don't | |
# mess with this, you are asking for trouble :) | |
# | |
# ENABLE_MANHOLE = False | |
# MANHOLE_INTERFACE = 127.0.0.1 | |
# MANHOLE_PORT = 7222 | |
# MANHOLE_USER = admin | |
# MANHOLE_PUBLIC_KEY = ssh-rsa AAAAB3NzaC1yc2EAAAABiwAaAIEAoxN0sv/e4eZCPpi3N3KYvyzRaBaMeS2RsOQ/cDuKv11dlNzVeiyc3RFmCv5Rjwn/lQ79y0zyHxw67qLyhQ/kDzINc4cY41ivuQXm2tPmgvexdrBv5nsfEpjs3gLZfJnyvlcVyWK/lId8WUvEWSWHTzsbtmXAF2raJMdgLTbQ8wE= | |
# Patterns for all of the metrics this machine will store. Read more at | |
# http://en.wikipedia.org/wiki/Advanced_Message_Queuing_Protocol#Bindings | |
# | |
# Example: store all sales, linux servers, and utilization metrics | |
# BIND_PATTERNS = sales.#, servers.linux.#, #.utilization | |
# | |
# Example: store everything | |
# BIND_PATTERNS = # | |
# To configure special settings for the carbon-cache instance 'b', uncomment this: | |
[cache:a] | |
LINE_RECEIVER_PORT = 2003 | |
PICKLE_RECEIVER_PORT = 2004 | |
CACHE_QUERY_PORT = 7002 | |
# and any other settings you want to customize, defaults are inherited | |
# from [carbon] section. | |
# You can then specify the --instance=b option to manage this instance | |
# Set this to False to drop datapoints received after the cache | |
# reaches MAX_CACHE_SIZE. If this is True (the default) then sockets | |
# over which metrics are received will temporarily stop accepting | |
# data until the cache size falls below 95% MAX_CACHE_SIZE. | |
USE_FLOW_CONTROL = True | |
# Set this to True to enable whitelisting and blacklisting of metrics in | |
# CONF_DIR/whitelist and CONF_DIR/blacklist. If the whitelist is missing or | |
# empty, all metrics will pass through | |
USE_WHITELIST = True | |
# Enabling this option will cause Whisper to lock each Whisper file it writes | |
# to with an exclusive lock (LOCK_EX, see: man 2 flock). This is useful when | |
# multiple carbon-cache daemons are writing to the same files | |
WHISPER_LOCK_WRITES = True | |
# To configure special settings for the carbon-cache instance 'b', uncomment this: | |
[cache:b] | |
LINE_RECEIVER_PORT = 2103 | |
PICKLE_RECEIVER_PORT = 2104 | |
CACHE_QUERY_PORT = 7102 | |
# and any other settings you want to customize, defaults are inherited | |
# from [carbon] section. | |
# You can then specify the --instance=b option to manage this instance | |
# Set this to False to drop datapoints received after the cache | |
# reaches MAX_CACHE_SIZE. If this is True (the default) then sockets | |
# over which metrics are received will temporarily stop accepting | |
# data until the cache size falls below 95% MAX_CACHE_SIZE. | |
USE_FLOW_CONTROL = True | |
# Set this to True to enable whitelisting and blacklisting of metrics in | |
# CONF_DIR/whitelist and CONF_DIR/blacklist. If the whitelist is missing or | |
# empty, all metrics will pass through | |
USE_WHITELIST = True | |
# Enabling this option will cause Whisper to lock each Whisper file it writes | |
# to with an exclusive lock (LOCK_EX, see: man 2 flock). This is useful when | |
# multiple carbon-cache daemons are writing to the same files | |
WHISPER_LOCK_WRITES = True | |
# To configure special settings for the carbon-cache instance 'b', uncomment this: | |
[cache:c] | |
LINE_RECEIVER_PORT = 2203 | |
PICKLE_RECEIVER_PORT = 2204 | |
CACHE_QUERY_PORT = 7202 | |
# and any other settings you want to customize, defaults are inherited | |
# from [carbon] section. | |
# You can then specify the --instance=c option to manage this instance | |
# Set this to False to drop datapoints received after the cache | |
# reaches MAX_CACHE_SIZE. If this is True (the default) then sockets | |
# over which metrics are received will temporarily stop accepting | |
# data until the cache size falls below 95% MAX_CACHE_SIZE. | |
USE_FLOW_CONTROL = True | |
# Set this to True to enable whitelisting and blacklisting of metrics in | |
# CONF_DIR/whitelist and CONF_DIR/blacklist. If the whitelist is missing or | |
# empty, all metrics will pass through | |
USE_WHITELIST = True | |
# Enabling this option will cause Whisper to lock each Whisper file it writes | |
# to with an exclusive lock (LOCK_EX, see: man 2 flock). This is useful when | |
# multiple carbon-cache daemons are writing to the same files | |
WHISPER_LOCK_WRITES = True |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment