Quotient extends the OpenInference semantic conventions with attributes tailored to vector database operations. Instrumentors for Chroma, Pinecone, and Qdrant automatically populate these attributes when you add them during tracer initialization.

​
Quick Start

vector_db_tracing.py
from quotientai import QuotientAI, ChromaInstrumentor, PineconeInstrumentor, QdrantInstrumentor

quotient = QuotientAI()

quotient.tracer.init(
    app_name="retrieval-app",
    environment="production",
    instruments=[
        ChromaInstrumentor(),
        PineconeInstrumentor(),
        QdrantInstrumentor(),
    ],
)

​
Common Attributes

AttributeTypeDescriptionExample
db.system.namestringVector database system name"chroma", "pinecone", "qdrant"
db.operationstringOperation executed"query", "add", "upsert", "delete"
db.collection.namestringCollection or index name"user_profiles"
db.operation.statusstringOperation status"completed", "error"
db.ids_countintNumber of IDs processed150
db.vector_countintNumber of vectors processed320
db.n_resultsintResults returned15
db.query.retrieved_documentsstringJSON string of retrieved documents[{"id": "doc1", "score": 0.95}]

​
Database-Specific Attributes

​
Chroma

  • db.documents_count: Number of documents processed.
  • db.metadatas_count: Number of metadata entries.
  • db.filter: Applied filters (JSON string).
  • db.where_document: Document filter conditions.

​
Pinecone

  • db.index.name: Index name.
  • db.index.dimension: Index dimension.
  • db.create_index.metric: Distance metric used.
  • db.create_index.spec: Index specifications.
  • db.query.namespace: Query namespace.
  • db.delete_all: Whether all records are deleted.
  • db.update.id: ID being updated.
  • db.update.metadata: Metadata being updated.

​
Qdrant

  • db.collection.dimension: Collection dimension.
  • db.limit: Query limit.
  • db.offset: Query offset.
  • db.filter: Applied filters (JSON string).
  • db.operation.id: Operation ID for async operations.

​
Document Format

The db.query.retrieved_documents attribute contains a JSON string with entries shaped like: 
[
  {
    "document.id": "doc123",
    "document.score": 0.95,
    "document.content": "document text content",
    "document.metadata": "{\"source\": \"web\", \"category\": \"tech\"}"
  }
]

​
Error Handling

Instrumentors are defensive:
  • If the underlying client library is missing, the instrumentor logs a warning and skips instrumentation.
  • Failures while tracing default to no-op so your database call still succeeds.
  • Errors during span creation are captured in the logs for later debugging.
Next: Retrieve Traces