[airflow] branch taskflow-context-variables-and-logging created (now ae8ca7dab1)

[ma...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

malthe pushed a change to branch taskflow-context-variables-and-logging
in repository https://gitbox.apache.org/repos/asf/airflow.git


      at ae8ca7dab1 Mention context variables and logging

This branch includes the following new commits:

     new ae8ca7dab1 Mention context variables and logging

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.

[airflow] 01/01: Mention context variables and logging

[ma...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

malthe pushed a commit to branch taskflow-context-variables-and-logging
in repository https://gitbox.apache.org/repos/asf/airflow.git

commit ae8ca7dab16c64002cf41e8db6ec4a0dcd9241a9
Author: Malthe Borch <mb...@gmail.com>
AuthorDate: Tue Jun 7 18:58:48 2022 +0000

    Mention context variables and logging
---
 docs/apache-airflow/concepts/taskflow.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/apache-airflow/concepts/taskflow.rst b/docs/apache-airflow/concepts/taskflow.rst
index 4cfc91f821..dea009ad95 100644
--- a/docs/apache-airflow/concepts/taskflow.rst
+++ b/docs/apache-airflow/concepts/taskflow.rst
@@ -63,6 +63,24 @@ You can also use a plain value or variable to call a TaskFlow function - for exa
 
 If you want to learn more about using TaskFlow, you should consult :doc:`the TaskFlow tutorial </tutorial_taskflow_api>`.
 
+Context
+-------
+
+When running your callable, Airflow will pass a set of keyword arguments that can be used in your function. This set of kwargs correspond exactly to the :ref:`context variables<templates:variables>` you can use in your Jinja templates. 
+
+For this to work, you need to define ``**kwargs`` in your function header, or you can add directly the keyword arguments you would like to get such as ``ti=None`` to have the task instance passed.
+
+Logging
+-------
+
+To use logging from your task functions, simply import and use Python's logging system:
+
+.. code-block:: python
+
+   import logging
+   logger = logging.getlogger("airflow.task")
+
+Every logging line created this way will be recorded in the task log.
 
 History
 -------