Initial version of Azure extension (#613)

Introduced a new package opencensus-ext-azure.
Implemented the skeleton of Azure trace exporter.
Fixed the example in opencensus-ext-flask (now it is in-sync with the doc).
Increased the test_transport.py interval to 0.1 second (it keeps failing on Windows machine with anti-virus software).

Author: reyang

README.rst

@@ -234,6 +234,7 @@ OpenCensus supports integration with popular web frameworks, client libraries an
 Trace Exporter
 --------------
 
+-  `Azure`_
 -  `Jaeger`_
 -  `OCAgent`_
 -  `Stackdriver`_
@@ -245,6 +246,7 @@ Stats Exporter
 -  `Prometheus`_
 -  `Stackdriver`_
 
+.. _Azure: https://github.com/census-instrumentation/opencensus-python/tree/master/contrib/opencensus-ext-azure
 .. _Django: https://github.com/census-instrumentation/opencensus-python/tree/master/contrib/opencensus-ext-django
 .. _Flask: https://github.com/census-instrumentation/opencensus-python/tree/master/contrib/opencensus-ext-flask
 .. _Google Cloud Client Libraries: https://github.com/census-instrumentation/opencensus-python/tree/master/contrib/opencensus-ext-google-cloud-clientlibs

contrib/opencensus-ext-azure/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Changelog
+
+## Unreleased
+- Initial project skeleton

contrib/opencensus-ext-azure/README.rst

@@ -0,0 +1,21 @@
+OpenCensus Azure Monitor Trace Exporter
+============================================================================
+
+|pypi|
+
+.. |pypi| image:: https://badge.fury.io/py/opencensus-ext-azure.svg
+   :target: https://pypi.org/project/opencensus-ext-azure/
+
+Installation
+------------
+
+::
+
+    pip install opencensus-ext-azure
+
+Usage
+-----
+
+.. code:: python
+
+    # TBD

contrib/opencensus-ext-azure/examples/client.py

@@ -0,0 +1,33 @@
+# Copyright 2019, OpenCensus Authors
+#
+# 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.
+
+import requests
+
+from opencensus.ext.azure.trace_exporter import AzureExporter
+from opencensus.trace import config_integration
+from opencensus.trace.propagation.trace_context_http_header_format \
+    import TraceContextPropagator
+from opencensus.trace.tracer import Tracer
+
+if __name__ == '__main__':
+    config_integration.trace_integrations(['requests'])
+    tracer = Tracer(
+        propagator=TraceContextPropagator(),
+        exporter=AzureExporter(),
+    )
+    with tracer.span(name='parent'):
+        with tracer.span(name='child'):
+            response = requests.get(url='http://localhost:8080/')
+            print(response.status_code)
+            print(response.text)

contrib/opencensus-ext-azure/examples/server.py

@@ -0,0 +1,43 @@
+# Copyright 2019, OpenCensus Authors
+#
+# 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.
+
+from flask import Flask
+import requests
+
+from opencensus.trace import config_integration
+from opencensus.ext.azure.trace_exporter import AzureExporter
+from opencensus.ext.flask.flask_middleware import FlaskMiddleware
+from opencensus.trace.propagation.trace_context_http_header_format \
+    import TraceContextPropagator
+
+app = Flask(__name__)
+middleware = FlaskMiddleware(
+    app,
+    exporter=AzureExporter(),
+    propagator=TraceContextPropagator(),
+)
+
+
+@app.route('/')
+def hello():
+    requests.get('https://www.wikipedia.org/wiki/Rabbit')
+    return 'Hello, World!'
+
+
+if __name__ == '__main__':
+    import logging
+    logger = logging.getLogger('werkzeug')
+    logger.setLevel(logging.ERROR)
+    config_integration.trace_integrations(['requests'])
+    app.run(host='localhost', port=8080, threaded=True)

contrib/opencensus-ext-azure/examples/simple.py

@@ -0,0 +1,23 @@
+# Copyright 2019, OpenCensus Authors
+#
+# 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.
+
+from opencensus.ext.azure.trace_exporter import AzureExporter
+from opencensus.trace import tracer as tracer_module
+
+tracer = tracer_module.Tracer(exporter=AzureExporter())
+
+if __name__ == '__main__':
+    with tracer.span(name='foo') as foo:
+        with foo.span(name='bar'):
+            print('Hello, World!')

contrib/opencensus-ext-azure/opencensus/__init__.py

@@ -0,0 +1 @@
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)

contrib/opencensus-ext-azure/opencensus/ext/__init__.py

@@ -0,0 +1 @@
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)

contrib/opencensus-ext-azure/opencensus/ext/azure/__init__.py

@@ -0,0 +1 @@
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)

contrib/opencensus-ext-azure/opencensus/ext/azure/common/__init__.py

@@ -0,0 +1,26 @@
+# Copyright 2019, OpenCensus Authors
+#
+# 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.
+
+import os
+
+from opencensus.ext.azure.common.protocol import Object
+
+
+class Options(Object):
+    prototype = Object(
+        endpoint='https://dc.services.visualstudio.com/v2/track',
+        instrumentation_key=os.getenv('APPINSIGHTS_INSTRUMENTATIONKEY', None),
+        proxy=None,
+        timeout=5.0,  # timeout in seconds
+    )