feat: Qdrant instrumentation (#278)

Co-authored-by: Nir Gazit <nirga@users.noreply.github.com>

Author: Anush008

.github/dependabot.yml

@@ -46,6 +46,12 @@ updates:
       interval: "weekly"
     labels:
       - "instrumentation-pinecone"
+  - package-ecosystem: "npm"
+    directory: "/packages/instrumentation-qdrant"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "instrumentation-qdrant"
   - package-ecosystem: "npm"
     directory: "/packages/instrumentation-vertexai"
     schedule:

.github/workflows/ci.yml

@@ -28,6 +28,11 @@ jobs:
   build-and-test:
     name: Build and test
     runs-on: ubuntu-latest
+    services:
+      qdrant:
+        image: qdrant/qdrant
+        ports:
+          - 6333:6333
     permissions:
       contents: "read"
       id-token: "write"

.python-version

@@ -0,0 +1 @@
+3.10.13

README.md

@@ -119,6 +119,7 @@ OpenLLMetry-JS can instrument everything that [OpenTelemetry already instruments
 
 - ✅ Pinecone
 - ✅ Chroma
+- ✅ Qdrant
 - ⏳ Weaviate
 - ⏳ Milvus
 

package-lock.json

@@ -38,6 +38,14 @@ export const SpanAttributes = {
   // Vector DB
   VECTOR_DB_VENDOR: "db.system",
   VECTOR_DB_QUERY_TOP_K: "db.vector.query.top_k",
+  VECTOR_DB_TABLE_NAME: "db.vector.table_name",
+  VECTOR_DB_ADD_COUNT: "db.vector.add.count",
+  VECTOR_DB_DELETE_SELECTOR: "db.vector.delete.selector",
+  VECTOR_DB_DELETE_COUNT: "db.vector.delete.count",
+  VECTOR_DB_GET_SELECTOR: "db.vector.get.selector",
+  VECTOR_DB_GET_COUNT: "db.vector.get.count",
+  VECTOR_DB_GET_INCLUDE_METADATA: "db.vector.get.include_metadata",
+  VECTOR_DB_GET_INCLUDE_VALUES: "db.vector.get.include_values",
 
   // LLM Workflows
   TRACELOOP_SPAN_KIND: "traceloop.span.kind",

packages/ai-semantic-conventions/src/SemanticAttributes.ts

@@ -0,0 +1 @@
+node_modules

packages/instrumentation-qdrant/.eslintignore

@@ -0,0 +1,18 @@
+{
+  "extends": ["../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    }
+  ]
+}

packages/instrumentation-qdrant/.eslintrc.json

@@ -0,0 +1,2 @@
+/dist
+/coverage

packages/instrumentation-qdrant/.prettierignore

@@ -0,0 +1,53 @@
+# OpenTelemetry Qdrant instrumentation for Node.js
+
+[![NPM Published Version][npm-img]][npm-url]
+[![Apache License][license-image]][license-image]
+
+This module provides automatic instrumentation for [`@qdrant/js-client-rest`](https://www.npmjs.com/package/@qdrant/js-client-rest) module, which may be loaded using the [`@opentelemetry/sdk-trace-node`](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-sdk-trace-node) package and is included in the [`@traceloop/node-server-sdk`](https://www.npmjs.com/package/@traceloop/node-server-sdk) bundle.
+
+If total installation size is not constrained, it is recommended to use the [`@traceloop/node-server-sdk`](https://www.npmjs.com/package/@traceloop/node-server-sdk) bundle for the most seamless instrumentation experience.
+
+Compatible with OpenTelemetry JS API and SDK `1.0+`.
+
+## Installation
+
+```bash
+npm install --save @traceloop/instrumentation-qdrant
+```
+
+## Supported Versions
+
+- `>=1.9.0`
+
+## Usage
+
+To load a specific plugin, specify it in the registerInstrumentations's configuration:
+
+```js
+const { NodeTracerProvider } = require("@opentelemetry/sdk-trace-node");
+const { QdrantInstrumentation } = require("@traceloop/instrumentation-qdrant");
+const { registerInstrumentations } = require("@opentelemetry/instrumentation");
+
+const provider = new NodeTracerProvider();
+provider.register();
+
+registerInstrumentations({
+  instrumentations: [new QdrantInstrumentation()],
+});
+```
+
+## Useful links
+
+- For more information on OpenTelemetry, visit: <https://opentelemetry.io/>
+- For more about OpenTelemetry JavaScript: <https://github.com/open-telemetry/opentelemetry-js>
+- For help or feedback on this project, join us on [Slack][slack-url]
+
+## License
+
+Apache 2.0 - See [LICENSE][license-url] for more information.
+
+[slack-url]: https://traceloop.com/slack
+[license-url]: https://github.com/traceloop/openllmetry-js/blob/main/LICENSE
+[license-image]: https://img.shields.io/badge/license-Apache_2.0-green.svg?style=flat
+[npm-url]: https://www.npmjs.com/package/@traceloop/instrumentation-qdrant
+[npm-img]: https://badge.fury.io/js/%40traceloop%2Finstrumentation-qdrant.svg