{"action":"created","issue":{"url":"https://api.github.com/repos/prometheus/prometheus/issues/1002","labels_url":"https://api.github.com/repos/prometheus/prometheus/issues/1002/labels{/name}","comments_url":"https://api.github.com/repos/prometheus/prometheus/issues/1002/comments","events_url":"https://api.github.com/repos/prometheus/prometheus/issues/1002/events","html_url":"https://github.com/prometheus/prometheus/issues/1002","id":101661405,"number":1002,"title":"Remove RUNBOOK from alerts","user":{"login":"brian-brazil","id":7115638,"avatar_url":"https://avatars.githubusercontent.com/u/7115638?v=3","gravatar_id":"","url":"https://api.github.com/users/brian-brazil","html_url":"https://github.com/brian-brazil","followers_url":"https://api.github.com/users/brian-brazil/followers","following_url":"https://api.github.com/users/brian-brazil/following{/other_user}","gists_url":"https://api.github.com/users/brian-brazil/gists{/gist_id}","starred_url":"https://api.github.com/users/brian-brazil/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brian-brazil/subscriptions","organizations_url":"https://api.github.com/users/brian-brazil/orgs","repos_url":"https://api.github.com/users/brian-brazil/repos","events_url":"https://api.github.com/users/brian-brazil/events{/privacy}","received_events_url":"https://api.github.com/users/brian-brazil/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":58,"created_at":"2015-08-18T13:55:47Z","updated_at":"2015-09-24T17:21:47Z","closed_at":null,"body":"RUNBOOK was added in a hurry in #843 for an internal demo of one of our users, which didn't give it enough time to be fully discussed. The demo has been done, so we can reconsider this.\r\n\r\n I think we should revert this change, and remove RUNBOOK:\r\n  * Our general policy is that if it can be done with labels, do it with labels\r\n  * All notification methods in the alertmanager will need extra code to deal with this\r\n  * In future, all alertmanager notification templates will need extra code to deal with this\r\n  * In general, all user code touching the alertmanager will need extra code to deal with this\r\n  * This presumes a certain workflow in that you have something called a \"runbook\" (and not any other name - playbook is also common) and that you have exactly one of them\r\n\r\nRunbooks are not a fundamental aspect of an alert, are not in use by all of our users and thus I don't believe they meet the bar for first-class support within prometheus. This is especially true considering that they don't add anything that isn't already possible with labels."},"comment":{"url":"https://api.github.com/repos/prometheus/prometheus/issues/comments/142994418","html_url":"https://github.com/prometheus/prometheus/issues/1002#issuecomment-142994418","issue_url":"https://api.github.com/repos/prometheus/prometheus/issues/1002","id":142994418,"user":{"login":"brian-brazil","id":7115638,"avatar_url":"https://avatars.githubusercontent.com/u/7115638?v=3","gravatar_id":"","url":"https://api.github.com/users/brian-brazil","html_url":"https://github.com/brian-brazil","followers_url":"https://api.github.com/users/brian-brazil/followers","following_url":"https://api.github.com/users/brian-brazil/following{/other_user}","gists_url":"https://api.github.com/users/brian-brazil/gists{/gist_id}","starred_url":"https://api.github.com/users/brian-brazil/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brian-brazil/subscriptions","organizations_url":"https://api.github.com/users/brian-brazil/orgs","repos_url":"https://api.github.com/users/brian-brazil/repos","events_url":"https://api.github.com/users/brian-brazil/events{/privacy}","received_events_url":"https://api.github.com/users/brian-brazil/received_events","type":"User","site_admin":false},"created_at":"2015-09-24T17:21:47Z","updated_at":"2015-09-24T17:21:47Z","body":"> while the description/summary solution would degrade into one 75% hate once we have to introduce user-configurable payload.\r\n\r\nI'm okay with introducing user-configurable payloads + summary/description once the use case arises. I'd rather not do so prematurely, as in the best case it'll cause confusion about the two types of labels and I'm not convinced yet that we'll end up needing it."}}