This is an automated email from the ASF dual-hosted git repository. ephraimanierobi pushed a commit to branch sync_v2_10_test in repository https://gitbox.apache.org/repos/asf/airflow.git
commit d3a8849c045b10715ac0e6d6e51c2a93c45ab3bd Author: Wei Lee <[email protected]> AuthorDate: Tue Sep 3 10:55:55 2024 +0800 Add warning that listeners can be dangerous (#41968) They are necessarily dangerous, but simply due to the way they are integrated into Airflow, their side effects can be pretty impactful. Co-authored-by: Jed Cunningham <[email protected]> --- docs/apache-airflow/administration-and-deployment/listeners.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/apache-airflow/administration-and-deployment/listeners.rst b/docs/apache-airflow/administration-and-deployment/listeners.rst index a8dbda4c5d..34909e225a 100644 --- a/docs/apache-airflow/administration-and-deployment/listeners.rst +++ b/docs/apache-airflow/administration-and-deployment/listeners.rst @@ -21,6 +21,11 @@ Listeners You can write listeners to enable Airflow to notify you when events happen. `Pluggy <https://pluggy.readthedocs.io/en/stable/>`__ powers these listeners. +.. warning:: + + Listeners are an advanced feature of Airflow. They are not isolated from the Airflow components they run in, and + can slow down or in come cases take down your Airflow instance. As such, extra care should be taken when writing listeners. + Airflow supports notifications for the following events: Lifecycle Events
