{"action":"created","comment":{"url":"https://api.github.com/repos/Particular/ServiceControl/pulls/comments/103842647","pull_request_review_id":24643559,"id":103842647,"diff_hunk":"@@ -0,0 +1,49 @@\n+At its heart ServiceControl and ServicePulse provide operational support for systems built on the Particular Service Platform. They do this by:\n+\n+- monitoring system health\n+- diagnosing and treating errors\n+\n+In this context, system refers to NServiceBus endpoints and communication with third-party services.\n+\n+ServiceControl should provide the following features:\n+\n+- process and store the contents of the error queue\n+- replay messages from the error queue\n+- process and store the contents of the audit queue\n+- generate and collect heartbeat messages\n+- generate and collect saga state changes\n+- provide an API for monitoring user-defined conditions\n+- provide operational events for consumption by other applications\n+\n+Implicit in these requirements is that ServiceControl should:\n+\n+- scale to an entire system based on the Particular Service Platform\n+- be durable (i.e. no message loss)\n+\n+### Process and store the contents of the error queue\n+\n+Rationale: To view the contents of the error queue in order to triage potential bugs or infrastructure failures in a system.\n+\n+### Replay messages from the error queue\n+\n+Rationale: To recover from bugs or infrastructure failures in order to maintain stability of a system.\n+\n+### Process and store the contents of the audit queue\n+\n+Rationale: To verify that a replayed message completed successfully. To understand the emergent design of a system through correllated messages. To identify design flaws in a system.","path":"docs/requirements.md","position":45,"original_position":33,"commit_id":"a6f341a230166648f4f7e9d85fe4353b41378c42","original_commit_id":"420ddcf67d21abade0df0b3a4eb5a5de9757f0c9","user":{"login":"mikeminutillo","id":124014,"avatar_url":"https://avatars3.githubusercontent.com/u/124014?v=3","gravatar_id":"","url":"https://api.github.com/users/mikeminutillo","html_url":"https://github.com/mikeminutillo","followers_url":"https://api.github.com/users/mikeminutillo/followers","following_url":"https://api.github.com/users/mikeminutillo/following{/other_user}","gists_url":"https://api.github.com/users/mikeminutillo/gists{/gist_id}","starred_url":"https://api.github.com/users/mikeminutillo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mikeminutillo/subscriptions","organizations_url":"https://api.github.com/users/mikeminutillo/orgs","repos_url":"https://api.github.com/users/mikeminutillo/repos","events_url":"https://api.github.com/users/mikeminutillo/events{/privacy}","received_events_url":"https://api.github.com/users/mikeminutillo/received_events","type":"User","site_admin":false},"body":"I'd also question whether reading from the audit queue is the most efficient way to detect successful retries. Without that requirement, the decision to audit or not is completely decoupled from the recoverability/retries capability.","created_at":"2017-03-02T03:03:45Z","updated_at":"2017-03-02T03:21:39Z","html_url":"https://github.com/Particular/ServiceControl/pull/902#discussion_r103842647","pull_request_url":"https://api.github.com/repos/Particular/ServiceControl/pulls/902","_links":{"self":{"href":"https://api.github.com/repos/Particular/ServiceControl/pulls/comments/103842647"},"html":{"href":"https://github.com/Particular/ServiceControl/pull/902#discussion_r103842647"},"pull_request":{"href":"https://api.github.com/repos/Particular/ServiceControl/pulls/902"}}},"pull_request":{"url":"https://api.github.com/repos/Particular/ServiceControl/pulls/902","id":102516543,"html_url":"https://github.com/Particular/ServiceControl/pull/902","diff_url":"https://github.com/Particular/ServiceControl/pull/902.diff","patch_url":"https://github.com/Particular/ServiceControl/pull/902.patch","issue_url":"https://api.github.com/repos/Particular/ServiceControl/issues/902","number":902,"state":"open","locked":false,"title":"[WIP] Draft of requirements","user":{"login":"kbaley","id":130546,"avatar_url":"https://avatars2.githubusercontent.com/u/130546?v=3","gravatar_id":"","url":"https://api.github.com/users/kbaley","html_url":"https://github.com/kbaley","followers_url":"https://api.github.com/users/kbaley/followers","following_url":"https://api.github.com/users/kbaley/following{/other_user}","gists_url":"https://api.github.com/users/kbaley/gists{/gist_id}","starred_url":"https://api.github.com/users/kbaley/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kbaley/subscriptions","organizations_url":"https://api.github.com/users/kbaley/orgs","repos_url":"https://api.github.com/users/kbaley/repos","events_url":"https://api.github.com/users/kbaley/events{/privacy}","received_events_url":"https://api.github.com/users/kbaley/received_events","type":"User","site_admin":false},"body":"PR is meant to initiate discussions on the requirements of ServiceControl and ServicePulse. So far, we've captured what ServiceControl currently does as well as the business rationale for the major features.","created_at":"2017-01-20T18:56:42Z","updated_at":"2017-03-02T03:21:39Z","closed_at":null,"merged_at":null,"merge_commit_sha":"b12295fcab1b5f000d78b511235d27137b4b0759","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/Particular/ServiceControl/pulls/902/commits","review_comments_url":"https://api.github.com/repos/Particular/ServiceControl/pulls/902/comments","review_comment_url":"https://api.github.com/repos/Particular/ServiceControl/pulls/comments{/number}","comments_url":"https://api.github.com/repos/Particular/ServiceControl/issues/902/comments","statuses_url":"https://api.github.com/repos/Particular/ServiceControl/statuses/a6f341a230166648f4f7e9d85fe4353b41378c42","head":{"label":"Particular:requirements","ref":"requirements","sha":"a6f341a230166648f4f7e9d85fe4353b41378c42","user":{"login":"Particular","id":5038441,"avatar_url":"https://avatars3.githubusercontent.com/u/5038441?v=3","gravatar_id":"","url":"https://api.github.com/users/Particular","html_url":"https://github.com/Particular","followers_url":"https://api.github.com/users/Particular/followers","following_url":"https://api.github.com/users/Particular/following{/other_user}","gists_url":"https://api.github.com/users/Particular/gists{/gist_id}","starred_url":"https://api.github.com/users/Particular/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Particular/subscriptions","organizations_url":"https://api.github.com/users/Particular/orgs","repos_url":"https://api.github.com/users/Particular/repos","events_url":"https://api.github.com/users/Particular/events{/privacy}","received_events_url":"https://api.github.com/users/Particular/received_events","type":"Organization","site_admin":false},"repo":{"id":7913469,"name":"ServiceControl","full_name":"Particular/ServiceControl","owner":{"login":"Particular","id":5038441,"avatar_url":"https://avatars3.githubusercontent.com/u/5038441?v=3","gravatar_id":"","url":"https://api.github.com/users/Particular","html_url":"https://github.com/Particular","followers_url":"https://api.github.com/users/Particular/followers","following_url":"https://api.github.com/users/Particular/following{/other_user}","gists_url":"https://api.github.com/users/Particular/gists{/gist_id}","starred_url":"https://api.github.com/users/Particular/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Particular/subscriptions","organizations_url":"https://api.github.com/users/Particular/orgs","repos_url":"https://api.github.com/users/Particular/repos","events_url":"https://api.github.com/users/Particular/events{/privacy}","received_events_url":"https://api.github.com/users/Particular/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Particular/ServiceControl","description":"Backend for ServiceInsight and ServicePulse","fork":false,"url":"https://api.github.com/repos/Particular/ServiceControl","forks_url":"https://api.github.com/repos/Particular/ServiceControl/forks","keys_url":"https://api.github.com/repos/Particular/ServiceControl/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Particular/ServiceControl/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Particular/ServiceControl/teams","hooks_url":"https://api.github.com/repos/Particular/ServiceControl/hooks","issue_events_url":"https://api.github.com/repos/Particular/ServiceControl/issues/events{/number}","events_url":"https://api.github.com/repos/Particular/ServiceControl/events","assignees_url":"https://api.github.com/repos/Particular/ServiceControl/assignees{/user}","branches_url":"https://api.github.com/repos/Particular/ServiceControl/branches{/branch}","tags_url":"https://api.github.com/repos/Particular/ServiceControl/tags","blobs_url":"https://api.github.com/repos/Particular/ServiceControl/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Particular/ServiceControl/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Particular/ServiceControl/git/refs{/sha}","trees_url":"https://api.github.com/repos/Particular/ServiceControl/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Particular/ServiceControl/statuses/{sha}","languages_url":"https://api.github.com/repos/Particular/ServiceControl/languages","stargazers_url":"https://api.github.com/repos/Particular/ServiceControl/stargazers","contributors_url":"https://api.github.com/repos/Particular/ServiceControl/contributors","subscribers_url":"https://api.github.com/repos/Particular/ServiceControl/subscribers","subscription_url":"https://api.github.com/repos/Particular/ServiceControl/subscription","commits_url":"https://api.github.com/repos/Particular/ServiceControl/commits{/sha}","git_commits_url":"https://api.github.com/repos/Particular/ServiceControl/git/commits{/sha}","comments_url":"https://api.github.com/repos/Particular/ServiceControl/comments{/number}","issue_comment_url":"https://api.github.com/repos/Particular/ServiceControl/issues/comments{/number}","contents_url":"https://api.github.com/repos/Particular/ServiceControl/contents/{+path}","compare_url":"https://api.github.com/repos/Particular/ServiceControl/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Particular/ServiceControl/merges","archive_url":"https://api.github.com/repos/Particular/ServiceControl/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Particular/ServiceControl/downloads","issues_url":"https://api.github.com/repos/Particular/ServiceControl/issues{/number}","pulls_url":"https://api.github.com/repos/Particular/ServiceControl/pulls{/number}","milestones_url":"https://api.github.com/repos/Particular/ServiceControl/milestones{/number}","notifications_url":"https://api.github.com/repos/Particular/ServiceControl/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Particular/ServiceControl/labels{/name}","releases_url":"https://api.github.com/repos/Particular/ServiceControl/releases{/id}","deployments_url":"https://api.github.com/repos/Particular/ServiceControl/deployments","created_at":"2013-01-30T11:42:44Z","updated_at":"2017-01-08T11:05:36Z","pushed_at":"2017-02-23T08:13:41Z","git_url":"git://github.com/Particular/ServiceControl.git","ssh_url":"git@github.com:Particular/ServiceControl.git","clone_url":"https://github.com/Particular/ServiceControl.git","svn_url":"https://github.com/Particular/ServiceControl","homepage":"https://docs.particular.net/servicecontrol/","size":53193,"stargazers_count":17,"watchers_count":17,"language":"C#","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":26,"mirror_url":null,"open_issues_count":41,"forks":26,"open_issues":41,"watchers":17,"default_branch":"master"}},"base":{"label":"Particular:master","ref":"master","sha":"439240f9021e4224e458450366c4411c375901db","user":{"login":"Particular","id":5038441,"avatar_url":"https://avatars3.githubusercontent.com/u/5038441?v=3","gravatar_id":"","url":"https://api.github.com/users/Particular","html_url":"https://github.com/Particular","followers_url":"https://api.github.com/users/Particular/followers","following_url":"https://api.github.com/users/Particular/following{/other_user}","gists_url":"https://api.github.com/users/Particular/gists{/gist_id}","starred_url":"https://api.github.com/users/Particular/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Particular/subscriptions","organizations_url":"https://api.github.com/users/Particular/orgs","repos_url":"https://api.github.com/users/Particular/repos","events_url":"https://api.github.com/users/Particular/events{/privacy}","received_events_url":"https://api.github.com/users/Particular/received_events","type":"Organization","site_admin":false},"repo":{"id":7913469,"name":"ServiceControl","full_name":"Particular/ServiceControl","owner":{"login":"Particular","id":5038441,"avatar_url":"https://avatars3.githubusercontent.com/u/5038441?v=3","gravatar_id":"","url":"https://api.github.com/users/Particular","html_url":"https://github.com/Particular","followers_url":"https://api.github.com/users/Particular/followers","following_url":"https://api.github.com/users/Particular/following{/other_user}","gists_url":"https://api.github.com/users/Particular/gists{/gist_id}","starred_url":"https://api.github.com/users/Particular/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Particular/subscriptions","organizations_url":"https://api.github.com/users/Particular/orgs","repos_url":"https://api.github.com/users/Particular/repos","events_url":"https://api.github.com/users/Particular/events{/privacy}","received_events_url":"https://api.github.com/users/Particular/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Particular/ServiceControl","description":"Backend for ServiceInsight and ServicePulse","fork":false,"url":"https://api.github.com/repos/Particular/ServiceControl","forks_url":"https://api.github.com/repos/Particular/ServiceControl/forks","keys_url":"https://api.github.com/repos/Particular/ServiceControl/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Particular/ServiceControl/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Particular/ServiceControl/teams","hooks_url":"https://api.github.com/repos/Particular/ServiceControl/hooks","issue_events_url":"https://api.github.com/repos/Particular/ServiceControl/issues/events{/number}","events_url":"https://api.github.com/repos/Particular/ServiceControl/events","assignees_url":"https://api.github.com/repos/Particular/ServiceControl/assignees{/user}","branches_url":"https://api.github.com/repos/Particular/ServiceControl/branches{/branch}","tags_url":"https://api.github.com/repos/Particular/ServiceControl/tags","blobs_url":"https://api.github.com/repos/Particular/ServiceControl/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Particular/ServiceControl/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Particular/ServiceControl/git/refs{/sha}","trees_url":"https://api.github.com/repos/Particular/ServiceControl/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Particular/ServiceControl/statuses/{sha}","languages_url":"https://api.github.com/repos/Particular/ServiceControl/languages","stargazers_url":"https://api.github.com/repos/Particular/ServiceControl/stargazers","contributors_url":"https://api.github.com/repos/Particular/ServiceControl/contributors","subscribers_url":"https://api.github.com/repos/Particular/ServiceControl/subscribers","subscription_url":"https://api.github.com/repos/Particular/ServiceControl/subscription","commits_url":"https://api.github.com/repos/Particular/ServiceControl/commits{/sha}","git_commits_url":"https://api.github.com/repos/Particular/ServiceControl/git/commits{/sha}","comments_url":"https://api.github.com/repos/Particular/ServiceControl/comments{/number}","issue_comment_url":"https://api.github.com/repos/Particular/ServiceControl/issues/comments{/number}","contents_url":"https://api.github.com/repos/Particular/ServiceControl/contents/{+path}","compare_url":"https://api.github.com/repos/Particular/ServiceControl/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Particular/ServiceControl/merges","archive_url":"https://api.github.com/repos/Particular/ServiceControl/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Particular/ServiceControl/downloads","issues_url":"https://api.github.com/repos/Particular/ServiceControl/issues{/number}","pulls_url":"https://api.github.com/repos/Particular/ServiceControl/pulls{/number}","milestones_url":"https://api.github.com/repos/Particular/ServiceControl/milestones{/number}","notifications_url":"https://api.github.com/repos/Particular/ServiceControl/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Particular/ServiceControl/labels{/name}","releases_url":"https://api.github.com/repos/Particular/ServiceControl/releases{/id}","deployments_url":"https://api.github.com/repos/Particular/ServiceControl/deployments","created_at":"2013-01-30T11:42:44Z","updated_at":"2017-01-08T11:05:36Z","pushed_at":"2017-02-23T08:13:41Z","git_url":"git://github.com/Particular/ServiceControl.git","ssh_url":"git@github.com:Particular/ServiceControl.git","clone_url":"https://github.com/Particular/ServiceControl.git","svn_url":"https://github.com/Particular/ServiceControl","homepage":"https://docs.particular.net/servicecontrol/","size":53193,"stargazers_count":17,"watchers_count":17,"language":"C#","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":26,"mirror_url":null,"open_issues_count":41,"forks":26,"open_issues":41,"watchers":17,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/Particular/ServiceControl/pulls/902"},"html":{"href":"https://github.com/Particular/ServiceControl/pull/902"},"issue":{"href":"https://api.github.com/repos/Particular/ServiceControl/issues/902"},"comments":{"href":"https://api.github.com/repos/Particular/ServiceControl/issues/902/comments"},"review_comments":{"href":"https://api.github.com/repos/Particular/ServiceControl/pulls/902/comments"},"review_comment":{"href":"https://api.github.com/repos/Particular/ServiceControl/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/Particular/ServiceControl/pulls/902/commits"},"statuses":{"href":"https://api.github.com/repos/Particular/ServiceControl/statuses/a6f341a230166648f4f7e9d85fe4353b41378c42"}}}}
{"actor":{"display_login":"mikeminutillo"}}