{"action":"created","issue":{"url":"https://api.github.com/repos/logentries/le/issues/75","labels_url":"https://api.github.com/repos/logentries/le/issues/75/labels{/name}","comments_url":"https://api.github.com/repos/logentries/le/issues/75/comments","events_url":"https://api.github.com/repos/logentries/le/issues/75/events","html_url":"https://github.com/logentries/le/issues/75","id":57738415,"number":75,"title":"README.md Documentation Updates","user":{"login":"virgofx","id":739719,"avatar_url":"https://avatars.githubusercontent.com/u/739719?v=3","gravatar_id":"","url":"https://api.github.com/users/virgofx","html_url":"https://github.com/virgofx","followers_url":"https://api.github.com/users/virgofx/followers","following_url":"https://api.github.com/users/virgofx/following{/other_user}","gists_url":"https://api.github.com/users/virgofx/gists{/gist_id}","starred_url":"https://api.github.com/users/virgofx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/virgofx/subscriptions","organizations_url":"https://api.github.com/users/virgofx/orgs","repos_url":"https://api.github.com/users/virgofx/repos","events_url":"https://api.github.com/users/virgofx/events{/privacy}","received_events_url":"https://api.github.com/users/virgofx/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2015-02-15T17:42:31Z","updated_at":"2015-02-18T14:30:53Z","closed_at":null,"body":"From my latest installation and testing with the software ... here are some comments on the documentation. I figured it could be wrapped into a single issue.\r\n\r\n\r\n1) The configuration path seems to be wrong. Configuration is located in the **proper** `/etc/le/config` location.\r\n```\r\nLocal configuration\r\n\r\nThe agent stores configuration in ~/.le/config for ordinary users and in /root/le/config for root (daemon). It is created with init or reinit commands and can be created or modified manually.\r\n```\r\n\r\n2) `Filers are useful` ... should be **Filters**\r\n\r\n3) Metrics - psutil\r\nWhile there is a note for the requirement for **psutil** at the very bottom... it took me hours to figure out this was the issue. If this could be set as a Github markdown note (using ` > `) immediately under the title with more emphasis, this would save a lot of troubleshooting time. Something to the effect \"IMPORTANT: Metrics requires **psutil** and will not appear in LogEntries unless this is installed.\r\n\r\nPerhaps even better ... since logentries is now done via package management ... would it be possible to specify psutil as a required dependency during the yum install / apt-get install ?\r\n\r\n5) System Stat Token\r\nI realize this is beta, however there really is no documentation on this, it's functionality, how it differs from the metrics token, how to use it, etc?\r\n\r\n6) Log Stats Distinction\r\nThe metrics section made sense for logging specific metrics into a defined log. I was unable to find any related information on logging what seems to be the CPU, Disk, and Bandwidth into the automated graphs section at the very top of the host section in the UI. Could the documentation be updated to include instructions/distinctions on this section and how to populate this data? I saw a couple screenshots in the LogEntries home page doc section; however, all it said was to install the agent (oh great, did that, now what?). Most DevOps and engineers tend to read through these source readme's much more thoroughly as the information contained within here is much more technical so having a discussion on how that works here would be incredible useful.\r\n![image](https://cloud.githubusercontent.com/assets/739719/6204214/71b468c0-b4f7-11e4-8b04-5e96fafb0602.png)\r\n\r\n7) Architecture Design Question\r\nThe `/etc/le/config` seems to store the majority of the information. The followed files seem to pick up whats been explicitly followed via the command as well as what's specified as followed within the host in the app(if i'm correct). I did not see any output of followed files in the config (Perhaps very useful if `pull-server-config` is false).  Would it be possible to specify a best practice installation rollout for environments that spin up lots of servers in an automated fashion.\r\n\r\nWould the recommended course of action be either:\r\na) Install LE, register host with account key, then run multiple follow commands for the designated files?\r\nor\r\nb) Install LE, register host, and drop in enterprise config file (that includes follow options).\r\n\r\nThere seems to be a few ways to do things (even define followed files via the UI, see #74) so I'm perhaps just asking for some clarification in the direction of the agent.\r\n\r\nVery pleased so far."},"comment":{"url":"https://api.github.com/repos/logentries/le/issues/comments/74872249","html_url":"https://github.com/logentries/le/issues/75#issuecomment-74872249","issue_url":"https://api.github.com/repos/logentries/le/issues/75","id":74872249,"user":{"login":"StephenHynes7","id":4609179,"avatar_url":"https://avatars.githubusercontent.com/u/4609179?v=3","gravatar_id":"","url":"https://api.github.com/users/StephenHynes7","html_url":"https://github.com/StephenHynes7","followers_url":"https://api.github.com/users/StephenHynes7/followers","following_url":"https://api.github.com/users/StephenHynes7/following{/other_user}","gists_url":"https://api.github.com/users/StephenHynes7/gists{/gist_id}","starred_url":"https://api.github.com/users/StephenHynes7/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/StephenHynes7/subscriptions","organizations_url":"https://api.github.com/users/StephenHynes7/orgs","repos_url":"https://api.github.com/users/StephenHynes7/repos","events_url":"https://api.github.com/users/StephenHynes7/events{/privacy}","received_events_url":"https://api.github.com/users/StephenHynes7/received_events","type":"User","site_admin":false},"created_at":"2015-02-18T14:30:53Z","updated_at":"2015-02-18T14:30:53Z","body":"We even have support Diamond :) https://github.com/BrightcoveOS/Diamond/blob/master/src/diamond/handler/logentries_diamond.py"}}