docs: Add troubleshooting guide on new S3 checksums (#684)

* docs: Add troubleshooting guide on new S3 checksums

* Apply suggestions from code review

Co-authored-by: Andrew Kenworthy <1712947+adwk67@users.noreply.github.com>

---------

Co-authored-by: Andrew Kenworthy <1712947+adwk67@users.noreply.github.com>

Author: sbernauer

docs/modules/airflow/pages/troubleshooting/index.adoc

@@ -0,0 +1,27 @@
+= Troubleshooting
+
+== S3 Logging: An error occurred (411) when calling the PutObject operation: Length Required
+
+If Airflow is trying to access S3 (e.g. for remote task logging) and throws the following error
+
+[source,text]
+----
+{s3_task_handler.py:190} ERROR - Could not write logs to s3://***/***-task-logs/dag_id=test/run_id=manual__2025-05-22T08:14:17.917519+00:00/task_id=extract/attempt=1.log
+Traceback (most recent call last):
+[..]
+botocore.exceptions.ClientError: An error occurred (411) when calling the PutObject operation: Length Required
+----
+
+then this is an indication that your S3 store doesn't support the new AWS S3 checksums.
+Ideally you should upgrade your S3 store to a more recent version that supports the new checksums (if there is any).
+If this is not possible, you can work around this by setting the following env vars
+
+[source,yaml]
+----
+webservers: # Also add to other roles!
+  envOverrides:
+    AWS_REQUEST_CHECKSUM_CALCULATION: when_required
+    AWS_RESPONSE_CHECKSUM_VALIDATION: when_required
+----
+
+See e.g. https://github.com/minio/minio/issues/20845[this MinIO issue] for details.

docs/modules/airflow/partials/nav.adoc

@@ -18,6 +18,7 @@
 *** xref:airflow:usage-guide/operations/pod-placement.adoc[]
 *** xref:airflow:usage-guide/operations/pod-disruptions.adoc[]
 *** xref:airflow:usage-guide/operations/graceful-shutdown.adoc[]
+* xref:nifi:troubleshooting/index.adoc[]
 * xref:airflow:reference/index.adoc[]
 ** xref:airflow:reference/crds.adoc[]
 *** {crd-docs}/airflow.stackable.tech/airflowcluster/v1alpha1/[AirflowCluster {external-link-icon}^]