)]}'
{"specs/newton/approved/json-schema-for-notifications.rst":[{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"196b51a7f2fcdff6bcdde8e8689029b592fe2cc9","unresolved":false,"context_lines":[{"line_number":8,"context_line":"JSON schema for notifications"},{"line_number":9,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Include the URL of your launchpad blueprint:"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"https://blueprints.launchpad.net/nova/+spec/json-schema-for-notifications"},{"line_number":14,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a18252c_a2d9a585","line":11,"updated":"2016-04-13 23:21:23.000000000","message":"You can remove this line. :)","commit_id":"3d12631ee475f0fd601e30073486b8f37d709659"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"7e1245e8010a195268cc89fdf5181d5ac52f805f","unresolved":false,"context_lines":[{"line_number":8,"context_line":"JSON schema for notifications"},{"line_number":9,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Include the URL of your launchpad blueprint:"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"https://blueprints.launchpad.net/nova/+spec/json-schema-for-notifications"},{"line_number":14,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a18252c_d558c18c","line":11,"in_reply_to":"5a18252c_a2d9a585","updated":"2016-04-14 12:21:43.000000000","message":"Done :)","commit_id":"3d12631ee475f0fd601e30073486b8f37d709659"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"196b51a7f2fcdff6bcdde8e8689029b592fe2cc9","unresolved":false,"context_lines":[{"line_number":13,"context_line":"https://blueprints.launchpad.net/nova/+spec/json-schema-for-notifications"},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Versioned notifications has a well defined schema implemented with versioned"},{"line_number":16,"context_line":"objects. This schema prevents nova to change the structure of the notification"},{"line_number":17,"context_line":"without communicating the change with the notification consumers. This"},{"line_number":18,"context_line":"communication is done via the version number embedded into the notification"},{"line_number":19,"context_line":"payload. However this communication is limited and does not contains"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a18252c_e2e39d31","line":16,"range":{"start_line":16,"start_character":35,"end_line":16,"end_character":44},"updated":"2016-04-13 23:21:23.000000000","message":"from changing","commit_id":"3d12631ee475f0fd601e30073486b8f37d709659"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"7e1245e8010a195268cc89fdf5181d5ac52f805f","unresolved":false,"context_lines":[{"line_number":13,"context_line":"https://blueprints.launchpad.net/nova/+spec/json-schema-for-notifications"},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Versioned notifications has a well defined schema implemented with versioned"},{"line_number":16,"context_line":"objects. This schema prevents nova to change the structure of the notification"},{"line_number":17,"context_line":"without communicating the change with the notification consumers. This"},{"line_number":18,"context_line":"communication is done via the version number embedded into the notification"},{"line_number":19,"context_line":"payload. However this communication is limited and does not contains"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a18252c_9562c93c","line":16,"range":{"start_line":16,"start_character":35,"end_line":16,"end_character":44},"in_reply_to":"5a18252c_e2e39d31","updated":"2016-04-14 12:21:43.000000000","message":"Done","commit_id":"3d12631ee475f0fd601e30073486b8f37d709659"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"196b51a7f2fcdff6bcdde8e8689029b592fe2cc9","unresolved":false,"context_lines":[{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Versioned notifications has a well defined schema implemented with versioned"},{"line_number":16,"context_line":"objects. This schema prevents nova to change the structure of the notification"},{"line_number":17,"context_line":"without communicating the change with the notification consumers. This"},{"line_number":18,"context_line":"communication is done via the version number embedded into the notification"},{"line_number":19,"context_line":"payload. However this communication is limited and does not contains"},{"line_number":20,"context_line":"information about what is changed in the schema or what is the the structure of"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a18252c_22d47545","line":17,"range":{"start_line":17,"start_character":33,"end_line":17,"end_character":37},"updated":"2016-04-13 23:21:23.000000000","message":"to","commit_id":"3d12631ee475f0fd601e30073486b8f37d709659"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"7e1245e8010a195268cc89fdf5181d5ac52f805f","unresolved":false,"context_lines":[{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Versioned notifications has a well defined schema implemented with versioned"},{"line_number":16,"context_line":"objects. This schema prevents nova to change the structure of the notification"},{"line_number":17,"context_line":"without communicating the change with the notification consumers. This"},{"line_number":18,"context_line":"communication is done via the version number embedded into the notification"},{"line_number":19,"context_line":"payload. However this communication is limited and does not contains"},{"line_number":20,"context_line":"information about what is changed in the schema or what is the the structure of"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a18252c_b5d425bd","line":17,"range":{"start_line":17,"start_character":33,"end_line":17,"end_character":37},"in_reply_to":"5a18252c_22d47545","updated":"2016-04-14 12:21:43.000000000","message":"Done","commit_id":"3d12631ee475f0fd601e30073486b8f37d709659"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"196b51a7f2fcdff6bcdde8e8689029b592fe2cc9","unresolved":false,"context_lines":[{"line_number":16,"context_line":"objects. This schema prevents nova to change the structure of the notification"},{"line_number":17,"context_line":"without communicating the change with the notification consumers. This"},{"line_number":18,"context_line":"communication is done via the version number embedded into the notification"},{"line_number":19,"context_line":"payload. However this communication is limited and does not contains"},{"line_number":20,"context_line":"information about what is changed in the schema or what is the the structure of"},{"line_number":21,"context_line":"a new notification."},{"line_number":22,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a18252c_82cbc9a4","line":19,"range":{"start_line":19,"start_character":60,"end_line":19,"end_character":68},"updated":"2016-04-13 23:21:23.000000000","message":"contain","commit_id":"3d12631ee475f0fd601e30073486b8f37d709659"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"7e1245e8010a195268cc89fdf5181d5ac52f805f","unresolved":false,"context_lines":[{"line_number":16,"context_line":"objects. This schema prevents nova to change the structure of the notification"},{"line_number":17,"context_line":"without communicating the change with the notification consumers. This"},{"line_number":18,"context_line":"communication is done via the version number embedded into the notification"},{"line_number":19,"context_line":"payload. However this communication is limited and does not contains"},{"line_number":20,"context_line":"information about what is changed in the schema or what is the the structure of"},{"line_number":21,"context_line":"a new notification."},{"line_number":22,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"5a18252c_15deb9dc","line":19,"range":{"start_line":19,"start_character":60,"end_line":19,"end_character":68},"in_reply_to":"5a18252c_82cbc9a4","updated":"2016-04-14 12:21:43.000000000","message":"Done","commit_id":"3d12631ee475f0fd601e30073486b8f37d709659"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"55c280ff5e69050cc00e8cb1bed096cb9d45fa1d","unresolved":false,"context_lines":[{"line_number":15,"context_line":"notification without communicating the change to the notification consumers."},{"line_number":16,"context_line":"This communication is done via the version number embedded into the"},{"line_number":17,"context_line":"notification payload. However this communication is limited and does not"},{"line_number":18,"context_line":"contain information about what is changed in the schema or what is the the"},{"line_number":19,"context_line":"structure of a new notification."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a122d0e_3a0df037","line":18,"updated":"2016-04-18 11:32:13.000000000","message":"s/is the the/is in the/ ?","commit_id":"36953df5b64dff5174bd4036388fe32ee973a040"},{"author":{"_account_id":11803,"name":"Ryan Rossiter","email":"rlrossit@us.ibm.com","username":"rlrossiter"},"change_message_id":"344c8d16d946cd92c05c1260600bae9e4f00c1a0","unresolved":false,"context_lines":[{"line_number":56,"context_line":"notification payload that the notification consumer software can use to"},{"line_number":57,"context_line":"understand and validate the received notification."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Therefore this spec proposes to add json schema for every versioned"},{"line_number":60,"context_line":"notification in Nova."},{"line_number":61,"context_line":""},{"line_number":62,"context_line":"Alternatives"},{"line_number":63,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"5a18252c_2976f9d6","line":60,"range":{"start_line":59,"start_character":0,"end_line":60,"end_character":21},"updated":"2016-04-14 13:13:03.000000000","message":"I\u0027m a little in the dark about the proposed change here. This is an API addition right? I didn\u0027t read anything about the API in here at all, so that worries me that we\u0027re passing this schema as a part of every notification that gets broadcasted. That\u0027ll be a lot of unnecessary MQ traffic.","commit_id":"36953df5b64dff5174bd4036388fe32ee973a040"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"dc6f5bfa516b411d0246ccb9b1d513743947eba7","unresolved":false,"context_lines":[{"line_number":57,"context_line":"understand and validate the received notification."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Therefore this spec proposes to add json schema for every versioned"},{"line_number":60,"context_line":"notification in Nova."},{"line_number":61,"context_line":""},{"line_number":62,"context_line":"Alternatives"},{"line_number":63,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a122d0e_96a3fdff","line":60,"in_reply_to":"1a122d0e_1abbd4e6","updated":"2016-04-19 15:12:42.000000000","message":"@Chris: Thanks for the info. Based on it I agree that let\u0027s store the schema first and add discoverability as a future step. I\u0027ll amend the spec to make this intention clear for the future reader.","commit_id":"36953df5b64dff5174bd4036388fe32ee973a040"},{"author":{"_account_id":11803,"name":"Ryan Rossiter","email":"rlrossit@us.ibm.com","username":"rlrossiter"},"change_message_id":"31cffdd1ea01c45904c1959cd7374f235d1ce8a2","unresolved":false,"context_lines":[{"line_number":56,"context_line":"notification payload that the notification consumer software can use to"},{"line_number":57,"context_line":"understand and validate the received notification."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Therefore this spec proposes to add json schema for every versioned"},{"line_number":60,"context_line":"notification in Nova."},{"line_number":61,"context_line":""},{"line_number":62,"context_line":"Alternatives"},{"line_number":63,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a122d0e_9249cdd3","line":60,"range":{"start_line":59,"start_character":0,"end_line":60,"end_character":21},"in_reply_to":"1a122d0e_8dc89576","updated":"2016-04-15 13:33:47.000000000","message":"Yeah I was trying to look at this from the standpoint of nova\u0027s source code is untouchable (which isn\u0027t the case, but from an ease-of-use standpoint, it pretty much is). Here\u0027s what I was thinking:\n\nWe have an API endpoint that when you request an notification, it returns the schema for said notification. Not sure if it will be able to return any version, or just the currently used version. That way, when a consumer gets a notification, they can check their cache of schemas, and if it\u0027s a new version from their schema, they can just make an API request to get the new schema, and then they keep that around locally now.\n\nThis may be a totally crazy idea, but this is just what I had assumed coming into this spec.","commit_id":"36953df5b64dff5174bd4036388fe32ee973a040"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"708c20c18c75d4d78b8cf0f701f49506213ce4f3","unresolved":false,"context_lines":[{"line_number":56,"context_line":"notification payload that the notification consumer software can use to"},{"line_number":57,"context_line":"understand and validate the received notification."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Therefore this spec proposes to add json schema for every versioned"},{"line_number":60,"context_line":"notification in Nova."},{"line_number":61,"context_line":""},{"line_number":62,"context_line":"Alternatives"},{"line_number":63,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a122d0e_f0dc791a","line":60,"range":{"start_line":59,"start_character":0,"end_line":60,"end_character":21},"in_reply_to":"1a122d0e_9249cdd3","updated":"2016-04-15 13:55:48.000000000","message":"OK I see. This make sense to me technically. However I don\u0027t know the exact use case we need to support. I\u0027ll add ceilometer people to the review as ceilometer is a big client of the notifications. I hope they can argue for or against to this REST API.","commit_id":"36953df5b64dff5174bd4036388fe32ee973a040"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"55c280ff5e69050cc00e8cb1bed096cb9d45fa1d","unresolved":false,"context_lines":[{"line_number":57,"context_line":"understand and validate the received notification."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Therefore this spec proposes to add json schema for every versioned"},{"line_number":60,"context_line":"notification in Nova."},{"line_number":61,"context_line":""},{"line_number":62,"context_line":"Alternatives"},{"line_number":63,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a122d0e_1abbd4e6","line":60,"in_reply_to":"1a122d0e_f0dc791a","updated":"2016-04-18 11:32:13.000000000","message":"This has been talked about within ceilometer before but there hasn\u0027t been any particular conclusion, at least last I checked (which was back in November). jd and gordc may have additional thought.\n\nThe options discussed were:\n\n* a central HTTP service that hosts schema for notifications from all services, various services install their schema files (static) into somewhere that this central service reads\n* a well known location in each services API which provides the notification (and other) json schema used by this service\n* keeping the schema in the project\u0027s src tree available for inspection\n\nSince each of these ideas require that the schema files exist in the first place, I would think doing that as a first step is worthwhile and then we can see what the next best step is.\n\nLong term have a the schema available, over HTTP, somehow would be a big win. Not just for ceilometer.","commit_id":"36953df5b64dff5174bd4036388fe32ee973a040"},{"author":{"_account_id":9708,"name":"Balazs Gibizer","display_name":"gibi","email":"gibizer@gmail.com","username":"gibi"},"change_message_id":"64e80126d409aea4f3318fef8b97d0fb799f99d4","unresolved":false,"context_lines":[{"line_number":56,"context_line":"notification payload that the notification consumer software can use to"},{"line_number":57,"context_line":"understand and validate the received notification."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"Therefore this spec proposes to add json schema for every versioned"},{"line_number":60,"context_line":"notification in Nova."},{"line_number":61,"context_line":""},{"line_number":62,"context_line":"Alternatives"},{"line_number":63,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a122d0e_8dc89576","line":60,"range":{"start_line":59,"start_character":0,"end_line":60,"end_character":21},"in_reply_to":"5a18252c_2976f9d6","updated":"2016-04-15 11:48:00.000000000","message":"My original plan was to add store the schema in the nova source tree in a separate directory. I agree that attaching the schema to every notification is a bit overkill.\n\nWhat kind of API addition you have in mind? Some REST API that can be used to discover what notifications nova emits and with what schema?","commit_id":"36953df5b64dff5174bd4036388fe32ee973a040"}]}
