{"action":"created","comment":{"url":"https://api.github.com/repos/influxdb/influxdb.com/pulls/comments/39825077","id":39825077,"diff_hunk":"@@ -2,48 +2,372 @@\n title: Database Configuration\n ---\n \n-## Generating a Configuration file\n-\n-To generate an InfluxDB configuration file run the command\n+## The basics\n+---\n+Generate a new configuration file by running `influxd config` and redirecting the output to a file:\n+```\n+influxd config  > /etc/influxdb/influx_v0.9.x.conf\n+```\n \n+Start the influxd process using that configuration file with `influxd -config`:  \n ```\n-influxd config  > influx.conf\n+influxd -config /etc/influxdb/influx_v0.9.x.conf\n ```\n \n-## Authentication\n+## Upgrading your configuration file\n+___\n+While configuration files from prior versions of InfluxDB 0.9 should work with future releases, old files may lack options for new features. To keep your configuration file up-to-date we recommend doing one of the following:\n \n-To add authentication to InfluxDB set `auth-enabled = true` in the `[http]` section of your config file.\n+* Generate a new configuration file with each InfluxDB upgrade. Any changes that you made to the old file will need to be manually ported to the new file.\n \n-```\n-[http]\n-...\n-auth-enabled = true\n-...\n-```\n+* Use both the `config` and `-config` flags to combine the new configuration file with your old configuration file. In the example below, InfluxDB uses the union of the new configuration file and the old configuration file (`influx_v0.9.x.conf`), where any configurations in the old file trump those in the new file.  \n+<br>\n+    ```\n+    influxd config -config /etc/influxdb/influx_v0.9.x.conf\n+    ```\n+\n+## The configuration file\n+---\n+The following sections follow the structure of the [sample configuration file on GitHub](https://github.com/influxdb/influxdb/blob/master/etc/config.sample.toml) and offer detailed explanations of the different options.\n+\n+Configuration sections:  \n+\n+* [reporting](../administration/config.html#reporting)  \n+* [[meta]](../administration/config.html#meta)  \n+* [[data]](../administration/config.html#data)  \n+* [[cluster]](../administration/config.html#cluster)  \n+* [[retention]](../administration/config.html#retention)  \n+* [[monitor]](../administration/config.html#monitor)  \n+* [[admin]](../administration/config.html#admin)  \n+* [[http]](../administration/config.html#http)  \n+* [[graphite]](../administration/config.html#graphite)  \n+* [[collectd]](../administration/config.html#collectd)  \n+* [[opentsdb]](../administration/config.html#opentsdb)  \n+* [[udp]](../administration/config.html#udp)  \n+* [[continuous_queries]](../administration/config.html#continuous-queries)  \n+* [[hinted-handoff]](../administration/config.html#hinted-handoff)  \n+\n+## reporting\n+Once every 24 hours InfluxDB reports anonymous data to m.influxdb.com. Those data include Raft ID (random 8 bytes), OS, architecture, InfluxDB version, and metadata. InfluxDB doesn't track IP addresses of servers reporting. This is only used to track the number of instances running and the versions, which is very helpful for us. \n+\n+**reporting-disabled = false**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Change this option to `true` to disable reporting.\n+\n+## [meta]\n+This section handles some of the parameters for the InfluxDB cluster. Specifically, it controls the parameters for the Raft consensus group which stores metadata about the cluster. For step-by-step instructions on setting up a cluster, see the [setup guide](../guides/clustering.html). \n+\n+**dir = \"/var/opt/influxdb/meta\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The directory where InfluxDB stores `id`, `peers.json`, `raft.db`, and the `snapshots` directory.\n+\n+> * `id` stores the identification number of the Raft peer: `1` for the first node to join the cluster, `2` for the second node, and `3` for the third node to join the cluster.\n+* `peers.json` stores the hostnames and ports of the three Raft peers.\n+* `snapshots` contains the server's snapshots taken for the purpose of log compaction.\n+* `raft.db` 🎁\n+\n+**hostname = \"localhost\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The `hostname` of the Raft peer. \n+\n+**bind-address = \":8088\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The `port` over which the Raft peer communicates.\n+\n+**retention-autocreate = true**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;🎁\n+\n+**election-timeout = \"1s\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The time that the follower waits for communication from the leader before the follower begins a new election. In practice, InfluxDB staggers this parameter for each \n+Raft peer. The default should work for most systems.\n+\n+**heartbeat-timeout = \"1s\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The rate at which the leader sends heartbeats to the other Raft peers to preserve its leader status. You may want to alter this parameter depending on your network.\n+\n+**leader-lease-timeout = \"500ms\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;🎁\n+\n+**commit-timeout = \"50ms\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;🎁\n+\n+## [data]\n+This section controls where the actual shard data for InfluxDB live and how they are flushed from the WAL. You may want to change the `dir` setting, but the WAL settings are an advanced configuration. The defaults should work for most systems.\n+\n+**dir = \"/var/opt/influxdb/data\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The directory where InfluxDB stores the shard data.\n+\n+The following three WAL settings are for the b1 storage engine used in 0.9.2. They won't apply to any new shards created after upgrading to versions 0.9.3+. \n+ \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; **max-wal-size = 104857600**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The maximum size the WAL can reach before a flush. Defaults to 100MB.\n+  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;**wal-flush-interval = \"10m\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The maximum time data can sit in WAL before a flush.\n+\n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;**wal-partition-flush-delay = \"2s\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The delay time between each WAL partition being flushed.\n+\n+The following WAL settings are for the storage engine in versions 0.9.3+.\n+ \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;**wal-dir = \"/var/opt/influxdb/wal\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;🎁\n+ \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;**wal-enable-logging = true**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `false` to disable logging.\n+\n+🎁Any explanation for why the next lines are commented out?\n+\n+**# wal-ready-series-size = 25600**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;When a series in the WAL in-memory cache reaches this size in bytes it is marked as ready to flush to the index.\n+  \n+**# wal-compaction-threshold = 0.6**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Flush and compact a partition once this ratio of series are over the ready size.\n+\n+**# wal-max-series-size = 2097152**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Force a flush and compaction if any series in a partition gets above this size in bytes.\n+\n+**# wal-flush-cold-interval = \"10m\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Force a flush of all series and full compaction if there have been no writes in this amount of time. This is useful for ensuring that shards that are cold for writes don't keep a bunch of data cached in memory and in the WAL.\n+\n+**# wal-partition-size-threshold = 20971520**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Force a partition to flush its largest series if it reaches this approximate size in bytes. Remember there are 5 partitions so you'll need at least 5x this amount of memory. The more memory you have, the bigger this can be.\n+\n+## [cluster]\n+This section handles non-Raft cluster behavior, which generally includes how data are shared across shards.\n+\n+**shard-writer-timeout = \"5s\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The time within which a shard must respond to a write.\n+ \n+ **write-timeout = \"5s\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The time within which a write operation must complete on the cluster.\n+\n+## [retention]\n+This section controls the enforcement of retention policies for evicting old data.\n+\n+**enabled = true**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Change this to `false` to prevent InfluxDB from enforcing retention policies. \n+\n+**check-interval = \"30m\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The rate at which InfluxDB checks to enforce a retention policy. \n+\n+## [monitor]\n+This section controls InfluxDB's [system self-monitoring](https://github.com/influxdb/influxdb/blob/master/monitor/README.md).\n+\n+The retention policy for these data is the default retention policy within the `_internal` database. If the `_internal` database does not exist, InfluxDB creates that database automatically with a default retention policy of infinite retention. If you want to use a retention policy other than infinite retention, you must [create](../administration/administration.html#retention-policy-management) it. \n+\n+**store-enabled = true**   \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Whether to record statistics internally.\n+\n+**store-database = \"_internal\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The destination database for recorded statistics.\n+\n+**store-interval = \"10s\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The interval at which to record statistics.\n+\n+## [admin]\n+Controls the availability of the built-in, web-based admin interface.\n+\n+>**Note:** If you want to enable HTTPS for the admin interface you must also enable HTTPS on the [[http]](../administration/config.html#http) service.\n+\n+**enabled = true**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `false` to disable the admin interface.\n+\n+**bind-address = \":8083\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The admin interface uses port `8083` by default.\n+\n+**https-enabled = false**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `true` to enable HTTPS for the admin interface.\n+\n+**https-certificate = \"/etc/ssl/influxdb.pem\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to the path of the certificate file.\n+\n+## [http]\n+This section controls how InfluxDB configures the HTTP endpoints. These are the primary mechanism for getting data into and out of InfluxDB. Edit options in this section to enable HTTPS and authentication.\n+\n+**enabled = true**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `false` to disable HTTP. Note that the InfluxDB CLI connects to the database using the HTTP API.\n+\n+**bind-address = \":8086\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The HTTP API uses port `8086`  by default.\n+\n+**auth-enabled = false**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `true` to enable authentication.\n \n-## Anonymous Statistics\n+**log-enabled = true**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `false` to disable logging.\n \n-By default, InfluxDB sends anonymous statistics about your InfluxDB instance. If you would like to disable this functionality, set `enabled = false` in the `[monitoring]` section of your config file.\n+**write-tracing = false**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;🎁\n \n+**pprof-enabled = false**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;🎁\n+\n+**https-enabled = false**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `true` to enable HTTPS.\n+\n+**https-certificate = \"/etc/ssl/influxdb.pem\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to the path of the certificate file.\n+\n+## [[graphite]]\n+This section controls one or many listeners for Graphite data. See the [README](https://github.com/influxdb/influxdb/blob/master/services/graphite/README.md) on GitHub for more information.\n+\n+**enabled = false**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this to `true` to enable Graphite input.\n+\n+**# bind-address = \":2003\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\n+\n+**# protocol = \"tcp\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\n+\n+**# consistency-level = \"one\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\n+\n+**# name-separator = \".\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\n+\n+The next three options control how batching works. 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.\n+\n+**# batch-size = 1000**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The input will flush if this many points get buffered.\n+\n+**# batch-pending = 5**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The number of batches that may be pending in memory.\n+\n+**# batch-timeout = \"1s\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The input will flush at least this often even if we haven't reached the configured batch size.\n+\n+**# name-schema = \"type.host.measurement.device\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This option configures tag names for parsing the metric name from graphite protocol; separated by `name-separator`. The \"measurement\" tag is special and the corresponding field will become the name of the metric. e.g. \"type.host.measurement.device\" will parse \"server.localhost.cpu.cpu0\" as:\n+<br>\n+<br>\n ```\n-[monitoring]\n-enabled = false\n+  ## {\n+  ##     measurement: \"cpu\",\n+  ##     tags: {\n+  ##         \"type\": \"server\",\n+  ##         \"host\": \"localhost,\n+  ##         \"device\": \"cpu0\"\n+  ##     }\n+  ## }\n ```\n \n-## Cluster\n+**ignore-unnamed = true**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If set to `true`, when the input metric name has more fields than `name-schema` specified, the extra fields will be ignored. Otherwise an error will be logged and the metric rejected.\n+\n+## [collectd]\n+This section controls the listener for Collectd data.\n+\n+**enabled = false**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `true` to enable Collectd writes.\n+\n+**# bind-address = \"\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\n+\n+**# database = \"\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The name of the database that you want to write to.\n+\n+**# typesdb = \"\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\n+\n+The next three options control how batching works. 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.\n+\n+**# batch-size = 1000**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The input will flush if this many points get buffered.\n+\n+**# batch-pending = 5**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The number of batches that may be pending in memory.\n+\n+**# batch-timeout = \"1s\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The input will flush at least this often even if we haven't reached the configured batch-size.\n+\n+## [opentsdb]\n+Controls the listener for OpenTSDB data. See the [README](https://github.com/influxdb/influxdb/blob/master/services/opentsdb/README.md) on GitHub for more information.\n+\n+**enabled = false**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `true` to enable openTSDB writes.\n+\n+**# bind-address = \"\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\n+\n+**# database = \"\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The name of the database that you want to write to. If the database does not exist, it will be created automatically when the input is initialized.\n+\n+**# retention-policy = \"\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\n+\n+The next three options 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.\n+\n+**# batch-size = 1000**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The input will flush if this many points get buffered.\n+\n+**# batch-pending = 5**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The number of batches that may be pending in memory.\n+\n+**# batch-timeout = \"1s\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The input will flush at least this often even if we haven't reached the configured batch-size.\n+\n+## [[udp]]\n+This section controls the listeners for InfluxDB line protocol data via UDP. See the [UDP page](../write_protocols/udp.html) for more information.\n+\n+**enabled = false**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `true` to enable writes over UDP.\n+\n+**# bind-address = \"\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\n+\n+**# database = \"\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The name of the database that you want to write to.\n+\n+The next three options control how batching works. 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.\n+\n+**# batch-size = 1000**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Will flush if this many points get buffered.\n+\n+**# batch-pending = 5**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The number of batches that may be pending in memory.\n+\n+**# batch-timeout = \"1s\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Will flush at least this often even if we haven't reached the configured batch-size.\n+\n+## [continuous_queries]\n+This section controls how continuous queries run within InfluxDB.\n+\n+**log-enabled = true**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `false` to disable logging.\n+\n+**enabled = true**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `false` to disable continuous queries.\n+\n+**recompute-previous-n = 2**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;🎁\n+\n+**recompute-no-older-than = \"10m\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The maximum interval over which the continuous query will recompute results.\n+\n+**compute-runs-per-interval = 10**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;🎁\n+\n+**compute-no-more-than = \"2m\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;🎁\n+\n+## [hinted-handoff]\n+This section controls the hinted handoff feature, which allows nodes to temporarily store queued data when one node of a cluster is down for a short period of time.\n+\n+🎁Any notes on what may need to be changed for most systems?\n+\n+**enabled = true**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set this option to `false` to disable hinted handoff. \n+\n+**dir = \"/var/opt/influxdb/hh\"**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\n+\n+**max-size = 1073741824**  \n+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The maximum size of the hinted handoff queue.","path":"content/docs/v0.9/administration/config.md","position":378,"original_position":378,"commit_id":"1655af0a8df61625d8e3119d980d19e2a7c1fefa","original_commit_id":"1655af0a8df61625d8e3119d980d19e2a7c1fefa","user":{"login":"beckettsean","id":6537329,"avatar_url":"https://avatars.githubusercontent.com/u/6537329?v=3","gravatar_id":"","url":"https://api.github.com/users/beckettsean","html_url":"https://github.com/beckettsean","followers_url":"https://api.github.com/users/beckettsean/followers","following_url":"https://api.github.com/users/beckettsean/following{/other_user}","gists_url":"https://api.github.com/users/beckettsean/gists{/gist_id}","starred_url":"https://api.github.com/users/beckettsean/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/beckettsean/subscriptions","organizations_url":"https://api.github.com/users/beckettsean/orgs","repos_url":"https://api.github.com/users/beckettsean/repos","events_url":"https://api.github.com/users/beckettsean/events{/privacy}","received_events_url":"https://api.github.com/users/beckettsean/received_events","type":"User","site_admin":false},"body":"what happens if this is exceeded? Are older writes pushed off the stack by newer ones? Do new writes for that node fail? Return failures to the client?","created_at":"2015-09-18T05:23:45Z","updated_at":"2015-09-18T05:23:45Z","html_url":"https://github.com/influxdb/influxdb.com/pull/325#discussion_r39825077","pull_request_url":"https://api.github.com/repos/influxdb/influxdb.com/pulls/325","_links":{"self":{"href":"https://api.github.com/repos/influxdb/influxdb.com/pulls/comments/39825077"},"html":{"href":"https://github.com/influxdb/influxdb.com/pull/325#discussion_r39825077"},"pull_request":{"href":"https://api.github.com/repos/influxdb/influxdb.com/pulls/325"}}},"pull_request":{"url":"https://api.github.com/repos/influxdb/influxdb.com/pulls/325","id":45354136,"html_url":"https://github.com/influxdb/influxdb.com/pull/325","diff_url":"https://github.com/influxdb/influxdb.com/pull/325.diff","patch_url":"https://github.com/influxdb/influxdb.com/pull/325.patch","issue_url":"https://api.github.com/repos/influxdb/influxdb.com/issues/325","number":325,"state":"open","locked":false,"title":"restructure the config doc and add material [WIP]","user":{"login":"rkuchan","id":8750814,"avatar_url":"https://avatars.githubusercontent.com/u/8750814?v=3","gravatar_id":"","url":"https://api.github.com/users/rkuchan","html_url":"https://github.com/rkuchan","followers_url":"https://api.github.com/users/rkuchan/followers","following_url":"https://api.github.com/users/rkuchan/following{/other_user}","gists_url":"https://api.github.com/users/rkuchan/gists{/gist_id}","starred_url":"https://api.github.com/users/rkuchan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rkuchan/subscriptions","organizations_url":"https://api.github.com/users/rkuchan/orgs","repos_url":"https://api.github.com/users/rkuchan/repos","events_url":"https://api.github.com/users/rkuchan/events{/privacy}","received_events_url":"https://api.github.com/users/rkuchan/received_events","type":"User","site_admin":false},"body":"This is a first attempt at https://github.com/influxdb/influxdb.com/issues/153. \r\n\r\nThere are a couple things to note/please comment on:\r\n\r\n* Is the current layout OK or is the structure of the [v0.8 config doc](https://influxdb.com/docs/v0.8/advanced_topics/configuration_options.html) preferable?\r\n* 🎁s mark where I wasn't sure what to write - it covers areas where I don't know what the options do as well as areas where it might be good to put a note about what works for most systems (but I wasn't sure what that was). Any knowledge gifts are appreciated!\r\n* I linked to whatever documentation we have for the plugins but, in general, I left those sections well alone.\r\n* I made all of my changes to administration/config.md - happy to make this a whole new page if that's preferred.\r\n\r\n\r\n","created_at":"2015-09-17T23:24:44Z","updated_at":"2015-09-18T05:23:45Z","closed_at":null,"merged_at":null,"merge_commit_sha":null,"assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/influxdb/influxdb.com/pulls/325/commits","review_comments_url":"https://api.github.com/repos/influxdb/influxdb.com/pulls/325/comments","review_comment_url":"https://api.github.com/repos/influxdb/influxdb.com/pulls/comments{/number}","comments_url":"https://api.github.com/repos/influxdb/influxdb.com/issues/325/comments","statuses_url":"https://api.github.com/repos/influxdb/influxdb.com/statuses/1655af0a8df61625d8e3119d980d19e2a7c1fefa","head":{"label":"influxdb:config_doc","ref":"config_doc","sha":"1655af0a8df61625d8e3119d980d19e2a7c1fefa","user":{"login":"influxdb","id":5713248,"avatar_url":"https://avatars.githubusercontent.com/u/5713248?v=3","gravatar_id":"","url":"https://api.github.com/users/influxdb","html_url":"https://github.com/influxdb","followers_url":"https://api.github.com/users/influxdb/followers","following_url":"https://api.github.com/users/influxdb/following{/other_user}","gists_url":"https://api.github.com/users/influxdb/gists{/gist_id}","starred_url":"https://api.github.com/users/influxdb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/influxdb/subscriptions","organizations_url":"https://api.github.com/users/influxdb/orgs","repos_url":"https://api.github.com/users/influxdb/repos","events_url":"https://api.github.com/users/influxdb/events{/privacy}","received_events_url":"https://api.github.com/users/influxdb/received_events","type":"Organization","site_admin":false},"repo":{"id":35440649,"name":"influxdb.com","full_name":"influxdb/influxdb.com","owner":{"login":"influxdb","id":5713248,"avatar_url":"https://avatars.githubusercontent.com/u/5713248?v=3","gravatar_id":"","url":"https://api.github.com/users/influxdb","html_url":"https://github.com/influxdb","followers_url":"https://api.github.com/users/influxdb/followers","following_url":"https://api.github.com/users/influxdb/following{/other_user}","gists_url":"https://api.github.com/users/influxdb/gists{/gist_id}","starred_url":"https://api.github.com/users/influxdb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/influxdb/subscriptions","organizations_url":"https://api.github.com/users/influxdb/orgs","repos_url":"https://api.github.com/users/influxdb/repos","events_url":"https://api.github.com/users/influxdb/events{/privacy}","received_events_url":"https://api.github.com/users/influxdb/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/influxdb/influxdb.com","description":"The main InfluxDB site","fork":false,"url":"https://api.github.com/repos/influxdb/influxdb.com","forks_url":"https://api.github.com/repos/influxdb/influxdb.com/forks","keys_url":"https://api.github.com/repos/influxdb/influxdb.com/keys{/key_id}","collaborators_url":"https://api.github.com/repos/influxdb/influxdb.com/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/influxdb/influxdb.com/teams","hooks_url":"https://api.github.com/repos/influxdb/influxdb.com/hooks","issue_events_url":"https://api.github.com/repos/influxdb/influxdb.com/issues/events{/number}","events_url":"https://api.github.com/repos/influxdb/influxdb.com/events","assignees_url":"https://api.github.com/repos/influxdb/influxdb.com/assignees{/user}","branches_url":"https://api.github.com/repos/influxdb/influxdb.com/branches{/branch}","tags_url":"https://api.github.com/repos/influxdb/influxdb.com/tags","blobs_url":"https://api.github.com/repos/influxdb/influxdb.com/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/influxdb/influxdb.com/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/influxdb/influxdb.com/git/refs{/sha}","trees_url":"https://api.github.com/repos/influxdb/influxdb.com/git/trees{/sha}","statuses_url":"https://api.github.com/repos/influxdb/influxdb.com/statuses/{sha}","languages_url":"https://api.github.com/repos/influxdb/influxdb.com/languages","stargazers_url":"https://api.github.com/repos/influxdb/influxdb.com/stargazers","contributors_url":"https://api.github.com/repos/influxdb/influxdb.com/contributors","subscribers_url":"https://api.github.com/repos/influxdb/influxdb.com/subscribers","subscription_url":"https://api.github.com/repos/influxdb/influxdb.com/subscription","commits_url":"https://api.github.com/repos/influxdb/influxdb.com/commits{/sha}","git_commits_url":"https://api.github.com/repos/influxdb/influxdb.com/git/commits{/sha}","comments_url":"https://api.github.com/repos/influxdb/influxdb.com/comments{/number}","issue_comment_url":"https://api.github.com/repos/influxdb/influxdb.com/issues/comments{/number}","contents_url":"https://api.github.com/repos/influxdb/influxdb.com/contents/{+path}","compare_url":"https://api.github.com/repos/influxdb/influxdb.com/compare/{base}...{head}","merges_url":"https://api.github.com/repos/influxdb/influxdb.com/merges","archive_url":"https://api.github.com/repos/influxdb/influxdb.com/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/influxdb/influxdb.com/downloads","issues_url":"https://api.github.com/repos/influxdb/influxdb.com/issues{/number}","pulls_url":"https://api.github.com/repos/influxdb/influxdb.com/pulls{/number}","milestones_url":"https://api.github.com/repos/influxdb/influxdb.com/milestones{/number}","notifications_url":"https://api.github.com/repos/influxdb/influxdb.com/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/influxdb/influxdb.com/labels{/name}","releases_url":"https://api.github.com/repos/influxdb/influxdb.com/releases{/id}","created_at":"2015-05-11T18:02:06Z","updated_at":"2015-08-28T19:07:39Z","pushed_at":"2015-09-17T23:24:44Z","git_url":"git://github.com/influxdb/influxdb.com.git","ssh_url":"git@github.com:influxdb/influxdb.com.git","clone_url":"https://github.com/influxdb/influxdb.com.git","svn_url":"https://github.com/influxdb/influxdb.com","homepage":null,"size":6920,"stargazers_count":10,"watchers_count":10,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":38,"mirror_url":null,"open_issues_count":70,"forks":38,"open_issues":70,"watchers":10,"default_branch":"master"}},"base":{"label":"influxdb:master","ref":"master","sha":"2abbd2a58a5e21be163a7d226be3a23434a62e35","user":{"login":"influxdb","id":5713248,"avatar_url":"https://avatars.githubusercontent.com/u/5713248?v=3","gravatar_id":"","url":"https://api.github.com/users/influxdb","html_url":"https://github.com/influxdb","followers_url":"https://api.github.com/users/influxdb/followers","following_url":"https://api.github.com/users/influxdb/following{/other_user}","gists_url":"https://api.github.com/users/influxdb/gists{/gist_id}","starred_url":"https://api.github.com/users/influxdb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/influxdb/subscriptions","organizations_url":"https://api.github.com/users/influxdb/orgs","repos_url":"https://api.github.com/users/influxdb/repos","events_url":"https://api.github.com/users/influxdb/events{/privacy}","received_events_url":"https://api.github.com/users/influxdb/received_events","type":"Organization","site_admin":false},"repo":{"id":35440649,"name":"influxdb.com","full_name":"influxdb/influxdb.com","owner":{"login":"influxdb","id":5713248,"avatar_url":"https://avatars.githubusercontent.com/u/5713248?v=3","gravatar_id":"","url":"https://api.github.com/users/influxdb","html_url":"https://github.com/influxdb","followers_url":"https://api.github.com/users/influxdb/followers","following_url":"https://api.github.com/users/influxdb/following{/other_user}","gists_url":"https://api.github.com/users/influxdb/gists{/gist_id}","starred_url":"https://api.github.com/users/influxdb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/influxdb/subscriptions","organizations_url":"https://api.github.com/users/influxdb/orgs","repos_url":"https://api.github.com/users/influxdb/repos","events_url":"https://api.github.com/users/influxdb/events{/privacy}","received_events_url":"https://api.github.com/users/influxdb/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/influxdb/influxdb.com","description":"The main InfluxDB site","fork":false,"url":"https://api.github.com/repos/influxdb/influxdb.com","forks_url":"https://api.github.com/repos/influxdb/influxdb.com/forks","keys_url":"https://api.github.com/repos/influxdb/influxdb.com/keys{/key_id}","collaborators_url":"https://api.github.com/repos/influxdb/influxdb.com/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/influxdb/influxdb.com/teams","hooks_url":"https://api.github.com/repos/influxdb/influxdb.com/hooks","issue_events_url":"https://api.github.com/repos/influxdb/influxdb.com/issues/events{/number}","events_url":"https://api.github.com/repos/influxdb/influxdb.com/events","assignees_url":"https://api.github.com/repos/influxdb/influxdb.com/assignees{/user}","branches_url":"https://api.github.com/repos/influxdb/influxdb.com/branches{/branch}","tags_url":"https://api.github.com/repos/influxdb/influxdb.com/tags","blobs_url":"https://api.github.com/repos/influxdb/influxdb.com/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/influxdb/influxdb.com/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/influxdb/influxdb.com/git/refs{/sha}","trees_url":"https://api.github.com/repos/influxdb/influxdb.com/git/trees{/sha}","statuses_url":"https://api.github.com/repos/influxdb/influxdb.com/statuses/{sha}","languages_url":"https://api.github.com/repos/influxdb/influxdb.com/languages","stargazers_url":"https://api.github.com/repos/influxdb/influxdb.com/stargazers","contributors_url":"https://api.github.com/repos/influxdb/influxdb.com/contributors","subscribers_url":"https://api.github.com/repos/influxdb/influxdb.com/subscribers","subscription_url":"https://api.github.com/repos/influxdb/influxdb.com/subscription","commits_url":"https://api.github.com/repos/influxdb/influxdb.com/commits{/sha}","git_commits_url":"https://api.github.com/repos/influxdb/influxdb.com/git/commits{/sha}","comments_url":"https://api.github.com/repos/influxdb/influxdb.com/comments{/number}","issue_comment_url":"https://api.github.com/repos/influxdb/influxdb.com/issues/comments{/number}","contents_url":"https://api.github.com/repos/influxdb/influxdb.com/contents/{+path}","compare_url":"https://api.github.com/repos/influxdb/influxdb.com/compare/{base}...{head}","merges_url":"https://api.github.com/repos/influxdb/influxdb.com/merges","archive_url":"https://api.github.com/repos/influxdb/influxdb.com/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/influxdb/influxdb.com/downloads","issues_url":"https://api.github.com/repos/influxdb/influxdb.com/issues{/number}","pulls_url":"https://api.github.com/repos/influxdb/influxdb.com/pulls{/number}","milestones_url":"https://api.github.com/repos/influxdb/influxdb.com/milestones{/number}","notifications_url":"https://api.github.com/repos/influxdb/influxdb.com/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/influxdb/influxdb.com/labels{/name}","releases_url":"https://api.github.com/repos/influxdb/influxdb.com/releases{/id}","created_at":"2015-05-11T18:02:06Z","updated_at":"2015-08-28T19:07:39Z","pushed_at":"2015-09-17T23:24:44Z","git_url":"git://github.com/influxdb/influxdb.com.git","ssh_url":"git@github.com:influxdb/influxdb.com.git","clone_url":"https://github.com/influxdb/influxdb.com.git","svn_url":"https://github.com/influxdb/influxdb.com","homepage":null,"size":6920,"stargazers_count":10,"watchers_count":10,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":38,"mirror_url":null,"open_issues_count":70,"forks":38,"open_issues":70,"watchers":10,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/influxdb/influxdb.com/pulls/325"},"html":{"href":"https://github.com/influxdb/influxdb.com/pull/325"},"issue":{"href":"https://api.github.com/repos/influxdb/influxdb.com/issues/325"},"comments":{"href":"https://api.github.com/repos/influxdb/influxdb.com/issues/325/comments"},"review_comments":{"href":"https://api.github.com/repos/influxdb/influxdb.com/pulls/325/comments"},"review_comment":{"href":"https://api.github.com/repos/influxdb/influxdb.com/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/influxdb/influxdb.com/pulls/325/commits"},"statuses":{"href":"https://api.github.com/repos/influxdb/influxdb.com/statuses/1655af0a8df61625d8e3119d980d19e2a7c1fefa"}}}}