PyPI - tigrcorn-observability - Versions diffs - 0.3.18.dev2__tar.gz → 0.3.18.dev3__tar.gz - Mend

tigrcorn-observability 0.3.18.dev2tar.gz → 0.3.18.dev3tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

{tigrcorn_observability-0.3.18.dev2 → tigrcorn_observability-0.3.18.dev3}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrcorn-observability
-Version: 0.3.18.dev2
+Version: 0.3.18.dev3
 Summary: Logging, metrics, tracing, DoS warning events, and release-evidence metadata for the Tigrcorn Python web server.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License: Apache License
@@ -186,8 +186,8 @@ Classifier: Typing :: Typed
 Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: tigrcorn-core==0.3.18.dev2
-Requires-Dist: tigrcorn-config==0.3.18.dev2
+Requires-Dist: tigrcorn-core==0.3.18.dev3
+Requires-Dist: tigrcorn-config==0.3.18.dev3
 Dynamic: license-file
 <div align="center">
@@ -277,7 +277,7 @@ The package exposes its supported public surface through the <code>tigrcorn_obse
 ## Package Graph
-[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-quic-cc](https://pypi.org/project/tigrcorn-quic-cc/) | [tigrcorn-quic-cc-reno](https://pypi.org/project/tigrcorn-quic-cc-reno/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
 ## Best Practices

{tigrcorn_observability-0.3.18.dev2 → tigrcorn_observability-0.3.18.dev3}/README.md RENAMED Viewed

@@ -85,7 +85,7 @@ The package exposes its supported public surface through the <code>tigrcorn_obse
 ## Package Graph
-[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-quic-cc](https://pypi.org/project/tigrcorn-quic-cc/) | [tigrcorn-quic-cc-reno](https://pypi.org/project/tigrcorn-quic-cc-reno/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
 ## Best Practices

{tigrcorn_observability-0.3.18.dev2 → tigrcorn_observability-0.3.18.dev3}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "tigrcorn-observability"
-version = "0.3.18.dev2"
+version = "0.3.18.dev3"
 description = "Logging, metrics, tracing, DoS warning events, and release-evidence metadata for the Tigrcorn Python web server."
 readme = "README.md"
 requires-python = ">=3.10,<3.15"
@@ -29,8 +29,8 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-  "tigrcorn-core==0.3.18.dev2",
-  "tigrcorn-config==0.3.18.dev2",
+  "tigrcorn-core==0.3.18.dev3",
+  "tigrcorn-config==0.3.18.dev3",
 ]
 [tool.setuptools]

{tigrcorn_observability-0.3.18.dev2 → tigrcorn_observability-0.3.18.dev3}/src/tigrcorn_observability/metrics.py RENAMED Viewed

@@ -47,11 +47,27 @@ class Metrics:
     quic_path_migrations: int = 0
     quic_packets_lost: int = 0
     quic_pto_expirations: int = 0
+    quic_pto_probes: int = 0
+    quic_stream_bytes_retransmitted: int = 0
+    quic_crypto_bytes_retransmitted: int = 0
+    quic_datagram_frames_abandoned: int = 0
+    quic_frames_regenerated: int = 0
+    quic_bytes_in_flight: int = 0
+    quic_congestion_window_bytes: int = 0
+    quic_smoothed_rtt_seconds: float = 0.0
+    quic_pacing_rate_bytes_per_second: float = 0.0
+    quic_pending_outbound_datagrams: int = 0
+    quic_congestion_controller_failures: int = 0
+    quic_persistent_congestion_events: int = 0
     http3_requests_served: int = 0
     http3_stream_resets: int = 0
     http3_goaway_received: int = 0
     http3_qpack_encoder_streams: int = 0
     http3_qpack_decoder_streams: int = 0
+    webtransport_profile_draft02_selected: int = 0
+    webtransport_profile_draft13_selected: int = 0
+    webtransport_profile_ietf_current_selected: int = 0
+    webtransport_negotiation_rejected: int = 0
     def connection_opened(self) -> None:
         self.connections_opened += 1
@@ -128,6 +144,42 @@ class Metrics:
     def quic_pto_expired(self) -> None:
         self.quic_pto_expirations += 1
+    def quic_recovery_observed(
+        self,
+        *,
+        pto_probes: int = 0,
+        stream_bytes_retransmitted: int = 0,
+        crypto_bytes_retransmitted: int = 0,
+        datagram_frames_abandoned: int = 0,
+        frames_regenerated: int = 0,
+    ) -> None:
+        self.quic_pto_probes += max(0, int(pto_probes))
+        self.quic_stream_bytes_retransmitted += max(0, int(stream_bytes_retransmitted))
+        self.quic_crypto_bytes_retransmitted += max(0, int(crypto_bytes_retransmitted))
+        self.quic_datagram_frames_abandoned += max(0, int(datagram_frames_abandoned))
+        self.quic_frames_regenerated += max(0, int(frames_regenerated))
+    def quic_transport_state_observed(
+        self,
+        *,
+        bytes_in_flight: int,
+        congestion_window: int,
+        smoothed_rtt: float,
+        pacing_rate: float,
+        pending_outbound: int,
+    ) -> None:
+        self.quic_bytes_in_flight = max(0, int(bytes_in_flight))
+        self.quic_congestion_window_bytes = max(0, int(congestion_window))
+        self.quic_smoothed_rtt_seconds = max(0.0, float(smoothed_rtt))
+        self.quic_pacing_rate_bytes_per_second = max(0.0, float(pacing_rate))
+        self.quic_pending_outbound_datagrams = max(0, int(pending_outbound))
+    def quic_congestion_controller_failed(self) -> None:
+        self.quic_congestion_controller_failures += 1
+    def quic_persistent_congestion_observed(self) -> None:
+        self.quic_persistent_congestion_events += 1
     def http3_request_served(self) -> None:
         self.http3_requests_served += 1
@@ -143,6 +195,18 @@ class Metrics:
     def http3_qpack_decoder_stream_opened(self) -> None:
         self.http3_qpack_decoder_streams += 1
+    def webtransport_profile_selected(self, profile: str) -> None:
+        field_name = {
+            'draft02': 'webtransport_profile_draft02_selected',
+            'draft13': 'webtransport_profile_draft13_selected',
+            'ietf-current': 'webtransport_profile_ietf_current_selected',
+        }.get(profile)
+        if field_name is not None:
+            setattr(self, field_name, int(getattr(self, field_name)) + 1)
+    def webtransport_negotiation_rejected_observed(self) -> None:
+        self.webtransport_negotiation_rejected += 1
     @property
     def uptime_seconds(self) -> float:
         return max(0.0, monotonic() - self.started_at)
@@ -182,11 +246,27 @@ class Metrics:
             'quic_path_migrations': self.quic_path_migrations,
             'quic_packets_lost': self.quic_packets_lost,
             'quic_pto_expirations': self.quic_pto_expirations,
+            'quic_pto_probes': self.quic_pto_probes,
+            'quic_stream_bytes_retransmitted': self.quic_stream_bytes_retransmitted,
+            'quic_crypto_bytes_retransmitted': self.quic_crypto_bytes_retransmitted,
+            'quic_datagram_frames_abandoned': self.quic_datagram_frames_abandoned,
+            'quic_frames_regenerated': self.quic_frames_regenerated,
+            'quic_bytes_in_flight': self.quic_bytes_in_flight,
+            'quic_congestion_window_bytes': self.quic_congestion_window_bytes,
+            'quic_smoothed_rtt_seconds': self.quic_smoothed_rtt_seconds,
+            'quic_pacing_rate_bytes_per_second': self.quic_pacing_rate_bytes_per_second,
+            'quic_pending_outbound_datagrams': self.quic_pending_outbound_datagrams,
+            'quic_congestion_controller_failures': self.quic_congestion_controller_failures,
+            'quic_persistent_congestion_events': self.quic_persistent_congestion_events,
             'http3_requests_served': self.http3_requests_served,
             'http3_stream_resets': self.http3_stream_resets,
             'http3_goaway_received': self.http3_goaway_received,
             'http3_qpack_encoder_streams': self.http3_qpack_encoder_streams,
             'http3_qpack_decoder_streams': self.http3_qpack_decoder_streams,
+            'webtransport_profile_draft02_selected': self.webtransport_profile_draft02_selected,
+            'webtransport_profile_draft13_selected': self.webtransport_profile_draft13_selected,
+            'webtransport_profile_ietf_current_selected': self.webtransport_profile_ietf_current_selected,
+            'webtransport_negotiation_rejected': self.webtransport_negotiation_rejected,
         }
     def render_prometheus(self, *, prefix: str = 'tigrcorn') -> str:
@@ -203,7 +283,17 @@ class Metrics:
 def _is_gauge_metric(name: str) -> bool:
-    return name.startswith('active_') or name == 'uptime_seconds'
+    return (
+        name.startswith('active_')
+        or name == 'uptime_seconds'
+        or name in {
+            'quic_bytes_in_flight',
+            'quic_congestion_window_bytes',
+            'quic_smoothed_rtt_seconds',
+            'quic_pacing_rate_bytes_per_second',
+            'quic_pending_outbound_datagrams',
+        }
+    )
 def iter_statsd_lines(snapshot: Mapping[str, Any], *, previous: Mapping[str, Any] | None = None, prefix: str = 'tigrcorn') -> list[str]:

{tigrcorn_observability-0.3.18.dev2 → tigrcorn_observability-0.3.18.dev3}/src/tigrcorn_observability.egg-info/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrcorn-observability
-Version: 0.3.18.dev2
+Version: 0.3.18.dev3
 Summary: Logging, metrics, tracing, DoS warning events, and release-evidence metadata for the Tigrcorn Python web server.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License: Apache License
@@ -186,8 +186,8 @@ Classifier: Typing :: Typed
 Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: tigrcorn-core==0.3.18.dev2
-Requires-Dist: tigrcorn-config==0.3.18.dev2
+Requires-Dist: tigrcorn-core==0.3.18.dev3
+Requires-Dist: tigrcorn-config==0.3.18.dev3
 Dynamic: license-file
 <div align="center">
@@ -277,7 +277,7 @@ The package exposes its supported public surface through the <code>tigrcorn_obse
 ## Package Graph
-[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-quic-cc](https://pypi.org/project/tigrcorn-quic-cc/) | [tigrcorn-quic-cc-reno](https://pypi.org/project/tigrcorn-quic-cc-reno/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
 ## Best Practices