timeout give extra info (#83206)

the new field shows the python code in execution when it timed out, 99% of the time it will be on a selector waiting for output from ssh to remote.

changelogs/fragments/timeout_show_frame.yml

@@ -0,0 +1,2 @@
+minor_changes:
+  - task timeout now returns timedout key with frame/code that was in execution when the timeout is triggered.

lib/ansible/executor/task_executor.py

@@ -42,11 +42,13 @@ __all__ = ['TaskExecutor']
 
 
 class TaskTimeoutError(BaseException):
-    pass
+    def __init__(self, message="", frame=None):
+        self.frame = str(frame)
+        super(TaskTimeoutError, self).__init__(message)
 
 
 def task_timeout(signum, frame):
-    raise TaskTimeoutError
+    raise TaskTimeoutError(frame=frame)
 
 
 def remove_omit(task_args, omit_token):
@@ -640,7 +642,7 @@ class TaskExecutor:
                 return dict(unreachable=True, msg=to_text(e))
             except TaskTimeoutError as e:
                 msg = 'The %s action failed to execute in the expected time frame (%d) and was terminated' % (self._task.action, self._task.timeout)
-                return dict(failed=True, msg=msg)
+                return dict(failed=True, msg=msg, timedout=e.frame)
             finally:
                 if self._task.timeout:
                     signal.alarm(0)

test/integration/targets/playbook/timeout.yml

@@ -10,3 +10,4 @@
         that:
             - time is failed
             - '"The shell action failed to execute in the expected time frame" in time["msg"]'
+            - '"timedout" in time'