Add PREFECT_LOGGING_ORION_WHEN_MISSING_FLOW setting to handle error raised when logs outside of flow run context

src/prefect/logging/handlers.py

@@ -26,6 +26,7 @@
     PREFECT_LOGGING_ORION_BATCH_SIZE,
     PREFECT_LOGGING_ORION_ENABLED,
     PREFECT_LOGGING_ORION_MAX_LOG_SIZE,
+    PREFECT_LOGGING_ORION_WHEN_MISSING_FLOW,
 )
 
 
@@ -285,8 +286,13 @@ def handleError(self, record: logging.LogRecord) -> None:
         # Warn when a logger is used outside of a run context, the stack level here
         # gets us to the user logging call
         if isinstance(exc, MissingContextError):
-            warnings.warn(exc, stacklevel=8)
-            return
+            if PREFECT_LOGGING_ORION_WHEN_MISSING_FLOW.value() == "warn":
+                warnings.warn(str(exc), stacklevel=8)
+                return
+            elif PREFECT_LOGGING_ORION_WHEN_MISSING_FLOW.value() == "ignore":
+                return
+            else:
+                raise exc
 
         # Display a longer traceback for other errors
         return super().handleError(record)

src/prefect/settings.py

@@ -53,6 +53,7 @@
     Generic,
     Iterable,
     List,
+    Literal,
     Mapping,
     Optional,
     Set,
@@ -583,6 +584,20 @@ def default_cloud_ui_url(settings, value):
 )
 """The maximum size in bytes for a single log."""
 
+PREFECT_LOGGING_ORION_WHEN_MISSING_FLOW = Setting(
+    Literal["warn", "error", "ignore"],
+    default="warn",
+)
+"""
+Controls the behavior when logs are attempted to be sent to Orion without a flow run id.
+The Orion log handler can only send logs within flow run contexts unless the flow run id is
+manually provided.
+
+"warn": Log a warning message.
+"error": Raise an error.
+"ignore": Do not log a warning message or raise an error.
+"""
+
 PREFECT_LOGGING_COLORS = Setting(
     bool,
     default=True,