[docs] updating metrics examples (#2507)

* [docs] updating metrics examples

Adding different instruments to the example code.

* use correct Measurement

Co-authored-by: Diego Hurtado <[email protected]>

Author: Alex Boten

docs/examples/metrics/example.py

@@ -1,4 +1,7 @@
+from typing import Iterable
+
 from opentelemetry._metrics import get_meter_provider, set_meter_provider
+from opentelemetry._metrics.measurement import Measurement
 from opentelemetry.exporter.otlp.proto.grpc._metric_exporter import (
     OTLPMetricExporter,
 )
@@ -10,7 +13,43 @@
 provider = MeterProvider(metric_readers=[reader])
 set_meter_provider(provider)
 
+
+def observable_counter_func() -> Iterable[Measurement]:
+    yield Measurement(1, {})
+
+
+def observable_up_down_counter_func() -> Iterable[Measurement]:
+    yield Measurement(-10, {})
+
+
+def observable_gauge_func() -> Iterable[Measurement]:
+    yield Measurement(9, {})
+
+
 meter = get_meter_provider().get_meter("getting-started", "0.1.2")
-counter = meter.create_counter("first_counter")
+
+# Counter
+counter = meter.create_counter("counter")
 counter.add(1)
-# TODO: fill in details for additional metrics
+
+# Async Counter
+observable_counter = meter.create_observable_counter(
+    "observable_counter", observable_counter_func
+)
+
+# UpDownCounter
+updown_counter = meter.create_up_down_counter("updown_counter")
+updown_counter.add(1)
+updown_counter.add(-5)
+
+# Async UpDownCounter
+observable_updown_counter = meter.create_observable_up_down_counter(
+    "observable_updown_counter", observable_up_down_counter_func
+)
+
+# Histogram
+histogram = meter.create_histogram("histogram")
+histogram.record(99.9)
+
+# Async Gauge
+gauge = meter.create_observable_gauge("gauge", observable_gauge_func)

docs/getting_started/metrics_example.py

@@ -15,7 +15,10 @@
 # metrics.py
 # This is still work in progress as the metrics SDK is being implemented
 
+from typing import Iterable
+
 from opentelemetry._metrics import get_meter_provider, set_meter_provider
+from opentelemetry._metrics.measurement import Measurement
 from opentelemetry.sdk._metrics import MeterProvider
 from opentelemetry.sdk._metrics.export import (
     ConsoleMetricExporter,
@@ -27,7 +30,43 @@
 provider = MeterProvider(metric_readers=[reader])
 set_meter_provider(provider)
 
+
+def observable_counter_func() -> Iterable[Measurement]:
+    yield Measurement(1, {})
+
+
+def observable_up_down_counter_func() -> Iterable[Measurement]:
+    yield Measurement(-10, {})
+
+
+def observable_gauge_func() -> Iterable[Measurement]:
+    yield Measurement(9, {})
+
+
 meter = get_meter_provider().get_meter("getting-started", "0.1.2")
-counter = meter.create_counter("first_counter")
+
+# Counter
+counter = meter.create_counter("counter")
 counter.add(1)
-# TODO: fill in details for additional metrics
+
+# Async Counter
+observable_counter = meter.create_observable_counter(
+    "observable_counter", observable_counter_func
+)
+
+# UpDownCounter
+updown_counter = meter.create_up_down_counter("updown_counter")
+updown_counter.add(1)
+updown_counter.add(-5)
+
+# Async UpDownCounter
+observable_updown_counter = meter.create_observable_up_down_counter(
+    "observable_updown_counter", observable_up_down_counter_func
+)
+
+# Histogram
+histogram = meter.create_histogram("histogram")
+histogram.record(99.9)
+
+# Async Gauge
+gauge = meter.create_observable_gauge("gauge", observable_gauge_func)