influxdb.conf 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173
  1. ### Welcome to the InfluxDB configuration file.
  2. # The values in this file override the default values used by the system if a config option is not specified. The commented out lines are the configuration field and the default value used. Uncommenting a line and changing the
  3. # value will change the value used at runtime when the process is restarted. Once every 24 hours InfluxDB will report usage data to usage.influxdata.com The data includes a random ID, os, arch, version, the number of series and
  4. # other usage data. No data from user databases is ever transmitted. Change this option to true to disable reporting. reporting-disabled = false Bind address to use for the RPC service for backup and restore. bind-address =
  5. # "127.0.0.1:8088"
  6. ###
  7. ### [meta]
  8. ###
  9. ### Controls the parameters for the Raft consensus group that stores metadata about the InfluxDB cluster.
  10. ###
  11. [meta]
  12. # Where the metadata/raft database is stored
  13. dir = "/var/lib/influxdb/meta"
  14. # Automatically create a default retention policy when creating a database. retention-autocreate = true If log messages are printed for the meta service logging-enabled = true
  15. ###
  16. ### [data]
  17. ###
  18. ### Controls where the actual shard data for InfluxDB lives and how it is flushed from the WAL. "dir" may need to be changed to a suitable place for your system, but the WAL settings are an advanced configuration. The defaults
  19. ### should work for most systems.
  20. ###
  21. [data]
  22. # The directory where the TSM storage engine stores TSM files.
  23. dir = "/var/lib/influxdb/data"
  24. # The directory where the TSM storage engine stores WAL files.
  25. wal-dir = "/var/lib/influxdb/wal"
  26. # The amount of time that a write will wait before fsyncing. A duration greater than 0 can be used to batch up multiple fsync calls. This is useful for slower disks or when WAL write contention is seen. A value of 0s fsyncs
  27. # every write to the WAL. Values in the range of 0-100ms are recommended for non-SSD disks. wal-fsync-delay = "0s" The type of shard index to use for new shards. The default is an in-memory index that is recreated at startup.
  28. # A value of "tsi1" will use a disk based index that supports higher cardinality datasets. index-version = "inmem" Trace logging provides more verbose output around the tsm engine. Turning this on can provide more useful output
  29. # for debugging tsm engine issues. trace-logging-enabled = false Whether queries should be logged before execution. Very useful for troubleshooting, but will log any sensitive data contained within a query. query-log-enabled =
  30. # true Settings for the TSM engine CacheMaxMemorySize is the maximum size a shard's cache can reach before it starts rejecting writes. Valid size suffixes are k, m, or g (case insensitive, 1024 = 1k). Vaues without a size
  31. # suffix are in bytes. cache-max-memory-size = "1g" CacheSnapshotMemorySize is the size at which the engine will snapshot the cache and write it to a TSM file, freeing up memory Valid size suffixes are k, m, or g (case
  32. # insensitive, 1024 = 1k). Values without a size suffix are in bytes. cache-snapshot-memory-size = "25m" CacheSnapshotWriteColdDuration is the length of time at which the engine will snapshot the cache and write it to a new TSM
  33. # file if the shard hasn't received writes or deletes cache-snapshot-write-cold-duration = "10m" CompactFullWriteColdDuration is the duration at which the engine will compact all TSM files in a shard if it hasn't received a
  34. # write or delete compact-full-write-cold-duration = "4h" The maximum number of concurrent full and level compactions that can run at one time. A value of 0 results in 50% of runtime.GOMAXPROCS(0) used at runtime. Any number
  35. # greater than 0 limits compactions to that value. This setting does not apply to cache snapshotting. max-concurrent-compactions = 0 The maximum series allowed per database before writes are dropped. This limit can prevent
  36. # high cardinality issues at the database level. This limit can be disabled by setting it to 0. max-series-per-database = 1000000 The maximum number of tag values per tag that are allowed before writes are dropped. This limit
  37. # can prevent high cardinality tag values from being written to a measurement. This limit can be disabled by setting it to 0. max-values-per-tag = 100000
  38. ###
  39. ### [coordinator]
  40. ###
  41. ### Controls the clustering service configuration.
  42. ###
  43. [coordinator]
  44. # The default time a write request will wait until a "timeout" error is returned to the caller. write-timeout = "10s" The maximum number of concurrent queries allowed to be executing at one time. If a query is executed and
  45. # exceeds this limit, an error is returned to the caller. This limit can be disabled by setting it to 0. max-concurrent-queries = 0 The maximum time a query will is allowed to execute before being killed by the system. This
  46. # limit can help prevent run away queries. Setting the value to 0 disables the limit. query-timeout = "0s" The time threshold when a query will be logged as a slow query. This limit can be set to help discover slow or
  47. # resource intensive queries. Setting the value to 0 disables the slow query logging. log-queries-after = "0s" The maximum number of points a SELECT can process. A value of 0 will make the maximum point count unlimited. This
  48. # will only be checked every second so queries will not be aborted immediately when hitting the limit. max-select-point = 0 The maximum number of series a SELECT can run. A value of 0 will make the maximum series count
  49. # unlimited. max-select-series = 0 The maxium number of group by time bucket a SELECT can create. A value of zero will max the maximum number of buckets unlimited. max-select-buckets = 0
  50. ###
  51. ### [retention]
  52. ###
  53. ### Controls the enforcement of retention policies for evicting old data.
  54. ###
  55. [retention]
  56. # Determines whether retention policy enforcement enabled. enabled = true The interval of time when retention policy enforcement checks run. check-interval = "30m"
  57. ###
  58. ### [shard-precreation]
  59. ###
  60. ### Controls the precreation of shards, so they are available before data arrives. Only shards that, after creation, will have both a start- and end-time in the future, will ever be created. Shards are never precreated that would
  61. ### be wholly or partially in the past.
  62. [shard-precreation]
  63. # Determines whether shard pre-creation service is enabled. enabled = true The interval of time when the check to pre-create new shards runs. check-interval = "10m" The default period ahead of the endtime of a shard group that
  64. # its successor group is created. advance-period = "30m"
  65. ###
  66. ### Controls the system self-monitoring, statistics and diagnostics.
  67. ###
  68. ### The internal database for monitoring data is created automatically if if it does not already exist. The target retention within this database is called 'monitor' and is also created with a retention period of 7 days and a
  69. ### replication factor of 1, if it does not exist. In all cases the this retention policy is configured as the default for the database.
  70. [monitor]
  71. # Whether to record statistics internally. store-enabled = true The destination database for recorded statistics store-database = "_internal" The interval at which to record statistics store-interval = "10s"
  72. ###
  73. ### [http]
  74. ###
  75. ### Controls how the HTTP endpoints are configured. These are the primary mechanism for getting data into and out of InfluxDB.
  76. ###
  77. [http]
  78. # Determines whether HTTP endpoint is enabled. enabled = true The bind address used by the HTTP service. bind-address = ":8086" Determines whether user authentication is enabled over HTTP/HTTPS. auth-enabled = false The default
  79. # realm sent back when issuing a basic auth challenge. realm = "InfluxDB" Determines whether HTTP request logging is enabled. log-enabled = true When HTTP request logging is enabled, this option specifies the path where log
  80. # entries should be written. If unspecified, the default is to write to stderr, which intermingles HTTP logs with internal InfluxDB logging.
  81. #
  82. # If influxd is unable to access the specified path, it will log an error and fall back to writing the request log to stderr. access-log-path = "" Determines whether detailed write logging is enabled. write-tracing = false
  83. # Determines whether the pprof endpoint is enabled. This endpoint is used for troubleshooting and monitoring. pprof-enabled = true Determines whether HTTPS is enabled. https-enabled = false The SSL certificate to use when
  84. # HTTPS is enabled. https-certificate = "/etc/ssl/influxdb.pem" Use a separate private key location. https-private-key = "" The JWT auth shared secret to validate requests using JSON web tokens. shared-secret = "" The default
  85. # chunk size for result sets that should be chunked. max-row-limit = 0 The maximum number of HTTP connections that may be open at once. New connections that would exceed this limit are dropped. Setting this value to 0
  86. # disables the limit. max-connection-limit = 0 Enable http service over unix domain socket unix-socket-enabled = false The path of the unix domain socket. bind-socket = "/var/run/influxdb.sock" The maximum size of a client
  87. # request body, in bytes. Setting this value to 0 disables the limit. max-body-size = 25000000
  88. ###
  89. ### [ifql]
  90. ###
  91. ### Configures the ifql RPC API.
  92. ###
  93. [ifql]
  94. # Determines whether the RPC service is enabled. enabled = true Determines whether additional logging is enabled. log-enabled = true The bind address used by the ifql RPC service. bind-address = ":8082"
  95. ###
  96. ### [logging]
  97. ###
  98. ### Controls how the logger emits logs to the output.
  99. ###
  100. [logging]
  101. # Determines which log encoder to use for logs. Available options are auto, logfmt, and json. auto will use a more a more user-friendly output format if the output terminal is a TTY, but the format is not as easily
  102. # machine-readable. When the output is a non-TTY, auto will use logfmt. format = "auto" Determines which level of logs will be emitted. The available levels are error, warn, info, and debug. Logs that are equal to or above the
  103. # specified level will be emitted. level = "info" Suppresses the logo output that is printed when the program is started. The logo is always suppressed if STDOUT is not a TTY. suppress-logo = false
  104. ###
  105. ### [subscriber]
  106. ###
  107. ### Controls the subscriptions, which can be used to fork a copy of all data received by the InfluxDB host.
  108. ###
  109. [subscriber]
  110. # Determines whether the subscriber service is enabled. enabled = true The default timeout for HTTP writes to subscribers. http-timeout = "30s" Allows insecure HTTPS connections to subscribers. This is useful when testing with
  111. # self- signed certificates. insecure-skip-verify = false The path to the PEM encoded CA certs file. If the empty string, the default system certs will be used ca-certs = "" The number of writer goroutines processing the write
  112. # channel. write-concurrency = 40 The number of in-flight writes buffered in the write channel. write-buffer-size = 1000
  113. ###
  114. ### [[graphite]]
  115. ###
  116. ### Controls one or many listeners for Graphite data.
  117. ###
  118. [[graphite]]
  119. # Determines whether the graphite endpoint is enabled. enabled = false database = "graphite" retention-policy = "" bind-address = ":2003" protocol = "tcp" consistency-level = "one" These next lines control how batching works.
  120. # You should have this enabled otherwise you could get dropped metrics or poor performance. Batching will buffer points in memory if you have many coming in. Flush if this many points get buffered batch-size = 5000 number of
  121. # batches that may be pending in memory batch-pending = 10 Flush at least this often even if we haven't hit buffer limit batch-timeout = "1s" UDP Read buffer size, 0 means OS default. UDP listener will fail if set above OS max.
  122. # udp-read-buffer = 0
  123. ### This string joins multiple matching 'measurement' values providing more control over the final measurement name.
  124. # separator = "."
  125. ### Default tags that will be added to all metrics. These can be overridden at the template level or by tags extracted from metric
  126. # tags = ["region=us-east", "zone=1c"]
  127. ### Each template line requires a template pattern. It can have an optional filter before the template and separated by spaces. It can also have optional extra tags following the template. Multiple tags should be separated
  128. ### by commas and no spaces similar to the line protocol format. There can be only one default template.
  129. # templates = [
  130. # "*.app env.service.resource.measurement",
  131. # # Default template
  132. # "server.*", ]
  133. ###
  134. ### [collectd]
  135. ###
  136. ### Controls one or many listeners for collectd data.
  137. ###
  138. [[collectd]]
  139. # enabled = false bind-address = ":25826" database = "collectd" retention-policy = ""
  140. #
  141. # The collectd service supports either scanning a directory for multiple types db files, or specifying a single db file. typesdb = "/usr/local/share/collectd"
  142. #
  143. # security-level = "none" auth-file = "/etc/collectd/auth_file" These next lines control how batching works. You should have this enabled otherwise you could get dropped metrics or poor performance. Batching will buffer points
  144. # in memory if you have many coming in. Flush if this many points get buffered batch-size = 5000 Number of batches that may be pending in memory batch-pending = 10 Flush at least this often even if we haven't hit buffer limit
  145. # batch-timeout = "10s" UDP Read buffer size, 0 means OS default. UDP listener will fail if set above OS max. read-buffer = 0 Multi-value plugins can be handled two ways. "split" will parse and store the multi-value plugin data
  146. # into separate measurements "join" will parse and store the multi-value plugin as a single multi-value measurement. "split" is the default behavior for backward compatability with previous versions of influxdb.
  147. # parse-multivalue-plugin = "split"
  148. ###
  149. ### [opentsdb]
  150. ###
  151. ### Controls one or many listeners for OpenTSDB data.
  152. ###
  153. [[opentsdb]]
  154. # enabled = false bind-address = ":4242" database = "opentsdb" retention-policy = "" consistency-level = "one" tls-enabled = false certificate= "/etc/ssl/influxdb.pem" Log an error for every malformed point. log-point-errors =
  155. # true These next lines control how batching works. You should have this enabled otherwise you could get dropped metrics or poor performance. Only points metrics received over the telnet protocol undergo batching. Flush if this
  156. # many points get buffered batch-size = 1000 Number of batches that may be pending in memory batch-pending = 5 Flush at least this often even if we haven't hit buffer limit batch-timeout = "1s"
  157. ###
  158. ### [[udp]]
  159. ###
  160. ### Controls the listeners for InfluxDB line protocol data via UDP.
  161. ###
  162. [[udp]]
  163. # enabled = false bind-address = ":8089" database = "udp" retention-policy = "" These next lines control how batching works. You should have this enabled otherwise you could get dropped metrics or poor performance. Batching
  164. # will buffer points in memory if you have many coming in. Flush if this many points get buffered batch-size = 5000 Number of batches that may be pending in memory batch-pending = 10 Will flush at least this often even if we
  165. # haven't hit buffer limit batch-timeout = "1s" UDP Read buffer size, 0 means OS default. UDP listener will fail if set above OS max. read-buffer = 0
  166. ###
  167. ### [continuous_queries]
  168. ###
  169. ### Controls how continuous queries are run within InfluxDB.
  170. ###
  171. [continuous_queries]
  172. # Determines whether the continuous query service is enabled. enabled = true Controls whether queries are logged when executed by the CQ service. log-enabled = true Controls whether queries are logged to the self-monitoring
  173. # data store. query-stats-enabled = false interval for how often continuous queries will be checked if they need to run run-interval = "1s"