docs: Update for get_tracer_provider() (open-telemetry#503)

disfluxly · mauriciovasquezbernal · toumorokoshi · web-flow · commit 6afcea979a17 · 2020-03-27T20:50:38.000-07:00
Update to the zipkin/jaeger ext READMEs and also a small doc update.

0.5.0 changed .tracer_provider() to .get_tracer_provider()

Co-authored-by: Mauricio Vásquez &lt;mauricio@kinvolk.io&gt;
Co-authored-by: Yusuke Tsutsumi &lt;yusuke@tsutsumi.io&gt;
diff --git a/ext/opentelemetry-ext-dbapi/src/opentelemetry/ext/dbapi/__init__.py b/ext/opentelemetry-ext-dbapi/src/opentelemetry/ext/dbapi/__init__.py
@@ -23,15 +23,16 @@
 
     import mysql.connector
     import pyodbc
-    from opentelemetry.trace import tracer_provider
+
     from opentelemetry.ext.dbapi import trace_integration
+    from opentelemetry.trace import TracerProvider
 
     trace.set_tracer_provider(TracerProvider())
     tracer = trace.get_tracer(__name__)
     # Ex: mysql.connector
-    trace_integration(tracer_provider(), mysql.connector, "connect", "mysql", "sql")
+    trace_integration(tracer, mysql.connector, "connect", "mysql", "sql")
     # Ex: pyodbc
-    trace_integration(tracer_provider(), pyodbc, "Connection", "odbc", "sql")
+    trace_integration(tracer, pyodbc, "Connection", "odbc", "sql")
 
 API
 ---
diff --git a/ext/opentelemetry-ext-http-requests/src/opentelemetry/ext/http_requests/__init__.py b/ext/opentelemetry-ext-http-requests/src/opentelemetry/ext/http_requests/__init__.py
@@ -23,9 +23,9 @@
 
     import requests
     import opentelemetry.ext.http_requests
-    from opentelemetry.trace import tracer_provider
+    from opentelemetry.trace import TracerProvider
 
-    opentelemetry.ext.http_requests.enable(tracer_provider())
+    opentelemetry.ext.http_requests.enable(TracerProvider())
     response = requests.get(url='https://www.example.org/')
 
 Limitations
diff --git a/ext/opentelemetry-ext-jaeger/src/opentelemetry/ext/jaeger/__init__.py b/ext/opentelemetry-ext-jaeger/src/opentelemetry/ext/jaeger/__init__.py
@@ -50,7 +50,7 @@
     span_processor = BatchExportSpanProcessor(jaeger_exporter)
 
     # add to the tracer
-    trace.tracer_provider().add_span_processor(span_processor)
+    trace.get_tracer_provider().add_span_processor(span_processor)
 
     with tracer.start_as_current_span('foo'):
         print('Hello world!')
diff --git a/ext/opentelemetry-ext-mysql/src/opentelemetry/ext/mysql/__init__.py b/ext/opentelemetry-ext-mysql/src/opentelemetry/ext/mysql/__init__.py
@@ -24,10 +24,13 @@
 .. code:: python
 
     import mysql.connector
-    from opentelemetry.trace import tracer_provider
+    from opentelemetry.trace import TracerProvider
     from opentelemetry.ext.mysql import trace_integration
 
-    trace_integration(tracer_provider())
+    trace.set_tracer_provider(TracerProvider())
+    tracer = trace.get_tracer(__name__)
+
+    trace_integration(tracer)
     cnx = mysql.connector.connect(database='MySQL_Database')
     cursor = cnx.cursor()
     cursor.execute("INSERT INTO test (testField) VALUES (123)"
diff --git a/ext/opentelemetry-ext-pymongo/src/opentelemetry/ext/pymongo/__init__.py b/ext/opentelemetry-ext-pymongo/src/opentelemetry/ext/pymongo/__init__.py
@@ -24,10 +24,13 @@
 .. code:: python
 
     from pymongo import MongoClient
-    from opentelemetry.trace import tracer_provider
+    from opentelemetry.trace import TracerProvider
     from opentelemetry.trace.ext.pymongo import trace_integration
 
-    trace_integration(tracer_provider())
+    trace.set_tracer_provider(TracerProvider())
+    tracer = trace.get_tracer(__name__)
+
+    trace_integration(tracer)
     client = MongoClient()
     db = client["MongoDB_Database"]
     collection = db["MongoDB_Collection"]
diff --git a/ext/opentelemetry-ext-zipkin/src/opentelemetry/ext/zipkin/__init__.py b/ext/opentelemetry-ext-zipkin/src/opentelemetry/ext/zipkin/__init__.py
@@ -60,7 +60,7 @@
     span_processor = BatchExportSpanProcessor(zipkin_exporter)
 
     # add to the tracer
-    trace.tracer_provider().add_span_processor(span_processor)
+    trace.get_tracer_provider().add_span_processor(span_processor)
 
     with tracer.start_as_current_span("foo"):
         print("Hello world!")
diff --git a/opentelemetry-api/src/opentelemetry/metrics/__init__.py b/opentelemetry-api/src/opentelemetry/metrics/__init__.py
@@ -425,7 +425,7 @@ def get_meter(
 ) -> "Meter":
     """Returns a `Meter` for use by the given instrumentation library.
     This function is a convenience wrapper for
-    opentelemetry.metrics.meter_provider().get_meter
+    opentelemetry.metrics.get_meter_provider().get_meter
     """
     return get_meter_provider().get_meter(
         instrumenting_module_name, stateful, instrumenting_library_version
diff --git a/opentelemetry-api/src/opentelemetry/trace/__init__.py b/opentelemetry-api/src/opentelemetry/trace/__init__.py
@@ -660,7 +660,7 @@ def get_tracer(
     """Returns a `Tracer` for use by the given instrumentation library.
 
     This function is a convenience wrapper for
-    opentelemetry.trace.tracer_provider().get_tracer
+    opentelemetry.trace.get_tracer_provider().get_tracer
     """
     return get_tracer_provider().get_tracer(
         instrumenting_module_name, instrumenting_library_version
