[26.1] Iceberg stress testing and performance tuning

[kbatuigas]

Description

This pull request introduces significant improvements to the Iceberg documentation by splitting out performance tuning and troubleshooting content into dedicated pages, enhancing navigation, and updating cross-references for clarity. The changes make it easier for users to find best practices for optimizing and troubleshooting Iceberg topics, and ensure that documentation links are accurate and up-to-date.

Documentation Restructuring and Navigation:

• Added new navigation entries for "Tune Performance" and "Troubleshoot" under the Iceberg section in nav.adoc, improving discoverability of these topics.
• Updated links in the "About Iceberg Topics" page to reference the new dedicated performance tuning and troubleshooting pages, and removed the inlined troubleshooting and performance sections for better modularity.

New and Updated Content:

• Created a new iceberg-performance-tuning.adoc page with comprehensive guidance on partitioning, compaction, flush threshold and lag tuning, cluster sizing, and monitoring translation performance for Iceberg topics.

  • This standalone page now hosts content currently found in the About Iceberg Topics > Performance considerations section.

• Created a new standalone iceberg-troubleshooting.adoc page that hosts content currently at About Iceberg Topics > Troubleshoot errors. Added list of relevant metrics.

Resolves https://redpandadata.atlassian.net/browse/
Review deadline:

Page previews

Tune Performance for Iceberg Topics
Troubleshoot Iceberg Topics

Checks

• New feature
• Content gap
• Support Follow-up
• Small fix (typos, links, copyedits, etc)

[netlify]

✅ Deploy Preview for redpanda-docs-preview ready!

Name	Link
🔨 Latest commit	0041b57
🔍 Latest deploy log	https://app.netlify.com/projects/redpanda-docs-preview/deploys/69c308726ea0c800080ffff2
😎 Deploy Preview	https://deploy-preview-1599--redpanda-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 9cce81f9-c33c-45c2-a217-5d4e8d7a1c93

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch DOC-1848-Document-feature-Iceberg-stress-testing

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}