Make metrics public (#2684)

* Make metrics public

Fixes #2682

* Make environment variable public

* Make environment variable public

* Fix example

* Make exporter public

* Fix environment variable import path

* Fix exporter

* Fix lint

* Fix import order

* Add tag

* Fix import path

Author: ocelotl

CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased](https://github.com/open-telemetry/opentelemetry-python/compare/v1.11.1-0.30b1...HEAD)
 
+- Make metrics components public
+  ([#2684](https://github.com/open-telemetry/opentelemetry-python/pull/2684))
 - Update to semantic conventions v1.11.0
   ([#2669](https://github.com/open-telemetry/opentelemetry-python/pull/2669))
 - Update opentelemetry-proto to v0.17.0

docs/api/metrics.rst

@@ -1,17 +1,10 @@
-opentelemetry._metrics package
-==============================
-
-.. warning::
-   OpenTelemetry Python metrics are in an experimental state. The APIs within
-   :mod:`opentelemetry._metrics` are subject to change in minor/patch releases and make no
-   backward compatability guarantees at this time.
-
-   Once metrics become stable, this package will be be renamed to ``opentelemetry.metrics``.
+opentelemetry.metrics package
+=============================
 
 .. toctree::
 
 
 Module contents
 ---------------
 
-.. automodule:: opentelemetry._metrics
+.. automodule:: opentelemetry.metrics

docs/conf.py

@@ -99,11 +99,11 @@
     ("py:class", "ValueT"),
     (
         "py:class",
-        "opentelemetry.sdk._metrics._internal.instrument._Synchronous",
+        "opentelemetry.sdk.metrics._internal.instrument._Synchronous",
     ),
     (
         "py:class",
-        "opentelemetry.sdk._metrics._internal.instrument._Asynchronous",
+        "opentelemetry.sdk.metrics._internal.instrument._Asynchronous",
     ),
     # Even if wrapt is added to intersphinx_mapping, sphinx keeps failing
     # with "class reference target not found: ObjectProxy".

docs/examples/metrics/README.rst

@@ -1,11 +1,6 @@
 OpenTelemetry Metrics SDK
 =========================
 
-.. warning::
-   OpenTelemetry Python metrics are in an experimental state. The APIs within
-   :mod:`opentelemetry.sdk._metrics` are subject to change in minor/patch releases and there are no
-   backward compatability guarantees at this time.
-
 Start the Collector locally to see data being exported. Write the following file:
 
 .. code-block:: yaml
@@ -45,4 +40,4 @@ The resulting metrics will appear in the output from the collector and look simi
 
 .. code-block:: sh
 
-TODO
+TODO

docs/examples/metrics/example.py

@@ -1,16 +1,16 @@
 from typing import Iterable
 
-from opentelemetry._metrics import (
+from opentelemetry.exporter.otlp.proto.grpc.metric_exporter import (
+    OTLPMetricExporter,
+)
+from opentelemetry.metrics import (
+    CallbackOptions,
     Observation,
     get_meter_provider,
     set_meter_provider,
 )
-from opentelemetry._metrics._internal.instrument import CallbackOptions
-from opentelemetry.exporter.otlp.proto.grpc._metric_exporter import (
-    OTLPMetricExporter,
-)
-from opentelemetry.sdk._metrics import MeterProvider
-from opentelemetry.sdk._metrics.export import PeriodicExportingMetricReader
+from opentelemetry.sdk.metrics import MeterProvider
+from opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader
 
 exporter = OTLPMetricExporter(insecure=True)
 reader = PeriodicExportingMetricReader(exporter)

docs/getting_started/metrics_example.py

@@ -17,14 +17,14 @@
 
 from typing import Iterable
 
-from opentelemetry._metrics import (
+from opentelemetry.metrics import (
     CallbackOptions,
     Observation,
     get_meter_provider,
     set_meter_provider,
 )
-from opentelemetry.sdk._metrics import MeterProvider
-from opentelemetry.sdk._metrics.export import (
+from opentelemetry.sdk.metrics import MeterProvider
+from opentelemetry.sdk.metrics.export import (
     ConsoleMetricExporter,
     PeriodicExportingMetricReader,
 )

docs/sdk/metrics.export.rst

@@ -1,7 +1,7 @@
-opentelemetry.sdk._metrics.export
-=================================
+opentelemetry.sdk.metrics.export
+================================
 
-.. automodule:: opentelemetry.sdk._metrics.export
+.. automodule:: opentelemetry.sdk.metrics.export
     :members:
     :undoc-members:
     :show-inheritance:

docs/sdk/metrics.rst

@@ -1,13 +1,6 @@
-opentelemetry.sdk._metrics package
+opentelemetry.sdk.metrics package
 ==================================
 
-.. warning::
-   OpenTelemetry Python metrics are in an experimental state. The APIs within
-   :mod:`opentelemetry.sdk._metrics` are subject to change in minor/patch releases and there are no
-   backward compatability guarantees at this time.
-
-   Once metrics become stable, this package will be be renamed to ``opentelemetry.sdk.metrics``.
-
 Submodules
 ----------
 
@@ -16,7 +9,7 @@ Submodules
    metrics.export
    metrics.view
 
-.. automodule:: opentelemetry.sdk._metrics
+.. automodule:: opentelemetry.sdk.metrics
     :members:
     :undoc-members:
     :show-inheritance:

docs/sdk/metrics.view.rst

@@ -1,7 +1,7 @@
-opentelemetry.sdk._metrics.view
-===============================
+opentelemetry.sdk.metrics.view
+==============================
 
-.. automodule:: opentelemetry.sdk._metrics.view
+.. automodule:: opentelemetry.sdk.metrics.view
     :members:
     :undoc-members:
     :show-inheritance:

exporter/opentelemetry-exporter-otlp-proto-grpc/src/opentelemetry/exporter/otlp/proto/grpc/_metric_exporter/__init__.py renamed to exporter/opentelemetry-exporter-otlp-proto-grpc/src/opentelemetry/exporter/otlp/proto/grpc/metric_exporter/__init__.py

@@ -30,14 +30,14 @@
 from opentelemetry.sdk.environment_variables import (
     OTEL_EXPORTER_OTLP_METRICS_INSECURE,
 )
-from opentelemetry.sdk._metrics.export import (
+from opentelemetry.sdk.metrics.export import (
     Gauge,
     Histogram,
     Metric,
     Sum,
 )
 
-from opentelemetry.sdk._metrics.export import (
+from opentelemetry.sdk.metrics.export import (
     MetricExporter,
     MetricExportResult,
     MetricsData,