{"action":"closed","issue":{"url":"https://api.github.com/repos/docker/docker.github.io/issues/5432","repository_url":"https://api.github.com/repos/docker/docker.github.io","labels_url":"https://api.github.com/repos/docker/docker.github.io/issues/5432/labels{/name}","comments_url":"https://api.github.com/repos/docker/docker.github.io/issues/5432/comments","events_url":"https://api.github.com/repos/docker/docker.github.io/issues/5432/events","html_url":"https://github.com/docker/docker.github.io/issues/5432","id":278729947,"number":5432,"title":"Add Docker Events notes about limited backlog of events and event scope.","user":{"login":"BretFisher","id":792287,"avatar_url":"https://avatars0.githubusercontent.com/u/792287?v=4","gravatar_id":"","url":"https://api.github.com/users/BretFisher","html_url":"https://github.com/BretFisher","followers_url":"https://api.github.com/users/BretFisher/followers","following_url":"https://api.github.com/users/BretFisher/following{/other_user}","gists_url":"https://api.github.com/users/BretFisher/gists{/gist_id}","starred_url":"https://api.github.com/users/BretFisher/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/BretFisher/subscriptions","organizations_url":"https://api.github.com/users/BretFisher/orgs","repos_url":"https://api.github.com/users/BretFisher/repos","events_url":"https://api.github.com/users/BretFisher/events{/privacy}","received_events_url":"https://api.github.com/users/BretFisher/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2017-12-03T00:07:36Z","updated_at":"2017-12-04T19:50:06Z","closed_at":"2017-12-04T19:50:06Z","author_association":"CONTRIBUTOR","body":"File: [engine/reference/commandline/events.md](https://docs.docker.com/engine/reference/commandline/events/), CC @mistyhacks\r\n\r\n1) Great doc on the events command but I don't see anything to educate the user on the backlog limits of the events cli/api.  With all the nice date-based filter values, the reader might think it would be a file written to disk for long-term storage like the dockerd log.  I don't think that's the case, but I'm coming up with little info on how much is exactly stored.  I see a @cpuguy83 [mention here of 1000 event backlog maximum](https://github.com/moby/moby/issues/29548#issuecomment-268329529) (I assume per node). If that's true, it would be great to mention it here.\r\n2) Second, only after using them a while did I realize that Swarm events (services/nodes/secrets/configs) are seen on managers only, and any other events are only from the local server. I know there's a filter shown for `local|swarm` but maybe it would improve visibility of this big difference to mention the two types in description, with something like \"different event types have different scopes, local scoped events are only seen on the node they take place on, and swarm scoped events are seen on all managers\".\r\n\r\nIf you think this is good additional info, I'm happy to submit PR but wanted to get confirmation and feedback first. Maybe these two should just be added to the [top description](https://github.com/docker/cli/blob/master/docs/reference/commandline/events.md#events)?\r\n"}}
{"actor":{"display_login":"johndmulhausen"}}