1### Welcome to the InfluxDB configuration file. 2 3# The values in this file override the default values used by the system if 4# a config option is not specified. The commented out lines are the configuration 5# field and the default value used. Uncommenting a line and changing the value 6# will change the value used at runtime when the process is restarted. 7 8# Once every 24 hours InfluxDB will report usage data to usage.influxdata.com 9# The data includes a random ID, os, arch, version, the number of series and other 10# usage data. No data from user databases is ever transmitted. 11# Change this option to true to disable reporting. 12# reporting-disabled = false 13 14# Bind address to use for the RPC service for backup and restore. 15# bind-address = "127.0.0.1:8088" 16 17### 18### [meta] 19### 20### Controls the parameters for the Raft consensus group that stores metadata 21### about the InfluxDB cluster. 22### 23 24[meta] 25 # Where the metadata/raft database is stored 26 dir = "/var/lib/influxdb/meta" 27 28 # Automatically create a default retention policy when creating a database. 29 # retention-autocreate = true 30 31 # If log messages are printed for the meta service 32 # logging-enabled = true 33 34### 35### [data] 36### 37### Controls where the actual shard data for InfluxDB lives and how it is 38### flushed from the WAL. "dir" may need to be changed to a suitable place 39### for your system, but the WAL settings are an advanced configuration. The 40### defaults should work for most systems. 41### 42 43[data] 44 # The directory where the TSM storage engine stores TSM files. 45 dir = "/var/lib/influxdb/data" 46 47 # The directory where the TSM storage engine stores WAL files. 48 wal-dir = "/var/lib/influxdb/wal" 49 50 # The amount of time that a write will wait before fsyncing. A duration 51 # greater than 0 can be used to batch up multiple fsync calls. This is useful for slower 52 # disks or when WAL write contention is seen. A value of 0s fsyncs every write to the WAL. 53 # Values in the range of 0-100ms are recommended for non-SSD disks. 54 # wal-fsync-delay = "0s" 55 56 57 # The type of shard index to use for new shards. The default is an in-memory index that is 58 # recreated at startup. A value of "tsi1" will use a disk based index that supports higher 59 # cardinality datasets. 60 # index-version = "inmem" 61 62 # Trace logging provides more verbose output around the tsm engine. Turning 63 # this on can provide more useful output for debugging tsm engine issues. 64 # trace-logging-enabled = false 65 66 # Whether queries should be logged before execution. Very useful for troubleshooting, but will 67 # log any sensitive data contained within a query. 68 # query-log-enabled = true 69 70 # Validates incoming writes to ensure keys only have valid unicode characters. 71 # This setting will incur a small overhead because every key must be checked. 72 # validate-keys = false 73 74 # Settings for the TSM engine 75 76 # CacheMaxMemorySize is the maximum size a shard's cache can 77 # reach before it starts rejecting writes. 78 # Valid size suffixes are k, m, or g (case insensitive, 1024 = 1k). 79 # Values without a size suffix are in bytes. 80 # cache-max-memory-size = "1g" 81 82 # CacheSnapshotMemorySize is the size at which the engine will 83 # snapshot the cache and write it to a TSM file, freeing up memory 84 # Valid size suffixes are k, m, or g (case insensitive, 1024 = 1k). 85 # Values without a size suffix are in bytes. 86 # cache-snapshot-memory-size = "25m" 87 88 # CacheSnapshotWriteColdDuration is the length of time at 89 # which the engine will snapshot the cache and write it to 90 # a new TSM file if the shard hasn't received writes or deletes 91 # cache-snapshot-write-cold-duration = "10m" 92 93 # CompactFullWriteColdDuration is the duration at which the engine 94 # will compact all TSM files in a shard if it hasn't received a 95 # write or delete 96 # compact-full-write-cold-duration = "4h" 97 98 # The maximum number of concurrent full and level compactions that can run at one time. A 99 # value of 0 results in 50% of runtime.GOMAXPROCS(0) used at runtime. Any number greater 100 # than 0 limits compactions to that value. This setting does not apply 101 # to cache snapshotting. 102 # max-concurrent-compactions = 0 103 104 # CompactThroughput is the rate limit in bytes per second that we 105 # will allow TSM compactions to write to disk. Note that short bursts are allowed 106 # to happen at a possibly larger value, set by CompactThroughputBurst 107 # compact-throughput = "48m" 108 109 # CompactThroughputBurst is the rate limit in bytes per second that we 110 # will allow TSM compactions to write to disk. 111 # compact-throughput-burst = "48m" 112 113 # If true, then the mmap advise value MADV_WILLNEED will be provided to the kernel with respect to 114 # TSM files. This setting has been found to be problematic on some kernels, and defaults to off. 115 # It might help users who have slow disks in some cases. 116 # tsm-use-madv-willneed = false 117 118 # Settings for the inmem index 119 120 # The maximum series allowed per database before writes are dropped. This limit can prevent 121 # high cardinality issues at the database level. This limit can be disabled by setting it to 122 # 0. 123 # max-series-per-database = 1000000 124 125 # The maximum number of tag values per tag that are allowed before writes are dropped. This limit 126 # can prevent high cardinality tag values from being written to a measurement. This limit can be 127 # disabled by setting it to 0. 128 # max-values-per-tag = 100000 129 130 # Settings for the tsi1 index 131 132 # The threshold, in bytes, when an index write-ahead log file will compact 133 # into an index file. Lower sizes will cause log files to be compacted more 134 # quickly and result in lower heap usage at the expense of write throughput. 135 # Higher sizes will be compacted less frequently, store more series in-memory, 136 # and provide higher write throughput. 137 # Valid size suffixes are k, m, or g (case insensitive, 1024 = 1k). 138 # Values without a size suffix are in bytes. 139 # max-index-log-file-size = "1m" 140 141 # The size of the internal cache used in the TSI index to store previously 142 # calculated series results. Cached results will be returned quickly from the cache rather 143 # than needing to be recalculated when a subsequent query with a matching tag key/value 144 # predicate is executed. Setting this value to 0 will disable the cache, which may 145 # lead to query performance issues. 146 # This value should only be increased if it is known that the set of regularly used 147 # tag key/value predicates across all measurements for a database is larger than 100. An 148 # increase in cache size may lead to an increase in heap usage. 149 series-id-set-cache-size = 100 150 151### 152### [coordinator] 153### 154### Controls the clustering service configuration. 155### 156 157[coordinator] 158 # The default time a write request will wait until a "timeout" error is returned to the caller. 159 # write-timeout = "10s" 160 161 # The maximum number of concurrent queries allowed to be executing at one time. If a query is 162 # executed and exceeds this limit, an error is returned to the caller. This limit can be disabled 163 # by setting it to 0. 164 # max-concurrent-queries = 0 165 166 # The maximum time a query will is allowed to execute before being killed by the system. This limit 167 # can help prevent run away queries. Setting the value to 0 disables the limit. 168 # query-timeout = "0s" 169 170 # The time threshold when a query will be logged as a slow query. This limit can be set to help 171 # discover slow or resource intensive queries. Setting the value to 0 disables the slow query logging. 172 # log-queries-after = "0s" 173 174 # The maximum number of points a SELECT can process. A value of 0 will make 175 # the maximum point count unlimited. This will only be checked every second so queries will not 176 # be aborted immediately when hitting the limit. 177 # max-select-point = 0 178 179 # The maximum number of series a SELECT can run. A value of 0 will make the maximum series 180 # count unlimited. 181 # max-select-series = 0 182 183 # The maximum number of group by time bucket a SELECT can create. A value of zero will max the maximum 184 # number of buckets unlimited. 185 # max-select-buckets = 0 186 187### 188### [retention] 189### 190### Controls the enforcement of retention policies for evicting old data. 191### 192 193[retention] 194 # Determines whether retention policy enforcement enabled. 195 # enabled = true 196 197 # The interval of time when retention policy enforcement checks run. 198 # check-interval = "30m" 199 200### 201### [shard-precreation] 202### 203### Controls the precreation of shards, so they are available before data arrives. 204### Only shards that, after creation, will have both a start- and end-time in the 205### future, will ever be created. Shards are never precreated that would be wholly 206### or partially in the past. 207 208[shard-precreation] 209 # Determines whether shard pre-creation service is enabled. 210 # enabled = true 211 212 # The interval of time when the check to pre-create new shards runs. 213 # check-interval = "10m" 214 215 # The default period ahead of the endtime of a shard group that its successor 216 # group is created. 217 # advance-period = "30m" 218 219### 220### Controls the system self-monitoring, statistics and diagnostics. 221### 222### The internal database for monitoring data is created automatically if 223### if it does not already exist. The target retention within this database 224### is called 'monitor' and is also created with a retention period of 7 days 225### and a replication factor of 1, if it does not exist. In all cases the 226### this retention policy is configured as the default for the database. 227 228[monitor] 229 # Whether to record statistics internally. 230 # store-enabled = true 231 232 # The destination database for recorded statistics 233 # store-database = "_internal" 234 235 # The interval at which to record statistics 236 # store-interval = "10s" 237 238### 239### [http] 240### 241### Controls how the HTTP endpoints are configured. These are the primary 242### mechanism for getting data into and out of InfluxDB. 243### 244 245[http] 246 # Determines whether HTTP endpoint is enabled. 247 # enabled = true 248 249 # Determines whether the Flux query endpoint is enabled. 250 # flux-enabled = false 251 252 # Determines whether the Flux query logging is enabled. 253 # flux-log-enabled = false 254 255 # The bind address used by the HTTP service. 256 # bind-address = ":8086" 257 258 # Determines whether user authentication is enabled over HTTP/HTTPS. 259 # auth-enabled = false 260 261 # The default realm sent back when issuing a basic auth challenge. 262 # realm = "InfluxDB" 263 264 # Determines whether HTTP request logging is enabled. 265 # log-enabled = true 266 267 # Determines whether the HTTP write request logs should be suppressed when the log is enabled. 268 # suppress-write-log = false 269 270 # When HTTP request logging is enabled, this option specifies the path where 271 # log entries should be written. If unspecified, the default is to write to stderr, which 272 # intermingles HTTP logs with internal InfluxDB logging. 273 # 274 # If influxd is unable to access the specified path, it will log an error and fall back to writing 275 # the request log to stderr. 276 # access-log-path = "" 277 278 # Filters which requests should be logged. Each filter is of the pattern NNN, NNX, or NXX where N is 279 # a number and X is a wildcard for any number. To filter all 5xx responses, use the string 5xx. 280 # If multiple filters are used, then only one has to match. The default is to have no filters which 281 # will cause every request to be printed. 282 # access-log-status-filters = [] 283 284 # Determines whether detailed write logging is enabled. 285 # write-tracing = false 286 287 # Determines whether the pprof endpoint is enabled. This endpoint is used for 288 # troubleshooting and monitoring. 289 # pprof-enabled = true 290 291 # Enables authentication on pprof endpoints. Users will need admin permissions 292 # to access the pprof endpoints when this setting is enabled. This setting has 293 # no effect if either auth-enabled or pprof-enabled are set to false. 294 # pprof-auth-enabled = false 295 296 # Enables a pprof endpoint that binds to localhost:6060 immediately on startup. 297 # This is only needed to debug startup issues. 298 # debug-pprof-enabled = false 299 300 # Enables authentication on the /ping, /metrics, and deprecated /status 301 # endpoints. This setting has no effect if auth-enabled is set to false. 302 # ping-auth-enabled = false 303 304 # Determines whether HTTPS is enabled. 305 # https-enabled = false 306 307 # The SSL certificate to use when HTTPS is enabled. 308 # https-certificate = "/etc/ssl/influxdb.pem" 309 310 # Use a separate private key location. 311 # https-private-key = "" 312 313 # The JWT auth shared secret to validate requests using JSON web tokens. 314 # shared-secret = "" 315 316 # The default chunk size for result sets that should be chunked. 317 # max-row-limit = 0 318 319 # The maximum number of HTTP connections that may be open at once. New connections that 320 # would exceed this limit are dropped. Setting this value to 0 disables the limit. 321 # max-connection-limit = 0 322 323 # Enable http service over unix domain socket 324 # unix-socket-enabled = false 325 326 # The path of the unix domain socket. 327 # bind-socket = "/var/run/influxdb.sock" 328 329 # The maximum size of a client request body, in bytes. Setting this value to 0 disables the limit. 330 # max-body-size = 25000000 331 332 # The maximum number of writes processed concurrently. 333 # Setting this to 0 disables the limit. 334 # max-concurrent-write-limit = 0 335 336 # The maximum number of writes queued for processing. 337 # Setting this to 0 disables the limit. 338 # max-enqueued-write-limit = 0 339 340 # The maximum duration for a write to wait in the queue to be processed. 341 # Setting this to 0 or setting max-concurrent-write-limit to 0 disables the limit. 342 # enqueued-write-timeout = 0 343 344### 345### [logging] 346### 347### Controls how the logger emits logs to the output. 348### 349 350[logging] 351 # Determines which log encoder to use for logs. Available options 352 # are auto, logfmt, and json. auto will use a more a more user-friendly 353 # output format if the output terminal is a TTY, but the format is not as 354 # easily machine-readable. When the output is a non-TTY, auto will use 355 # logfmt. 356 # format = "auto" 357 358 # Determines which level of logs will be emitted. The available levels 359 # are error, warn, info, and debug. Logs that are equal to or above the 360 # specified level will be emitted. 361 # level = "info" 362 363 # Suppresses the logo output that is printed when the program is started. 364 # The logo is always suppressed if STDOUT is not a TTY. 365 # suppress-logo = false 366 367### 368### [subscriber] 369### 370### Controls the subscriptions, which can be used to fork a copy of all data 371### received by the InfluxDB host. 372### 373 374[subscriber] 375 # Determines whether the subscriber service is enabled. 376 # enabled = true 377 378 # The default timeout for HTTP writes to subscribers. 379 # http-timeout = "30s" 380 381 # Allows insecure HTTPS connections to subscribers. This is useful when testing with self- 382 # signed certificates. 383 # insecure-skip-verify = false 384 385 # The path to the PEM encoded CA certs file. If the empty string, the default system certs will be used 386 # ca-certs = "" 387 388 # The number of writer goroutines processing the write channel. 389 # write-concurrency = 40 390 391 # The number of in-flight writes buffered in the write channel. 392 # write-buffer-size = 1000 393 394 395### 396### [[graphite]] 397### 398### Controls one or many listeners for Graphite data. 399### 400 401[[graphite]] 402 # Determines whether the graphite endpoint is enabled. 403 # enabled = false 404 # database = "graphite" 405 # retention-policy = "" 406 # bind-address = ":2003" 407 # protocol = "tcp" 408 # consistency-level = "one" 409 410 # These next lines control how batching works. You should have this enabled 411 # otherwise you could get dropped metrics or poor performance. Batching 412 # will buffer points in memory if you have many coming in. 413 414 # Flush if this many points get buffered 415 # batch-size = 5000 416 417 # number of batches that may be pending in memory 418 # batch-pending = 10 419 420 # Flush at least this often even if we haven't hit buffer limit 421 # batch-timeout = "1s" 422 423 # UDP Read buffer size, 0 means OS default. UDP listener will fail if set above OS max. 424 # udp-read-buffer = 0 425 426 ### This string joins multiple matching 'measurement' values providing more control over the final measurement name. 427 # separator = "." 428 429 ### Default tags that will be added to all metrics. These can be overridden at the template level 430 ### or by tags extracted from metric 431 # tags = ["region=us-east", "zone=1c"] 432 433 ### Each template line requires a template pattern. It can have an optional 434 ### filter before the template and separated by spaces. It can also have optional extra 435 ### tags following the template. Multiple tags should be separated by commas and no spaces 436 ### similar to the line protocol format. There can be only one default template. 437 # templates = [ 438 # "*.app env.service.resource.measurement", 439 # # Default template 440 # "server.*", 441 # ] 442 443### 444### [collectd] 445### 446### Controls one or many listeners for collectd data. 447### 448 449[[collectd]] 450 # enabled = false 451 # bind-address = ":25826" 452 # database = "collectd" 453 # retention-policy = "" 454 # 455 # The collectd service supports either scanning a directory for multiple types 456 # db files, or specifying a single db file. 457 # typesdb = "/usr/local/share/collectd" 458 # 459 # security-level = "none" 460 # auth-file = "/etc/collectd/auth_file" 461 462 # These next lines control how batching works. You should have this enabled 463 # otherwise you could get dropped metrics or poor performance. Batching 464 # will buffer points in memory if you have many coming in. 465 466 # Flush if this many points get buffered 467 # batch-size = 5000 468 469 # Number of batches that may be pending in memory 470 # batch-pending = 10 471 472 # Flush at least this often even if we haven't hit buffer limit 473 # batch-timeout = "10s" 474 475 # UDP Read buffer size, 0 means OS default. UDP listener will fail if set above OS max. 476 # read-buffer = 0 477 478 # Multi-value plugins can be handled two ways. 479 # "split" will parse and store the multi-value plugin data into separate measurements 480 # "join" will parse and store the multi-value plugin as a single multi-value measurement. 481 # "split" is the default behavior for backward compatibility with previous versions of influxdb. 482 # parse-multivalue-plugin = "split" 483### 484### [opentsdb] 485### 486### Controls one or many listeners for OpenTSDB data. 487### 488 489[[opentsdb]] 490 # enabled = false 491 # bind-address = ":4242" 492 # database = "opentsdb" 493 # retention-policy = "" 494 # consistency-level = "one" 495 # tls-enabled = false 496 # certificate= "/etc/ssl/influxdb.pem" 497 498 # Log an error for every malformed point. 499 # log-point-errors = true 500 501 # These next lines control how batching works. You should have this enabled 502 # otherwise you could get dropped metrics or poor performance. Only points 503 # metrics received over the telnet protocol undergo batching. 504 505 # Flush if this many points get buffered 506 # batch-size = 1000 507 508 # Number of batches that may be pending in memory 509 # batch-pending = 5 510 511 # Flush at least this often even if we haven't hit buffer limit 512 # batch-timeout = "1s" 513 514### 515### [[udp]] 516### 517### Controls the listeners for InfluxDB line protocol data via UDP. 518### 519 520[[udp]] 521 # enabled = false 522 # bind-address = ":8089" 523 # database = "udp" 524 # retention-policy = "" 525 526 # InfluxDB precision for timestamps on received points ("" or "n", "u", "ms", "s", "m", "h") 527 # precision = "" 528 529 # These next lines control how batching works. You should have this enabled 530 # otherwise you could get dropped metrics or poor performance. Batching 531 # will buffer points in memory if you have many coming in. 532 533 # Flush if this many points get buffered 534 # batch-size = 5000 535 536 # Number of batches that may be pending in memory 537 # batch-pending = 10 538 539 # Will flush at least this often even if we haven't hit buffer limit 540 # batch-timeout = "1s" 541 542 # UDP Read buffer size, 0 means OS default. UDP listener will fail if set above OS max. 543 # read-buffer = 0 544 545### 546### [continuous_queries] 547### 548### Controls how continuous queries are run within InfluxDB. 549### 550 551[continuous_queries] 552 # Determines whether the continuous query service is enabled. 553 # enabled = true 554 555 # Controls whether queries are logged when executed by the CQ service. 556 # log-enabled = true 557 558 # Controls whether queries are logged to the self-monitoring data store. 559 # query-stats-enabled = false 560 561 # interval for how often continuous queries will be checked if they need to run 562 # run-interval = "1s" 563 564### 565### [tls] 566### 567### Global configuration settings for TLS in InfluxDB. 568### 569 570[tls] 571 # Determines the available set of cipher suites. See https://golang.org/pkg/crypto/tls/#pkg-constants 572 # for a list of available ciphers, which depends on the version of Go (use the query 573 # SHOW DIAGNOSTICS to see the version of Go used to build InfluxDB). If not specified, uses 574 # the default settings from Go's crypto/tls package. 575 # ciphers = [ 576 # "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305", 577 # "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305", 578 # ] 579 580 # Minimum version of the tls protocol that will be negotiated. If not specified, uses the 581 # default settings from Go's crypto/tls package. 582 # min-version = "tls1.2" 583 584 # Maximum version of the tls protocol that will be negotiated. If not specified, uses the 585 # default settings from Go's crypto/tls package. 586 # max-version = "tls1.3" 587