OpenTelemetry migration.

.circleci/config.yml

@@ -56,7 +56,6 @@ commands:
       - run:
           name: Run Tests With Coverage Report
           environment:
-            INSTANA_TEST: "true"
             CASSANDRA_TEST: "<<parameters.cassandra>>"
             COUCHBASE_TEST: "<<parameters.couchbase>>"
             GEVENT_STARLETTE_TEST: "<<parameters.gevent>>"
@@ -78,6 +77,7 @@ commands:
     steps:
       - store_test_results:
           path: test-results
+
   run_sonarqube:
     steps:
       - attach_workspace:
@@ -118,8 +118,8 @@ commands:
 jobs:
   python38:
     docker:
-      - image: cimg/python:3.8.20
-      - image: cimg/postgres:9.6.24
+      - image: cimg/python:3.8
+      - image: cimg/postgres:14.12
         environment:
           POSTGRES_USER: root
           POSTGRES_PASSWORD: passw0rd
@@ -142,8 +142,8 @@ jobs:
 
   python39:
     docker:
-      - image: cimg/python:3.9.20
-      - image: cimg/postgres:9.6.24
+      - image: cimg/python:3.9
+      - image: cimg/postgres:14.12
         environment:
           POSTGRES_USER: root
           POSTGRES_PASSWORD: passw0rd
@@ -166,8 +166,8 @@ jobs:
 
   python310:
     docker:
-      - image: cimg/python:3.10.15
-      - image: cimg/postgres:9.6.24
+      - image: cimg/python:3.10
+      - image: cimg/postgres:14.12
         environment:
           POSTGRES_USER: root
           POSTGRES_PASSWORD: passw0rd
@@ -191,8 +191,8 @@ jobs:
 
   python311:
     docker:
-      - image: cimg/python:3.11.10
-      - image: cimg/postgres:9.6.24
+      - image: cimg/python:3.11
+      - image: cimg/postgres:14.12
         environment:
           POSTGRES_USER: root
           POSTGRES_PASSWORD: passw0rd
@@ -231,8 +231,8 @@ jobs:
 
   python312:
     docker:
-      - image: cimg/python:3.12.6
-      - image: cimg/postgres:9.6.24
+      - image: cimg/python:3.12
+      - image: cimg/postgres:14.12
         environment:
           POSTGRES_USER: root
           POSTGRES_PASSWORD: passw0rd
@@ -269,10 +269,23 @@ jobs:
       - store-pytest-results
       - store-coverage-report
 
+  py312aws:
+    docker:
+      - image: cimg/python:3.12
+    working_directory: ~/repo
+    steps:
+      - checkout
+      - pip-install-deps:
+          requirements: "tests/requirements-312.txt"
+      - run-tests-with-coverage-report:
+          tests: "tests_aws"
+      - store-pytest-results
+      - store-coverage-report
+
   python313:
     docker:
       - image: python:3.13.0rc2-bookworm
-      - image: cimg/postgres:9.6.24
+      - image: cimg/postgres:14.12
         environment:
           POSTGRES_USER: root
           POSTGRES_PASSWORD: passw0rd
@@ -296,7 +309,7 @@ jobs:
 
   py39couchbase:
     docker:
-      - image: cimg/python:3.9.20
+      - image: cimg/python:3.9
       - image: couchbase/server-sandbox:5.5.0
     working_directory: ~/repo
     steps:
@@ -312,7 +325,7 @@ jobs:
 
   py39cassandra:
     docker:
-      - image: cimg/python:3.9.20
+      - image: cimg/python:3.9
       - image: cassandra:3.11
         environment:
           MAX_HEAP_SIZE: 2048m
@@ -365,9 +378,10 @@ workflows:
       - python313
       - py39cassandra
       - py39couchbase
-      - py39gevent_starlette
+      # - py39gevent_starlette
       - py311googlecloud
       - py312googlecloud
+      - py312aws
       - final_job:
           requires:
             - python38
@@ -378,6 +392,7 @@ workflows:
             - python313
             - py39cassandra
             - py39couchbase
-            - py39gevent_starlette
+            # - py39gevent_starlette
             - py311googlecloud
             - py312googlecloud
+            - py312aws

.coveragerc

@@ -0,0 +1,7 @@
+[report]
+exclude_lines = 
+    pragma: no cover
+    if TYPE_CHECKING:
+    except ImportError: 
+    except Exception:
+    except Exception as exc:

.tekton/pipeline.yaml

@@ -100,3 +100,17 @@ spec:
       workspaces:
         - name: task-pvc
           workspace: python-tracer-ci-pipeline-pvc
+    - name: unittest-aws
+      runAfter:
+        - clone
+      matrix:
+        params:
+          - name: imageDigest
+            value:
+              # 3.12.6-bookworm
+              - "sha256:af6fa5c329d6bd6dec52855ccb8bb37c30fb8f00819953a035d49499e43b2c9b"
+      taskRef:
+        name: python-tracer-unittest-googlecloud-task
+      workspaces:
+        - name: task-pvc
+          workspace: python-tracer-ci-pipeline-pvc

.tekton/run_unittests.sh

@@ -44,6 +44,9 @@ googlecloud)
   export REQUIREMENTS='requirements-googlecloud.txt'
   export TESTS=('tests/clients/test_google-cloud-storage.py' 'tests/clients/test_google-cloud-pubsub.py')
   export GOOGLE_CLOUD_TEST='true' ;;  
+aws)
+  export REQUIREMENTS='requirements-312.txt'
+  export TESTS=('tests_aws')
 *)
   echo "ERROR \$TEST_CONFIGURATION='${TEST_CONFIGURATION}' is unsupported " \
        "not in (default|cassandra|couchbase|gevent_starlette|googlecloud)" >&2
@@ -52,7 +55,6 @@ esac
 
 echo -n "Configuration is '${TEST_CONFIGURATION}' on ${PYTHON_VERSION} "
 echo    "with dependencies in '${REQUIREMENTS}'"
-export INSTANA_TEST='true'
 ls -lah .
 if [[ -n "${COUCHBASE_TEST}" ]]; then
   echo "Install Couchbase Dependencies"

.tekton/task.yaml

@@ -207,3 +207,24 @@ spec:
       workingDir: /workspace/python-sensor/
       command:
       - /workspace/python-sensor/.tekton/run_unittests.sh
+---
+apiVersion: tekton.dev/v1
+kind: Task
+metadata:
+  name: python-tracer-unittest-aws-task
+spec:
+  params:
+  - name: imageDigest
+    type: string
+  workspaces:
+    - name: task-pvc
+      mountPath: /workspace
+  steps:
+    - name: unittest
+      image: python@$(params.imageDigest)
+      env:
+        - name: TEST_CONFIGURATION
+          value: aws
+      workingDir: /workspace/python-sensor/
+      command:
+      - /workspace/python-sensor/.tekton/run_unittests.sh

README.md

@@ -2,12 +2,16 @@
 
 The `instana` Python package collects key metrics and distributed traces for [Instana].
 
-This package supports Python 3.8 or greater.
-
 Any feedback is welcome.  Happy Python visibility.
 
 [![CircleCI](https://circleci.com/gh/instana/python-sensor/tree/master.svg?style=svg)](https://circleci.com/gh/instana/python-sensor/tree/master)
-[![OpenTracing Badge](https://img.shields.io/badge/OpenTracing-enabled-blue.svg)](http://opentracing.io)
+[![OpenTracing Badge](https://img.shields.io/badge/OpenTracing-disabled-red.svg)](http://opentracing.io)
+[![OpenTelemetry Badge](https://img.shields.io/badge/OpenTelemetry-enabled-blue.svg)](http://opentelemetry.io)
+![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Finstana%2Fpython-sensor%2Frefs%2Fheads%2Fmaster%2Fpyproject.toml)
+![GitHub Release](https://img.shields.io/github/v/release/instana/python-sensor)
+
+> [!NOTE]
+> Support for OpenTracing is deprecated starting on version 3.0.0. If you still want to use it, rely on any version up to 2.5.3 or use the `legacy_2.x` branch.
 
 ## Installation
 
@@ -53,7 +57,7 @@ Want to instrument other languages?  See our [Node.js], [Go], [Ruby] instrumenta
 
 <!-- Reference links -->
 [Instana]: https://www.instana.com/ "IBM Instana Observability"
-[Instana AutoTrace™️]: https://www.instana.com/supported-technologies/instana-autotrace/ "Instana AutoTrace"
+[Instana AutoTrace™️]: https://www.ibm.com/docs/en/instana-observability/current?topic=kubernetes-instana-autotrace-webhook "Instana AutoTrace"
 [configuration page]: https://www.ibm.com/docs/en/instana-observability/current?topic=package-python-configuration-configuring-instana#general "Instana Python package configuration"
 [PyPI]: https://pypi.python.org/pypi/instana "Instana package at PyPI"
 [installation document]: https://www.ibm.com/docs/en/instana-observability/current?topic=technologies-monitoring-python-instana-python-package#installing "Instana Python package installation"

pyproject.toml

@@ -13,7 +13,7 @@ requires-python = ">=3.8"
 license = "MIT"
 keywords = [
     "performance",
-    "opentracing",
+    "opentelemetry",
     "metrics",
     "monitoring",
     "tracing",
@@ -44,13 +44,14 @@ classifiers = [
 ]
 dependencies = [
     "autowrapt>=1.0",
-    "basictracer>=3.1.0",
     "fysom>=2.1.2",
-    "opentracing>=2.3.0",
     "protobuf<5.0.0",
     "requests>=2.6.0",
     "six>=1.12.0",
     "urllib3>=1.26.5",
+    "opentelemetry-api>=1.27.0",
+    "opentelemetry-semantic-conventions>=0.48b0",
+    "typing_extensions>=4.12.2",
 ]
 
 [project.entry-points."instana"]
@@ -59,6 +60,8 @@ string = "instana:load"
 [project.optional-dependencies]
 dev = [
   "pytest",
+  "pytest-cov",
+  "pytest-mock",
 ]
 
 [project.urls]
@@ -77,3 +80,12 @@ include = [
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/instana"]
+
+[tool.coverage.report]
+exclude_also = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "except ImportError:",
+    "except Exception:",
+    "except Exception as exc:",
+    ]

pytest.ini

@@ -3,3 +3,7 @@ log_cli = 1
 log_cli_level = WARN
 log_cli_format = %(asctime)s %(levelname)s %(message)s
 log_cli_date_format = %H:%M:%S
+pythonpath = src
+testpaths = 
+    tests
+    tests_aws