gl-observability-binary 0.1.0__cp311-cp311-win_amd64.whl → 0.1.2__cp311-cp311-win_amd64.whl

gl_observability/initializer.pyi

@@ -15,8 +15,9 @@ class TelemetryConfig:
     use_langchain: Incomplete
     use_httpx: Incomplete
     use_requests: Incomplete
+    log_trace_context: Incomplete
     backend_config: Incomplete
-    def __init__(self, *, attributes: dict[str, str] | None = None, trace_sampler: Sampler | None = None, fastapi_config: FastAPIConfig | None = None, use_langchain: bool = False, use_httpx: bool = True, use_requests: bool = True, backend_config: OpenTelemetryBackendConfig | SentryBackendConfig | None = None) -> None:
+    def __init__(self, *, attributes: dict[str, str] | None = None, trace_sampler: Sampler | None = None, fastapi_config: FastAPIConfig | None = None, use_langchain: bool = False, use_httpx: bool = True, use_requests: bool = True, log_trace_context: bool = True, backend_config: OpenTelemetryBackendConfig | SentryBackendConfig | None = None) -> None:
         """Initialize the telemetry configuration.
 
         Args:
@@ -27,6 +28,8 @@ class TelemetryConfig:
             use_langchain (bool, optional): Enable Langchain instrumentation. Defaults to False.
             use_httpx (bool, optional): Enable HTTPX instrumentation. Defaults to True.
             use_requests (bool, optional): Enable Requests instrumentation. Defaults to True.
+            log_trace_context (bool, optional): Add trace context to logs. You have to set the formatter to
+                include the trace context. Defaults to True.
             backend_config (OpenTelemetryBackendConfig | SentryBackendConfig | None, optional): The telemetry
                 backend configuration. Defaults to None. Make sure to set at least one backend configuration,
                 if not traces will not be exported.

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/traces/config.pyi

@@ -22,7 +22,8 @@ class OpenTelemetryTraceConfig:
     use_langchain: Incomplete
     use_httpx: Incomplete
     use_requests: Incomplete
-    def __init__(self, *, attributes: dict[str, str], trace_sampler: Sampler | None, fastapi_config: FastAPIConfig | None, use_langchain: bool, use_httpx: bool, use_requests: bool) -> None:
+    log_trace_context: Incomplete
+    def __init__(self, *, attributes: dict[str, str], trace_sampler: Sampler | None, fastapi_config: FastAPIConfig | None, use_langchain: bool, use_httpx: bool, use_requests: bool, log_trace_context: bool) -> None:
         """Initialize OpenTelemetry configuration.
 
         Args:
@@ -32,6 +33,7 @@ class OpenTelemetryTraceConfig:
             use_langchain (bool): Enable Langchain instrumentation.
             use_httpx (bool): Enable HTTPX instrumentation.
             use_requests (bool): Enable Requests instrumentation.
+            log_trace_context (bool): Add trace context to logs.
         """
 
 def setup_tracer_provider(opentelemetry_config: OpenTelemetryTraceConfig):

gl_observability.pyi

@@ -38,6 +38,7 @@ import opentelemetry.instrumentation
 import opentelemetry.instrumentation.fastapi
 import opentelemetry.instrumentation.httpx
 import opentelemetry.instrumentation.langchain
+import opentelemetry.instrumentation.logging
 import opentelemetry.instrumentation.requests
 import opentelemetry.sdk.resources
 import importlib

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: gl-observability-binary
-Version: 0.1.0
+Version: 0.1.2
 Summary: SDK for Observability tools
 Author-email: HansSeanNathanael <hans.s.nathanael@gdplabs.id>
 Requires-Python: <3.14,>=3.11
@@ -18,6 +18,7 @@ Requires-Dist: opentelemetry-instrumentation-fastapi
 Requires-Dist: opentelemetry-instrumentation-langchain
 Requires-Dist: opentelemetry-instrumentation-requests
 Requires-Dist: opentelemetry-instrumentation-httpx
+Requires-Dist: opentelemetry-instrumentation-logging
 Provides-Extra: dev
 Requires-Dist: pytest<9.0.0,>=8.3.4; extra == "dev"
 Requires-Dist: pre-commit<4.0.0,>=3.7.0; extra == "dev"
@@ -34,7 +35,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 +85,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 +125,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.2.dist-info}/RECORD

@@ -1,20 +1,20 @@
-gl_observability.cp311-win_amd64.pyd,sha256=JEpUOre6UBjt9Fuv9MYykQtUa3UrqhIqTImmrJ-Jpv4,656896
-gl_observability.pyi,sha256=zLWMUAsSLQclPGwJIhjJpDo_yw3gjUE3RmEB0e2JDUQ,1671
+gl_observability.cp311-win_amd64.pyd,sha256=uOpa2JXzpTDXy-R0mFY6C7CyWgZ4qcMSsEmwM0-maiM,660480
+gl_observability.pyi,sha256=qtuD7uFNK7X5LdTcoxlAY0XiubUVccp8sc-z7q0TQTo,1716
 gl_observability/__init__.pyi,sha256=YvrsoNmib8ulmQtWz9yxKyHDWnsTxzLWXOiI5C-BqmM,518
-gl_observability/initializer.pyi,sha256=T8_r7zuT8zrVofPemaS-9TEliOy0iqR-hAgq6sPGN6I,3524
+gl_observability/initializer.pyi,sha256=ODCDy0e1N6PySqL9-UnZhBvVqb1kKiIU2YU-Cetnr2k,3762
 gl_observability/logs/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gl_observability/logs/ner_pii_logger_handler.pyi,sha256=KkX_78DsEJVFqdgcrrV-sosUmIR14gKJD6JEp16YOLU,1573
 gl_observability/logs/regex_pii_logger_handler.pyi,sha256=mN9pAOn8t3GrEjM7hldAn2HZLV8m3Ja2wY5vwWDWdAI,2538
 gl_observability/traces/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gl_observability/traces/config.pyi,sha256=E-U-Sda2CL4VKXQPTkGdwLSB230jusIHHbFKW8hC98I,1982
+gl_observability/traces/config.pyi,sha256=GGaRNV3keMRiWYzvgUHGJEv3yeVkN-KcVKQ6AOUbaUY,2108
 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=l2aKBREYfqJ7T2ljmr6hUiXPoNvvXF47bG4IHjuSyS4,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.2.dist-info/METADATA,sha256=n3leUPQyFERh3p5yUq-DJgjt9AdJCGijVvHOSAbIPWY,8313
+gl_observability_binary-0.1.2.dist-info/WHEEL,sha256=l2aKBREYfqJ7T2ljmr6hUiXPoNvvXF47bG4IHjuSyS4,96
+gl_observability_binary-0.1.2.dist-info/top_level.txt,sha256=qX0-e4NxRAAXXjWIZ7gvIspQP7J_dgxPQ7e3-WEbIeQ,17
+gl_observability_binary-0.1.2.dist-info/RECORD,,