tsd_metrics 0.2.0 → 0.2.8

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MmE1MmVlZTkwYWQyODhkYWJkY2RmNjVmNjRjMjFmZDFhZDY2MTE2Mw==
+  data.tar.gz: !binary |-
+    NGE0YTZjM2YwZGZiZjg5ZTMxYTQ1MmQ1NjkzZTdiMzE4NmM4OWQ5Zg==
+SHA512:
+  metadata.gz: !binary |-
+    MTQ2MDQ1MjU2ZjdmZGNlMzgwODU5NGFjMDE5NTlkZDZlNjY3MDZiNjk3MjNk
+    MTRjNzJjZGQ5NmUyN2E2NThhZGJkZDVjNGU4ODhlOTQ2NThhZDllYWJiNzZm
+    NGJlYTc2MDE1ZWExOTk0MzdlZjI4MzNiZTNlNWU2MTEyYTcwMjc=
+  data.tar.gz: !binary |-
+    ZDIyNWI4YzM3NWIyZWYzZWQ2NzdkNTBlMTMzM2RiYzNlY2UxNjg2ZDcxZWE1
+    MDhkOGMzMzExNzJlNjgwNWRlZTRiNDk5NzBjZTAyMmRjZjk2MTE1OTliNWNh
+    M2NkYzhlY2YxMDBiN2NlNGIwNjViYmY2ZTY0MDNlZmEyZDA4N2Q=

data/.gitignore

@@ -0,0 +1,23 @@
+# Output
+*.gem
+.bundle
+.rakeTasks
+tmp
+.gemencap
+my_file.json
+
+# Eclipse
+.metadata/
+.externalToolBuilders/
+bin/
+eclipse-bin/
+**/.classpath
+**/RemoteSystemsTempFiles/
+
+# IntelliJ
+.idea
+.settings/
+*.iml
+
+# Mac
+.DS_Store

data/.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+rvm:
+- 1.9.3
+- 2.0.0
+- 2.1.0
+deploy:
+  provider: rubygems
+  gem: tsd_metrics
+  on:
+    tags: true
+    rvm: 1.9.3
+  api_key:
+    secure: KACQT1NXqlICT2qSVobhBGRi71nw6JCuWUZZN59KeMfIqQhGwSnNJ8JpXVhrrz7lijAWbNAeW0aimf8toeeaRQiaP468o0eAH8WkWzOImFaSLs8TEiH4cZEt/QxBV3RP6BWJJkPK+VjLY3w2x4DzKQbpkJvTmIkLg+M4wgG4hmoDlEcEQ5NHrNv45BjxzaA6n/Wh1vLcsZy0PgXR4RgDeLnpzu/2/OqKeLecyrQvHh7IrJUvlgVBOAliZE8cEps5ebRqNrrLXWfKHLPzmyx/alRZFwllPveb5Gx3WymYamiiJOComfLPxg58v/fI7sKrkqWYgpgXPd41fwEh6yuK2D7siG8QC+sUZxLjwzJjm/xU7C64pjCUzbONx9Ju0849f8mfl7d4JSeEtKd6dxGdtotE/mlQIdnFac60T5dQ0BBfcSBa3+yegpvuvtsgKzZpa7ceSM9nBRMqTXoGwN+mhEKxTYJo4iWW5lLqSvUU5a9Ho0Prf+aMT5ntc01ax/U1cgV7jK3bwmRzsmEfRl1nW6Q1DJmjloZY0jgNJnaOhfZ0Yj9CE1gNPzGCI2yDIq+fHQ3EluSJGKpXmSao5eR2PYNvmel/S93/v4lxgMKxx1veewM9l8OjEjelQcKFrnH1efHzP8UOsv4LScbQgKJTH7SgmXWvvrKQBEN+zDztt1Q=

data/CONTRIBUTORS.md

@@ -0,0 +1,10 @@
+Contributors
+============
+
+The following people have made source contributions to the metrics client ruby project:
+
+* Brandon Arp (barp at groupon dot com)
+* Matthew Hayter (mhayter at groupon dot com)
+* Ville Koskela (vkoskela at groupon dot com)
+
+© Groupon Inc., 2014

data/DEPENDENCIES.md

@@ -0,0 +1,15 @@
+Dependencies
+========
+
+The following table lists the dependencies of the ruby client and their licenses.
+
+Build Tool Dependencies
+------------------
+
+Project              | License                    | Project link
+---------------------|----------------------------|-------------
+rspec                | MIT                        | https://github.com/rspec/rspec
+timecop              | MIT                        | https://github.com/travisjeffery/timecop
+pry                  | MIT                        | https://github.com/pry/pry
+
+© Groupon Inc., 2014

data/Gemfile

@@ -0,0 +1,22 @@
+# Copyright 2014 Groupon.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.
+
+# A sample Gemfile
+source "https://rubygems.org"
+
+gemspec
+
+group :test do
+  gem 'rake'
+end

data/LICENSE

@@ -0,0 +1,158 @@
+Apache License
+
+Version 2.0, January 2004
+
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object code,
+generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made
+available under the License, as indicated by a copyright notice that is included
+in or attached to the work (an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative Works
+shall not include works that remain separable from, or merely link (or bind by
+name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version
+of the Work and any modifications or additions to that Work or Derivative Works
+thereof, that is intentionally submitted to Licensor for inclusion in the Work
+by the copyright owner or by an individual or Legal Entity authorized to submit
+on behalf of the copyright owner. For the purposes of this definition,
+"submitted" means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems, and
+issue tracking systems that are managed by, or on behalf of, the Licensor for
+the purpose of discussing and improving the Work, but excluding communication
+that is conspicuously marked or otherwise designated in writing by the copyright
+owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+reproduce, prepare Derivative Works of, publicly display, publicly perform,
+sublicense, and distribute the Work and such Derivative Works in Source or
+Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License,
+each Contributor hereby grants to You a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable (except as stated in this section) patent
+license to make, have made, use, offer to sell, sell, import, and otherwise
+transfer the Work, where such license applies only to those patent claims
+licensable by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s) with the Work
+to which such Contribution(s) was submitted. If You institute patent litigation
+against any entity (including a cross-claim or counterclaim in a lawsuit)
+alleging that the Work or a Contribution incorporated within the Work
+constitutes direct or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate as of the date
+such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+Derivative Works thereof in any medium, with or without modifications, and in
+Source or Object form, provided that You meet the following conditions:
+
+a. You must give any other recipients of the Work or Derivative Works a copy of
+this License; and
+b. You must cause any modified files to carry prominent notices stating that You
+changed the files; and
+c. You must retain, in the Source form of any Derivative Works that You 
+distribute, all copyright, patent, trademark, and attribution notices from the
+Source form of the Work, excluding those notices that do not pertain to any part
+of the Derivative Works; and
+d. If the Work includes a "NOTICE" text file as part of its distribution, then
+any Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file, excluding those notices
+that do not pertain to any part of the Derivative Works, in at least one of the
+following places: within a NOTICE text file distributed as part of the
+Derivative Works; within the Source form or documentation, if provided along
+with the Derivative Works; or, within a display generated by the Derivative
+Works, if and wherever such third-party notices normally appear. The contents of
+the NOTICE file are for informational purposes only and do not modify the
+License. You may add Your own attribution notices within Derivative Works that
+You distribute, alongside or as an addendum to the NOTICE text from the Work,
+provided that such additional attribution notices cannot be construed as
+modifying the License. 
+
+You may add Your own copyright statement to Your modifications and may provide
+additional or different license terms and conditions for use, reproduction, or
+distribution of Your modifications, or for any such Derivative Works as a whole,
+provided Your use, reproduction, and distribution of the Work otherwise complies
+with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+Contribution intentionally submitted for inclusion in the Work by You to the
+Licensor shall be under the terms and conditions of this License, without any
+additional terms or conditions. Notwithstanding the above, nothing herein shall
+supersede or modify the terms of any separate license agreement you may have
+executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as required
+for reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+writing, Licensor provides the Work (and each Contributor provides its
+Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied, including, without limitation, any warranties
+or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any risks
+associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in
+tort (including negligence), contract, or otherwise, unless required by
+applicable law (such as deliberate and grossly negligent acts) or agreed to in
+writing, shall any Contributor be liable to You for damages, including any
+direct, indirect, special, incidental, or consequential damages of any character
+arising as a result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill, work stoppage,
+computer failure or malfunction, or any and all other commercial damages or
+losses), even if such Contributor has been advised of the possibility of such
+damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or
+Derivative Works thereof, You may choose to offer, and charge a fee for,
+acceptance of support, warranty, indemnity, or other liability obligations
+and/or rights consistent with this License. However, in accepting such
+obligations, You may act only on Your own behalf and on Your sole
+responsibility, not on behalf of any other Contributor, and only if You agree
+to indemnify, defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason of your
+accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

data/README.md

@@ -0,0 +1,182 @@
+Ruby Client
+===========
+
+<a href="https://raw.githubusercontent.com/ArpNetworking/metrics-client-ruby/master/LICENSE">
+    <img src="https://img.shields.io/hexpm/l/plug.svg"
+         alt="License: Apache 2">
+</a>
+<a href="https://travis-ci.org/ArpNetworking/metrics-client-ruby/">
+    <img src="https://travis-ci.org/ArpNetworking/metrics-client-ruby.png"
+         alt="Travis Build">
+</a>
+[![Gem Version](https://badge.fury.io/rb/tsd_metrics.svg)](https://badge.fury.io/rb/tsd_metrics)
+
+Client implementation for publishing metrics from Ruby applications. 
+
+
+Instrumenting Your Application
+------------------------------
+
+### Add Dependency
+
+Determine the latest version of the Ruby client in [rubygems.org](https://rubygems.org/gems/tsd_metrics).  Modify your Gemfile to include the Ruby Gems repository:
+
+    source "http://rubygems.org"
+
+Add a dependency on the metrics client in your Gemfile:
+
+    gem "tsd_metrics" "VERSION"
+
+### Initialization
+
+The metrics library must be initialized before being used. The following example will configure the library to output metrics to the relative directory "./log/query.log":
+
+```ruby
+TsdMetrics.init(filename: Rails.root.join('log', 'query.log'))
+```
+
+The options accepted by TsdMetrics.init() and their defaults are:
+```ruby
+TsdMetrics.init({
+  filename: 'query.log'  # Optional: the relative or absolute path to output metrics. Default: 'query.log' in the working directory
+  errorLogger: Logger.new(STDOUT)  # Optional: a place to which mis-uses of the library can be logged. Expects methods info, warn, error.
+  rollLogs: true  # Have the library do log rolling; not thread-safe! Setting to false means the library-user should have external log-rolling in place.
+})
+```
+
+### Metrics
+
+A new Metrics instance should be created for each unit of work.  For example:
+
+```ruby
+metrics = TsdMetrics.buildMetric
+```
+
+Counters, timers and gauges are recorded against a metrics instance which must be closed at the end of a unit of work.  After the Metrics instance is closed no further measurements may be recorded against that instance.
+ 
+ ```ruby
+metrics.incrementCounter("foo");
+metrics.startTimer("bar");
+// Do something that is being timed
+metrics.stopTimer("bar");
+metrics.setGauge("temperature", 21.7);
+metrics.close();
+```
+
+### Counters
+
+Surprisingly, counters are probably more difficult to use and interpret than timers and gauges.  In the simplest case you can just starting counting, for example, iterations of a loop:
+
+```ruby
+arrayOfStrings.each { |string|
+    metrics.incrementCounter("strings");
+    ...
+}
+```
+
+However, what happens if listOfString is empty? Then no sample is recorded. To always record a sample the counter should be reset before the loop is executed:
+
+```ruby
+metrics.resetCounter("strings");
+arrayOfStrings.each { |string|
+    metrics.incrementCounter("strings");
+    ...
+}
+```
+
+Next, if the loop is executed multiple times:
+
+```ruby
+arrayOfArrayOfStrings.each { |arrayOfStrings|
+    metrics.resetCounter("strings");
+    arrayOfStrings.each { |string|
+        metrics.incrementCounter("s");
+        ...
+    }
+}
+```
+
+The above code will produce a number of samples equal to the size of listOfListOfStrings (including no samples if listOfListOfStrings is empty).  If you move the resetCounter call outside the outer loop the code always produces a single sample (even if listOfListOfStrings is empty).  There is a significant difference between counting the total number of strings and the number of strings per list; especially, when computing and analyzing statistics such as percentiles. 
+
+Finally, if the loop is being executed concurrently for the same unit of work, that is for the same Metrics instance, then you could use a Counter object:
+
+```ruby 
+final Counter counter = metrics.createCounter("strings");
+arrayOfStrings.each { |string|
+    counter.increment();
+    ...
+}
+```
+
+The Counter object example extends in a similar way for nested loops.
+
+### Timers
+
+Timers are very easy to use. The only note worth making is that when using timers - either procedural or via objects - do not forget to stop/close the timer!  If you fail to do this the client will log a warning and suppress any unstopped/unclosed samples.
+
+The timer object allows a timer sample to be detached from the Metrics instance.  For example:  
+
+```ruby
+def threadFunc
+    final Timer t = metrics.createTimer("operation");
+    // Perform your operation
+    t.stop();
+}
+```
+
+This is very useful in a concurrent system when executing and thus measuring the same event multiple times concurrently.  The one caveat is to ensure the timer objects are stopped/closed before the Metrics instance is closed.  Failing to do so will log a warning and suppress any samples stopped/closed after the Metrics instance is closed.
+ 
+### Gauges
+
+Gauges are the simplest metric to record.  Samples for a gauge represent spot measurements. For example, the length of a queue or the number of active threads in a thread pool.  Gauges are often used in separate units of work to measure the state of system resources, for example the row count in a database table.  However, gauges are also useful in existing units of work, for example recording the memory in use at the beginning and end of each service request.
+
+Building
+--------
+
+Links to prerequisites:
+* [RVM](https://rvm.io/rvm/install) (w/ Ruby 1.9.3+)
+
+Install Ruby version with RVM:
+
+    client-ruby> rvm install 1.9.3
+
+Select Ruby version with RVM:
+
+    client-ruby> rvm 1.9.3
+
+Building the gem:
+
+    client-ruby> gem build tsd_metrics.gemspec
+
+Testing the gem:
+
+    client-ruby> rspec
+
+Install the current version locally:
+
+    gem install --local /path_to_gem/tsd_metrics.gem
+
+Using the local version is intended only for testing or development. 
+
+Frameworks
+----------
+
+It is common for Ruby frameworks to run in a multi-process mode for serving requests.  Often, the
+frameworks will using forking to setup new processes.  Forking can be problematic as the client
+creates a Ruby thread to write the log in the background.  If the client is initialized before 
+the fork, the background writer thread will continue to run in the original process, but not
+in the newly created process.  This often manifests as an increasing write queue, but no data
+written to the metrics log file.  The following describes what steps are needed for frameworks
+we have encountered.
+
+### Passenger
+
+No work is needed to make the client work under Phusion Passenger.  Internally, we detect the fork 
+and re-initialize the client.  Everything just works.
+
+License
+-------
+
+Published under Apache Software License 2.0, see LICENSE
+
+&copy; Groupon Inc., 2014

data/Rakefile

@@ -0,0 +1,5 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/demo.rb

@@ -0,0 +1,27 @@
+# Copyright 2014 Groupon.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.
+
+require_relative 'lib/tsd_metrics'
+filename = "my_logs.json"
+
+TsdMetrics.init(filename)
+# build metric, close
+while true
+  metric = TsdMetrics.buildMetric
+  metric.setGauge("myGauge", 1 / ((Time.now.to_f ** 2) + 1))
+  metric.setGauge("myGauge2", 20)
+  metric.annotate("myAnnotation", "Hi there")
+  metric.close
+  sleep (0.5)
+end

data/doc/QUERY_LOG_FORMAT.md

@@ -0,0 +1,59 @@
+Query Log Format
+================
+
+Provides a platform for recording, aggregating, publishing and accessing metrics produced by your host system, shared resource, or application. 
+
+
+Versions
+--------
+
+### 2G *(Proposed)*
+
+* *Example Not Available*
+* *Schema Not Available*
+
+Changes:
+* Include time offset relative to initTimestamp on each timer sample.
+
+### 2F *(Proposed)*
+
+* *Example Not Available*
+* *Schema Not Available*
+
+Changes:
+* Support for compound units (e.g. Megabytes per second).
+* Fully self-describing:
+    * Include service name
+    * Include cluster name
+    * Include host name
+
+### 2E
+
+* [Example](query-log-example-2e.json)
+* [Schema](query-log-schema-2e.json)
+
+Changes:
+* Wrap the metrics payload in a formatted container to better support general log routing and storage.
+    * The time, name and level fields must be serialized first and in that order.
+    * The time must be in ISO8601 with date, time and timezone.
+
+### 2D
+
+* [Example](query-log-example-2d.json)
+* [Schema](query-log-schema-2d.json)
+
+Changes:
+* Expand counter, timer and gauge samples to include optional units.
+* Switch finalTimestamp and initTimestamp annotations from epoch to ISO8601.
+
+### 2C
+
+* [Example](query-log-example-2c.json)
+* [Schema](query-log-schema-2c.json)
+
+Changes:
+* First standardized JSON format.
+
+### Pre-2C
+
+All versions prior to 2C of the file format and are considered *deprecated*.

data/doc/query-log-schema-2c.json

@@ -0,0 +1,55 @@
+{
+    "title": "Query Log",
+    "description": "log file entry for ingestion by tsd aggregator",
+    "type":"object",
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "properties":{
+        "annotations": {
+            "type":"object",
+            "properties":{
+                "finalTimestamp": {
+                    "type":"string"
+                },
+                "initTimestamp": {
+                    "type":"string"
+                }
+            },
+            "required": ["initTimestamp", "finalTimestamp"]
+        },
+        "counters": {
+            "type":"object",
+            "properties":{ },
+            "additionalProperties": {
+                "type": "array",
+                "items": {
+                    "type": "number"
+                }
+            }
+        },
+        "gauges": {
+            "type":"object",
+            "properties":{ },
+            "additionalProperties": {
+                "type": "array",
+                "items": {
+                    "type": "number"
+                }
+            }
+        },
+        "timers": {
+            "type":"object",
+            "properties":{ },
+            "additionalProperties": {
+                "type": "array",
+                "items": {
+                    "type": "number"
+                }
+            }
+        },
+        "version": {
+            "type":"string",
+            "pattern": "^2c$"
+        }
+    },
+    "required": ["annotations", "counters", "timers", "gauges", "version"]
+}

data/doc/query-log-schema-2d.json

@@ -0,0 +1,69 @@
+{
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "definitions": {
+        "sampleObject" : {
+            "type": "object",
+            "properties" : {
+                "unit": {
+                    "type": "string",
+                    "enum": ["nanosecond","microsecond", "millisecond", "second", "minute", "hour", "day", "week", "bit", "byte", "kilobit", "kilobyte", "megabit", "megabyte", "gigabit", "gigabyte", "terabyte", "petabyte"]
+                },
+                "value": {
+                    "type": "number"
+                }
+            }
+        },
+        "dataElement": {
+            "type": "object",
+            "properties": { 
+                "values": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/sampleObject"
+                    } 
+                }
+            }
+        },
+        "metricsList": {
+            "type": "object",
+            "additionalProperties": {
+                "$ref": "#/definitions/dataElement"
+            }
+        }
+    },
+
+    "title": "Query Log",
+    "description": "log file entry for ingestion by tsd aggregator",
+    "type":"object",
+
+    "properties":{
+        "annotations": {
+            "type":"object",
+            "properties": {
+                "finalTimestamp": {
+                    "type":"string",
+                    "format": "date-time"
+                },
+                "initTimestamp": {
+                    "type":"string",
+                    "format": "date-time"
+                }
+            },
+            "required": ["initTimestamp", "finalTimestamp"]
+        },
+        "counters":  {
+            "$ref": "#/definitions/metricsList"
+        },
+        "gauges": {
+            "$ref": "#/definitions/metricsList"
+        },
+        "timers": {
+            "$ref": "#/definitions/metricsList"
+        },
+        "version": {
+            "type":"string",
+            "pattern": "^2d$"
+        }
+    },
+    "required": ["annotations", "version"]
+}