Add Valkey Instrumentation

.changelog/3478.added

@@ -0,0 +1 @@
+`opentelemetry-instrumentation-valkey`: new instrumentation for Valkey, with a shared `opentelemetry-instrumentation-redis-valkey-base` package extracting common tracing logic for Redis and Valkey

.github/component_owners.yml

@@ -16,6 +16,12 @@ components:
     - lukeina2z
     - yiyuan-he
 
+  instrumentation/opentelemetry-instrumentation-redis-valkey-base:
+    - sightseeker
+
+  instrumentation/opentelemetry-instrumentation-valkey:
+    - sightseeker
+
   instrumentation/opentelemetry-instrumentation-pymssql:
     - guillaumep
 

.github/workflows/core_contrib_test.yml

@@ -3657,6 +3657,36 @@ jobs:
       - name: Run tests
         run: tox -e py310-test-processor-baggage -- -ra
 
+  py310-test-instrumentation-valkey:
+    name: instrumentation-valkey 
+    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-valkey -- -ra
+
   py310-test-opamp-client-latest:
     name: opamp-client-latest 
     runs-on: ubuntu-latest

.github/workflows/lint.yml

@@ -1335,6 +1335,25 @@ jobs:
       - name: Run tests
         run: tox -e lint-processor-baggage
 
+  lint-instrumentation-valkey:
+    name: instrumentation-valkey
+    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-valkey
+
   lint-opamp-client:
     name: opamp-client
     runs-on: ubuntu-latest

.github/workflows/test.yml

@@ -12545,6 +12545,120 @@ jobs:
       - name: Run tests
         run: tox -e pypy3-test-processor-baggage -- -ra
 
+  py310-test-instrumentation-valkey_ubuntu-latest:
+    name: instrumentation-valkey 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-valkey -- -ra
+
+  py311-test-instrumentation-valkey_ubuntu-latest:
+    name: instrumentation-valkey 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-valkey -- -ra
+
+  py312-test-instrumentation-valkey_ubuntu-latest:
+    name: instrumentation-valkey 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-valkey -- -ra
+
+  py313-test-instrumentation-valkey_ubuntu-latest:
+    name: instrumentation-valkey 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-valkey -- -ra
+
+  py314-test-instrumentation-valkey_ubuntu-latest:
+    name: instrumentation-valkey 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-valkey -- -ra
+
+  pypy3-test-instrumentation-valkey_ubuntu-latest:
+    name: instrumentation-valkey 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-valkey -- -ra
+
   py310-test-opamp-client-latest_ubuntu-latest:
     name: opamp-client-latest 3.10 Ubuntu
     runs-on: ubuntu-latest

instrumentation/README.md

@@ -39,6 +39,7 @@
 | [opentelemetry-instrumentation-pymysql](./opentelemetry-instrumentation-pymysql) | PyMySQL < 2 | No | migration
 | [opentelemetry-instrumentation-pyramid](./opentelemetry-instrumentation-pyramid) | pyramid >= 1.7 | Yes | migration
 | [opentelemetry-instrumentation-redis](./opentelemetry-instrumentation-redis) | redis >= 2.6 | No | migration
+| [opentelemetry-instrumentation-redis-valkey-base](./opentelemetry-instrumentation-redis-valkey-base) | _redis_valkey | No | development
 | [opentelemetry-instrumentation-remoulade](./opentelemetry-instrumentation-remoulade) | remoulade >= 0.50 | No | development
 | [opentelemetry-instrumentation-requests](./opentelemetry-instrumentation-requests) | requests ~= 2.0 | Yes | migration
 | [opentelemetry-instrumentation-sqlalchemy](./opentelemetry-instrumentation-sqlalchemy) | sqlalchemy >= 1.0.0, < 2.1.0 | Yes | migration
@@ -50,4 +51,5 @@
 | [opentelemetry-instrumentation-tortoiseorm](./opentelemetry-instrumentation-tortoiseorm) | tortoise-orm >= 0.17.0 | No | development
 | [opentelemetry-instrumentation-urllib](./opentelemetry-instrumentation-urllib) | urllib | Yes | migration
 | [opentelemetry-instrumentation-urllib3](./opentelemetry-instrumentation-urllib3) | urllib3 >= 1.0.0, < 3.0.0 | Yes | migration
+| [opentelemetry-instrumentation-valkey](./opentelemetry-instrumentation-valkey) | valkey >= 6.0.0 | No | development
 | [opentelemetry-instrumentation-wsgi](./opentelemetry-instrumentation-wsgi) | wsgi | Yes | migration