Release v4.19.0 (#1631)

Author: alexmojaki

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Release Notes
 
+## [v4.19.0] (2026-01-16)
+
+* Add DSPy integration to logfire by @bdsaglam in [#1625](https://github.com/pydantic/logfire/pull/1625)
+* Set log level based on HTTP status code, create issues for handled exceptions in FastAPI when the status code is 5xx by @alexmojaki in [#1628](https://github.com/pydantic/logfire/pull/1628)
+* Add OTel GenAI semantic convention attributes to LLM instrumentations by @jimilp7 in [#1619](https://github.com/pydantic/logfire/pull/1619)
+* Minor optimization: move tweaking of ASGI send/receive span level by @alexmojaki in [#1629](https://github.com/pydantic/logfire/pull/1629)
+
 ## [v4.18.0] (2026-01-12)
 
 * Adds `aiohttp` request body capture. by @adtyavrdhn in [#1595](https://github.com/pydantic/logfire/pull/1595)
@@ -1000,3 +1007,4 @@ First release from new repo!
 [v4.16.0]: https://github.com/pydantic/logfire/compare/v4.15.1...v4.16.0
 [v4.17.0]: https://github.com/pydantic/logfire/compare/v4.16.0...v4.17.0
 [v4.18.0]: https://github.com/pydantic/logfire/compare/v4.17.0...v4.18.0
+[v4.19.0]: https://github.com/pydantic/logfire/compare/v4.18.0...v4.19.0

logfire-api/logfire_api/_internal/exporters/processor_wrapper.pyi

@@ -1,4 +1,4 @@
-from ..constants import ATTRIBUTES_JSON_SCHEMA_KEY as ATTRIBUTES_JSON_SCHEMA_KEY, ATTRIBUTES_LOG_LEVEL_NUM_KEY as ATTRIBUTES_LOG_LEVEL_NUM_KEY, ATTRIBUTES_MESSAGE_KEY as ATTRIBUTES_MESSAGE_KEY, ATTRIBUTES_MESSAGE_TEMPLATE_KEY as ATTRIBUTES_MESSAGE_TEMPLATE_KEY, ATTRIBUTES_TAGS_KEY as ATTRIBUTES_TAGS_KEY, LEVEL_NUMBERS as LEVEL_NUMBERS, log_level_attributes as log_level_attributes
+from ..constants import ATTRIBUTES_EXCEPTION_FINGERPRINT_KEY as ATTRIBUTES_EXCEPTION_FINGERPRINT_KEY, ATTRIBUTES_JSON_SCHEMA_KEY as ATTRIBUTES_JSON_SCHEMA_KEY, ATTRIBUTES_LOG_LEVEL_NUM_KEY as ATTRIBUTES_LOG_LEVEL_NUM_KEY, ATTRIBUTES_MESSAGE_KEY as ATTRIBUTES_MESSAGE_KEY, ATTRIBUTES_MESSAGE_TEMPLATE_KEY as ATTRIBUTES_MESSAGE_TEMPLATE_KEY, ATTRIBUTES_TAGS_KEY as ATTRIBUTES_TAGS_KEY, LEVEL_NUMBERS as LEVEL_NUMBERS, log_level_attributes as log_level_attributes
 from ..db_statement_summary import message_from_db_statement as message_from_db_statement
 from ..json_schema import JsonSchemaProperties as JsonSchemaProperties, attributes_json_schema as attributes_json_schema
 from ..scrubbing import BaseScrubber as BaseScrubber
@@ -24,7 +24,6 @@ class MainSpanProcessorWrapper(WrapperSpanProcessor):
     Tweaks the send/receive span names generated by the ASGI middleware.
     """
     scrubber: BaseScrubber
-    def on_start(self, span: Span, parent_context: context.Context | None = None) -> None: ...
     def on_end(self, span: ReadableSpan) -> None: ...
 
 def guess_system(model: str, default: str = ''): ...

logfire-api/logfire_api/_internal/integrations/asgi.pyi

@@ -1,9 +1,11 @@
 from collections.abc import Awaitable
 from dataclasses import dataclass
 from logfire import Logfire as Logfire
+from logfire._internal.constants import log_level_attributes as log_level_attributes
 from logfire._internal.utils import is_asgi_send_receive_span_name as is_asgi_send_receive_span_name, maybe_capture_server_headers as maybe_capture_server_headers
 from opentelemetry.context import Context
-from opentelemetry.trace import Span, Tracer, TracerProvider
+from opentelemetry.trace import Span, SpanKind, Tracer, TracerProvider
+from opentelemetry.util import types as otel_types
 from typing import Any, Callable, Protocol, TypedDict
 from typing_extensions import Unpack
 
@@ -26,17 +28,23 @@ class ASGIInstrumentKwargs(TypedDict, total=False):
     http_capture_headers_sanitize_fields: list[str] | None
 
 def tweak_asgi_spans_tracer_provider(logfire_instance: Logfire, record_send_receive: bool) -> TracerProvider:
-    """If record_send_receive is False, return a TracerProvider that skips spans for ASGI send and receive events."""
+    """Return a TracerProvider that customizes ASGI send/receive spans.
+
+    If record_send_receive is False, spans are filtered out.
+    If record_send_receive is True, spans are created with debug log level.
+    """
 
 @dataclass
 class TweakAsgiTracerProvider(TracerProvider):
     tracer_provider: TracerProvider
+    record_send_receive: bool
     def get_tracer(self, *args: Any, **kwargs: Any) -> Tracer: ...
 
 @dataclass
 class TweakAsgiSpansTracer(Tracer):
     tracer: Tracer
-    def start_span(self, name: str, context: Context | None = None, *args: Any, **kwargs: Any) -> Span: ...
+    record_send_receive: bool
+    def start_span(self, name: str, context: Context | None = None, kind: SpanKind = ..., attributes: otel_types.Attributes = None, *args: Any, **kwargs: Any) -> Span: ...
     start_as_current_span = ...
 
 def instrument_asgi(logfire_instance: Logfire, app: ASGIApp, *, record_send_receive: bool = False, capture_headers: bool = False, **kwargs: Unpack[ASGIInstrumentKwargs]) -> ASGIApp:

logfire-api/logfire_api/_internal/integrations/dspy.pyi

@@ -0,0 +1,4 @@
+import logfire
+from typing import Any
+
+def instrument_dspy(logfire_instance: logfire.Logfire, **kwargs: Any): ...

logfire-api/logfire_api/_internal/main.pyi

@@ -41,7 +41,7 @@ from opentelemetry.context import Context as Context
 from opentelemetry.instrumentation.asgi.types import ClientRequestHook, ClientResponseHook, ServerRequestHook
 from opentelemetry.metrics import CallbackT as CallbackT, Counter, Histogram, UpDownCounter, _Gauge as Gauge
 from opentelemetry.sdk.trace import ReadableSpan, Span
-from opentelemetry.trace import SpanContext
+from opentelemetry.trace import SpanContext, SpanKind
 from opentelemetry.util import types as otel_types
 from pymongo.monitoring import CommandFailedEvent as CommandFailedEvent, CommandStartedEvent as CommandStartedEvent, CommandSucceededEvent as CommandSucceededEvent
 from sqlalchemy import Engine
@@ -218,7 +218,7 @@ class Logfire:
             _exc_info: Set to an exception or a tuple as returned by [`sys.exc_info()`][sys.exc_info]
                 to record a traceback with the log message.
         """
-    def span(self, msg_template: str, /, *, _tags: Sequence[str] | None = None, _span_name: str | None = None, _level: LevelName | None = None, _links: Sequence[tuple[SpanContext, otel_types.Attributes]] = (), **attributes: Any) -> LogfireSpan:
+    def span(self, msg_template: str, /, *, _tags: Sequence[str] | None = None, _span_name: str | None = None, _level: LevelName | None = None, _links: Sequence[tuple[SpanContext, otel_types.Attributes]] = (), _span_kind: SpanKind = ..., **attributes: Any) -> LogfireSpan:
         """Context manager for creating a span.
 
         ```py
@@ -236,6 +236,10 @@ class Logfire:
             _tags: An optional sequence of tags to include in the span.
             _level: An optional log level name.
             _links: An optional sequence of links to other spans. Each link is a tuple of a span context and attributes.
+            _span_kind: The [OpenTelemetry span kind](https://opentelemetry.io/docs/concepts/signals/traces/#span-kind).
+                If not provided, defaults to `INTERNAL`.
+                Users don't typically need to set this.
+                Not related to the `kind` column of the `records` table in Logfire.
             attributes: The arguments to include in the span and format the message template with.
                 Attributes starting with an underscore are not allowed.
         """
@@ -616,6 +620,13 @@ class Logfire:
         [`openinference-instrumentation-litellm`](https://pypi.org/project/openinference-instrumentation-litellm/)
         package, to which it passes `**kwargs`.
         """
+    def instrument_dspy(self, **kwargs: Any):
+        """Instrument [DSPy](https://dspy.ai/).
+
+        Uses the `DSPyInstrumentor().instrument()` method of the
+        [`openinference-instrumentation-dspy`](https://pypi.org/project/openinference-instrumentation-dspy/)
+        package, to which it passes `**kwargs`.
+        """
     def instrument_print(self) -> AbstractContextManager[None]:
         """Instrument the built-in `print` function so that calls to it are logged.
 
@@ -1136,7 +1147,7 @@ class FastLogfireSpan:
     def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: Any) -> None: ...
 
 class LogfireSpan(ReadableSpan):
-    def __init__(self, span_name: str, otlp_attributes: dict[str, otel_types.AttributeValue], tracer: _ProxyTracer, json_schema_properties: JsonSchemaProperties, links: Sequence[tuple[SpanContext, otel_types.Attributes]]) -> None: ...
+    def __init__(self, span_name: str, otlp_attributes: dict[str, otel_types.AttributeValue], tracer: _ProxyTracer, json_schema_properties: JsonSchemaProperties, links: Sequence[tuple[SpanContext, otel_types.Attributes]], span_kind: SpanKind = ...) -> None: ...
     def __getattr__(self, name: str) -> Any: ...
     def __enter__(self) -> LogfireSpan: ...
     @handle_internal_errors

logfire-api/logfire_api/_internal/tracer.pyi

@@ -14,10 +14,8 @@ from opentelemetry.sdk.trace.id_generator import IdGenerator
 from opentelemetry.trace import Link as Link, Span, SpanContext, SpanKind, Tracer, TracerProvider
 from opentelemetry.trace.status import Status, StatusCode
 from opentelemetry.util import types as otel_types
-from starlette.exceptions import HTTPException
 from threading import Lock
 from typing import Any, Callable
-from typing_extensions import TypeIs
 from weakref import WeakKeyDictionary, WeakValueDictionary
 
 OPEN_SPANS: WeakValueDictionary[tuple[int, int], _LogfireWrappedSpan]
@@ -116,4 +114,3 @@ def get_sample_rate_from_attributes(attributes: otel_types.Attributes) -> float
 def record_exception(span: trace_api.Span, exception: BaseException, *, attributes: otel_types.Attributes = None, timestamp: int | None = None, escaped: bool = False, callback: ExceptionCallback | None = None) -> None:
     """Similar to the OTEL SDK Span.record_exception method, with our own additions."""
 def set_exception_status(span: trace_api.Span, exception: BaseException): ...
-def is_starlette_http_exception(exception: BaseException) -> TypeIs[HTTPException]: ...

logfire-api/logfire_api/types.pyi

@@ -49,7 +49,6 @@ class ExceptionCallbackHelper:
         - Spans created directly by an OpenTelemetry tracer (e.g. from any `logfire.instrument_*()` method)
             typically don't have a level set, so this will return the default of `info`,
             but `level_is_unset` will be `True`.
-        - FastAPI/Starlette 4xx HTTPExceptions are warnings.
         - Will be a different level if this is created by e.g. `logfire.info(..., _exc_info=True)`.
         """
     @level.setter
@@ -117,7 +116,6 @@ class ExceptionCallbackHelper:
 
         - The level is \'error\' or higher or is unset (see `level_is_unset` for details),
         - No parent span exists in the current process,
-        - The exception isn\'t handled by FastAPI, except if it\'s a 5xx HTTPException.
 
         Example:
             if helper.create_issue:

logfire-api/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "logfire-api"
-version = "4.18.0"
+version = "4.19.0"
 description = "Shim for the Logfire SDK which does nothing unless Logfire is installed"
 authors = [
     { name = "Pydantic Team", email = "[email protected]" },

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "logfire"
-version = "4.18.0"
+version = "4.19.0"
 description = "The best Python observability tool! 🪵🔥"
 requires-python = ">=3.9"
 authors = [