ucaeon opened a new pull request, #72492: URL: https://github.com/apache/airflow/pull/72492
The troubleshooting page currently lists causes for "task state changed externally" but does not explain what the message means or how to investigate it. This PR keeps the existing page structure in `airflow-core/docs/troubleshooting.rst` and: - Expands `Task state changed externally` to explain the state mismatch and includes an example log message - Adds an investigation checklist covering task, scheduler, worker/executor, and infrastructure logs - Adds troubleshooting guidance for tasks stuck in `queued` or `running` states - Links to the existing timeout, heartbeat, process-termination, and OOM documentation instead of duplicating it closes: #72284 --- ##### Was generative AI tooling used to co-author this PR? - [x] Yes — Cursor (Grok) Generated-by: Cursor (Grok) following [the guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
