Release v1.2.0

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release Notes
 
+## [v1.2.0] (2024-10-17)
+
+* Add `local` parameter to `logfire.configure()` by @alexmojaki in [#508](https://github.com/pydantic/logfire/pull/508)
+
 ## [v1.1.0] (2024-10-14)
 
 * Fix error in checking for generators in auto-tracing by @alexmojaki in https://github.com/pydantic/logfire/pull/498
@@ -353,3 +357,4 @@ First release from new repo!
 [v1.0.0]: https://github.com/pydantic/logfire/compare/v0.55.0...v1.0.0
 [v1.0.1]: https://github.com/pydantic/logfire/compare/v1.0.0...v1.0.1
 [v1.1.0]: https://github.com/pydantic/logfire/compare/v1.0.1...v1.1.0
+[v1.2.0]: https://github.com/pydantic/logfire/compare/v1.1.0...v1.2.0

logfire-api/logfire_api/_internal/config.pyi

@@ -12,7 +12,7 @@ from .exporters.quiet_metrics import QuietMetricExporter as QuietMetricExporter
 from .exporters.remove_pending import RemovePendingSpansExporter as RemovePendingSpansExporter
 from .exporters.test import TestExporter as TestExporter
 from .integrations.executors import instrument_executors as instrument_executors
-from .main import FastLogfireSpan as FastLogfireSpan, LogfireSpan as LogfireSpan
+from .main import FastLogfireSpan as FastLogfireSpan, Logfire as Logfire, LogfireSpan as LogfireSpan
 from .metrics import ProxyMeterProvider as ProxyMeterProvider
 from .scrubbing import BaseScrubber as BaseScrubber, NOOP_SCRUBBER as NOOP_SCRUBBER, Scrubber as Scrubber, ScrubbingOptions as ScrubbingOptions
 from .stack_info import warn_at_user_stacklevel as warn_at_user_stacklevel
@@ -88,10 +88,12 @@ class CodeSource:
 
 class DeprecatedKwargs(TypedDict): ...
 
-def configure(*, send_to_logfire: bool | Literal['if-token-present'] | None = None, token: str | None = None, service_name: str | None = None, service_version: str | None = None, console: ConsoleOptions | Literal[False] | None = None, config_dir: Path | str | None = None, data_dir: Path | str | None = None, additional_span_processors: Sequence[SpanProcessor] | None = None, metrics: MetricsOptions | Literal[False] | None = None, scrubbing: ScrubbingOptions | Literal[False] | None = None, inspect_arguments: bool | None = None, sampling: SamplingOptions | None = None, code_source: CodeSource | None = None, advanced: AdvancedOptions | None = None, **deprecated_kwargs: Unpack[DeprecatedKwargs]) -> None:
+def configure(*, local: bool = False, send_to_logfire: bool | Literal['if-token-present'] | None = None, token: str | None = None, service_name: str | None = None, service_version: str | None = None, console: ConsoleOptions | Literal[False] | None = None, config_dir: Path | str | None = None, data_dir: Path | str | None = None, additional_span_processors: Sequence[SpanProcessor] | None = None, metrics: MetricsOptions | Literal[False] | None = None, scrubbing: ScrubbingOptions | Literal[False] | None = None, inspect_arguments: bool | None = None, sampling: SamplingOptions | None = None, code_source: CodeSource | None = None, advanced: AdvancedOptions | None = None, **deprecated_kwargs: Unpack[DeprecatedKwargs]) -> Logfire:
     """Configure the logfire SDK.
 
     Args:
+        local: If `True`, configures and returns a `Logfire` instance that is not the default global instance.
+            Use this to create multiple separate configurations, e.g. to send to different projects.
         send_to_logfire: Whether to send logs to logfire.dev. Defaults to the `LOGFIRE_SEND_TO_LOGFIRE` environment
             variable if set, otherwise defaults to `True`. If `if-token-present` is provided, logs will only be sent if
             a token is present.
@@ -153,7 +155,7 @@ class LogfireConfig(_LogfireConfigData):
         See `_LogfireConfigData` for parameter documentation.
         """
     def configure(self, send_to_logfire: bool | Literal['if-token-present'] | None, token: str | None, service_name: str | None, service_version: str | None, console: ConsoleOptions | Literal[False] | None, config_dir: Path | None, data_dir: Path | None, additional_span_processors: Sequence[SpanProcessor] | None, metrics: MetricsOptions | Literal[False] | None, scrubbing: ScrubbingOptions | Literal[False] | None, inspect_arguments: bool | None, sampling: SamplingOptions | None, code_source: CodeSource | None, advanced: AdvancedOptions | None) -> None: ...
-    def initialize(self) -> ProxyTracerProvider:
+    def initialize(self) -> None:
         """Configure internals to start exporting traces and metrics."""
     def force_flush(self, timeout_millis: int = 30000) -> bool:
         """Force flush all spans and metrics.

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

@@ -1,6 +1,7 @@
+from logfire import Logfire as Logfire
 from typing import Any
 
-def instrument_aiohttp_client(**kwargs: Any):
+def instrument_aiohttp_client(logfire_instance: Logfire, **kwargs: Any):
     """Instrument the `aiohttp` module so that spans are automatically created for each client request.
 
     See the `Logfire.instrument_aiohttp_client` method for details.

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

@@ -1,9 +1,10 @@
+from logfire import Logfire as Logfire
 from typing_extensions import TypedDict, Unpack
 
 class AsyncPGInstrumentKwargs(TypedDict, total=False):
     skip_dep_check: bool
 
-def instrument_asyncpg(**kwargs: Unpack[AsyncPGInstrumentKwargs]) -> None:
+def instrument_asyncpg(logfire_instance: Logfire, **kwargs: Unpack[AsyncPGInstrumentKwargs]) -> None:
     """Instrument the `asyncpg` module so that spans are automatically created for each query.
 
     See the `Logfire.instrument_asyncpg` method for details.

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

@@ -1,9 +1,10 @@
+from logfire import Logfire as Logfire
 from typing_extensions import TypedDict, Unpack
 
 class CeleryInstrumentKwargs(TypedDict, total=False):
     skip_dep_check: bool
 
-def instrument_celery(**kwargs: Unpack[CeleryInstrumentKwargs]) -> None:
+def instrument_celery(logfire_instance: Logfire, **kwargs: Unpack[CeleryInstrumentKwargs]) -> None:
     """Instrument the `celery` module so that spans are automatically created for each task.
 
     See the `Logfire.instrument_celery` method for details.

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

@@ -1,7 +1,8 @@
+from logfire import Logfire as Logfire
 from logfire._internal.utils import maybe_capture_server_headers as maybe_capture_server_headers
 from typing import Any
 
-def instrument_django(*, capture_headers: bool = False, **kwargs: Any):
+def instrument_django(logfire_instance: Logfire, *, capture_headers: bool = False, **kwargs: Any):
     """Instrument the `django` module so that spans are automatically created for each web request.
 
     See the `Logfire.instrument_django` method for details.

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

@@ -1,4 +1,5 @@
 from flask.app import Flask
+from logfire import Logfire as Logfire
 from logfire._internal.utils import maybe_capture_server_headers as maybe_capture_server_headers
 from opentelemetry.trace import Span
 from typing_extensions import Protocol, TypedDict, Unpack
@@ -17,7 +18,7 @@ class FlaskInstrumentKwargs(TypedDict, total=False):
     enable_commenter: bool | None
     commenter_options: dict[str, str] | None
 
-def instrument_flask(app: Flask, capture_headers: bool = False, **kwargs: Unpack[FlaskInstrumentKwargs]):
+def instrument_flask(logfire_instance: Logfire, app: Flask, capture_headers: bool = False, **kwargs: Unpack[FlaskInstrumentKwargs]):
     """Instrument `app` so that spans are automatically created for each request.
 
     See the `Logfire.instrument_flask` method for details.

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

@@ -1,4 +1,5 @@
 from _typeshed import Incomplete
+from logfire import Logfire as Logfire
 from typing import TypedDict, Unpack
 
 RequestHook: Incomplete
@@ -13,7 +14,7 @@ class HTTPXInstrumentKwargs(TypedDict, total=False):
     async_response_hook: AsyncResponseHook
     skip_dep_check: bool
 
-def instrument_httpx(**kwargs: Unpack[HTTPXInstrumentKwargs]) -> None:
+def instrument_httpx(logfire_instance: Logfire, **kwargs: Unpack[HTTPXInstrumentKwargs]) -> None:
     """Instrument the `httpx` module so that spans are automatically created for each request.
 
     See the `Logfire.instrument_httpx` method for details.

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

@@ -1,23 +1,15 @@
 from mysql.connector.abstracts import MySQLConnectionAbstract
 from mysql.connector.pooling import PooledMySQLConnection
+from opentelemetry.trace import TracerProvider
 from typing_extensions import TypeVar, TypedDict, Unpack
 
 MySQLConnection = TypeVar('MySQLConnection', bound=PooledMySQLConnection | MySQLConnectionAbstract | None)
 
 class MySQLInstrumentKwargs(TypedDict, total=False):
     skip_dep_check: bool
 
-def instrument_mysql(conn: MySQLConnection = None, **kwargs: Unpack[MySQLInstrumentKwargs]) -> MySQLConnection:
+def instrument_mysql(*, conn: MySQLConnection = None, tracer_provider: TracerProvider, **kwargs: Unpack[MySQLInstrumentKwargs]) -> MySQLConnection:
     """Instrument the `mysql` module or a specific MySQL connection so that spans are automatically created for each operation.
 
-    This function uses the OpenTelemetry MySQL Instrumentation library to instrument either the entire `mysql` module or a specific MySQL connection.
-
-    Args:
-        conn: The MySQL connection to instrument. If None, the entire `mysql` module is instrumented.
-        **kwargs: Additional keyword arguments to pass to the OpenTelemetry `instrument` methods.
-
-    Returns:
-        If a connection is provided, returns the instrumented connection. If no connection is provided, returns None.
-
     See the `Logfire.instrument_mysql` method for details.
     """

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

@@ -1,4 +1,5 @@
 from _typeshed import Incomplete
+from logfire import Logfire as Logfire
 from opentelemetry.instrumentation.psycopg import PsycopgInstrumentor
 from opentelemetry.instrumentation.psycopg2 import Psycopg2Instrumentor
 from typing import Any
@@ -17,7 +18,7 @@ class PsycopgInstrumentKwargs(TypedDict, total=False):
 
 PACKAGE_NAMES: Incomplete
 
-def instrument_psycopg(conn_or_module: Any = None, **kwargs: Unpack[PsycopgInstrumentKwargs]) -> None:
+def instrument_psycopg(logfire_instance: Logfire, conn_or_module: Any = None, **kwargs: Unpack[PsycopgInstrumentKwargs]) -> None:
     """Instrument a `psycopg` connection or module so that spans are automatically created for each query.
 
     See the `Logfire.instrument_psycopg` method for details.

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

@@ -1,6 +1,7 @@
+from logfire import Logfire as Logfire
 from typing import Any
 
-def instrument_requests(excluded_urls: str | None = None, **kwargs: Any):
+def instrument_requests(logfire_instance: Logfire, excluded_urls: str | None = None, **kwargs: Any):
     """Instrument the `requests` module so that spans are automatically created for each request.
 
     See the `Logfire.instrument_requests` method for details.

logfire-api/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "logfire-api"
-version = "1.1.0"
+version = "1.2.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 = "1.1.0"
+version = "1.2.0"
 description = "The best Python observability tool! 🪵🔥"
 requires-python = ">=3.8"
 authors = [