{"action":"created","issue":{"url":"https://api.github.com/repos/graphite-project/carbon/issues/262","labels_url":"https://api.github.com/repos/graphite-project/carbon/issues/262/labels{/name}","comments_url":"https://api.github.com/repos/graphite-project/carbon/issues/262/comments","events_url":"https://api.github.com/repos/graphite-project/carbon/issues/262/events","html_url":"https://github.com/graphite-project/carbon/issues/262","id":39960791,"number":262,"title":"documentation of MAX_CREATES_PER_MINUTE needs clarification","user":{"login":"wk66","id":1059572,"avatar_url":"https://avatars.githubusercontent.com/u/1059572?v=3","gravatar_id":"","url":"https://api.github.com/users/wk66","html_url":"https://github.com/wk66","followers_url":"https://api.github.com/users/wk66/followers","following_url":"https://api.github.com/users/wk66/following{/other_user}","gists_url":"https://api.github.com/users/wk66/gists{/gist_id}","starred_url":"https://api.github.com/users/wk66/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wk66/subscriptions","organizations_url":"https://api.github.com/users/wk66/orgs","repos_url":"https://api.github.com/users/wk66/repos","events_url":"https://api.github.com/users/wk66/events{/privacy}","received_events_url":"https://api.github.com/users/wk66/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/graphite-project/carbon/labels/documentation","name":"documentation","color":"0052cc"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2014-08-11T14:01:07Z","updated_at":"2015-04-14T15:48:52Z","closed_at":null,"body":"In the file _carbon.conf.example_ you'll find documentation about **MAX_CREATES_PER_MINUTE**. It says, that with low values of that setting\r\n\r\n> it will take much longer for those metrics' database files to all get created and\r\n> thus longer until the data becomes usable.\r\n\r\nwhich I interpret as _\"the metrics you sent are queued up and written later\"_. But the truth is, that some of the metrics sent in that minute are **discarded**. The documentation should state that clearly! A user who sends new metrics which shall not be lost, has to set **MAX_CREATES_PER_MINUTE** to the highest needed number. A clarification on this behaviour would save many new users hours of research where carbon put the (of course new) metrics they just sent.\r\n\r\nIn the original use cases of Graphite this may not be an issue, but think of use cases where precious data is collected once a day (maybe at high cost) and stored into carbon/graphite."},"comment":{"url":"https://api.github.com/repos/graphite-project/carbon/issues/comments/92921532","html_url":"https://github.com/graphite-project/carbon/issues/262#issuecomment-92921532","issue_url":"https://api.github.com/repos/graphite-project/carbon/issues/262","id":92921532,"user":{"login":"gaborurbanics","id":11159849,"avatar_url":"https://avatars.githubusercontent.com/u/11159849?v=3","gravatar_id":"","url":"https://api.github.com/users/gaborurbanics","html_url":"https://github.com/gaborurbanics","followers_url":"https://api.github.com/users/gaborurbanics/followers","following_url":"https://api.github.com/users/gaborurbanics/following{/other_user}","gists_url":"https://api.github.com/users/gaborurbanics/gists{/gist_id}","starred_url":"https://api.github.com/users/gaborurbanics/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gaborurbanics/subscriptions","organizations_url":"https://api.github.com/users/gaborurbanics/orgs","repos_url":"https://api.github.com/users/gaborurbanics/repos","events_url":"https://api.github.com/users/gaborurbanics/events{/privacy}","received_events_url":"https://api.github.com/users/gaborurbanics/received_events","type":"User","site_admin":false},"created_at":"2015-04-14T15:48:52Z","updated_at":"2015-04-14T15:48:52Z","body":":+1: That was a bit confusing in the doc for me, as well. Btw, do you know if there is any plan to change this behaviour (e.g. caching those metrics instead of dropping them) or make this configurable? Thx!"}}