New package: unhandled Exceptions logging instrumentation

.changelog/4503.added

@@ -0,0 +1 @@
+`opentelemetry-instrumentation-exceptions`: add instrumentation to emit OpenTelemetry logs for uncaught process, thread, and asyncio exceptions.

.github/component_owners.yml

@@ -12,6 +12,9 @@ components:
   instrumentation/opentelemetry-instrumentation-asyncio:
     - bourbonkk
 
+  instrumentation/opentelemetry-instrumentation-exceptions:
+    - iblancasa
+
   instrumentation/opentelemetry-instrumentation-botocore:
     - lukeina2z
     - yiyuan-he

.github/workflows/core_contrib_test.yml

@@ -1857,6 +1857,36 @@ jobs:
       - name: Run tests
         run: tox -e py310-test-instrumentation-logging -- -ra
 
+  py310-test-instrumentation-exceptions:
+    name: instrumentation-exceptions 
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout contrib repo @ SHA - ${{ env.CONTRIB_REPO_SHA }}
+        uses: actions/checkout@v4
+        with:
+          repository: open-telemetry/opentelemetry-python-contrib
+          ref: ${{ env.CONTRIB_REPO_SHA }}
+
+      - name: Checkout core repo @ SHA - ${{ env.CORE_REPO_SHA }}
+        uses: actions/checkout@v4
+        with:
+          repository: open-telemetry/opentelemetry-python
+          ref: ${{ env.CORE_REPO_SHA }}
+          path: opentelemetry-python
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+          architecture: "x64"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py310-test-instrumentation-exceptions -- -ra
+
   py310-test-exporter-richconsole:
     name: exporter-richconsole 
     runs-on: ubuntu-latest

.github/workflows/lint.yml

@@ -613,6 +613,25 @@ jobs:
       - name: Run tests
         run: tox -e lint-instrumentation-logging
 
+  lint-instrumentation-exceptions:
+    name: instrumentation-exceptions
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.14
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e lint-instrumentation-exceptions
+
   lint-exporter-richconsole:
     name: exporter-richconsole
     runs-on: ubuntu-latest

.github/workflows/test.yml

@@ -6275,6 +6275,120 @@ jobs:
       - name: Run tests
         run: tox -e pypy3-test-instrumentation-logging -- -ra
 
+  py310-test-instrumentation-exceptions_ubuntu-latest:
+    name: instrumentation-exceptions 3.10 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py310-test-instrumentation-exceptions -- -ra
+
+  py311-test-instrumentation-exceptions_ubuntu-latest:
+    name: instrumentation-exceptions 3.11 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py311-test-instrumentation-exceptions -- -ra
+
+  py312-test-instrumentation-exceptions_ubuntu-latest:
+    name: instrumentation-exceptions 3.12 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py312-test-instrumentation-exceptions -- -ra
+
+  py313-test-instrumentation-exceptions_ubuntu-latest:
+    name: instrumentation-exceptions 3.13 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py313-test-instrumentation-exceptions -- -ra
+
+  py314-test-instrumentation-exceptions_ubuntu-latest:
+    name: instrumentation-exceptions 3.14 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.14
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py314-test-instrumentation-exceptions -- -ra
+
+  pypy3-test-instrumentation-exceptions_ubuntu-latest:
+    name: instrumentation-exceptions pypy-3.10 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python pypy-3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "pypy-3.10"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e pypy3-test-instrumentation-exceptions -- -ra
+
   py310-test-exporter-richconsole_ubuntu-latest:
     name: exporter-richconsole 3.10 Ubuntu
     runs-on: ubuntu-latest

docs/instrumentation/exceptions/exceptions.rst

@@ -0,0 +1,7 @@
+OpenTelemetry Exceptions Instrumentation
+========================================
+
+.. automodule:: opentelemetry.instrumentation.exceptions
+    :members:
+    :undoc-members:
+    :show-inheritance:

instrumentation/README.md

@@ -20,6 +20,7 @@
 | [opentelemetry-instrumentation-dbapi](./opentelemetry-instrumentation-dbapi) | dbapi | No | migration
 | [opentelemetry-instrumentation-django](./opentelemetry-instrumentation-django) | django >= 2.0 | Yes | development
 | [opentelemetry-instrumentation-elasticsearch](./opentelemetry-instrumentation-elasticsearch) | elasticsearch >= 6.0 | No | development
+| [opentelemetry-instrumentation-exceptions](./opentelemetry-instrumentation-exceptions) | exceptions | No | development
 | [opentelemetry-instrumentation-falcon](./opentelemetry-instrumentation-falcon) | falcon >= 1.4.1, < 5.0.0 | Yes | migration
 | [opentelemetry-instrumentation-fastapi](./opentelemetry-instrumentation-fastapi) | fastapi ~= 0.92 | Yes | migration
 | [opentelemetry-instrumentation-flask](./opentelemetry-instrumentation-flask) | flask >= 1.0 | Yes | migration