Hello, I think I know the answer to this but I am wondering if there are options. We have a situation where some flow runs purposely throw warnings which is mainly to tell us that a certain unfavorable condition exists and is not bad enough to fail the run. We would like to create an Automation notification when this occurs. Since there doesn't appear to be a flow-run state of warn or warning, it doesn't seem like we can create a notification around it using the Cloud UI. Is that true? My other thought is that we would have to handle this within the code and manually generate the notification within the code, which means we will then have to ensure the message format follows what we have setup for our other Automation notifications. Is this our only other option?

Yeah, since warnings are just a log level and not a state, there's nothing preexisting you can use in Automations for them. You can, however, call a function in your code that sends a message to whatever destination you're using for notifications.

Thanks Kevin. That's what I was assuming we were going to need to do.

It's likely that all the things you want to include in your notification are available in your flow run via runtime.

Agreed

You could also emit a custom event, and set up an automation to react to that event.

Tell me more about the custom event. I started reading a little bit about them but was confused as to how to actually emit them. Is there a code example out there that I could take a look at?

yep you can just call

emit_event

https://docs.prefect.io/latest/cloud/events/#emit-custom-events-from-python-code

Ok. That might be an easy option as well. Thanks for that

here's a quick example I emit a custom event from my flow:

from prefect import flow, get_run_logger
from prefect.events import emit_event

@flow
def warning_event():
    # something acceptably bad happened
    get_run_logger().warning("This is a warning")
    emit_event(event="custom_events.logging.Warning", resource={"prefect.resource.id": "custom_events.event"})

I see it in my event feed, click on it, then click the three dots and click "Automate"

Awesome!