)]}'
{"ceilometer/api/controllers/v2.py":[{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":382,"context_line":"    \"The number of samples seen\""},{"line_number":383,"context_line":""},{"line_number":384,"context_line":"    duration \u003d float"},{"line_number":385,"context_line":"    \"The difference, in seconds, between the oldest and newest timestamp\""},{"line_number":386,"context_line":""},{"line_number":387,"context_line":"    duration_start \u003d datetime.datetime"},{"line_number":388,"context_line":"    \"UTC date and time of the earliest timestamp, or the query start time\""}],"source_content_type":"text/x-python","patch_set":4,"id":"AAAAP3%2F%2FlhQ%3D","line":385,"updated":"2013-07-16 08:19:31.000000000","message":"Not necessarily *whole* seconds right?\n\n(given that the type if float and timestamps can be specified with millisecond precision)","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"1b6b5b1c4efb2f09fe8fb29ae140bb4cf234f3b7","unresolved":false,"context_lines":[{"line_number":382,"context_line":"    \"The number of samples seen\""},{"line_number":383,"context_line":""},{"line_number":384,"context_line":"    duration \u003d float"},{"line_number":385,"context_line":"    \"The difference, in seconds, between the oldest and newest timestamp\""},{"line_number":386,"context_line":""},{"line_number":387,"context_line":"    duration_start \u003d datetime.datetime"},{"line_number":388,"context_line":"    \"UTC date and time of the earliest timestamp, or the query start time\""}],"source_content_type":"text/x-python","patch_set":4,"id":"AAAAP3%2F%2Fjik%3D","line":385,"in_reply_to":"AAAAP3%2F%2FlhQ%3D","updated":"2013-07-16 16:29:16.000000000","message":"No, but it\u0027s not written whole seconds neither. :) A better proposal?","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"}],"doc/source/webapi/v2.rst":[{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"25f17a4a69fc0701731823f5a077a963309d6321","unresolved":false,"context_lines":[{"line_number":128,"context_line":""},{"line_number":129,"context_line":"The above examples are meant to help you understand how to query the"},{"line_number":130,"context_line":"Ceilometer API to build custom metrics report. The query parameters should"},{"line_number":131,"context_line":"be encoded using one of the above method, e.g. into the URL parameters or"},{"line_number":132,"context_line":"into JSON encoded data passed to the GET request."},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Get the meters about instances running for June 2013::"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FSus%3D","line":131,"updated":"2013-07-04 20:52:37.000000000","message":"\"one of the above methods\" (add s)","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"3bd9ce3b0f90fe0eb670d2f9bbdfc0f2dec00d55","unresolved":false,"context_lines":[{"line_number":128,"context_line":""},{"line_number":129,"context_line":"The above examples are meant to help you understand how to query the"},{"line_number":130,"context_line":"Ceilometer API to build custom metrics report. The query parameters should"},{"line_number":131,"context_line":"be encoded using one of the above method, e.g. into the URL parameters or"},{"line_number":132,"context_line":"into JSON encoded data passed to the GET request."},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Get the meters about instances running for June 2013::"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FR7w%3D","line":131,"in_reply_to":"AAAAPn%2F%2FSus%3D","updated":"2013-07-05 09:52:21.000000000","message":"Done","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"25f17a4a69fc0701731823f5a077a963309d6321","unresolved":false,"context_lines":[{"line_number":156,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":""},{"line_number":159,"context_line":"Get the meters about instances running for June 2013 for a particular project::"},{"line_number":160,"context_line":""},{"line_number":161,"context_line":"    GET /v2/meters/instance"},{"line_number":162,"context_line":"    q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FSuo%3D","line":159,"updated":"2013-07-04 20:52:37.000000000","message":"This example looks the same as the previous one. Am I missing something subtle?","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"3bd9ce3b0f90fe0eb670d2f9bbdfc0f2dec00d55","unresolved":false,"context_lines":[{"line_number":156,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":""},{"line_number":159,"context_line":"Get the meters about instances running for June 2013 for a particular project::"},{"line_number":160,"context_line":""},{"line_number":161,"context_line":"    GET /v2/meters/instance"},{"line_number":162,"context_line":"    q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FR7s%3D","line":159,"in_reply_to":"AAAAPn%2F%2FSuo%3D","updated":"2013-07-05 09:52:21.000000000","message":"Copy paste error :)","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"25f17a4a69fc0701731823f5a077a963309d6321","unresolved":false,"context_lines":[{"line_number":183,"context_line":"         \"op\": \"eq\","},{"line_number":184,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":185,"context_line":""},{"line_number":186,"context_line":"Then look for resources that have a *instance* meter linked to them. That"},{"line_number":187,"context_line":"will indicate resources that has been measured has being instance. You can"},{"line_number":188,"context_line":"them request their samples to have more detailled information, like their"},{"line_number":189,"context_line":"state or their flavor::"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FSuk%3D","line":186,"updated":"2013-07-04 20:52:37.000000000","message":"\"have an *instance* meter\" (add n)","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"3bd9ce3b0f90fe0eb670d2f9bbdfc0f2dec00d55","unresolved":false,"context_lines":[{"line_number":183,"context_line":"         \"op\": \"eq\","},{"line_number":184,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":185,"context_line":""},{"line_number":186,"context_line":"Then look for resources that have a *instance* meter linked to them. That"},{"line_number":187,"context_line":"will indicate resources that has been measured has being instance. You can"},{"line_number":188,"context_line":"them request their samples to have more detailled information, like their"},{"line_number":189,"context_line":"state or their flavor::"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FR7o%3D","line":186,"in_reply_to":"AAAAPn%2F%2FSuk%3D","updated":"2013-07-05 09:52:21.000000000","message":"Done","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"25f17a4a69fc0701731823f5a077a963309d6321","unresolved":false,"context_lines":[{"line_number":184,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":185,"context_line":""},{"line_number":186,"context_line":"Then look for resources that have a *instance* meter linked to them. That"},{"line_number":187,"context_line":"will indicate resources that has been measured has being instance. You can"},{"line_number":188,"context_line":"them request their samples to have more detailled information, like their"},{"line_number":189,"context_line":"state or their flavor::"},{"line_number":190,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FSug%3D","line":187,"updated":"2013-07-04 20:52:37.000000000","message":"s/that has/that have/\n\ns/has being/as being an/","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"3bd9ce3b0f90fe0eb670d2f9bbdfc0f2dec00d55","unresolved":false,"context_lines":[{"line_number":184,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":185,"context_line":""},{"line_number":186,"context_line":"Then look for resources that have a *instance* meter linked to them. That"},{"line_number":187,"context_line":"will indicate resources that has been measured has being instance. You can"},{"line_number":188,"context_line":"them request their samples to have more detailled information, like their"},{"line_number":189,"context_line":"state or their flavor::"},{"line_number":190,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FR7k%3D","line":187,"in_reply_to":"AAAAPn%2F%2FSug%3D","updated":"2013-07-05 09:52:21.000000000","message":"Done","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"25f17a4a69fc0701731823f5a077a963309d6321","unresolved":false,"context_lines":[{"line_number":185,"context_line":""},{"line_number":186,"context_line":"Then look for resources that have a *instance* meter linked to them. That"},{"line_number":187,"context_line":"will indicate resources that has been measured has being instance. You can"},{"line_number":188,"context_line":"them request their samples to have more detailled information, like their"},{"line_number":189,"context_line":"state or their flavor::"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"    GET /v2/meter/instance"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FSuc%3D","line":188,"updated":"2013-07-04 20:52:37.000000000","message":"typo, \"them\" should be \"then\"","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"3bd9ce3b0f90fe0eb670d2f9bbdfc0f2dec00d55","unresolved":false,"context_lines":[{"line_number":185,"context_line":""},{"line_number":186,"context_line":"Then look for resources that have a *instance* meter linked to them. That"},{"line_number":187,"context_line":"will indicate resources that has been measured has being instance. You can"},{"line_number":188,"context_line":"them request their samples to have more detailled information, like their"},{"line_number":189,"context_line":"state or their flavor::"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"    GET /v2/meter/instance"}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FR7g%3D","line":188,"in_reply_to":"AAAAPn%2F%2FSuc%3D","updated":"2013-07-05 09:52:21.000000000","message":"Done","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"25f17a4a69fc0701731823f5a077a963309d6321","unresolved":false,"context_lines":[{"line_number":202,"context_line":"         \"op\": \"eq\","},{"line_number":203,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":204,"context_line":""},{"line_number":205,"context_line":"This will return a list of samples that has been recorded on this particular"},{"line_number":206,"context_line":"resource. You can inspect them to retrieve information, such as the instance"},{"line_number":207,"context_line":"state (check the *metadata.vm_state* field) or the instance flavor (check"},{"line_number":208,"context_line":"the *metadata.flavor* field)."}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FSuY%3D","line":205,"updated":"2013-07-04 20:52:37.000000000","message":"s/has been/have been/","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"3bd9ce3b0f90fe0eb670d2f9bbdfc0f2dec00d55","unresolved":false,"context_lines":[{"line_number":202,"context_line":"         \"op\": \"eq\","},{"line_number":203,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":204,"context_line":""},{"line_number":205,"context_line":"This will return a list of samples that has been recorded on this particular"},{"line_number":206,"context_line":"resource. You can inspect them to retrieve information, such as the instance"},{"line_number":207,"context_line":"state (check the *metadata.vm_state* field) or the instance flavor (check"},{"line_number":208,"context_line":"the *metadata.flavor* field)."}],"source_content_type":"text/x-rst","patch_set":1,"id":"AAAAPn%2F%2FR7c%3D","line":205,"in_reply_to":"AAAAPn%2F%2FSuY%3D","updated":"2013-07-05 09:52:21.000000000","message":"Done","commit_id":"40856135d07ee9083d5d5fb788bb38f4c358fa0c"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"86b817b1bcc780a72d603cbf7d191143521e3cd2","unresolved":false,"context_lines":[{"line_number":126,"context_line":"Functional examples"},{"line_number":127,"context_line":"+++++++++++++++++++"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"The above examples are meant to help you understand how to query the"},{"line_number":130,"context_line":"Ceilometer API to build custom metrics report. The query parameters should"},{"line_number":131,"context_line":"be encoded using one of the above methods, e.g. into the URL parameters or"},{"line_number":132,"context_line":"into JSON encoded data passed to the GET request."}],"source_content_type":"text/x-rst","patch_set":2,"id":"AAAAPn%2F%2FRXo%3D","line":129,"updated":"2013-07-05 14:52:00.000000000","message":"below","commit_id":"44af4b16a6f447daaae6791762418c3ef40328ce"},{"author":{"_account_id":7993,"name":"Frédéric FAURE","email":"frederic.faure@ysance.com","username":"frederic-faure"},"change_message_id":"cda4eddfb53bfe37786b0fce7b25d009f249df7b","unresolved":false,"context_lines":[{"line_number":124,"context_line":""},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Functional examples"},{"line_number":127,"context_line":"+++++++++++++++++++"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"The below examples are meant to help you understand how to query the"},{"line_number":130,"context_line":"Ceilometer API to build custom metrics report. The query parameters should"}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F6co%3D","line":127,"updated":"2013-07-09 11:50:45.000000000","message":"Split the functional examples by \"measurements types/categories\" : first queries on Resources, then on Samples and last on Statistics to follow the same order as the doc above.","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":7993,"name":"Frédéric FAURE","email":"frederic.faure@ysance.com","username":"frederic-faure"},"change_message_id":"cda4eddfb53bfe37786b0fce7b25d009f249df7b","unresolved":false,"context_lines":[{"line_number":131,"context_line":"be encoded using one of the above methods, e.g. into the URL parameters or"},{"line_number":132,"context_line":"into JSON encoded data passed to the GET request."},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Get the meters about instances running for June 2013::"},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"     GET /v2/meters/instance"},{"line_number":137,"context_line":"     q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F6qo%3D","line":134,"updated":"2013-07-09 11:50:45.000000000","message":"Get the list of samples about instances running for June 2013::","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"4d79487a4307f1b9119cf9c25f132c08510a8bfd","unresolved":false,"context_lines":[{"line_number":131,"context_line":"be encoded using one of the above methods, e.g. into the URL parameters or"},{"line_number":132,"context_line":"into JSON encoded data passed to the GET request."},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Get the meters about instances running for June 2013::"},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"     GET /v2/meters/instance"},{"line_number":137,"context_line":"     q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F51U%3D","line":134,"in_reply_to":"AAAAP3%2F%2F6qo%3D","updated":"2013-07-16 08:03:12.000000000","message":"Done","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":7993,"name":"Frédéric FAURE","email":"frederic.faure@ysance.com","username":"frederic-faure"},"change_message_id":"cda4eddfb53bfe37786b0fce7b25d009f249df7b","unresolved":false,"context_lines":[{"line_number":142,"context_line":"           \"value\": \"2013-07-01T00:00:00\"}]"},{"line_number":143,"context_line":""},{"line_number":144,"context_line":""},{"line_number":145,"context_line":"Get the meters about instances running for June 2013 for a particular project::"},{"line_number":146,"context_line":""},{"line_number":147,"context_line":"    GET /v2/meters/instance"},{"line_number":148,"context_line":"    q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F6qk%3D","line":145,"updated":"2013-07-09 11:50:45.000000000","message":"Get the list of samples about instances running for June 2013 for a particular project::","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"4d79487a4307f1b9119cf9c25f132c08510a8bfd","unresolved":false,"context_lines":[{"line_number":142,"context_line":"           \"value\": \"2013-07-01T00:00:00\"}]"},{"line_number":143,"context_line":""},{"line_number":144,"context_line":""},{"line_number":145,"context_line":"Get the meters about instances running for June 2013 for a particular project::"},{"line_number":146,"context_line":""},{"line_number":147,"context_line":"    GET /v2/meters/instance"},{"line_number":148,"context_line":"    q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F51M%3D","line":145,"in_reply_to":"AAAAP3%2F%2F6qk%3D","updated":"2013-07-16 08:03:12.000000000","message":"Done","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":7993,"name":"Frédéric FAURE","email":"frederic.faure@ysance.com","username":"frederic-faure"},"change_message_id":"cda4eddfb53bfe37786b0fce7b25d009f249df7b","unresolved":false,"context_lines":[{"line_number":153,"context_line":"         \"value\": \"2013-07-01T00:00:00\"},"},{"line_number":154,"context_line":"        {\"field\": \"project_id\","},{"line_number":155,"context_line":"         \"op\": \"eq\","},{"line_number":156,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"If you want to retrieve all the instances that have been run during this"},{"line_number":159,"context_line":"month, you should ask the resource endpoint for the list::"}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F6nI%3D","line":156,"updated":"2013-07-09 11:50:45.000000000","message":"Additional example:\n\nGet the list of samples about instances with m1.tiny flavor running for June 2013 for a particular project::\n\nGET /v2/meters/instance:m1.tiny\nq: [{\"field\": \"timestamp\",\n     \"op\": \"ge\",\n     \"value\": \"2013-06-01T00:00:00\"},\n    {\"field\": \"timestamp\",\n     \"op\": \"lt\",\n     \"value\": \"2013-07-01T00:00:00\"},\n    {\"field\": \"project_id\",\n     \"op\": \"eq\",\n     \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"4d79487a4307f1b9119cf9c25f132c08510a8bfd","unresolved":false,"context_lines":[{"line_number":153,"context_line":"         \"value\": \"2013-07-01T00:00:00\"},"},{"line_number":154,"context_line":"        {\"field\": \"project_id\","},{"line_number":155,"context_line":"         \"op\": \"eq\","},{"line_number":156,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"If you want to retrieve all the instances that have been run during this"},{"line_number":159,"context_line":"month, you should ask the resource endpoint for the list::"}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F51E%3D","line":156,"in_reply_to":"AAAAP3%2F%2F6nI%3D","updated":"2013-07-16 08:03:12.000000000","message":"Done","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":7993,"name":"Frédéric FAURE","email":"frederic.faure@ysance.com","username":"frederic-faure"},"change_message_id":"cda4eddfb53bfe37786b0fce7b25d009f249df7b","unresolved":false,"context_lines":[{"line_number":154,"context_line":"        {\"field\": \"project_id\","},{"line_number":155,"context_line":"         \"op\": \"eq\","},{"line_number":156,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"If you want to retrieve all the instances that have been run during this"},{"line_number":159,"context_line":"month, you should ask the resource endpoint for the list::"},{"line_number":160,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F6eE%3D","line":157,"updated":"2013-07-09 11:50:45.000000000","message":"There is a lack on statistics examples, here are some suggestions:\n\nNow you may want to have statistics on the meters you are targeting. Given the following example where you are getting the list of samples about CPU utilisation of a given instance (identified by its \"resource_id\") running for June 2013::\n\nGET /v2/meters/cpu_util\nq: [{\"field\": \"timestamp\",\n     \"op\": \"ge\",\n     \"value\": \"2013-06-01T00:00:00\"},\n    {\"field\": \"timestamp\",\n     \"op\": \"lt\",\n     \"value\": \"2013-07-01T00:00:00\"},\n    {\"field\": \"resource_id\",\n     \"op\": \"eq\",\n     \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]\n\nYou can have statistics on the list of samples requested (the avg, sum, ... is computed on the full duration):: \n\nGET /v2/meters/cpu_util/statistics\nq: [{\"field\": \"timestamp\",\n     \"op\": \"ge\",\n     \"value\": \"2013-06-01T00:00:00\"},\n    {\"field\": \"timestamp\",\n     \"op\": \"lt\",\n     \"value\": \"2013-07-01T00:00:00\"},\n    {\"field\": \"resource_id\",\n     \"op\": \"eq\",\n     \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]\n\nYou may want to aggregate samples on a given period (10 minutes for example) and get an array of the statistics computed on smaller durations::\n\nGET /v2/meters/cpu_util/statistics\nq: [{\"field\": \"timestamp\",\n     \"op\": \"ge\",\n     \"value\": \"2013-06-01T00:00:00\"},\n    {\"field\": \"timestamp\",\n     \"op\": \"lt\",\n     \"value\": \"2013-07-01T00:00:00\"},\n    {\"field\": \"resource_id\",\n     \"op\": \"eq\",\n     \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]\nperiod: 600\n\nDo you think it would be useful to point the fact that \"duration\"  in statistics is not a \"good\" indicator: I am thinking about instances stopped and started during a month (so not used during the whole period of time/duration), and people thinking about using duration for billing.\n\nMaybe giving a key for \"billing-like\" features: I saw you enhanced examples in https://review.openstack.org/#/c/35484/ with queries on \"metadata.event_type\". Could it be useful for such features? The idea is not to give all the cases, but some tips to help people understanding the API to make them use it.\n\n-----------------------------\n\nBy the way, there is mistake in the doc above about duration description: duration \u003d\u003e The difference, in minutes, between the oldest and newest timestamp. This is in seconds.\n\n-----------------------------\n\nWhat do you think about moving the examples below (from here up to the end) at the beginning of the functional examples because they deal with Resources?","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"4d79487a4307f1b9119cf9c25f132c08510a8bfd","unresolved":false,"context_lines":[{"line_number":154,"context_line":"        {\"field\": \"project_id\","},{"line_number":155,"context_line":"         \"op\": \"eq\","},{"line_number":156,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"If you want to retrieve all the instances that have been run during this"},{"line_number":159,"context_line":"month, you should ask the resource endpoint for the list::"},{"line_number":160,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2Fljo%3D","line":157,"in_reply_to":"AAAAP3%2F%2F6eE%3D","updated":"2013-07-16 08:03:12.000000000","message":"Duration is a good indicator for resources duration, it\u0027s just that you have to know what if you want the duration of the resource of the duration of the resource in a particular state.\n\nI\u0027ve fixed the duration units too in the doc, thanks.\n\nSince the example are more complex, I think it\u0027s good enough to put them at the end though.","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":7993,"name":"Frédéric FAURE","email":"frederic.faure@ysance.com","username":"frederic-faure"},"change_message_id":"cda4eddfb53bfe37786b0fce7b25d009f249df7b","unresolved":false,"context_lines":[{"line_number":156,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"If you want to retrieve all the instances that have been run during this"},{"line_number":159,"context_line":"month, you should ask the resource endpoint for the list::"},{"line_number":160,"context_line":""},{"line_number":161,"context_line":"    GET /v2/resources"},{"line_number":162,"context_line":"    q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F6qg%3D","line":159,"updated":"2013-07-09 11:50:45.000000000","message":"If you want to retrieve all the instances (not the list of samples, but the resource itself) that have been run during this month for a given project, you should ask the resource endpoint for the list of resources (all types: including storage, images, networking, ...)::","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"4d79487a4307f1b9119cf9c25f132c08510a8bfd","unresolved":false,"context_lines":[{"line_number":156,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":157,"context_line":""},{"line_number":158,"context_line":"If you want to retrieve all the instances that have been run during this"},{"line_number":159,"context_line":"month, you should ask the resource endpoint for the list::"},{"line_number":160,"context_line":""},{"line_number":161,"context_line":"    GET /v2/resources"},{"line_number":162,"context_line":"    q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F50Y%3D","line":159,"in_reply_to":"AAAAP3%2F%2F6qg%3D","updated":"2013-07-16 08:03:12.000000000","message":"Done","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":7993,"name":"Frédéric FAURE","email":"frederic.faure@ysance.com","username":"frederic-faure"},"change_message_id":"cda4eddfb53bfe37786b0fce7b25d009f249df7b","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Then look for resources that have an *instance* meter linked to them. That"},{"line_number":173,"context_line":"will indicate resources that have been measured as being instance. You can"},{"line_number":174,"context_line":"then request their samples to have more detailled information, like their"},{"line_number":175,"context_line":"state or their flavor::"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"    GET /v2/meter/instance"}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F6pc%3D","line":174,"updated":"2013-07-09 11:50:45.000000000","message":"detailled \u003d\u003e detailed :o)","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"4d79487a4307f1b9119cf9c25f132c08510a8bfd","unresolved":false,"context_lines":[{"line_number":171,"context_line":""},{"line_number":172,"context_line":"Then look for resources that have an *instance* meter linked to them. That"},{"line_number":173,"context_line":"will indicate resources that have been measured as being instance. You can"},{"line_number":174,"context_line":"then request their samples to have more detailled information, like their"},{"line_number":175,"context_line":"state or their flavor::"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"    GET /v2/meter/instance"}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F50U%3D","line":174,"in_reply_to":"AAAAP3%2F%2F6pc%3D","updated":"2013-07-16 08:03:12.000000000","message":"Done","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":7993,"name":"Frédéric FAURE","email":"frederic.faure@ysance.com","username":"frederic-faure"},"change_message_id":"cda4eddfb53bfe37786b0fce7b25d009f249df7b","unresolved":false,"context_lines":[{"line_number":186,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"},"},{"line_number":187,"context_line":"        {\"field\": \"project_id\","},{"line_number":188,"context_line":"         \"op\": \"eq\","},{"line_number":189,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"This will return a list of samples that have been recorded on this particular"},{"line_number":192,"context_line":"resource. You can inspect them to retrieve information, such as the instance"}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F6pA%3D","line":189,"updated":"2013-07-09 11:50:45.000000000","message":"when you give the \"resource_id\", is it still necessary to set the \"project_id\" in the query ? \"resource_id\" is more restrictive isn\u0027t it ?","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"4d79487a4307f1b9119cf9c25f132c08510a8bfd","unresolved":false,"context_lines":[{"line_number":186,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"},"},{"line_number":187,"context_line":"        {\"field\": \"project_id\","},{"line_number":188,"context_line":"         \"op\": \"eq\","},{"line_number":189,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":190,"context_line":""},{"line_number":191,"context_line":"This will return a list of samples that have been recorded on this particular"},{"line_number":192,"context_line":"resource. You can inspect them to retrieve information, such as the instance"}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F50Q%3D","line":189,"in_reply_to":"AAAAP3%2F%2F6pA%3D","updated":"2013-07-16 08:03:12.000000000","message":"No, it\u0027s not in theory, but it doesn\u0027t hurt either. :)","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":7993,"name":"Frédéric FAURE","email":"frederic.faure@ysance.com","username":"frederic-faure"},"change_message_id":"cda4eddfb53bfe37786b0fce7b25d009f249df7b","unresolved":false,"context_lines":[{"line_number":191,"context_line":"This will return a list of samples that have been recorded on this particular"},{"line_number":192,"context_line":"resource. You can inspect them to retrieve information, such as the instance"},{"line_number":193,"context_line":"state (check the *metadata.vm_state* field) or the instance flavor (check"},{"line_number":194,"context_line":"the *metadata.flavor* field)."}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2F6W0%3D","line":194,"updated":"2013-07-09 11:50:45.000000000","message":"It would be useful to show the 2 ways to get only the last sample of the resource in this case to retrieve metadata : (limit\u003d1 and sorted by descending timestamp) or \"last\" alias (if implemented).\n\nAnother example would be great: if I want to retrieve metrics (network.incoming.bytes for example) from the network interface of one of my instances, how to do the job because these metrics are bound to another resource with a \"iface ID\" instead of the \"inst ID\" as \"resource_id\". How to do the link?","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"4d79487a4307f1b9119cf9c25f132c08510a8bfd","unresolved":false,"context_lines":[{"line_number":191,"context_line":"This will return a list of samples that have been recorded on this particular"},{"line_number":192,"context_line":"resource. You can inspect them to retrieve information, such as the instance"},{"line_number":193,"context_line":"state (check the *metadata.vm_state* field) or the instance flavor (check"},{"line_number":194,"context_line":"the *metadata.flavor* field)."}],"source_content_type":"text/x-rst","patch_set":3,"id":"AAAAP3%2F%2FljI%3D","line":194,"in_reply_to":"AAAAP3%2F%2F6W0%3D","updated":"2013-07-16 08:03:12.000000000","message":"Added an example with limit\u003d.\n\nAbout network counters, the thing is I don\u0027t think we should document meter specific things in this general documentation. Each type of meter might have some way to link to each others etc, but this more a problem documenting the meters than the API.\nSo that should be done in some other place.","commit_id":"98658007c0b6a2880a2d4f9d2e6ea61d9afe6684"},{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":126,"context_line":"Functional examples"},{"line_number":127,"context_line":"+++++++++++++++++++"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"The below examples are meant to help you understand how to query the"},{"line_number":130,"context_line":"Ceilometer API to build custom metrics report. The query parameters should"},{"line_number":131,"context_line":"be encoded using one of the above methods, e.g. into the URL parameters or"},{"line_number":132,"context_line":"into JSON encoded data passed to the GET request."}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FlhI%3D","line":129,"updated":"2013-07-16 08:19:31.000000000","message":"s/below examples/examples below/","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"1b6b5b1c4efb2f09fe8fb29ae140bb4cf234f3b7","unresolved":false,"context_lines":[{"line_number":126,"context_line":"Functional examples"},{"line_number":127,"context_line":"+++++++++++++++++++"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"The below examples are meant to help you understand how to query the"},{"line_number":130,"context_line":"Ceilometer API to build custom metrics report. The query parameters should"},{"line_number":131,"context_line":"be encoded using one of the above methods, e.g. into the URL parameters or"},{"line_number":132,"context_line":"into JSON encoded data passed to the GET request."}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FjiY%3D","line":129,"in_reply_to":"AAAAP3%2F%2FlhI%3D","updated":"2013-07-16 16:29:16.000000000","message":"Done","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":129,"context_line":"The below examples are meant to help you understand how to query the"},{"line_number":130,"context_line":"Ceilometer API to build custom metrics report. The query parameters should"},{"line_number":131,"context_line":"be encoded using one of the above methods, e.g. into the URL parameters or"},{"line_number":132,"context_line":"into JSON encoded data passed to the GET request."},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Get the list of samples about instances running for June 2013::"},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FlhE%3D","line":132,"updated":"2013-07-16 08:19:31.000000000","message":"s/into/as/g","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"1b6b5b1c4efb2f09fe8fb29ae140bb4cf234f3b7","unresolved":false,"context_lines":[{"line_number":129,"context_line":"The below examples are meant to help you understand how to query the"},{"line_number":130,"context_line":"Ceilometer API to build custom metrics report. The query parameters should"},{"line_number":131,"context_line":"be encoded using one of the above methods, e.g. into the URL parameters or"},{"line_number":132,"context_line":"into JSON encoded data passed to the GET request."},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Get the list of samples about instances running for June 2013::"},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FjiI%3D","line":132,"in_reply_to":"AAAAP3%2F%2FlhE%3D","updated":"2013-07-16 16:29:16.000000000","message":"Done","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":168,"context_line":"         \"op\": \"eq\","},{"line_number":169,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":170,"context_line":""},{"line_number":171,"context_line":"Now you may want to have statistics on the meters you are targeting. Given"},{"line_number":172,"context_line":"the following example where you are getting the list of samples about CPU"},{"line_number":173,"context_line":"utilisation of a given instance (identified by its \"resource_id\") running"},{"line_number":174,"context_line":"for June 2013::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FlgU%3D","line":171,"updated":"2013-07-16 08:19:31.000000000","message":"s/Given/Consider/","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"1b6b5b1c4efb2f09fe8fb29ae140bb4cf234f3b7","unresolved":false,"context_lines":[{"line_number":168,"context_line":"         \"op\": \"eq\","},{"line_number":169,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":170,"context_line":""},{"line_number":171,"context_line":"Now you may want to have statistics on the meters you are targeting. Given"},{"line_number":172,"context_line":"the following example where you are getting the list of samples about CPU"},{"line_number":173,"context_line":"utilisation of a given instance (identified by its \"resource_id\") running"},{"line_number":174,"context_line":"for June 2013::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FjiE%3D","line":171,"in_reply_to":"AAAAP3%2F%2FlgU%3D","updated":"2013-07-16 16:29:16.000000000","message":"Done","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":184,"context_line":"         \"op\": \"eq\","},{"line_number":185,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]"},{"line_number":186,"context_line":""},{"line_number":187,"context_line":"You can have statistics on the list of samples requested (the avg, sum, ..."},{"line_number":188,"context_line":"is computed on the full duration)::"},{"line_number":189,"context_line":""},{"line_number":190,"context_line":"    GET /v2/meters/cpu_util/statistics"}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2Flgk%3D","line":187,"updated":"2013-07-16 08:19:31.000000000","message":"Probably best to be explicit here on the set of aggregate functions applied (i.e. avg, sum, min, max, count)","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"1b6b5b1c4efb2f09fe8fb29ae140bb4cf234f3b7","unresolved":false,"context_lines":[{"line_number":184,"context_line":"         \"op\": \"eq\","},{"line_number":185,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]"},{"line_number":186,"context_line":""},{"line_number":187,"context_line":"You can have statistics on the list of samples requested (the avg, sum, ..."},{"line_number":188,"context_line":"is computed on the full duration)::"},{"line_number":189,"context_line":""},{"line_number":190,"context_line":"    GET /v2/meters/cpu_util/statistics"}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FjgQ%3D","line":187,"in_reply_to":"AAAAP3%2F%2Flgk%3D","updated":"2013-07-16 16:29:16.000000000","message":"Done","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":185,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]"},{"line_number":186,"context_line":""},{"line_number":187,"context_line":"You can have statistics on the list of samples requested (the avg, sum, ..."},{"line_number":188,"context_line":"is computed on the full duration)::"},{"line_number":189,"context_line":""},{"line_number":190,"context_line":"    GET /v2/meters/cpu_util/statistics"},{"line_number":191,"context_line":"    q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2Flgc%3D","line":188,"updated":"2013-07-16 08:19:31.000000000","message":"s/is//","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"1b6b5b1c4efb2f09fe8fb29ae140bb4cf234f3b7","unresolved":false,"context_lines":[{"line_number":185,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]"},{"line_number":186,"context_line":""},{"line_number":187,"context_line":"You can have statistics on the list of samples requested (the avg, sum, ..."},{"line_number":188,"context_line":"is computed on the full duration)::"},{"line_number":189,"context_line":""},{"line_number":190,"context_line":"    GET /v2/meters/cpu_util/statistics"},{"line_number":191,"context_line":"    q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FjiA%3D","line":188,"in_reply_to":"AAAAP3%2F%2Flgc%3D","updated":"2013-07-16 16:29:16.000000000","message":"Done","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":198,"context_line":"         \"op\": \"eq\","},{"line_number":199,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]"},{"line_number":200,"context_line":""},{"line_number":201,"context_line":"You may want to aggregate samples on a given period (10 minutes for example)"},{"line_number":202,"context_line":"and get an array of the statistics computed on smaller durations::"},{"line_number":203,"context_line":""},{"line_number":204,"context_line":"    GET /v2/meters/cpu_util/statistics"}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FlgM%3D","line":201,"updated":"2013-07-16 08:19:31.000000000","message":"s/on/over/","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"1b6b5b1c4efb2f09fe8fb29ae140bb4cf234f3b7","unresolved":false,"context_lines":[{"line_number":198,"context_line":"         \"op\": \"eq\","},{"line_number":199,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]"},{"line_number":200,"context_line":""},{"line_number":201,"context_line":"You may want to aggregate samples on a given period (10 minutes for example)"},{"line_number":202,"context_line":"and get an array of the statistics computed on smaller durations::"},{"line_number":203,"context_line":""},{"line_number":204,"context_line":"    GET /v2/meters/cpu_util/statistics"}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FjgM%3D","line":201,"in_reply_to":"AAAAP3%2F%2FlgM%3D","updated":"2013-07-16 16:29:16.000000000","message":"Done","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":199,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]"},{"line_number":200,"context_line":""},{"line_number":201,"context_line":"You may want to aggregate samples on a given period (10 minutes for example)"},{"line_number":202,"context_line":"and get an array of the statistics computed on smaller durations::"},{"line_number":203,"context_line":""},{"line_number":204,"context_line":"    GET /v2/meters/cpu_util/statistics"},{"line_number":205,"context_line":"    q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FlgE%3D","line":202,"updated":"2013-07-16 08:19:31.000000000","message":"s/and/in order to/","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"1b6b5b1c4efb2f09fe8fb29ae140bb4cf234f3b7","unresolved":false,"context_lines":[{"line_number":199,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"}]"},{"line_number":200,"context_line":""},{"line_number":201,"context_line":"You may want to aggregate samples on a given period (10 minutes for example)"},{"line_number":202,"context_line":"and get an array of the statistics computed on smaller durations::"},{"line_number":203,"context_line":""},{"line_number":204,"context_line":"    GET /v2/meters/cpu_util/statistics"},{"line_number":205,"context_line":"    q: [{\"field\": \"timestamp\","}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2Fjh4%3D","line":202,"in_reply_to":"AAAAP3%2F%2FlgE%3D","updated":"2013-07-16 16:29:16.000000000","message":"Done","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":246,"context_line":"         \"value\": \"64da755c-9120-4236-bee1-54acafe24980\"},"},{"line_number":247,"context_line":"        {\"field\": \"project_id\","},{"line_number":248,"context_line":"         \"op\": \"eq\","},{"line_number":249,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":250,"context_line":""},{"line_number":251,"context_line":"This will return a list of samples that have been recorded on this particular"},{"line_number":252,"context_line":"resource. You can inspect them to retrieve information, such as the instance"}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2Fle0%3D","line":249,"updated":"2013-07-16 08:19:31.000000000","message":"If we\u0027re already specifying the resource ID, is the project ID moot?\n\n(assuming the resource is associated with the same tenant for it\u0027s lifetime)\n\nHmmm, maybe that assumption isn\u0027t correct ... what happens to owned resources when a tenant is deleted I wonder?","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":251,"context_line":"This will return a list of samples that have been recorded on this particular"},{"line_number":252,"context_line":"resource. You can inspect them to retrieve information, such as the instance"},{"line_number":253,"context_line":"state (check the *metadata.vm_state* field) or the instance flavor (check"},{"line_number":254,"context_line":"the *metadata.flavor* field)."},{"line_number":255,"context_line":""},{"line_number":256,"context_line":"To retrieve only the 3 last samples of a meters, you can pass the *limit*"},{"line_number":257,"context_line":"parameter to the query::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FleQ%3D","line":254,"updated":"2013-07-16 08:19:31.000000000","message":"Would it be useful to include an example query on some nested metadata field?\n\n(e.g. the user_metadata style intended for Heat usage).","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"1b6b5b1c4efb2f09fe8fb29ae140bb4cf234f3b7","unresolved":false,"context_lines":[{"line_number":251,"context_line":"This will return a list of samples that have been recorded on this particular"},{"line_number":252,"context_line":"resource. You can inspect them to retrieve information, such as the instance"},{"line_number":253,"context_line":"state (check the *metadata.vm_state* field) or the instance flavor (check"},{"line_number":254,"context_line":"the *metadata.flavor* field)."},{"line_number":255,"context_line":""},{"line_number":256,"context_line":"To retrieve only the 3 last samples of a meters, you can pass the *limit*"},{"line_number":257,"context_line":"parameter to the query::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2Fjgc%3D","line":254,"in_reply_to":"AAAAP3%2F%2FleQ%3D","updated":"2013-07-16 16:29:16.000000000","message":"Added a note on that.","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":2284,"name":"Eoghan Glynn","email":"eglynn@redhat.com","username":"eglynn"},"change_message_id":"4d48dc97925ce954508398ed6ae49102a0c3d9f4","unresolved":false,"context_lines":[{"line_number":271,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":272,"context_line":"    limit: 3"},{"line_number":273,"context_line":""},{"line_number":274,"context_line":"These would only return the last 3 samples."}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2FlfY%3D","line":274,"updated":"2013-07-16 08:19:31.000000000","message":"s/These/This query/","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"},{"author":{"_account_id":1669,"name":"Julien Danjou","display_name":"jd","email":"julien@danjou.info","username":"jdanjou"},"change_message_id":"1b6b5b1c4efb2f09fe8fb29ae140bb4cf234f3b7","unresolved":false,"context_lines":[{"line_number":271,"context_line":"         \"value\": \"8d6057bc-5b90-4296-afe0-84acaa2ef909\"}]"},{"line_number":272,"context_line":"    limit: 3"},{"line_number":273,"context_line":""},{"line_number":274,"context_line":"These would only return the last 3 samples."}],"source_content_type":"text/x-rst","patch_set":4,"id":"AAAAP3%2F%2Fjgg%3D","line":274,"in_reply_to":"AAAAP3%2F%2FlfY%3D","updated":"2013-07-16 16:29:16.000000000","message":"Done","commit_id":"4cb8f1671fb18ad2e65193532750e1e268748a73"}]}