021-python-observability 0.3.0__tar.gz → 0.4.0__tar.gz

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.4.0](https://github.com/from021-io/python-observability/compare/v0.3.2...v0.4.0) (2026-10-29)
+
+
+### Features
+
+* **logging:** log service and instrumentation versions ([#18](https://github.com/from021-io/python-observability/issues/18)) ([0ec6e90](https://github.com/from021-io/python-observability/commit/0ec6e90fa0806d92b4f19d0c699cdb7faca36b4e))
+
+## [0.3.2](https://github.com/from021-io/python-observability/compare/v0.3.1...v0.3.2) (2026-10-25)
+
+
+### Bug fixes
+
+* **telemetry:** actualiza dependencias y aísla credenciales OTLP ([#16](https://github.com/from021-io/python-observability/issues/16)) ([c383af9](https://github.com/from021-io/python-observability/commit/c383af9e5e50c9eec9fb4093d168b0f05dd73df2))
+
+## [0.3.1](https://github.com/from021-io/python-observability/compare/v0.3.0...v0.3.1) (2026-10-21)
+
+
+### Build
+
+* point the project URLs at from021-io/python-observability ([#14](https://github.com/from021-io/python-observability/issues/14)) ([851054e](https://github.com/from021-io/python-observability/commit/851054e5845b29e3a0de23b0eab775e7e1920c0e))
+
 ## [0.3.0](https://github.com/from021-io/observability-python/compare/v0.2.0...v0.3.0) (2026-10-21)
 
 

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/CONTRACT.md

@@ -72,6 +72,15 @@ Logs stay in Vercel; internal agent traces and LLM token/cost instrumentation re
 
 ## Safe log diagnostics
 
+At application lifespan startup, `observability.started` logs `service_name`, `environment`,
+`service_version` and `observability_version` at INFO. `service_version` reflects the
+consumer's configured version (or `unknown`), while `observability_version` is the installed
+instrumentation version. This event is filtered when the configured log level exceeds INFO.
+Every log through the configured JSON formatter includes both version fields. HTTP request
+context selects that app's service version; without request context the process-wide formatter
+uses the most recently configured app. Independent handlers and logs before setup are outside
+this contract.
+
 Domain correlation in logs accepts only UUID objects/strings for `brain_id`, `job_id`,
 `file_id`, `file_version_id`, `entity_id`, `event_id` and `correlation_id`. Values are
 normalized into JSON and `message`; invalid values are dropped. The metric attribute

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.5
 Name: 021-python-observability
-Version: 0.3.0
+Version: 0.4.0
 Summary: OpenTelemetry metrics, traces and safe JSON logs for FastAPI services
-Project-URL: Repository, https://github.com/from021-io/observability-python
-Project-URL: Changelog, https://github.com/from021-io/observability-python/blob/main/CHANGELOG.md
-Project-URL: Contract, https://github.com/from021-io/observability-python/blob/main/CONTRACT.md
+Project-URL: Repository, https://github.com/from021-io/python-observability
+Project-URL: Changelog, https://github.com/from021-io/python-observability/blob/main/CHANGELOG.md
+Project-URL: Contract, https://github.com/from021-io/python-observability/blob/main/CONTRACT.md
 License-Expression: Apache-2.0
 License-File: LICENSE
 Keywords: asgi,fastapi,observability,opentelemetry,otlp,structlog
@@ -23,9 +23,10 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Requires-Dist: fastapi<1,>=0.116
 Requires-Dist: httpx<1,>=0.28
-Requires-Dist: opentelemetry-api<2,>=1.44
-Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.44
-Requires-Dist: opentelemetry-sdk<2,>=1.44
+Requires-Dist: opentelemetry-api<2,>=1.45.1
+Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.45.1
+Requires-Dist: opentelemetry-sdk<2,>=1.45.1
+Requires-Dist: requests<3,>=2.34
 Requires-Dist: sqlalchemy[asyncio]<3,>=2.0
 Requires-Dist: structlog<27,>=25.1
 Provides-Extra: prometheus
@@ -34,9 +35,9 @@ Provides-Extra: vercel
 Requires-Dist: vercel<1,>=0.5.8; extra == 'vercel'
 Description-Content-Type: text/markdown
 
-# observability-python
+# python-observability
 
-Repository: `from021-io/observability-python`. Python distribution: `021-python-observability`; import: `observability_021`.
+Repository: `from021-io/python-observability` (named `observability-python` until 2026-10-21; the old URL redirects). Python distribution: `021-python-observability`; import: `observability_021`.
 Tags up to `v0.2.0` use the previous distribution name, `021-observability`.
 
 Common API observability for Python 3.12–3.14: FastAPI request metrics and traces,
@@ -54,14 +55,14 @@ writes [CHANGELOG.md](CHANGELOG.md) and tags `vX.Y.Z`. Consumers depend on a tag
 
 ```toml
 [tool.uv.sources]
-021-python-observability = { git = "https://github.com/from021-io/observability-python.git", tag = "v0.3.0" } # x-release-please-version
+021-python-observability = { git = "https://github.com/from021-io/python-observability.git", tag = "v0.4.0" } # x-release-please-version
 ```
 
 Once releases are published to PyPI, pin the exact version instead; no Git credential is
 needed to install it:
 
 ```sh
-uv add "021-python-observability==0.3.0" # x-release-please-version
+uv add "021-python-observability==0.4.0" # x-release-please-version
 ```
 
 ## Publishing to PyPI
@@ -134,6 +135,14 @@ keep its default value. A different Content-Type does not change the encoding.
 Use custom headers for gateway authentication and verify receipt of both signals
 against the configured gateway during rollout.
 
+`Settings` defaults to no compression. Set `traces_compression` and
+`metrics_compression` to `none`, `gzip` or `deflate` explicitly.
+`Settings.from_env()` reads `OTEL_EXPORTER_OTLP_COMPRESSION` and the signal-specific
+`OTEL_EXPORTER_OTLP_TRACES_COMPRESSION` and `OTEL_EXPORTER_OTLP_METRICS_COMPRESSION`
+overrides. Direct `Settings(...)` calls no longer inherit ambient compression.
+The exporter owns `Content-Encoding` so that the header matches the body. Custom
+and ambient headers cannot override it.
+
 Separate destinations are supported and take precedence over the shared base:
 
 ```dotenv
@@ -225,6 +234,18 @@ Operation/result remain separate dimensions. `operation()` reports `ok`, `error`
 
 ## Logging
 
+Each application lifespan emits an `observability.started` JSON log at INFO with
+`service_name`, `environment`, `service_version` and `observability_version`. The service
+version comes from `OTEL_SERVICE_VERSION`, falling back to `VERCEL_GIT_COMMIT_SHA` and
+then `unknown`; the deployment must set the release version to identify the running
+artifact. The observability version identifies this installed package, not the service.
+The event is suppressed if `LOG_LEVEL` is higher than INFO. Every log handled by this
+package's JSON formatter also includes both version fields, including stdlib and Uvicorn
+logs outside requests. Logging is configured process-wide: for multiple apps in one process,
+request logs use the active app version; logs without request context use the most recently
+configured app version. Logs emitted before setup or through independent handlers are outside
+this formatter's scope.
+
 `get_logger(__name__)` provides structlog logging. Use static event names and approved
 structured fields (`operation`, `op`, `action`, `dependency`, `status`, `reason`, `error_type`). Do not
 interpolate messages or pass business payloads into approved fields. Unknown extra fields

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/README.md

@@ -1,6 +1,6 @@
-# observability-python
+# python-observability
 
-Repository: `from021-io/observability-python`. Python distribution: `021-python-observability`; import: `observability_021`.
+Repository: `from021-io/python-observability` (named `observability-python` until 2026-10-21; the old URL redirects). Python distribution: `021-python-observability`; import: `observability_021`.
 Tags up to `v0.2.0` use the previous distribution name, `021-observability`.
 
 Common API observability for Python 3.12–3.14: FastAPI request metrics and traces,
@@ -18,14 +18,14 @@ writes [CHANGELOG.md](CHANGELOG.md) and tags `vX.Y.Z`. Consumers depend on a tag
 
 ```toml
 [tool.uv.sources]
-021-python-observability = { git = "https://github.com/from021-io/observability-python.git", tag = "v0.3.0" } # x-release-please-version
+021-python-observability = { git = "https://github.com/from021-io/python-observability.git", tag = "v0.4.0" } # x-release-please-version
 ```
 
 Once releases are published to PyPI, pin the exact version instead; no Git credential is
 needed to install it:
 
 ```sh
-uv add "021-python-observability==0.3.0" # x-release-please-version
+uv add "021-python-observability==0.4.0" # x-release-please-version
 ```
 
 ## Publishing to PyPI
@@ -98,6 +98,14 @@ keep its default value. A different Content-Type does not change the encoding.
 Use custom headers for gateway authentication and verify receipt of both signals
 against the configured gateway during rollout.
 
+`Settings` defaults to no compression. Set `traces_compression` and
+`metrics_compression` to `none`, `gzip` or `deflate` explicitly.
+`Settings.from_env()` reads `OTEL_EXPORTER_OTLP_COMPRESSION` and the signal-specific
+`OTEL_EXPORTER_OTLP_TRACES_COMPRESSION` and `OTEL_EXPORTER_OTLP_METRICS_COMPRESSION`
+overrides. Direct `Settings(...)` calls no longer inherit ambient compression.
+The exporter owns `Content-Encoding` so that the header matches the body. Custom
+and ambient headers cannot override it.
+
 Separate destinations are supported and take precedence over the shared base:
 
 ```dotenv
@@ -189,6 +197,18 @@ Operation/result remain separate dimensions. `operation()` reports `ok`, `error`
 
 ## Logging
 
+Each application lifespan emits an `observability.started` JSON log at INFO with
+`service_name`, `environment`, `service_version` and `observability_version`. The service
+version comes from `OTEL_SERVICE_VERSION`, falling back to `VERCEL_GIT_COMMIT_SHA` and
+then `unknown`; the deployment must set the release version to identify the running
+artifact. The observability version identifies this installed package, not the service.
+The event is suppressed if `LOG_LEVEL` is higher than INFO. Every log handled by this
+package's JSON formatter also includes both version fields, including stdlib and Uvicorn
+logs outside requests. Logging is configured process-wide: for multiple apps in one process,
+request logs use the active app version; logs without request context use the most recently
+configured app version. Logs emitted before setup or through independent handlers are outside
+this formatter's scope.
+
 `get_logger(__name__)` provides structlog logging. Use static event names and approved
 structured fields (`operation`, `op`, `action`, `dependency`, `status`, `reason`, `error_type`). Do not
 interpolate messages or pass business payloads into approved fields. Unknown extra fields

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "021-python-observability"
-version = "0.3.0"
+version = "0.4.0"
 description = "OpenTelemetry metrics, traces and safe JSON logs for FastAPI services"
 readme = "README.md"
 license = "Apache-2.0"
@@ -28,17 +28,18 @@ classifiers = [
 dependencies = [
   "fastapi>=0.116,<1",
   "httpx>=0.28,<1",
+  "requests>=2.34,<3",
   "sqlalchemy[asyncio]>=2.0,<3",
   "structlog>=25.1,<27",
-  "opentelemetry-api>=1.44,<2",
-  "opentelemetry-sdk>=1.44,<2",
-  "opentelemetry-exporter-otlp-proto-http>=1.44,<2",
+  "opentelemetry-api>=1.45.1,<2",
+  "opentelemetry-sdk>=1.45.1,<2",
+  "opentelemetry-exporter-otlp-proto-http>=1.45.1,<2",
 ]
 
 [project.urls]
-Repository = "https://github.com/from021-io/observability-python"
-Changelog = "https://github.com/from021-io/observability-python/blob/main/CHANGELOG.md"
-Contract = "https://github.com/from021-io/observability-python/blob/main/CONTRACT.md"
+Repository = "https://github.com/from021-io/python-observability"
+Changelog = "https://github.com/from021-io/python-observability/blob/main/CHANGELOG.md"
+Contract = "https://github.com/from021-io/python-observability/blob/main/CONTRACT.md"
 
 [project.optional-dependencies]
 vercel = ["vercel>=0.5.8,<1"]

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/src/observability_021/asgi.py

@@ -20,6 +20,7 @@ from starlette.responses import JSONResponse
 from .config import Settings, identifier
 from .logging import configure_logging, get_logger
 from .runtime import (
+    INSTRUMENTATION_VERSION,
     BackgroundTask,
     Observability,
     current_observability,
@@ -175,7 +176,11 @@ def setup_observability(
     if app.middleware_stack is not None:
         raise RuntimeError("Configure observability before the application starts")
     settings = settings or Settings.from_env(service_name=service_name)
-    configure_logging(settings.log_level)
+    configure_logging(
+        settings.log_level,
+        service_version=settings.service_version,
+        observability_version=INSTRUMENTATION_VERSION,
+    )
     obs = Observability(
         settings,
         prometheus=prometheus,
@@ -192,9 +197,20 @@ def setup_observability(
     @asynccontextmanager
     async def lifespan(application):
         # Servers accepting an already-built app may configure logging after setup.
-        configure_logging(settings.log_level)
+        configure_logging(
+            settings.log_level,
+            service_version=settings.service_version,
+            observability_version=INSTRUMENTATION_VERSION,
+        )
         token = current_observability.set(obs)
         try:
+            logger.info(
+                "observability.started",
+                service_name=settings.service_name,
+                environment=settings.environment,
+                service_version=settings.service_version,
+                observability_version=INSTRUMENTATION_VERSION,
+            )
             async with original_lifespan(application) as state:
                 yield state
         finally:

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/src/observability_021/config.py

@@ -64,6 +64,8 @@ class Settings:
     log_level: str = "INFO"
     serverless: bool = False
     readiness_timeout_seconds: float = 2.0
+    traces_compression: str = "none"
+    metrics_compression: str = "none"
 
     def __post_init__(self) -> None:
         identifier(self.service_name)
@@ -72,6 +74,11 @@ class Settings:
             raise ValueError("service_version must contain 1–128 characters")
         _endpoint(self.traces_endpoint)
         _endpoint(self.metrics_endpoint)
+        if any(
+            value not in {"none", "gzip", "deflate"}
+            for value in (self.traces_compression, self.metrics_compression)
+        ):
+            raise ValueError("OTLP compression must be none, gzip or deflate")
         for value in (
             self.export_timeout_seconds,
             self.metric_interval_ms,
@@ -124,6 +131,14 @@ class Settings:
                     "OTEL_EXPORTER_OTLP_METRICS_HEADERS", env.get("OTEL_EXPORTER_OTLP_HEADERS", "")
                 )
             ),
+            traces_compression=env.get(
+                "OTEL_EXPORTER_OTLP_TRACES_COMPRESSION",
+                env.get("OTEL_EXPORTER_OTLP_COMPRESSION", "none"),
+            ),
+            metrics_compression=env.get(
+                "OTEL_EXPORTER_OTLP_METRICS_COMPRESSION",
+                env.get("OTEL_EXPORTER_OTLP_COMPRESSION", "none"),
+            ),
             export_timeout_seconds=float(env.get("OTEL_EXPORTER_OTLP_TIMEOUT", "2")),
             metric_interval_ms=float(env.get("OTEL_METRIC_EXPORT_INTERVAL", "60000")),
             trace_sample_ratio=float(env.get("OBS_TRACE_SAMPLE_RATIO", "1")),

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/src/observability_021/logging.py

@@ -31,6 +31,7 @@ _FIELDS = frozenset(
         "service_name",
         "environment",
         "service_version",
+        "observability_version",
         "request_id",
         "trace_id",
         "span_id",
@@ -154,9 +155,21 @@ def _sanitize(_logger, _method, event):
     return result
 
 
-def configure_logging(level: str = "INFO") -> None:
+def configure_logging(
+    level: str = "INFO",
+    *,
+    service_version: str = "unknown",
+    observability_version: str = "unknown",
+) -> None:
+    def add_versions(_logger, _method, event):
+        context = structlog.contextvars.get_contextvars()
+        event["service_version"] = context.get("service_version", service_version)
+        event["observability_version"] = observability_version
+        return event
+
     shared = [
         structlog.contextvars.merge_contextvars,
+        add_versions,
         structlog.stdlib.add_log_level,
         structlog.stdlib.add_logger_name,
         structlog.processors.TimeStamper(fmt="iso", utc=True, key="timestamp"),
@@ -174,7 +187,7 @@ def configure_logging(level: str = "INFO") -> None:
     handler = logging.StreamHandler(sys.stdout)
     handler.setFormatter(
         structlog.stdlib.ProcessorFormatter(
-            processors=[_sanitize, structlog.processors.JSONRenderer(sort_keys=True)],
+            processors=[add_versions, _sanitize, structlog.processors.JSONRenderer(sort_keys=True)],
             foreign_pre_chain=[*shared, structlog.stdlib.ExtraAdder(allow=_FIELDS)],
         )
     )

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/src/observability_021/runtime.py

@@ -17,6 +17,7 @@ from typing import TYPE_CHECKING, Any
 if TYPE_CHECKING:
     import httpx
 
+from opentelemetry.exporter.otlp.proto.http import Compression
 from opentelemetry.exporter.otlp.proto.http.metric_exporter import OTLPMetricExporter
 from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
 from opentelemetry.metrics import Observation
@@ -27,12 +28,14 @@ from opentelemetry.sdk.resources import Resource
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import BatchSpanProcessor
 from opentelemetry.sdk.trace.sampling import ParentBased, TraceIdRatioBased
+from requests import PreparedRequest, Request, Session
+from requests.structures import CaseInsensitiveDict
 
 from .config import Settings, identifier
 from .logging import get_logger
 
 # The package version, kept in step by release-please.
-INSTRUMENTATION_VERSION = "0.3.0"  # x-release-please-version
+INSTRUMENTATION_VERSION = "0.4.0"  # x-release-please-version
 
 # Seconds, with finite boundaries for both ordinary API traffic and long ingestion.
 DURATION_BUCKETS = (0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10, 30, 60, 120, 300)
@@ -53,6 +56,25 @@ def error_kind(error: BaseException) -> str:
     return "internal_error"
 
 
+class _ExportSession(Session):
+    def __init__(self, headers: Mapping[str, str], compression: Compression):
+        super().__init__()
+        self._export_headers = CaseInsensitiveDict(
+            {"Content-Type": "application/x-protobuf", **headers}
+        )
+        self._export_headers.pop("Content-Encoding", None)
+        if compression is not Compression.NoCompression:
+            self._export_headers["Content-Encoding"] = compression.value
+
+    def prepare_request(self, request: Request) -> PreparedRequest:
+        request.headers = CaseInsensitiveDict(self._export_headers)
+        prepared = super().prepare_request(request)
+        # Requests can add netrc credentials during preparation.
+        prepared.headers.pop("Authorization", None)
+        prepared.headers.update(self._export_headers)
+        return prepared
+
+
 class Observability:
     def __init__(
         self,
@@ -82,13 +104,15 @@ class Observability:
             sampler=ParentBased(TraceIdRatioBased(settings.trace_sample_ratio)),
             shutdown_on_exit=False,
         )
-        # A nonempty explicit mapping prevents SDK fallback to ambient OTLP credentials.
-        # Content-Type is already required by OTLP/HTTP, so no extra header is introduced.
         if settings.traces_endpoint:
             self.tracer_provider.add_span_processor(
                 BatchSpanProcessor(
                     OTLPSpanExporter(
                         endpoint=settings.traces_endpoint,
+                        session=_ExportSession(
+                            settings.traces_headers, Compression(settings.traces_compression)
+                        ),
+                        compression=Compression(settings.traces_compression),
                         headers={
                             "Content-Type": "application/x-protobuf",
                             **settings.traces_headers,
@@ -110,6 +134,10 @@ class Observability:
                 PeriodicExportingMetricReader(
                     OTLPMetricExporter(
                         endpoint=settings.metrics_endpoint,
+                        session=_ExportSession(
+                            settings.metrics_headers, Compression(settings.metrics_compression)
+                        ),
+                        compression=Compression(settings.metrics_compression),
                         headers={
                             "Content-Type": "application/x-protobuf",
                             **settings.metrics_headers,

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/tests/test_contract.py

@@ -1,10 +1,12 @@
 from __future__ import annotations
 
 import asyncio
+import gzip
 import json
 import logging
 import threading
 import time
+import zlib
 from contextlib import contextmanager
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 from unittest.mock import patch
@@ -27,6 +29,7 @@ from sqlalchemy.pool import NullPool, QueuePool
 
 from observability_021 import Settings, get_logger, setup_observability
 from observability_021.asgi import ObservabilityMiddleware
+from observability_021.runtime import INSTRUMENTATION_VERSION
 
 
 @contextmanager
@@ -105,16 +108,33 @@ def test_configuration_signal_overrides_and_no_implicit_export():
             "OTEL_EXPORTER_OTLP_METRICS_ENDPOINT": "https://metrics.test/custom",
             "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Basic%20SECRET",
             "OTEL_EXPORTER_OTLP_METRICS_HEADERS": "x-token=OTHER",
+            "OTEL_EXPORTER_OTLP_COMPRESSION": "gzip",
+            "OTEL_EXPORTER_OTLP_METRICS_COMPRESSION": "deflate",
         }
     )
     assert settings.traces_endpoint == "https://otel.test/otlp/v1/traces"
     assert settings.metrics_endpoint == "https://metrics.test/custom"
     assert settings.traces_headers == {"Authorization": "Basic SECRET"}
     assert settings.metrics_headers == {"x-token": "OTHER"}
+    assert settings.traces_compression == "gzip"
+    assert settings.metrics_compression == "deflate"
     assert "SECRET" not in repr(settings) and "OTHER" not in repr(settings)
     assert settings.environment == "staging" and settings.service_version == "0.1.0"
 
 
+@pytest.mark.parametrize("service_version", ["1.2.3", "unknown"])
+def test_lifespan_logs_service_and_observability_versions(capsys, service_version):
+    settings = Settings("test-api", environment="test", service_version=service_version)
+    with observed(settings=settings) as (app, _, _, _), TestClient(app):
+        lines = [json.loads(line) for line in capsys.readouterr().out.splitlines()]
+        events = [line for line in lines if line.get("event") == "observability.started"]
+        assert len(events) == 1
+        assert events[0]["service_name"] == "test-api"
+        assert events[0]["environment"] == "test"
+        assert events[0]["service_version"] == service_version
+        assert events[0]["observability_version"] == INSTRUMENTATION_VERSION
+
+
 @pytest.mark.parametrize(
     "env",
     [
@@ -123,6 +143,9 @@ def test_configuration_signal_overrides_and_no_implicit_export():
         {"OTEL_EXPORTER_OTLP_HEADERS": "Authorization=hello%0aInjected"},
         {"OTEL_EXPORTER_OTLP_PROTOCOL": "grpc"},
         {"OTEL_EXPORTER_OTLP_TIMEOUT": "nan"},
+        {"OTEL_EXPORTER_OTLP_COMPRESSION": "SECRET"},
+        {"OTEL_EXPORTER_OTLP_TRACES_COMPRESSION": "SECRET"},
+        {"OTEL_EXPORTER_OTLP_METRICS_COMPRESSION": "SECRET"},
         {"OBS_TRACE_SAMPLE_RATIO": "1.1"},
     ],
 )
@@ -442,6 +465,11 @@ def receiver(*, status=200, delay=0):
     class Handler(BaseHTTPRequestHandler):
         def do_POST(self):
             raw = self.rfile.read(int(self.headers.get("content-length", "0")))
+            assert self.headers.get("content-encoding") in {None, "gzip", "deflate"}
+            if self.headers.get("content-encoding") == "gzip":
+                raw = gzip.decompress(raw)
+            elif self.headers.get("content-encoding") == "deflate":
+                raw = zlib.decompress(raw)
             message = (
                 ExportTraceServiceRequest()
                 if self.path.endswith("traces")

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/tests/test_extra_contract.py

@@ -152,13 +152,32 @@ def test_readiness_all_healthy_then_unavailable():
             assert client.get("/health").status_code == 200
 
 
-def test_explicit_configuration_does_not_inherit_ambient_credentials():
-    with (
-        receiver() as (endpoint, received),
-        patch.dict(
-            "os.environ", {"OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer%20UNRELATED-SECRET"}
+@pytest.mark.parametrize("compression", ["none", "gzip", "deflate"])
+@pytest.mark.parametrize("explicit_auth", [None, "Bearer EXPLICIT"])
+@pytest.mark.parametrize("ambient_encoding", ["gzip", "deflate"])
+def test_explicit_configuration_does_not_inherit_ambient_credentials(
+    compression, explicit_auth, ambient_encoding, tmp_path
+):
+    netrc = tmp_path / "netrc"
+    netrc.write_text("machine 127.0.0.1 login unrelated password SECRET\n")
+    ambient = {
+        "NETRC": str(netrc),
+        "OTEL_EXPORTER_OTLP_HEADERS": (
+            f"Authorization=Bearer%20COMMON-SECRET,X-Secret=COMMON,Content-Encoding={ambient_encoding}"
         ),
-    ):
+        "OTEL_EXPORTER_OTLP_TRACES_HEADERS": (
+            f"Authorization=Bearer%20TRACE-SECRET,Content-Encoding={ambient_encoding}"
+        ),
+        "OTEL_EXPORTER_OTLP_METRICS_HEADERS": (
+            f"Authorization=Bearer%20METRIC-SECRET,Content-Encoding={ambient_encoding}"
+        ),
+        "OTEL_EXPORTER_OTLP_COMPRESSION": "gzip",
+        "OTEL_PYTHON_EXPORTER_OTLP_HTTP_CREDENTIAL_PROVIDER": "must-not-load",
+    }
+    headers = {"Content-Encoding": "br"}
+    if explicit_auth:
+        headers["authorization"] = explicit_auth
+    with receiver() as (endpoint, received), patch.dict("os.environ", ambient):
         app = FastAPI()
         obs = setup_observability(
             app,
@@ -166,9 +185,14 @@ def test_explicit_configuration_does_not_inherit_ambient_credentials():
                 "isolated",
                 traces_endpoint=endpoint + "/v1/traces",
                 metrics_endpoint=endpoint + "/v1/metrics",
+                traces_headers=headers,
+                metrics_headers=headers,
+                traces_compression=compression,
+                metrics_compression=compression,
             ),
         )
         with TestClient(app) as client:
             assert client.get("/missing").status_code == 404
             asyncio.run(obs.flush_async())
-        assert received and all(auth is None for _, auth, _ in received)
+        assert {path for path, _, _ in received} == {"/v1/traces", "/v1/metrics"}
+        assert all(auth == explicit_auth for _, auth, _ in received)

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/tests/test_logging_contract.py

@@ -2,15 +2,17 @@ import asyncio
 import json
 import logging
 import sys
+import threading
 from pathlib import Path
 from uuid import UUID, uuid4
 
 import pytest
 import structlog
 from fastapi.testclient import TestClient
-from test_contract import observed, points
+from test_contract import invoke, observed, points
 
-from observability_021 import get_logger
+from observability_021 import Settings, get_logger
+from observability_021.runtime import INSTRUMENTATION_VERSION
 
 
 def fail():
@@ -18,6 +20,43 @@ def fail():
     raise ValueError(f"SECRET-ERROR {private_local}")
 
 
+def test_versions_on_structlog_stdlib_thread_and_requests(capsys):
+    with observed(settings=Settings("api", service_version="1.2.3")) as (app, _, _, _):
+
+        @app.get("/versions")
+        async def versions():
+            get_logger("request").info("request.log", service_version="untrusted")
+            return {}
+
+        get_logger("worker").info("worker.log", observability_version="untrusted")
+        thread = threading.Thread(target=logging.getLogger("thread").warning, args=("message",))
+        thread.start()
+        thread.join()
+        with TestClient(app) as client:
+            assert client.get("/versions").status_code == 200
+
+    rows = [json.loads(line) for line in capsys.readouterr().out.splitlines()]
+    assert {"worker.log", "library.log", "request.log", "request.completed"} <= {
+        row["event"] for row in rows
+    }
+    assert all(row["service_version"] == "1.2.3" for row in rows)
+    assert all(row["observability_version"] == INSTRUMENTATION_VERSION for row in rows)
+
+
+def test_request_version_uses_active_app_not_last_configured(capsys):
+    with observed(settings=Settings("first", service_version="1.0")) as (first, _, _, _):
+        with observed(settings=Settings("second", service_version="2.0")):
+
+            @first.get("/version")
+            async def version():
+                get_logger("request").info("request.log")
+                return {}
+
+            asyncio.run(invoke(first, path="/version"))
+    rows = [json.loads(line) for line in capsys.readouterr().out.splitlines()]
+    assert [row["service_version"] for row in rows if row["event"] == "request.log"] == ["1.0"]
+
+
 @pytest.mark.parametrize("source", ["structlog", "stdlib", "uvicorn.error"])
 @pytest.mark.parametrize("exc_form", ["current", "instance", "tuple"])
 def test_exception_logs_keep_safe_diagnostics_and_correlation(capsys, source, exc_form):

{021_python_observability-0.3.0 → 021_python_observability-0.4.0}/tests/wheel_smoke.py

@@ -10,6 +10,7 @@ from fastapi import FastAPI
 
 import observability_021
 from observability_021 import setup_observability
+from observability_021.runtime import INSTRUMENTATION_VERSION
 
 
 async def main():
@@ -25,6 +26,7 @@ async def main():
             assert response.headers["x-request-id"]
     origin = Path(observability_021.__file__)
     assert "site-packages" in origin.parts, origin
+    assert INSTRUMENTATION_VERSION == importlib.metadata.version("021-python-observability")
     print(
         f"wheel={importlib.metadata.version('021-python-observability')} "
         f"python={sys.version.split()[0]} health=200 isolated_install=passed"