openvino icon indicating copy to clipboard operation
openvino copied to clipboard

Add documentation for Linux THP alignment performance impact in OpenVINO

Open ArmaanBawa opened this issue 2 weeks ago • 3 comments

Summary

This PR adds a documentation page describing a Linux kernel Transparent Huge Page (THP) alignment behavior (commit efa7df3e3bb5) that can negatively impact performance when running dynamic Hugging Face Transformer models with OpenVINO. The document explains affected workloads, symptoms, diagnostic tips, and recommended mitigation guidance.

Motivation

This issue was reported based on performance regressions observed on Intel Developer Cloud when THP coalescence was disrupted due to forced PMD alignment. The documentation helps users understand and avoid this behavior when benchmarking or deploying OpenVINO-based workloads on Linux.

Related Issue

Fixes: #33137

Changes • Added new page: linux_thp_performance_impact.rst in docs/articles_en/documentation/.

ArmaanBawa avatar Dec 09 '25 12:12 ArmaanBawa

@mlukasze @ahnyoung-paul @alanzhai219 Can you please review this PR if possible and tell me the changes required!!

ArmaanBawa avatar Dec 11 '25 09:12 ArmaanBawa

.take

ArmaanBawa avatar Dec 11 '25 09:12 ArmaanBawa

@almilosz Can you please also review!

ArmaanBawa avatar Dec 11 '25 09:12 ArmaanBawa