graphiti-core 0.22.0rc3__tar.gz → 0.22.0rc4__tar.gz

{graphiti_core-0.22.0rc3 → graphiti_core-0.22.0rc4}/CLAUDE.md

@@ -12,6 +12,7 @@ Key features:
 - Hybrid retrieval combining semantic embeddings, keyword search (BM25), and graph traversal
 - Support for custom entity definitions via Pydantic models
 - Integration with Neo4j and FalkorDB as graph storage backends
+- Optional OpenTelemetry distributed tracing support
 
 ## Development Commands
 

graphiti_core-0.22.0rc4/OTEL_TRACING.md

@@ -0,0 +1,58 @@
+# OpenTelemetry Tracing in Graphiti
+
+## Overview
+
+Graphiti supports OpenTelemetry distributed tracing through dependency injection. Tracing is optional - without a tracer, operations are no-op with zero overhead.
+
+## Installation
+
+To use tracing, install the OpenTelemetry SDK:
+
+```bash
+pip install opentelemetry-sdk
+```
+
+## Basic Usage
+
+```python
+from opentelemetry import trace
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import ConsoleSpanExporter, SimpleSpanProcessor
+
+# Set up OpenTelemetry
+provider = TracerProvider()
+processor = SimpleSpanProcessor(ConsoleSpanExporter())
+provider.add_span_processor(processor)
+trace.set_tracer_provider(provider)
+
+# Get a tracer
+tracer = trace.get_tracer(__name__)
+
+# Create Graphiti with tracing enabled
+from graphiti_core import Graphiti
+
+graphiti = Graphiti(
+    uri="bolt://localhost:7687",
+    user="neo4j",
+    password="password",
+    tracer=tracer,
+    trace_span_prefix="myapp.graphiti"  # Optional, defaults to "graphiti"
+)
+```
+
+## Configuration
+
+### Span Name Prefix
+
+You can configure the prefix for all span names:
+
+```python
+graphiti = Graphiti(
+    uri="bolt://localhost:7687",
+    user="neo4j",
+    password="password",
+    tracer=tracer,
+    trace_span_prefix="myapp.kg"
+)
+```
+

{graphiti_core-0.22.0rc3 → graphiti_core-0.22.0rc4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphiti-core
-Version: 0.22.0rc3
+Version: 0.22.0rc4
 Summary: A temporal graph building library
 Project-URL: Homepage, https://help.getzep.com/graphiti/graphiti/overview
 Project-URL: Repository, https://github.com/getzep/graphiti
@@ -34,6 +34,7 @@ Requires-Dist: langchain-openai>=0.2.6; extra == 'dev'
 Requires-Dist: langgraph>=0.2.15; extra == 'dev'
 Requires-Dist: langsmith>=0.1.108; extra == 'dev'
 Requires-Dist: opensearch-py>=3.0.0; extra == 'dev'
+Requires-Dist: opentelemetry-sdk>=1.20.0; extra == 'dev'
 Requires-Dist: pyright>=1.1.404; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
 Requires-Dist: pytest-xdist>=3.6.1; extra == 'dev'
@@ -59,6 +60,9 @@ Requires-Dist: langchain-aws>=0.2.29; extra == 'neptune'
 Requires-Dist: opensearch-py>=3.0.0; extra == 'neptune'
 Provides-Extra: sentence-transformers
 Requires-Dist: sentence-transformers>=3.2.1; extra == 'sentence-transformers'
+Provides-Extra: tracing
+Requires-Dist: opentelemetry-api>=1.20.0; extra == 'tracing'
+Requires-Dist: opentelemetry-sdk>=1.20.0; extra == 'tracing'
 Provides-Extra: voyageai
 Requires-Dist: voyageai>=0.2.3; extra == 'voyageai'
 Description-Content-Type: text/markdown