Metrics Implementation (#160)

* Create functions

Comments for Meter

More comments

Add more comments

Fix typos

* fix lint

* Fix lint

* fix typing

* Remove options, constructors, seperate labels

* Consistent naming for float and int

* Abstract time series

* Use ABC

* Fix typo

* Fix docs

* seperate measure classes

* Add examples

* fix lint

* Update to RFC 0003

* Add spancontext, measurebatch

* Fix docs

* Fix comments

* fix lint

* fix lint

* fix lint

* skip examples

* white space

* fix spacing

* fix imports

* fix imports

* LabelValues to str

* Black formatting

* fix isort

* Remove aggregation

* Fix names

* Remove aggregation from docs

* Fix lint

* metric changes

* Typing

* Fix lint

* Fix lint

* Add space

* Fix lint

* fix comments

* handle, recordbatch

* docs

* Update recordbatch

* black

* Fix typo

* remove ValueType

* fix lint

* sdk

* metrics

* example

* counter

* Tests

* Address comments

* ADd tests

* Fix typing and examples

* black

* fix lint

* remove override

* Fix tests

* mypy

* fix lint

* fix type

* fix typing

* fix tests

* isort

* isort

* isort

* isort

* noop

* lint

* lint

* fix tuple typing

* fix type

* black

* address comments

* fix type

* fix lint

* remove imports

* default tests

* fix lint

* usse sequence

* remove ellipses

* remove ellipses

* black

* Fix typo

* fix example

* fix type

* fix type

* address comments

Author: lzchen

docs/opentelemetry.metrics.handle.rst

@@ -1,13 +1,6 @@
 opentelemetry.metrics package
 =============================
 
-Submodules
-----------
-
-.. toctree::
-
-   opentelemetry.metrics.handle
-
 Module contents
 ---------------
 

docs/opentelemetry.metrics.rst

@@ -11,26 +11,29 @@
 # 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.
+#
+"""
+This module serves as an example for a simple application using metrics
+"""
 
-# pylint: skip-file
 from opentelemetry import metrics
+from opentelemetry.sdk.metrics import Counter, Meter
 
-METER = metrics.Meter()
-MEASURE = metrics.create_measure(
-    "idle_cpu_percentage",
-    "cpu idle over time",
-    "percentage",
-    metrics.ValueType.FLOAT,
-    ["environment"],
+metrics.set_preferred_meter_implementation(lambda _: Meter())
+meter = metrics.meter()
+counter = meter.create_metric(
+    "available memory",
+    "available memory",
+    "bytes",
+    int,
+    Counter,
+    ("environment",),
 )
 
-# Metrics sent to some exporter
-MEASURE_METRIC_TESTING = MEASURE.get_handle("Testing")
-MEASURE_METRIC_STAGING = MEASURE.get_handle("Staging")
-
-# record individual measures
-STATISTIC = 100
-MEASURE_METRIC_STAGING.record(STATISTIC)
+label_values = ("staging",)
+counter_handle = counter.get_handle(label_values)
+counter_handle.add(100)
+meter.record_batch(label_values, [(counter, 50)])
+print(counter_handle.data)
 
-# Batch recording
-METER.record_batch([tuple(MEASURE_METRIC_STAGING, STATISTIC)])
+# TODO: exporters