[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
 -------