{"action":"opened","number":108,"pull_request":{"url":"https://api.github.com/repos/apache/incubator-metron/pulls/108","id":69221647,"html_url":"https://github.com/apache/incubator-metron/pull/108","diff_url":"https://github.com/apache/incubator-metron/pull/108.diff","patch_url":"https://github.com/apache/incubator-metron/pull/108.patch","issue_url":"https://api.github.com/repos/apache/incubator-metron/issues/108","number":108,"state":"open","locked":false,"title":"METRON-141: The ability to do threat triage","user":{"login":"cestella","id":540359,"avatar_url":"https://avatars.githubusercontent.com/u/540359?v=3","gravatar_id":"","url":"https://api.github.com/users/cestella","html_url":"https://github.com/cestella","followers_url":"https://api.github.com/users/cestella/followers","following_url":"https://api.github.com/users/cestella/following{/other_user}","gists_url":"https://api.github.com/users/cestella/gists{/gist_id}","starred_url":"https://api.github.com/users/cestella/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cestella/subscriptions","organizations_url":"https://api.github.com/users/cestella/orgs","repos_url":"https://api.github.com/users/cestella/repos","events_url":"https://api.github.com/users/cestella/events{/privacy}","received_events_url":"https://api.github.com/users/cestella/received_events","type":"User","site_admin":false},"body":"We have the ability to mark messages as part of the enrichment topology as threat alerts, but we have no ability to prioritize those alerts.\r\n\r\nWe should allow for the prioritization of messages that have some threat intelligence alert via a scoring mechanism. \r\n\r\nThe general idea is for each message from each sensor:\r\n1. Map threat conditions as defined by a lightweight query language to threat levels (a number).\r\n2. More than one condition may match a given message, so allow for the choice of aggregation functions.\r\n3. If the aggregated score is positive, then add a field (`threat.triage.level`) with the level to the JSON message.\r\n\r\nThe above configuration is done at the per-sensor level.\r\n\r\nAs part of this PR, the following were added out of necessity:\r\n* A query language DSL which is used in defining the conditions which map to threat levels.  Docs at [here](https://github.com/cestella/incubator-metron/tree/METRON-141/metron-platform/metron-common#query-language)\r\n* The addition of a `triageConfig` section to the sensor enrichment config.  Description at [here](https://github.com/cestella/incubator-metron/tree/METRON-141/metron-platform/metron-common#the-threatintel-configuration)\r\n* Actual documentation of our enrichment configuration.  Documentation at [here](https://github.com/cestella/incubator-metron/tree/METRON-141/metron-platform/metron-common#enrichment-configuration)\r\n* A rewrite of the `zk_load_configs.sh` utility to support both pushing and pulling configs (the threat triage rules are part of the configs and until we have a UI, we need to add them).  Docs at [here](https://github.com/cestella/incubator-metron/tree/METRON-141/metron-platform/metron-common#management-utility)\r\n\r\n","created_at":"2016-05-06T22:59:17Z","updated_at":"2016-05-06T22:59:17Z","closed_at":null,"merged_at":null,"merge_commit_sha":null,"assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/apache/incubator-metron/pulls/108/commits","review_comments_url":"https://api.github.com/repos/apache/incubator-metron/pulls/108/comments","review_comment_url":"https://api.github.com/repos/apache/incubator-metron/pulls/comments{/number}","comments_url":"https://api.github.com/repos/apache/incubator-metron/issues/108/comments","statuses_url":"https://api.github.com/repos/apache/incubator-metron/statuses/cfdffd48d6a5ea7c228c4b66f23c16cc55691f79","head":{"label":"cestella:METRON-141","ref":"METRON-141","sha":"cfdffd48d6a5ea7c228c4b66f23c16cc55691f79","user":{"login":"cestella","id":540359,"avatar_url":"https://avatars.githubusercontent.com/u/540359?v=3","gravatar_id":"","url":"https://api.github.com/users/cestella","html_url":"https://github.com/cestella","followers_url":"https://api.github.com/users/cestella/followers","following_url":"https://api.github.com/users/cestella/following{/other_user}","gists_url":"https://api.github.com/users/cestella/gists{/gist_id}","starred_url":"https://api.github.com/users/cestella/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cestella/subscriptions","organizations_url":"https://api.github.com/users/cestella/orgs","repos_url":"https://api.github.com/users/cestella/repos","events_url":"https://api.github.com/users/cestella/events{/privacy}","received_events_url":"https://api.github.com/users/cestella/received_events","type":"User","site_admin":false},"repo":{"id":47701789,"name":"incubator-metron","full_name":"cestella/incubator-metron","owner":{"login":"cestella","id":540359,"avatar_url":"https://avatars.githubusercontent.com/u/540359?v=3","gravatar_id":"","url":"https://api.github.com/users/cestella","html_url":"https://github.com/cestella","followers_url":"https://api.github.com/users/cestella/followers","following_url":"https://api.github.com/users/cestella/following{/other_user}","gists_url":"https://api.github.com/users/cestella/gists{/gist_id}","starred_url":"https://api.github.com/users/cestella/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cestella/subscriptions","organizations_url":"https://api.github.com/users/cestella/orgs","repos_url":"https://api.github.com/users/cestella/repos","events_url":"https://api.github.com/users/cestella/events{/privacy}","received_events_url":"https://api.github.com/users/cestella/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/cestella/incubator-metron","description":"Mirror of Apache Metron (Incubating)","fork":true,"url":"https://api.github.com/repos/cestella/incubator-metron","forks_url":"https://api.github.com/repos/cestella/incubator-metron/forks","keys_url":"https://api.github.com/repos/cestella/incubator-metron/keys{/key_id}","collaborators_url":"https://api.github.com/repos/cestella/incubator-metron/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/cestella/incubator-metron/teams","hooks_url":"https://api.github.com/repos/cestella/incubator-metron/hooks","issue_events_url":"https://api.github.com/repos/cestella/incubator-metron/issues/events{/number}","events_url":"https://api.github.com/repos/cestella/incubator-metron/events","assignees_url":"https://api.github.com/repos/cestella/incubator-metron/assignees{/user}","branches_url":"https://api.github.com/repos/cestella/incubator-metron/branches{/branch}","tags_url":"https://api.github.com/repos/cestella/incubator-metron/tags","blobs_url":"https://api.github.com/repos/cestella/incubator-metron/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/cestella/incubator-metron/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/cestella/incubator-metron/git/refs{/sha}","trees_url":"https://api.github.com/repos/cestella/incubator-metron/git/trees{/sha}","statuses_url":"https://api.github.com/repos/cestella/incubator-metron/statuses/{sha}","languages_url":"https://api.github.com/repos/cestella/incubator-metron/languages","stargazers_url":"https://api.github.com/repos/cestella/incubator-metron/stargazers","contributors_url":"https://api.github.com/repos/cestella/incubator-metron/contributors","subscribers_url":"https://api.github.com/repos/cestella/incubator-metron/subscribers","subscription_url":"https://api.github.com/repos/cestella/incubator-metron/subscription","commits_url":"https://api.github.com/repos/cestella/incubator-metron/commits{/sha}","git_commits_url":"https://api.github.com/repos/cestella/incubator-metron/git/commits{/sha}","comments_url":"https://api.github.com/repos/cestella/incubator-metron/comments{/number}","issue_comment_url":"https://api.github.com/repos/cestella/incubator-metron/issues/comments{/number}","contents_url":"https://api.github.com/repos/cestella/incubator-metron/contents/{+path}","compare_url":"https://api.github.com/repos/cestella/incubator-metron/compare/{base}...{head}","merges_url":"https://api.github.com/repos/cestella/incubator-metron/merges","archive_url":"https://api.github.com/repos/cestella/incubator-metron/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/cestella/incubator-metron/downloads","issues_url":"https://api.github.com/repos/cestella/incubator-metron/issues{/number}","pulls_url":"https://api.github.com/repos/cestella/incubator-metron/pulls{/number}","milestones_url":"https://api.github.com/repos/cestella/incubator-metron/milestones{/number}","notifications_url":"https://api.github.com/repos/cestella/incubator-metron/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/cestella/incubator-metron/labels{/name}","releases_url":"https://api.github.com/repos/cestella/incubator-metron/releases{/id}","deployments_url":"https://api.github.com/repos/cestella/incubator-metron/deployments","created_at":"2015-12-09T15:57:23Z","updated_at":"2016-01-27T14:23:10Z","pushed_at":"2016-05-06T22:46:16Z","git_url":"git://github.com/cestella/incubator-metron.git","ssh_url":"git@github.com:cestella/incubator-metron.git","clone_url":"https://github.com/cestella/incubator-metron.git","svn_url":"https://github.com/cestella/incubator-metron","homepage":null,"size":41466,"stargazers_count":0,"watchers_count":0,"language":"Java","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"apache:master","ref":"master","sha":"ec431b8dd2a6bb5c275ef3825c1c7516ec4ffce9","user":{"login":"apache","id":47359,"avatar_url":"https://avatars.githubusercontent.com/u/47359?v=3","gravatar_id":"","url":"https://api.github.com/users/apache","html_url":"https://github.com/apache","followers_url":"https://api.github.com/users/apache/followers","following_url":"https://api.github.com/users/apache/following{/other_user}","gists_url":"https://api.github.com/users/apache/gists{/gist_id}","starred_url":"https://api.github.com/users/apache/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apache/subscriptions","organizations_url":"https://api.github.com/users/apache/orgs","repos_url":"https://api.github.com/users/apache/repos","events_url":"https://api.github.com/users/apache/events{/privacy}","received_events_url":"https://api.github.com/users/apache/received_events","type":"Organization","site_admin":false},"repo":{"id":47607561,"name":"incubator-metron","full_name":"apache/incubator-metron","owner":{"login":"apache","id":47359,"avatar_url":"https://avatars.githubusercontent.com/u/47359?v=3","gravatar_id":"","url":"https://api.github.com/users/apache","html_url":"https://github.com/apache","followers_url":"https://api.github.com/users/apache/followers","following_url":"https://api.github.com/users/apache/following{/other_user}","gists_url":"https://api.github.com/users/apache/gists{/gist_id}","starred_url":"https://api.github.com/users/apache/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/apache/subscriptions","organizations_url":"https://api.github.com/users/apache/orgs","repos_url":"https://api.github.com/users/apache/repos","events_url":"https://api.github.com/users/apache/events{/privacy}","received_events_url":"https://api.github.com/users/apache/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/apache/incubator-metron","description":"Mirror of Apache Metron (Incubating)","fork":false,"url":"https://api.github.com/repos/apache/incubator-metron","forks_url":"https://api.github.com/repos/apache/incubator-metron/forks","keys_url":"https://api.github.com/repos/apache/incubator-metron/keys{/key_id}","collaborators_url":"https://api.github.com/repos/apache/incubator-metron/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/apache/incubator-metron/teams","hooks_url":"https://api.github.com/repos/apache/incubator-metron/hooks","issue_events_url":"https://api.github.com/repos/apache/incubator-metron/issues/events{/number}","events_url":"https://api.github.com/repos/apache/incubator-metron/events","assignees_url":"https://api.github.com/repos/apache/incubator-metron/assignees{/user}","branches_url":"https://api.github.com/repos/apache/incubator-metron/branches{/branch}","tags_url":"https://api.github.com/repos/apache/incubator-metron/tags","blobs_url":"https://api.github.com/repos/apache/incubator-metron/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/apache/incubator-metron/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/apache/incubator-metron/git/refs{/sha}","trees_url":"https://api.github.com/repos/apache/incubator-metron/git/trees{/sha}","statuses_url":"https://api.github.com/repos/apache/incubator-metron/statuses/{sha}","languages_url":"https://api.github.com/repos/apache/incubator-metron/languages","stargazers_url":"https://api.github.com/repos/apache/incubator-metron/stargazers","contributors_url":"https://api.github.com/repos/apache/incubator-metron/contributors","subscribers_url":"https://api.github.com/repos/apache/incubator-metron/subscribers","subscription_url":"https://api.github.com/repos/apache/incubator-metron/subscription","commits_url":"https://api.github.com/repos/apache/incubator-metron/commits{/sha}","git_commits_url":"https://api.github.com/repos/apache/incubator-metron/git/commits{/sha}","comments_url":"https://api.github.com/repos/apache/incubator-metron/comments{/number}","issue_comment_url":"https://api.github.com/repos/apache/incubator-metron/issues/comments{/number}","contents_url":"https://api.github.com/repos/apache/incubator-metron/contents/{+path}","compare_url":"https://api.github.com/repos/apache/incubator-metron/compare/{base}...{head}","merges_url":"https://api.github.com/repos/apache/incubator-metron/merges","archive_url":"https://api.github.com/repos/apache/incubator-metron/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/apache/incubator-metron/downloads","issues_url":"https://api.github.com/repos/apache/incubator-metron/issues{/number}","pulls_url":"https://api.github.com/repos/apache/incubator-metron/pulls{/number}","milestones_url":"https://api.github.com/repos/apache/incubator-metron/milestones{/number}","notifications_url":"https://api.github.com/repos/apache/incubator-metron/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/apache/incubator-metron/labels{/name}","releases_url":"https://api.github.com/repos/apache/incubator-metron/releases{/id}","deployments_url":"https://api.github.com/repos/apache/incubator-metron/deployments","created_at":"2015-12-08T08:00:05Z","updated_at":"2016-05-05T19:46:20Z","pushed_at":"2016-05-06T22:53:11Z","git_url":"git://github.com/apache/incubator-metron.git","ssh_url":"git@github.com:apache/incubator-metron.git","clone_url":"https://github.com/apache/incubator-metron.git","svn_url":"https://github.com/apache/incubator-metron","homepage":null,"size":41649,"stargazers_count":54,"watchers_count":54,"language":"Java","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":54,"mirror_url":"git://git.apache.org/incubator-metron.git","open_issues_count":7,"forks":54,"open_issues":7,"watchers":54,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/apache/incubator-metron/pulls/108"},"html":{"href":"https://github.com/apache/incubator-metron/pull/108"},"issue":{"href":"https://api.github.com/repos/apache/incubator-metron/issues/108"},"comments":{"href":"https://api.github.com/repos/apache/incubator-metron/issues/108/comments"},"review_comments":{"href":"https://api.github.com/repos/apache/incubator-metron/pulls/108/comments"},"review_comment":{"href":"https://api.github.com/repos/apache/incubator-metron/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/apache/incubator-metron/pulls/108/commits"},"statuses":{"href":"https://api.github.com/repos/apache/incubator-metron/statuses/cfdffd48d6a5ea7c228c4b66f23c16cc55691f79"}},"merged":false,"mergeable":null,"mergeable_state":"unknown","merged_by":null,"comments":0,"review_comments":0,"commits":1,"additions":4843,"deletions":471,"changed_files":89}}