add client server example

Author: majorgreys

docs/examples/datadog_exporter/README.rst

@@ -12,8 +12,8 @@ Installation
     pip install opentelemetry-sdk
     pip install opentelemetry-ext-datadog
 
-Run the Example
----------------
+Basic Example
+-------------
 
 * Start Datadog Agent
 
@@ -27,10 +27,33 @@ Run the Example
         -e DD_APM_ENABLED=true \
         datadog/agent:latest
 
-* Run the example
+* Run example
 
 .. code-block:: sh
 
     python datadog_exporter.py
 
-The traces will be available at http://datadoghq.com/.
+Auto-Instrumention Example
+--------------------------
+
+* Start Datadog Agent (same as above)
+
+* Install libraries
+
+.. code-block:: sh
+
+    pip install opentelemetry-api
+    pip install opentelemetry-sdk
+    pip install opentelemetry-ext-datadog
+    pip install opentelemetry-auto-instrumentation
+    pip install opentelemetry-ext-flask
+    pip install flask
+    pip install requests
+
+* Run auto-instrumentation example
+
+.. code-block:: sh
+    # start server in a terminal
+    opentelemetry-auto-instrumentation server.py
+    # run client in another terminal
+    python client.py testing

docs/examples/datadog_exporter/client.py

@@ -0,0 +1,50 @@
+# Copyright The OpenTelemetry 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 sys import argv
+
+from requests import get
+
+from opentelemetry import propagators, trace
+from opentelemetry.ext.datadog import DatadogSpanExporter
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchExportSpanProcessor
+
+trace.set_tracer_provider(TracerProvider())
+
+trace.get_tracer_provider().add_span_processor(
+    BatchExportSpanProcessor(
+        DatadogSpanExporter(
+            agent_url="http://localhost:8126", service="example-client"
+        )
+    )
+)
+
+tracer = trace.get_tracer(__name__)
+
+assert len(argv) == 2
+
+with tracer.start_as_current_span("client"):
+
+    with tracer.start_as_current_span("client-server"):
+        headers = {}
+        propagators.inject(dict.__setitem__, headers)
+        requested = get(
+            "http://localhost:8082/server_request",
+            params={"param": argv[1]},
+            headers=headers,
+        )
+
+        assert requested.status_code == 200
+        print(requested.text)

docs/examples/datadog_exporter/datadog_exporter.py

@@ -13,7 +13,6 @@
 # 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 opentelemetry import trace
 from opentelemetry.ext.datadog import DatadogSpanExporter

docs/examples/datadog_exporter/server.py

@@ -0,0 +1,44 @@
+# Copyright The OpenTelemetry 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, request
+
+from opentelemetry import trace
+from opentelemetry.ext.datadog import DatadogSpanExporter
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchExportSpanProcessor
+
+app = Flask(__name__)
+
+trace.set_tracer_provider(TracerProvider())
+
+trace.get_tracer_provider().add_span_processor(
+    BatchExportSpanProcessor(
+        DatadogSpanExporter(
+            agent_url="http://localhost:8126", service="example-server"
+        )
+    )
+)
+
+tracer = trace.get_tracer(__name__)
+
+
+@app.route("/server_request")
+def server_request():
+    with tracer.start_as_current_span("server-inner"):
+        return "served: {}".format(request.args.get("param"))
+
+
+if __name__ == "__main__":
+    app.run(port=8082)