gl-observability-binary 0.1.0__cp312-cp312-win_amd64.whl → 0.1.1__cp312-cp312-win_amd64.whl

gl_observability/traces/backend/opentelemetry.pyi

@@ -18,13 +18,13 @@ class OpenTelemetryBackendConfig:
             **kwargs: Additional keyword arguments passed to OTLPSpanExporter.
         '''
 
-def init_otel_with_external_exporter(tracer_provider: TracerProvider, config: OpenTelemetryBackendConfig) -> None:
+def init_otel_with_external_exporter(config: OpenTelemetryBackendConfig, tracer_provider: TracerProvider) -> None:
     """Initialize OpenTelemetry with an external OTLP exporter.
 
     This method initializes OpenTelemetry with an external exporter (OTLP)
     and instruments FastAPI, Langchain, HTTPX, and Requests if configured.
 
     Args:
-        tracer_provider (TracerProvider): The tracer provider to use.
         config (OpenTelemetryBackendConfig): The OTLP exporter configuration.
+        tracer_provider (TracerProvider): The tracer provider to use.
     """

{gl_observability_binary-0.1.0.dist-info → gl_observability_binary-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: gl-observability-binary
-Version: 0.1.0
+Version: 0.1.1
 Summary: SDK for Observability tools
 Author-email: HansSeanNathanael <hans.s.nathanael@gdplabs.id>
 Requires-Python: <3.14,>=3.11
@@ -34,7 +34,7 @@ Requires-Dist: ruff<1.0.0,>=0.11.12; extra == "dev"
 
 ## Key Features
 
-- 📊 **OpenTelemetry Integration**: simplified initialization for tracing and metrics.
+- 📊 **OpenTelemetry Integration**: simplified initialization for tracing.
 - 🛡️ **Sentry Support**: easy setup for error tracking and performance monitoring.
 - 🕵️ **PII Redaction**: custom logging handlers to redact PII using Regex or NER (Named Entity Recognition).
 - 🔌 **Framework Support**: built-in support for FastAPI, Langchain, HTTPX, and Requests instrumentation.
@@ -84,34 +84,39 @@ poetry add "git+ssh://git@github.com/GDP-ADMIN/gl-sdk.git#subdirectory=libs/gl-o
 
 ### 1. Telemetry Initialization
 
-The library uses a unified `init_telemetry` function that takes a `TelemetryConfig` object. You can configure it for OpenTelemetry, Sentry, or both.
+The library uses a unified `init_telemetry` function that takes a `TelemetryConfig` object. You can configure it to send traces to OpenTelemetry (OTLP) or Sentry backend. Multiple backend configuration is supported.
 
-#### OpenTelemetry Configuration (External Exporter)
+#### OpenTelemetry Configuration
 
 This setup sends traces to an external OTLP collector (e.g., Jaeger, Tempo).
 
 ```python
 from fastapi import FastAPI
-from gl_observability.traces.opentelemetry import FastAPIConfig, OpenTelemetryConfig
-from gl_observability import TelemetryConfig, init_telemetry
+from gl_observability import init_telemetry, TelemetryConfig, OpenTelemetryBackendConfig, FastAPIConfig
 
 # 1. Setup FastAPI Config (optional, if using FastAPI)
 app = FastAPI()
 fastapi_config = FastAPIConfig(app=app)
 
-# 2. Configure OpenTelemetry
-otel_config = OpenTelemetryConfig(
-    endpoint="localhost:4317",  # OTLP endpoint
-    use_grpc=False,             # Use gRPC or HTTP
-    fastapi_config=fastapi_config,
-    use_langchain=True,         # Enable Langchain instrumentation
-    use_httpx=True,             # Enable HTTPX instrumentation
-    use_requests=True,          # Enable Requests instrumentation
-    attributes={"service.name": "my-service", "env": "production"}
+# 2. Configure OpenTelemetryBackendConfig
+otel_backend_config = OpenTelemetryBackendConfig(
+    endpoint="localhost:4318",                  # OTLP endpoint
+    use_grpc=False,                             # Use gRPC or HTTP
+    headers={"Authorization": "Bearer ..."},    # Optional headers
 )
 
-# 3. Initialize Telemetry
-init_telemetry(TelemetryConfig(otel_config=otel_config))
+# 3. Configure TelemetryConfig
+otel_config = TelemetryConfig(
+    attributes={"service.name": "..."},         # Resource attributes
+    backend_config=otel_backend_config,         # Backend configuration
+    fastapi_config=fastapi_config,              # FastAPI Instrumentation
+    use_langchain=True,                         # Enable Langchain instrumentation
+    use_httpx=True,                             # Enable HTTPX instrumentation
+    use_requests=True,                          # Enable Requests instrumentation
+)
+
+# 4. Initialize Telemetry
+init_telemetry(otel_config)
 ```
 
 #### Sentry Configuration
@@ -119,55 +124,69 @@ init_telemetry(TelemetryConfig(otel_config=otel_config))
 This setup sends errors and traces to Sentry.
 
 ```python
-from gl_observability.traces.sentry import SentryConfig
-from gl_observability import TelemetryConfig, init_telemetry
-
-def traces_sampler(sampling_context: dict) -> float:
-    """Custom trace sampler."""
-    return 1.0
-
-# 1. Configure Sentry
-sentry_config = SentryConfig(
-    dsn="your-sentry-dsn",
-    environment="production",
-    release="1.0.0",
-    traces_sampler=traces_sampler,
-    send_default_pii=True
+from fastapi import FastAPI
+from gl_observability import init_telemetry, TelemetryConfig, SentryBackendConfig, FastAPIConfig
+
+# 1. Setup FastAPI Config (optional, if using FastAPI)
+app = FastAPI()
+fastapi_config = FastAPIConfig(app=app)
+
+# 2. Configure SentryBackendConfig
+sentry_backend_config = SentryBackendConfig(
+    dsn="https://...",
+    environment="...",
+    release="...",
+    send_default_pii=True,
+    disable_sentry_distributed_tracing=False
 )
 
-# 2. Initialize Telemetry
-init_telemetry(TelemetryConfig(sentry_config=sentry_config))
+# 3. Configure TelemetryConfig
+otel_config = TelemetryConfig(
+    attributes={"service.name": "..."},         # Resource attributes
+    backend_config=sentry_backend_config,       # Backend configuration
+    fastapi_config=fastapi_config,              # FastAPI Instrumentation
+    use_langchain=True,                         # Enable Langchain instrumentation
+    use_httpx=True,                             # Enable HTTPX instrumentation
+    use_requests=True,                          # Enable Requests instrumentation
+)
+
+# 4. Initialize Telemetry
+init_telemetry(otel_config)
 ```
 
-#### Sentry with OpenTelemetry
+#### Multiple Backend Configuration
 
-This setup combines Sentry with OpenTelemetry instrumentation, allowing Sentry to capture OTel spans.
+This setup the OpenTelemetry SDK used for tracing.
 
 ```python
 from fastapi import FastAPI
-from gl_observability.traces.opentelemetry import FastAPIConfig, OpenTelemetryConfig
-from gl_observability.traces.sentry import SentryConfig
-from gl_observability import TelemetryConfig, init_telemetry
-
-app = FastAPI()
-fastapi_config = FastAPIConfig(app=app)
-
-# 1. Configure OpenTelemetry (without endpoint, as Sentry handles export)
-otel_config = OpenTelemetryConfig(
-    attributes={"service.name": "my-service"},
-    fastapi_config=fastapi_config,
-    use_langchain=True
+from gl_observability import init_telemetry, TelemetryConfig, OpenTelemetryBackendConfig, SentryBackendConfig
+
+jaeger_backend = OpenTelemetryBackendConfig(endpoint="jager...", ...)
+init_telemetry(
+    TelemetryConfig(
+        attributes={"service.name": "..."},
+        backend_config=jaeger_backend,
+        fastapi_config=fastapi_config,
+        use_langchain=True,
+        use_httpx=True,
+        use_requests=True,
+    )
 )
 
-# 2. Configure Sentry with OTel config
-sentry_config = SentryConfig(
-    dsn="your-sentry-dsn",
-    environment="production",
-    open_telemetry_config=otel_config
+langfuse_backend = OpenTelemetryBackendConfig(endpoint="langfuse...", ...)
+init_telemetry(
+    TelemetryConfig(
+        backend_config=langfuse_backend
+    )
 )
 
-# 3. Initialize Telemetry
-init_telemetry(TelemetryConfig(sentry_config=sentry_config))
+sentry_backend = SentryBackendConfig(dsn="https://...", ...)
+init_telemetry(
+    TelemetryConfig(
+        backend_config=sentry_backend
+    )
+)
 ```
 
 ### 2. Logging Handlers

{gl_observability_binary-0.1.0.dist-info → gl_observability_binary-0.1.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-gl_observability.cp312-win_amd64.pyd,sha256=f9aApaLgH2KzPHB2LHevOKo0aGrwak3Yz1WtGvg73So,649728
+gl_observability.cp312-win_amd64.pyd,sha256=QWLdX_t-OGG7CW9bFyZuuTZViFXjlyshnHudLW_Xz8E,649728
 gl_observability.pyi,sha256=zLWMUAsSLQclPGwJIhjJpDo_yw3gjUE3RmEB0e2JDUQ,1671
 gl_observability/__init__.pyi,sha256=YvrsoNmib8ulmQtWz9yxKyHDWnsTxzLWXOiI5C-BqmM,518
 gl_observability/initializer.pyi,sha256=T8_r7zuT8zrVofPemaS-9TEliOy0iqR-hAgq6sPGN6I,3524
@@ -8,13 +8,13 @@ gl_observability/logs/regex_pii_logger_handler.pyi,sha256=mN9pAOn8t3GrEjM7hldAn2
 gl_observability/traces/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gl_observability/traces/config.pyi,sha256=E-U-Sda2CL4VKXQPTkGdwLSB230jusIHHbFKW8hC98I,1982
 gl_observability/traces/backend/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gl_observability/traces/backend/opentelemetry.pyi,sha256=VaQPBEHHhLT4elEcjll0DgQTIb9RW5BSWqEI8It3cdo,1460
+gl_observability/traces/backend/opentelemetry.pyi,sha256=jXsw3ZG2PnT0VWuC23yjQHaPMit3mF8m-C8LFeEBruo,1460
 gl_observability/traces/backend/sentry.pyi,sha256=dVrmxAc5F7vZym3NQ6G7gCynuwa_TkstodEkFSvdhbs,2049
 gl_observability/traces/instrument/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gl_observability/traces/instrument/functions.pyi,sha256=Hd2CmrBF4qxjb_LEUf5jgljVJ1DKy7XiQXJzvpYTl5w,4293
 gl_observability/traces/instrument/http.pyi,sha256=F86Nscqe9GxNdEduPJepzzjg3EeLZL-zRMUSj7tPxRg,2033
 gl_observability.build/.gitignore,sha256=aEiIwOuxfzdCmLZe4oB1JsBmCUxwG8x-u-HBCV9JT8E,1
-gl_observability_binary-0.1.0.dist-info/METADATA,sha256=l-feSdIDQ99lCJ-qXF6jmekmDswcojtMmNa-4n3zagc,7429
-gl_observability_binary-0.1.0.dist-info/WHEEL,sha256=x5rgv--I0NI0IT1Lh9tN1VG2cI637p3deednwYLKnxc,96
-gl_observability_binary-0.1.0.dist-info/top_level.txt,sha256=qX0-e4NxRAAXXjWIZ7gvIspQP7J_dgxPQ7e3-WEbIeQ,17
-gl_observability_binary-0.1.0.dist-info/RECORD,,
+gl_observability_binary-0.1.1.dist-info/METADATA,sha256=wWLm2SHd2xY9o1ae3TP2RWO-rh8H2yQXJJwE7P2rVMg,8259
+gl_observability_binary-0.1.1.dist-info/WHEEL,sha256=x5rgv--I0NI0IT1Lh9tN1VG2cI637p3deednwYLKnxc,96
+gl_observability_binary-0.1.1.dist-info/top_level.txt,sha256=qX0-e4NxRAAXXjWIZ7gvIspQP7J_dgxPQ7e3-WEbIeQ,17
+gl_observability_binary-0.1.1.dist-info/RECORD,,