prefect 3.4.15.dev4__tar.gz → 3.4.16.dev2__tar.gz

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect
-Version: 3.4.15.dev4
+Version: 3.4.16.dev2
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/pyproject.toml

@@ -159,7 +159,7 @@ dev = [
     "watchfiles>=1.0.4",
     "respx>=0.22.0",
     "codespell==2.4.1",
-    "ruff==0.12.10",
+    "ruff==0.12.11",
     "mypy==1.15.0",
     "types-cachetools>=5.3.1",
     "types-PyYAML>=6.0.12",

prefect-3.4.16.dev2/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.4.16.dev2"
+__build_date__ = "2025-08-31 08:08:14.206300+00:00"
+__git_commit__ = "3d77c2f890dbab8b4dcc7771133e471359733e78"
+__dirty__ = False

prefect-3.4.16.dev2/src/prefect/cli/events.py

@@ -0,0 +1,185 @@
+import asyncio
+import json
+from enum import Enum
+from typing import Optional
+
+import orjson
+import typer
+import websockets
+from anyio import open_file
+
+from prefect.cli._types import PrefectTyper
+from prefect.cli._utilities import exit_with_error
+from prefect.cli.root import app
+from prefect.events import Event
+from prefect.events.clients import (
+    PrefectCloudAccountEventSubscriber,
+    get_events_client,
+    get_events_subscriber,
+)
+
+events_app: PrefectTyper = PrefectTyper(name="events", help="Stream events.")
+app.add_typer(events_app, aliases=["event"])
+
+
+class StreamFormat(str, Enum):
+    json = "json"
+    text = "text"
+
+
+@events_app.command()
+async def stream(
+    format: StreamFormat = typer.Option(
+        StreamFormat.json, "--format", help="Output format (json or text)"
+    ),
+    output_file: str = typer.Option(
+        None, "--output-file", help="File to write events to"
+    ),
+    account: bool = typer.Option(
+        False,
+        "--account",
+        help="Stream events for entire account, including audit logs",
+    ),
+    run_once: bool = typer.Option(False, "--run-once", help="Stream only one event"),
+):
+    """Subscribes to the event stream of a workspace, printing each event
+    as it is received. By default, events are printed as JSON, but can be
+    printed as text by passing `--format text`.
+    """
+
+    try:
+        if account:
+            events_subscriber = PrefectCloudAccountEventSubscriber()
+        else:
+            events_subscriber = get_events_subscriber()
+
+        app.console.print("Subscribing to event stream...")
+        async with events_subscriber as subscriber:
+            async for event in subscriber:
+                await handle_event(event, format, output_file)
+                if run_once:
+                    typer.Exit(0)
+    except Exception as exc:
+        handle_error(exc)
+
+
+async def handle_event(event: Event, format: StreamFormat, output_file: str) -> None:
+    if format == StreamFormat.json:
+        event_data = orjson.dumps(event.model_dump(), default=str).decode()
+    elif format == StreamFormat.text:
+        event_data = f"{event.occurred.isoformat()} {event.event} {event.resource.id}"
+    else:
+        raise ValueError(f"Unknown format: {format}")
+    if output_file:
+        async with open_file(output_file, "a") as f:  # type: ignore
+            await f.write(event_data + "\n")
+    else:
+        print(event_data)
+
+
+def handle_error(exc: Exception) -> None:
+    if isinstance(exc, websockets.exceptions.ConnectionClosedError):
+        exit_with_error(f"Connection closed, retrying... ({exc})")
+    elif isinstance(exc, (KeyboardInterrupt, asyncio.exceptions.CancelledError)):
+        exit_with_error("Exiting...")
+    elif isinstance(exc, (PermissionError)):
+        exit_with_error(f"Error writing to file: {exc}")
+    else:
+        exit_with_error(f"An unexpected error occurred: {exc}")
+
+
+@events_app.command()
+async def emit(
+    event: str = typer.Argument(help="The name of the event"),
+    resource: str = typer.Option(
+        None,
+        "--resource",
+        "-r",
+        help="Resource specification as 'key=value' or JSON. Can be used multiple times.",
+    ),
+    resource_id: str = typer.Option(
+        None,
+        "--resource-id",
+        help="The resource ID (shorthand for --resource prefect.resource.id=<id>)",
+    ),
+    related: Optional[str] = typer.Option(
+        None,
+        "--related",
+        help="Related resources as JSON string",
+    ),
+    payload: Optional[str] = typer.Option(
+        None,
+        "--payload",
+        "-p",
+        help="Event payload as JSON string",
+    ),
+):
+    """Emit a single event to Prefect.
+
+    Examples:
+        # Simple event with resource ID
+        prefect event emit user.logged_in --resource-id user-123
+
+        # Event with payload
+        prefect event emit order.shipped --resource-id order-456 --payload '{"tracking": "ABC123"}'
+
+        # Event with full resource specification
+        prefect event emit customer.subscribed --resource '{"prefect.resource.id": "customer-789", "prefect.resource.name": "ACME Corp"}'
+    """
+    resource_dict = {}
+
+    if resource:
+        try:
+            parsed = json.loads(resource)
+            if not isinstance(parsed, dict):
+                exit_with_error(
+                    "Resource must be a JSON object, not an array or string"
+                )
+            resource_dict = parsed
+        except json.JSONDecodeError:
+            if "=" in resource:
+                key, value = resource.split("=", 1)
+                resource_dict[key] = value
+            else:
+                exit_with_error("Resource must be JSON or 'key=value' format")
+
+    if resource_id:
+        resource_dict["prefect.resource.id"] = resource_id
+
+    if "prefect.resource.id" not in resource_dict:
+        exit_with_error("Resource must include 'prefect.resource.id'")
+
+    related_list = None
+    if related:
+        try:
+            parsed_related = json.loads(related)
+            if isinstance(parsed_related, dict):
+                related_list = [parsed_related]
+            elif isinstance(parsed_related, list):
+                related_list = parsed_related
+            else:
+                exit_with_error("Related resources must be a JSON object or array")
+        except json.JSONDecodeError:
+            exit_with_error("Related resources must be valid JSON")
+
+    payload_dict = None
+    if payload:
+        try:
+            parsed_payload = json.loads(payload)
+            if not isinstance(parsed_payload, dict):
+                exit_with_error("Payload must be a JSON object")
+            payload_dict = parsed_payload
+        except json.JSONDecodeError:
+            exit_with_error("Payload must be valid JSON")
+
+    event_obj = Event(
+        event=event,
+        resource=resource_dict,
+        related=related_list or [],
+        payload=payload_dict or {},
+    )
+
+    async with get_events_client() as events_client:
+        await events_client.emit(event_obj)
+
+    app.console.print(f"Successfully emitted event '{event}' with ID {event_obj.id}")

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/client/orchestration/_artifacts/client.py

@@ -5,6 +5,7 @@ from pydantic import Field
 from typing_extensions import TypedDict, Unpack
 
 from prefect.client.orchestration.base import BaseAsyncClient, BaseClient
+from prefect.events.utilities import emit_event
 from prefect.exceptions import ObjectNotFound
 
 if TYPE_CHECKING:
@@ -49,7 +50,31 @@ class ArtifactClient(BaseClient):
         )
         from prefect.client.schemas.objects import Artifact
 
-        return Artifact.model_validate(response.json())
+        created = Artifact.model_validate(response.json())
+
+        # Emit an event for artifact creation
+        resource = {
+            "prefect.resource.id": f"prefect.artifact.{created.id}",
+        }
+        if created.key:
+            resource["prefect.resource.name"] = created.key
+
+        payload = {
+            k: v
+            for k, v in {
+                "key": created.key,
+                "type": created.type,
+                "description": created.description,
+            }.items()
+        }
+
+        emit_event(
+            event="prefect.artifact.created",
+            resource=resource,
+            payload=payload,
+        )
+
+        return created
 
     def update_artifact(self, artifact_id: "UUID", artifact: "ArtifactUpdate") -> None:
         self.request(
@@ -58,6 +83,16 @@ class ArtifactClient(BaseClient):
             json=artifact.model_dump(mode="json", exclude_unset=True),
             path_params={"id": artifact_id},
         )
+        # Emit an event for artifact update
+        resource = {
+            "prefect.resource.id": f"prefect.artifact.{artifact_id}",
+        }
+        payload = artifact.model_dump(mode="json", exclude_unset=True)
+        emit_event(
+            event="prefect.artifact.updated",
+            resource=resource,
+            payload=payload,
+        )
         return None
 
     def delete_artifact(self, artifact_id: "UUID") -> None:
@@ -115,7 +150,32 @@ class ArtifactAsyncClient(BaseAsyncClient):
         )
         from prefect.client.schemas.objects import Artifact
 
-        return Artifact.model_validate(response.json())
+        created = Artifact.model_validate(response.json())
+
+        # Emit an event for artifact creation
+        resource = {
+            "prefect.resource.id": f"prefect.artifact.{created.id}",
+        }
+        if created.key:
+            resource["prefect.resource.name"] = created.key
+
+        payload = {
+            k: v
+            for k, v in {
+                "key": created.key,
+                "type": created.type,
+                "description": created.description,
+            }.items()
+            if v is not None
+        }
+
+        emit_event(
+            event="prefect.artifact.created",
+            resource=resource,
+            payload=payload,
+        )
+
+        return created
 
     async def update_artifact(
         self, artifact_id: "UUID", artifact: "ArtifactUpdate"
@@ -126,6 +186,16 @@ class ArtifactAsyncClient(BaseAsyncClient):
             path_params={"id": artifact_id},
             json=artifact.model_dump(mode="json", exclude_unset=True),
         )
+        # Emit an event for artifact update
+        resource = {
+            "prefect.resource.id": f"prefect.artifact.{artifact_id}",
+        }
+        payload = artifact.model_dump(mode="json", exclude_unset=True)
+        emit_event(
+            event="prefect.artifact.updated",
+            resource=resource,
+            payload=payload or None,
+        )
         return None
 
     async def read_artifacts(

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/api/server.py

@@ -18,7 +18,7 @@ import sqlite3
 import subprocess
 import sys
 import time
-from contextlib import asynccontextmanager
+from contextlib import AsyncExitStack, asynccontextmanager
 from functools import wraps
 from hashlib import sha256
 from typing import TYPE_CHECKING, Any, AsyncGenerator, Awaitable, Callable, Optional
@@ -47,7 +47,7 @@ from prefect.client.constants import SERVER_API_VERSION
 from prefect.logging import get_logger
 from prefect.server.api.dependencies import EnforceMinimumAPIVersion
 from prefect.server.exceptions import ObjectNotFoundError
-from prefect.server.services.base import RunInAllServers, Service
+from prefect.server.services.base import RunInEphemeralServers, Service
 from prefect.server.utilities.database import get_dialect
 from prefect.settings import (
     PREFECT_API_DATABASE_CONNECTION_URL,
@@ -644,18 +644,21 @@ def create_app(
 
     @asynccontextmanager
     async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
-        if app not in LIFESPAN_RAN_FOR_APP:
-            await run_migrations()
-            await add_block_types()
+        if app in LIFESPAN_RAN_FOR_APP:
+            yield
+            return
 
-            Services: type[Service] = Service
-            if ephemeral or webserver_only:
-                Services = RunInAllServers
+        await run_migrations()
+        await add_block_types()
 
-            async with Services.running():
-                LIFESPAN_RAN_FOR_APP.add(app)
-                yield
-        else:
+        Services: type[Service] | None = (
+            None if webserver_only else RunInEphemeralServers if ephemeral else Service
+        )
+
+        async with AsyncExitStack() as stack:
+            if Services:
+                await stack.enter_async_context(Services.running())
+            LIFESPAN_RAN_FOR_APP.add(app)
             yield
 
     def on_service_exit(service: Service, task: asyncio.Task[None]) -> None:

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/events/ordering/__init__.py

@@ -88,11 +88,15 @@ class CausalOrdering(abc.ABC):
 
 
 def get_triggers_causal_ordering() -> CausalOrdering:
-    from prefect.server.events.ordering.db import (
-        CausalOrdering as TriggersCausalOrdering,
-    )
+    import_path = get_current_settings().server.events.causal_ordering
+    causal_ordering_module = importlib.import_module(import_path)
+
+    if not isinstance(causal_ordering_module, CausalOrderingModule):
+        raise ValueError(
+            f"Module at {import_path} does not export a CausalOrdering class. Please check your server.events.causal_ordering setting."
+        )
 
-    return TriggersCausalOrdering(scope="")
+    return causal_ordering_module.CausalOrdering(scope="triggers")
 
 
 def get_task_run_recorder_causal_ordering() -> CausalOrdering:

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/events/services/actions.py

@@ -5,7 +5,7 @@ from typing import TYPE_CHECKING, NoReturn
 
 from prefect.logging import get_logger
 from prefect.server.events import actions
-from prefect.server.services.base import RunInAllServers, Service
+from prefect.server.services.base import RunInEphemeralServers, Service
 from prefect.server.utilities.messaging import Consumer, create_consumer
 from prefect.server.utilities.messaging._consumer_names import (
     generate_unique_consumer_name,
@@ -19,7 +19,7 @@ if TYPE_CHECKING:
 logger: "logging.Logger" = get_logger(__name__)
 
 
-class Actions(RunInAllServers, Service):
+class Actions(RunInEphemeralServers, Service):
     """Runs the actions triggered by automations"""
 
     consumer_task: asyncio.Task[None] | None = None

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/events/services/event_logger.py

@@ -7,7 +7,7 @@ import rich
 
 from prefect.logging import get_logger
 from prefect.server.events.schemas.events import ReceivedEvent
-from prefect.server.services.base import RunInAllServers, Service
+from prefect.server.services.base import RunInEphemeralServers, Service
 from prefect.server.utilities.messaging import Consumer, Message, create_consumer
 from prefect.server.utilities.messaging._consumer_names import (
     generate_unique_consumer_name,
@@ -22,7 +22,7 @@ if TYPE_CHECKING:
 logger: "logging.Logger" = get_logger(__name__)
 
 
-class EventLogger(RunInAllServers, Service):
+class EventLogger(RunInEphemeralServers, Service):
     """A debugging service that logs events to the console as they arrive."""
 
     consumer_task: asyncio.Task[None] | None = None

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/events/services/event_persister.py

@@ -17,7 +17,7 @@ from prefect.logging import get_logger
 from prefect.server.database import provide_database_interface
 from prefect.server.events.schemas.events import ReceivedEvent
 from prefect.server.events.storage.database import write_events
-from prefect.server.services.base import RunInAllServers, Service
+from prefect.server.services.base import RunInEphemeralServers, Service
 from prefect.server.utilities.messaging import (
     Consumer,
     Message,
@@ -80,7 +80,7 @@ async def batch_delete(
     return total_deleted
 
 
-class EventPersister(RunInAllServers, Service):
+class EventPersister(RunInEphemeralServers, Service):
     """A service that persists events to the database as they arrive."""
 
     consumer_task: asyncio.Task[None] | None = None

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/events/services/triggers.py

@@ -5,7 +5,7 @@ from typing import TYPE_CHECKING, Any, NoReturn, Optional
 
 from prefect.logging import get_logger
 from prefect.server.events import triggers
-from prefect.server.services.base import LoopService, RunInAllServers, Service
+from prefect.server.services.base import LoopService, RunInEphemeralServers, Service
 from prefect.server.utilities.messaging import Consumer, create_consumer
 from prefect.server.utilities.messaging._consumer_names import (
     generate_unique_consumer_name,
@@ -21,7 +21,7 @@ if TYPE_CHECKING:
 logger: "logging.Logger" = get_logger(__name__)
 
 
-class ReactiveTriggers(RunInAllServers, Service):
+class ReactiveTriggers(RunInEphemeralServers, Service):
     """Evaluates reactive automation triggers"""
 
     consumer_task: asyncio.Task[None] | None = None
@@ -61,7 +61,7 @@ class ReactiveTriggers(RunInAllServers, Service):
         logger.debug("Reactive triggers stopped")
 
 
-class ProactiveTriggers(RunInAllServers, LoopService):
+class ProactiveTriggers(RunInEphemeralServers, LoopService):
     """Evaluates proactive automation triggers"""
 
     @classmethod

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/events/stream.py

@@ -16,7 +16,7 @@ from typing import (
 from prefect.logging import get_logger
 from prefect.server.events.filters import EventFilter
 from prefect.server.events.schemas.events import ReceivedEvent
-from prefect.server.services.base import RunInAllServers, Service
+from prefect.server.services.base import RunInEphemeralServers, Service
 from prefect.server.utilities import messaging
 from prefect.settings.context import get_current_settings
 from prefect.settings.models.server.services import ServicesBaseSetting
@@ -136,7 +136,7 @@ async def stop_distributor() -> None:
         pass
 
 
-class Distributor(RunInAllServers, Service):
+class Distributor(RunInEphemeralServers, Service):
     name: str = "Distributor"
 
     @classmethod

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/events/triggers.py

@@ -217,6 +217,32 @@ async def evaluate(
                 "meets_threshold": meets_threshold,
             },
         )
+
+        # Special case of a proactive trigger for which the same event satisfies
+        # both `after` and `expect`.  For example, using flow run heartbeats for crash
+        # detection, after the first heartbeat we expect a subsequent heartbeat or
+        # terminal state within a given time.
+        #
+        # If we've already reached the proactive threshold, we need to remove the
+        # current bucket and start a new one for the latest event.
+        if (
+            triggering_event
+            and trigger.posture == Posture.Proactive
+            and not meets_threshold
+            and trigger.starts_after(triggering_event.event)
+            and trigger.expects(triggering_event.event)
+        ):
+            await remove_bucket(session, bucket)
+            return await start_new_bucket(
+                session,
+                trigger,
+                bucketing_key=bucket.bucketing_key,
+                start=triggering_event.occurred,
+                end=triggering_event.occurred + trigger.within,
+                count=0,
+                last_event=triggering_event,
+            )
+
         return bucket
     else:
         # Case #2 from the implementation notes above.
@@ -866,6 +892,7 @@ async def start_new_bucket(
     end: prefect.types._datetime.DateTime,
     count: int,
     triggered_at: Optional[prefect.types._datetime.DateTime] = None,
+    last_event: Optional[ReceivedEvent] = None,
 ) -> "ORMAutomationBucket":
     """Ensures that a bucket with the given start and end exists with the given count,
     returning the new bucket"""
@@ -882,6 +909,7 @@ async def start_new_bucket(
             count=count,
             last_operation="start_new_bucket[insert]",
             triggered_at=triggered_at,
+            last_event=last_event,
         )
         .on_conflict_do_update(
             index_elements=[
@@ -896,6 +924,7 @@ async def start_new_bucket(
                 last_operation="start_new_bucket[update]",
                 updated=prefect.types._datetime.now("UTC"),
                 triggered_at=triggered_at,
+                last_event=last_event,
             ),
         )
     )

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/logs/stream.py

@@ -17,7 +17,7 @@ from typing import (
 from prefect.logging import get_logger
 from prefect.server.schemas.core import Log
 from prefect.server.schemas.filters import LogFilter
-from prefect.server.services.base import RunInAllServers, Service
+from prefect.server.services.base import RunInEphemeralServers, Service
 from prefect.server.utilities import messaging
 from prefect.settings.context import get_current_settings
 from prefect.settings.models.server.services import ServicesBaseSetting
@@ -217,7 +217,7 @@ async def stop_distributor() -> None:
         pass
 
 
-class LogDistributor(RunInAllServers, Service):
+class LogDistributor(RunInEphemeralServers, Service):
     """Service for distributing logs to websocket subscribers"""
 
     name: str = "LogDistributor"

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/services/base.py

@@ -148,10 +148,9 @@ class Service(ABC):
         self.logger = get_logger(f"server.services.{self.name.lower()}")
 
 
-class RunInAllServers(Service, abc.ABC):
+class RunInEphemeralServers(Service, abc.ABC):
     """
-    A marker class for services that should run in all server processes, both the
-    web server and the standalone services process.
+    A marker class for services that should run even when running an ephemeral server
     """
 
     pass

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/services/task_run_recorder.py

@@ -22,7 +22,7 @@ from prefect.server.events.ordering import (
 from prefect.server.events.schemas.events import ReceivedEvent
 from prefect.server.schemas.core import TaskRun
 from prefect.server.schemas.states import State
-from prefect.server.services.base import RunInAllServers, Service
+from prefect.server.services.base import RunInEphemeralServers, Service
 from prefect.server.utilities.messaging import (
     Consumer,
     Message,
@@ -240,7 +240,7 @@ async def consumer() -> AsyncGenerator[MessageHandler, None]:
             logger.info("Periodically process followers task cancelled successfully")
 
 
-class TaskRunRecorder(RunInAllServers, Service):
+class TaskRunRecorder(RunInEphemeralServers, Service):
     """Constructs task runs and states from client-emitted events"""
 
     consumer_task: asyncio.Task[None] | None = None

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/server/services/telemetry.py

@@ -16,14 +16,14 @@ from prefect.server.database import PrefectDBInterface
 from prefect.server.database.dependencies import db_injector
 from prefect.server.models import configuration
 from prefect.server.schemas.core import Configuration
-from prefect.server.services.base import LoopService, RunInAllServers
+from prefect.server.services.base import LoopService, RunInEphemeralServers
 from prefect.settings import PREFECT_DEBUG_MODE
 from prefect.settings.context import get_current_settings
 from prefect.settings.models.server.services import ServicesBaseSetting
 from prefect.types._datetime import now
 
 
-class Telemetry(RunInAllServers, LoopService):
+class Telemetry(RunInEphemeralServers, LoopService):
     """
     Sends anonymous data to Prefect to help us improve
 

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/settings/base.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import inspect
+import json
 from functools import partial
 from typing import Any
 
@@ -235,4 +236,6 @@ def _to_environment_variable_value(
 ) -> str:
     if isinstance(value, (list, set, tuple)):
         return ",".join(str(v) for v in value)
+    if isinstance(value, dict):
+        return json.dumps(value)
     return str(value)

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/utilities/services.py

@@ -175,7 +175,7 @@ def start_client_metrics_server() -> None:
 
 
 def stop_client_metrics_server() -> None:
-    """Start the process-wide Prometheus metrics server for client metrics, if it has
+    """Stop the process-wide Prometheus metrics server for client metrics, if it has
     previously been started"""
     global _metrics_server
     if _metrics_server:

{prefect-3.4.15.dev4 → prefect-3.4.16.dev2}/src/prefect/workers/base.py

@@ -78,7 +78,11 @@ from prefect.tasks import Task
 from prefect.types import KeyValueLabels
 from prefect.utilities.dispatch import get_registry_for_type, register_base_type
 from prefect.utilities.engine import propose_state
-from prefect.utilities.services import critical_service_loop
+from prefect.utilities.services import (
+    critical_service_loop,
+    start_client_metrics_server,
+    stop_client_metrics_server,
+)
 from prefect.utilities.slugify import slugify
 from prefect.utilities.templating import (
     apply_values,
@@ -657,6 +661,8 @@ class BaseWorker(abc.ABC, Generic[C, V, R]):
 
                     self._started_event = await self._emit_worker_started_event()
 
+                    start_client_metrics_server()
+
                     if with_healthcheck:
                         from prefect.workers.server import build_healthcheck_server
 
@@ -674,6 +680,8 @@ class BaseWorker(abc.ABC, Generic[C, V, R]):
                         healthcheck_thread.start()
                     printer(f"Worker {worker.name!r} started!")
         finally:
+            stop_client_metrics_server()
+
             if healthcheck_server and healthcheck_thread:
                 self._logger.debug("Stopping healthcheck server...")
                 healthcheck_server.should_exit = True