This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 4e981d77056 Docs: Add RedisTaskHandler configuration example (#63898)
4e981d77056 is described below
commit 4e981d770565bb6829a01b5d666abcf504746ca4
Author: Subham <[email protected]>
AuthorDate: Fri Mar 20 17:23:15 2026 +0530
Docs: Add RedisTaskHandler configuration example (#63898)
---
providers/redis/docs/logging/index.rst | 26 ++++++++++++++++++++++++++
1 file changed, 26 insertions(+)
diff --git a/providers/redis/docs/logging/index.rst
b/providers/redis/docs/logging/index.rst
index 6dea5fff2b9..9b6551390da 100644
--- a/providers/redis/docs/logging/index.rst
+++ b/providers/redis/docs/logging/index.rst
@@ -22,3 +22,29 @@ Writing logs to Redis
Airflow can be configured to store log lines in Redis up to a configured
maximum log lines, always keeping the most recent, up to a configured TTL. This
deviates from other existing task handlers in that it accepts a connection ID.
This allows it to be used in addition to other handlers, and so allows a
graceful/reversible transition from one logging system to another. This is
particularly useful in situations that use Redis as a message broker, where
additional infrastructure isn't desired.
+
+Configuring logging
+-------------------
+
+To enable this feature, ``airflow.cfg`` must be configured as in this example:
+
+.. code-block:: ini
+
+ [logging]
+ remote_logging = True
+ remote_log_conn_id = redis_default
+
+ [redis]
+ # Optional configurations
+ # max_lines = 10000
+ # ttl_seconds = 2419200
+
+Airflow uses the :ref:`Redis Connection <howto/connection:redis>` to connect
to the Redis cluster.
+If you have a connection with ID ``redis_default`` properly set up, Airflow
will use it to read and write logs.
+
+Key template
+------------
+
+Logs are stored in Redis using keys generated with a template. The default
template is
+``dag_id={dag_id}/run_id={run_id}/task_id={task_id}/attempt={try_number}.log``.
+Each key holds a Redis List containing the log lines.
